テンプレートの作成

Kapplets テンプレートを作成するには、次の手順を実行します。

[テンプレート] ページに移動します。
プラス記号を選択して新しいテンプレートを作成します。
[一般] ペインで次の情報を設定します。
- 名前: テンプレート名を入力します。
- [ワークスペース]: ドロップダウンリストからワークスペースを選択します。
- [説明]: 短い説明を入力して、テンプレートに関する情報を追加します。
- [キュータイムアウト期間] および [キュータイムアウト単位]: キューのタイムアウト値を設定し、時間単位を選択して、Management Console でロボットがキューに留まる時間を指定します。このタイムアウトは、テンプレート内のすべてのロボットに適用されます。デフォルトは 600 秒です。
- 優先度: 実行の優先度を設定します。
- 完了時に通知: 実行が完了したときにブラウザ通知を有効にするには、オンにします。
  
  通知はブラウザで Kapplet を使用している場合にのみ利用でき、実行ステータス、Kapplet 名、完了時刻、および実行結果へのリンクが含まれます。
  - ブラウザ通知に関する権限と HTTPS 接続が必要です。
    
    通知の表示と動作は、ブラウザとオペレーティングシステムに応じて異なります。開発環境では、Google Chrome と Microsoft Edge で、Insecure origins treated as secure フラグを有効にする必要があります。Mozilla Firefox では、通知は localhost でのみサポートされます。
  - スケジュールされた実行および [コミットアクション] によってトリガーされたプロセスは、通知の対象に含まれません。
- [アイコン]: アイコンを追加することで、テンプレートを一意にして区別しやすくします。デフォルトでは、アイコンはワークスペースから継承されます。アイコンを変更するには、[ギャラリー] から画像を選択するか、新しい画像をアップロードします。アップロードされた画像に、区別しやすくするためのタグを設定します。
  
  [ギャラリー] では、.png および .jpeg ファイルのみがサポートされます。
[次へ] を選択します。
[ロボット] ペインで、1 つまたは複数のロボットを選択します。

ロボットのリストが長い場合は、検索フィールドを使用して必要なロボットを見つけます。
- 複数のロボットを選択する場合は、ツールバーの [選択したロボット] ボタンを使用して、選択したロボットを表示します。選択したロボットの番号がボタンに表示されます。
- [選択したロボット] ペインで [順番に実行] をオンにして、ロボットの実行順序を定義します。有効にすると、ロボットをドラッグして順番を変更できるようになります。
- [設定] ペインで、Management Console プロジェクトを基準としてロボットをフィルタします。
[次へ] を選択します。
[入力] ペインで、選択したロボットの入力パラメータを設定します。

このステップは、選択したロボットのいずれかに入力パラメータが含まれている場合にのみ表示されます。

入力パラメータと検証ルールを設定すると、自動的に検証されます。エラーが返された場合は、入力パラメータまたは対応する検証ルールを修正します。入力が有効な場合、「次へ」ボタンが有効になります。
- ロボットを選択して、その変数タイプを表示します。
- ロボット変数が表示されたウィンドウで、変数を選択してその属性を設定します。
- 変数ウィンドウの隣のウィンドウに、すべての属性が一覧表示されます。
- 入力フィールドの順序を変更するには、[開始] ページで順序を設定し (次の [ページ] ステップを参照)、テンプレートを保存した後に [テンプレートの並べ替え] オプションを有効にします。「テンプレートの並び替え」を参照してください。
- [開始] ページに表示する [フィールドラベル] と [フィールドのヒント] を入力します。
- [必須] または [非表示] を選択して、[開始ページ] にフィールドを表示する方法を設定します。
- 次のいずれかの [入力方法] を選択します。[テキスト入力] または [オプションから選択]。
  
  [オプションから選択] チェックボックスをオンにすると、定義済みリストから値を選択できるようになります。このリストを設定するには、次の手順を実行します。
  - 各項目の [オプションラベル] と [入力値] を指定します。
    
    この値は実行時にロボットに渡され、ラベルは [開始ページ] に表示されます。[オプションラベル] が指定されていない場合は、[入力値] がラベルとして使用されます。
  - 必要に応じて、項目の追加、削除、編集、および並べ替えを行います。
  - 定義済みのオプションから、入力フィールドの [デフォルト値] を選択します。
- パラメータを個別に設定します。パラメータのセットは、各属性によって異なります。
[次へ] を選択します。
[ページ] ペインで、必要に応じて次の設定を行います。
- [開始ページ] でページタイトルを編集し、[ページテキスト] フィールドにページの説明を入力します。
- [フィールドの順序] リストでアイテムをドラッグして、フィールドの順序を変更します。
- [ステータスページ] でページタイトルを編集します。
- [入力ページ] でページタイトルを編集します。
  
  実行結果では、このページに実行時に使用された入力パラメータが表示されます。
- 実行結果をテーブルで表示するには、ツールバーの [テーブルページの追加] アイコンを選択します。
  - [テーブルページ] でページのタイトルおよび説明を編集します。
  - リストからロボットを選択して、そのパラメータを設定します。[返されるタイプ] リストは、選択したロボットの出力タイプで構成されています。
  - ロボットが返す特定のデータセットの結果を表示するように [データセット] を設定します。
    - ロボットの戻り値の型名のいずれかに一致するデータセット値を入力します。
    - [このデータセットを Kapplet の結果件数として使用します] を選択して、実行履歴に結果件数を表示します。結果件数は、選択されたデータセットの行数に基づいています。
    - データセットが指定されている場合、実行情報にはそのデータセットの結果のみが表示されます。データセットが指定されていない場合、複数の戻り値の結果が同時に表示されます。
  - パラメータを選択してテーブルに表示されるそのフィールドを定義します。
  - [利用可能なコミットアクション] オプションを使用して、各ロボットにアクションをコミットするためのそれぞれ異なるロボットを割り当てます。「コミットアクションのロボットの選択」を参照してください。
- 実行結果をグラフで表示するには、ツールバーの [グラフページの追加] アイコンを選択します。
  - [チャートページ] でページのタイトルおよび説明を編集します。
  - リストからロボットを選択して、グラフに表示されるパラメータを設定します。
  - ロボットが返す特定のデータセットの結果を表示するように [データセット] を設定します。詳細については、[テーブルページ] の手順を参照してください。
  - 次のパラメータを選択します。[グラフのタイプ]、[配色]、[ラベル軸]、[データ軸]。
  - 他のグラフパラメータを設定します。
  - [プレビュー]  ボタンを選択してグラフをプレビューします。
テンプレートを保存するには、[保存] を選択します。

テンプレートのオブジェクトは次のようになります。テンプレートから Kapplet を作成するには、「Kapplets」を参照してください。