Workiva サポートセンター

コマンドの出力から変数を作成するには、ダイナミック出力を使用する。動的出力は、チェーン内での後ほどの使用向けなど、コマンドの出力から値または値のリストを抽出するルールです。以下を使えば、コマンドに複数のダイナミック出力を追加できます：

• 抽出する値の先頭または末尾の特定のテキストに基づく完全一致。
• 正規表現（regex）：特定のパターンやシーケンスに基づいて値をマッチングする。

例えば、あるコマンドが、チェーン内の後のコマンドで使用される値を含むテキスト・ファイルを出力する場合、File Utils connector's List File Content コマンドの動的出力によってそれらの値を抽出します。

メモ: 動的出力の文字列マッチサイズは最大1024文字。マッチがこの長さを超える場合は、何も返却されない。

ダイナミック出力のテスト

ダイナミック出力が希望する結果を確実に作成するために、作成する前にサンプル値でその条件をテストしてください。例えば、電話番号データを使ったダイナミック出力のテストができる：

(381) 782-5259 (511) 545-6132 (220) 476-8339 (837) 516-4312 

1. チェーンで、抽出する出力のコマンドを選択し、編集 作成 をクリックする。
2. 動的出力 flash_on を選択し、テスト をクリックする。
3. Value to test に、ダイナミック出力で使用されるコマンド出力を示すサンプルコンテンツを入力する。
4. 動的出力で使用する正規表現または完全一致の条件を入力します。例えば、サンプルの電話番号から市外局番を抽出する場合：
   • 完全一致：
     • Start とEnd には、それぞれ、( と) というように、始めと閉じの括弧を入力する。
     • 抽出値に括弧を含むには、開始を含む と終了を含む を選択する。
   • 正規表現 (regex) マッチとして：
     • マッチ種別に正規表現\(([0-9]*) \)を入力し、括弧内の数字にマッチさせます。
     • マッチ結果 で$0を入力すると、括弧を含むマッチした値全体が表示され、$1を入力すると、 括弧を含まないマッチした桁のみ が表示されます。
5. 提出をクリックし、結果が希望する出力と一致することを確認します。

完全一致に基づく動的出力の作成

1. チェーンで、抽出する出力のコマンドを選択し、編集 作成 をクリックする。
2. 動的出力 flash_on を選択し、動的出力の追加 をクリックする。
3. ダイナミック出力の識別に役立つ一意の名称を入力する。
4. オリジナル出力 で、抽出するコマンドの出力を選択する。
5. Match type で Exact を選択。
6. 抽出する文字列の開始または終了を示すテキストを入力し、一致したテキストを抽出値に含めるかどうかを選択します。
7. 出力の特定の文字列のみにテキストをマッチさせるには、チェックする線を入力します。
   • 行の範囲を含むには、1-10のように、-のダッシュを使用します。
   • 行または範囲を区切るには、1から10までそして13の行のように向けには1-10,13のように、コンマを使用します。
8. 出力タイプ で、単一の値を抽出するか、複数の値を抽出するかを選択する。

   メモ： Multipleの出力タイプは、最大1,000アイテムのJSON配列を作成し、コマンドまたはコマンドグループの反復で使用することができます。

9. テキストをマッチングする際に文字の大文字小文字を考慮するには、Case sensitive を選択します。
10. マッチしたテキストから先頭または末尾の空白を取り除くには、Trim matches を選択する。
11. [保存]をクリックします。

正規表現に基づく動的出力の作成

1. チェーンで、抽出する出力のコマンドを選択し、編集 作成 をクリックする。
2. 動的出力 flash_on を選択し、動的出力の追加 をクリックする。
3. ダイナミック出力の識別に役立つ一意の名称を入力する。
4. オリジナル出力 で、抽出するコマンドの出力を選択する。
5. Match type で、Regular Expression (regex) を選択する。
   
6. Match text に、抽出する値のマッチに使用する正規表現構文を入力します。
7. Match result に、マッチした値を表示する構文を入力する。例：
   • 一致する値全体には、$0 と入力する。
   • 括弧で囲まれた一致値には、$1 と入力する。
8. 出力の特定の文字列のみにテキストをマッチさせるには、チェックする線を入力します。
   • 行の範囲を含むには、1-10のように、-のダッシュを使用します。
   • 行または範囲を区切るには、、、1～10、13のようにカンマを使用します。
9. 出力タイプ で、単一の値を抽出するか、複数の値を抽出するかを選択する。

   メモ： Multipleの出力タイプは、最大1,000アイテムのJSON配列を作成し、コマンドまたはコマンドグループの反復で使用することができます。

10. [保存]をクリックします。

ダイナミック出力のテスト

コマンドから動的出力を削除するには：

1. チェーンで、抽出する出力があるコマンドを選択し、Edit create をクリックし、Dynamic Outputs flash_on を選択する。
2. 削除するダイナミック出力については、削除 削除 をクリックする。