重要: これらのタブのいずれかでキャンセル をクリックすると、コマンド構成ダイアログが閉じます。前回保存 をクリックした時以降の変更は破棄され、元に戻すことはできません。
修正コマンド タブ
コマンドの修正 タブでは、このコマンドの実行時に考慮または除外するフィールドを設定できます。
このコマンドを修正します:
- Modify command タブを選択します。
- (オプション)名称 で、指定されたデフォルト名を修正します。
- (オプション)[説明] で、コマンドの構成について有用な説明を入力します。
-
コマンド プロパティ で、このコマンドに適したWorkday 接続 と接続タイプ(CloudRunner または GroundRunner)を選択します。
メモ: CloudRunner がデフォルト選択ですが、この接続は GroundRunner を使用しても機能します。GroundRunner のインストールと使用については、Workiva サポートページGroundRunner のインストールと管理 を参照してください。
-
使用する入力ファイル を選択します。
これはソース・データを含む .csv ファイルです。このファイルのテンプレートは、Workiva ドキュメントで入手できます。メモ:EIBテンプレート(下記参照)を使用している場合、CSVのヘッダーはテンプレートファイルに定義されたフィールドと一致する必要があります。
- 予算構成 の下で、計画構成に関連付けられた予算構成 ID と、財務計画名称に関連付けられたCustom_Budget_ID を入力します。
-
使用するインポートモード を選択します。
インポートモード 動作 増分追加のみ 新規行を追加し、既存の行を更新します。何も削除しません。 すべて置換 既存の予算計画全体を削除し、ファイル内のデータと厳密に置換します。 削除を伴う増分追加 アップロードされたファイルに合わせてシステムを同期します。新規の追加、既存の更新、アップロードされたファイルから欠落しているシステム内の行の削除を行います。 期間による全置換 アップロードされたファイル で検索された期間のみデータをワイプおよび置換します。他の月/期間のデータを保存します。 - (オプション)コマンドの目的を説明するメモ を入力します。
-
このノードが完了したときにトリガするアクションを選択します。
コマンド 説明 自動完了 マーク(チェック)を付けると、ビジネスプロセスは自動的に処理されます。これは、すべての承認者がシステムで自動的に承認され、すべてのレビューとToDoが自動的にバイパスされ、すべての通知が自動的に抑制されることを意味します。 送信 マーク(チェック)すると、チェーンは自動的にアクションを提出またはサブミットします。
最後のフィールドとチェックボックスはEIBテンプレートを使用する場合のみです。EIB テンプレート・ファイルを使用していない場合は、これらの両方を無視できます。
メモ:EIB テンプレートは、Import Budget アクションの完了に必要なフィールドを定義する XML ファイルでなければなりません。構成がある場合、これは「予算構成」データよりも優先されます。
- 予算データのインポートに EIB テンプレートファイルを使用している場合は、EIB テンプレートファイル フィールドにファイル名を入力します。
- (オプション)Ignore warnings チェックボックスを選択すると、オプション・フィールドがありませんと、すべての警告を無視します。
テンプレートファイルにはオプションフィールドが含まれるため、このオプションが選択されていない限り、フィールドが存在しないとコマンドはエラーをスローします。
このオプションは EIB テンプレートを使用したインポート予算プロセスにのみ適用されます。
通知タブ
Notifications タブでは、条件が満たされたときに送信される通知メールを設定できます。
通知を設定するには
- 通知 タブを選択します。
- 新規通知 をクリックします。
-
メール をクリックします。
-
通知パネルのフィールドを入力します。
通知パネルのフィールド
フィールド名 サポートされる値とアクション 条件 サポートされる条件は次のとおりです:
- 成功: コマンドは正常に完了しました。
- エラー: コマンドは何らかの理由で失敗しました。
- Warning: これは、意図した結果が影響を受けたことを示しますが、なぜそうなったかについて、未解決の状況があるかもしれません。これが発生した理由については、コマンドの出力記録を確認してください。
- Pause はコマンドのステータスです。コマンドが "一時停止 "の場合、通知は送信されます。通知の一時停止とは関係ありません。
- 常に送信 :常にメッセージを送信します。
受信者 メッセージの送信先の電子メール アドレス (完全な電子メール アドレスである必要があります)。このフィールドをクリックすると、ワークスペースで有効なすべての電子メールアドレスのドロップダウンが表示されます。他の電子メールはプロバイダーできません。 対象 メールの件名。デフォルトでは、Chain.Environment 、Chain.Name 、Command Name 変数が使用され、選択された条件が続きますが、必要に応じて独自のテキストを入力できます。 添付ファイル これにより、電子メールにファイルを添付できます。構成ダイアログの左側にあるSelect a variable ペインの一覧からファイルを選択します。 添付ファイル名 ファイルに割り当てる名称(.txt や .csv などの拡張機能を含む)です。 本文 メール本文のテキスト。基本的な HTML 書式設定に対応しています。 - [保存]をクリックします。
追加の電子メール通知を送信するには、現在の通知の下にある新規通知 をクリックし、以下のステップを繰り返します。
通知の詳細については、Workiva サポートページManage chain and command notifications を参照してください。
条件タブをスキップ
Skip conditions タブでは、コマンドをスキップする条件と、コマンドがスキップされた場合に発生する処理を指定できます。
このコマンドのスキップ条件を設定します:
- Skip conditions タブを選択します。
-
Skip conditions フィールドをクリックし、トリガー条件を選択します。
オプションは次のとおりです:- Success (コマンドが正常に完了しました)。
- エラー (コマンドが何らかの形で失敗しました)。
-
警告 (これは意図した結果が影響を受けたことを示しますが、どのようにしてそうなったかについて未解決の状況があるかもしれません。コマンドの出力記録をチェックし、このルールが発動した理由を確認してください)
- コマンドがスキップされたときに何が起こるかを決定するルールを作成します。
- AND またはOR を選択します。デフォルトでは、最初の命令はAND で始まります。
-
+RULE をクリックし、テストするデータ型を選択します。
オプションは、String (デフォルト)、Integer 、Date 、Float 、およびJSON です。 - テストに使用する条件を入力します。
-
テスト値を選択します。オプションは以下の通り:
オプション 結果 空白 結果は空白(空設定)。 空白でない 結果は空集合ではありません。 含む 結果は特定の値を含みます。これを選択すると、マッチする文字列を入力するためのセカンダリフィールドが開きます。 RegExp に一致 結果は特定の正規表現に一致します。これを選択すると、正規表現を入力するためのセカンダリフィールドが開きます。 で開始 結果は特定の文字列で始まります。これを選択すると、文字列を入力するためのセカンダリフィールドが開きます。 で終了 結果は特定の文字列で終了します。これを選択すると、文字列を入力するためのセカンダリフィールドが開きます。 = (イコール) 結果は特定の値と一致します。これを選択すると、値を入力するためのセカンダリ・フィールドが開きます。 != (等しくない) 結果が特定の値と一致しません。これを選択すると、値を入力するためのセカンダリ・フィールドが開きます。 < (未満) 結果が特定の値より小さいこれを選択すると、値を入力するためのセカンダリ・フィールドが開きます。 > (より大きい) 結果が特定の値以上。これを選択すると、値を入力するためのセカンダリ・フィールドが開きます。 <=(以下) 結果が特定の値以下。これを選択すると、値を入力するためのセカンダリ・フィールドが開きます。 >= (以上) 結果は特定の値以上です。これを選択すると、考慮する値を入力するためのセカンダリ・フィールドが開きます。
- 条件が 1 つしかない場合は、保存 をクリックします。
- 複数の条件がある場合は、+RULE をもう一度クリックして単一の条件を追加するか、+GROUP をクリックして条件をグループとして評価します。
メモ
- 条件は、リストされた順番(上から下)に評価されます。グループ化された条件は1つのユニットとして評価され、その結果はリストに表示された順番に評価されます。
- 条件の順序を変更したい場合は、評価させたい順序でリストを再作成する必要があります。
- スキップ条件の詳細については、Workiva コミュニティページスキップ条件 を参照してください:Skip Conditions: Not to Be Skip, But Definitely Worth Considering! and the Workiva Support pageManage commands in chain.
動的出力タブ
動的出力 タブでは、コマンドの出力から値または値のリストを抽出するルールを指定できます。コマンドに複数の動的出力を追加するには、次のいずれかを使用します:
- 完全一致 - 抽出する値の先頭または末尾の特定のテキストに一致します。
- 正規表現 - 特定のパターンまたはシーケンスに基づいて値を一致させます。
動的出力ルールを設定するには、次のステップを実行します。
- 動的出力 タブを選択します。
-
+ADD DYNAMIC OUTPUT をクリックします。ダイナミック出力構成パネルが表示されます。
- この出力に名称 を入力します。
- Original output で、変換/トランスフォーメーションする出力を選択します。
- 出力の派生および保存方法を構成します。以下のフィールドはすべてオプションです。
- Match text フィールドには、一致させるテキストまたは正規表現を含めることができます。
- 指定されたテキストに正確に一致させるには、マッチタイプ で「Exact」を選択します。
- 正規表現を使用するには、マッチタイプ で「正規表現 (regex)」を選択します。
-
Match result に、結果のテキストをどのように表示するかを入力します。
たとえば、結果が括弧で囲まれた数字だった場合、括弧を含む一致した値全体を表示するには$0 と入力し、括弧を含まない一致した数字のみを表示するには$1 と入力します。 - 出力の特定の行のみにテキストをマッチさせるには、Lines to check にカンマで区切られた行番号または行数を入力します。行の範囲を含むには、ダッシュ(-)を使用します。したがって、1-10 は 1 行目から 10 行目までのコンテンツのみを返します。行または範囲を区切るには、カンマ (,) を使用します。したがって、1-10, 13 は、1 行目から 10 行目までと 13 行目のコンテンツのみを返します。
- Output type で、単一の出力を返却するか、出力リストを返却するかを選択します。
- Case sensitive およびTrim Matches のチェックボックスをマークまたはクリアして、期待する結果を得ます。
- [保存]をクリックします。
- (オプション)テスト をクリックして、期待する結果が得られるかどうかを確認します。
ダイナミック出力を追加作成する場合は、+ADD DYNAMIC OUTPUT をクリックします。これは、追加の動的出力のための動的出力構成パネルを表示します。
動的演算子での作業の詳細については、Workiva サポートページコマンドの動的出力の管理 を参照してください。
エラーアクションタブ
Error actions タブでは、コマンドのプロセスでエラーが発生した場合の処理を指定できます。
このコマンドでエラーが生成された場合のアクションを設定します:
- Error Actions タブを選択します。
-
Error actions で、コマンドに失敗した場合にチェーンが取るアクションを選択します。
- チェーン分岐ロジックに従うには、[チェーンを続行]を選択します。
- 問題の改善など、一時的にチェーンを停止するには、チェーンの一時停止 を選択する。
問題解決後にチェーンを再起動するには、チェーン内のコマンドを選択し、[再開] をクリックします。 - 完全にチェーンを停止するには[チェーンを閉じる]を選択します。
- コマンドの実行時間が必要以上に長い場合にコマンドを停止するには、Timeout conditions の下で、タスクの最大実行時間(秒)を入力します。
- データソースが断続的または使用できない場合にコマンドを再試行するには、実行する再試行の回数と、試行の間に待機する秒数を入力します。
-
エラー条件 の下で、無視するエラーを選択します。
条件 説明 無効な引数 このマークを付けると、コマンドは無効な引数を無視します。 一般的な失敗 このマークを付けると、コマンドが失敗してもチェーンが続行されます。 - 出力に基づいてコマンドのステータスを設定するには、Output interpretation の左側にある緑色の丸で囲まれたプラス記号をクリックします。
-
+Rule をクリックし、出力ステータスを解釈するルール(またはルールグループ)を定義します。
追加の条件を指定する場合は、青い丸で囲んだプラス記号をクリックして、追加の条件定義フィールドを追加します。
条件は、リストされた順序(上から下)で評価されます。グループ化された条件は1つのユニットとして評価され、その結果はリストに表示された順番に評価されます。
メモ: 条件の順序を変更する方法はありません。条件の順序を変更する場合は、評価したい順序でリストを再作成する必要があります。
-
ログ解釈 で、特定の出力に基づいてコマンドを失敗させるかどうかを選択します。
- しない 特定の出力に基づいてコマンドを失敗させるには、解釈しない を選択します。
- 特定の出力が見つかった場合にコマンドを失敗させるには、Fail if output(s) found を選択し、スキャンする出力を入力します。
- 特定の出力が見つからない場合にコマンドを失敗させるには、Fail if output(s) not found を選択し、スキャンする出力を入力します。
- 複数のテキスト行を\n で区切ります。
- [保存]をクリックします。
イテレータタブ
[イテレータ] [イテレータ]タブでは、[Get Workers]コマンドを反復(循環または繰 り返し)するためのルールを設定できます。
メモ: このタブはデフォルトで無効になっています。
イテレータ規則を設定するには、以下のステップを実行します。
- イテレータ タブを選択します。
- タブ上部のスイッチを切り替えて、イテレータを有効にします。
こうすることで、タブ見出しの次へ (イテレータ) のアイコンが濃い灰色から青色に変更され、イテレータ構成パネルが表示されます。タブタイトルの次へマーカーも緑色になります。 -
使用する修正タイプ を選択します。
オプションはList (デフォルト) およびRepeat until です。-
List を選択すると、コマンドを繰り返し実行します:
- 地域や法人などの静的な値のリスト。これも "3 "のような数字にすることができます。
- ワークスペース・リソースとしてアップロードされたファイルからの値や、チェーンの前のコマンドからの出力など、動的または変数リスト。
- Repeat until を選択すると、指定した条件が満たされるまでコマンドが繰り返されます。
メモ: コマンドの反復回数は最大 1000 回に制限されています。
-
List を選択すると、コマンドを繰り返し実行します:
- イテレータをコントロールするルールを入力します。
イテレータの指定方法を含む、イテレータの使用に関する詳細については、Workiva サポートページコマンドおよびコマンドグループでのイテレータの使用 を参照してください。 - [保存]をクリックします。