コマンドの出力から変数を作成するには、ダイナミック・アウトプットを使う。動的出力は、コマンドの出力から値または値のリストを抽出するルールである。を使って、コマンドに複数のダイナミック出力を追加することができる:
- 抽出する値の先頭または末尾にある特定のテキストに基づく完全一致
- 正規表現(regex): 特定のパターンやシーケンスに基づいて値をマッチさせる。
たとえば、あるコマンドが、チェーン内の後続のコマンドで使用される値を含むテキスト・ファイルを出力する場合、File Utils connector's List File Content コマンドの動的出力によってそれらの値を抽出します。
注: 動的出力の最大文字列マッチサイズは1024文字です。マッチがこの長さを超える場合は、何も返されない。
ダイナミック出力のテスト
ダイナミック・アウトプットが確実に望ましい結果を生み出すようにするには、作成する前にサンプル値でその基準をテストしてください。例えば、電話番号データを使った動的出力をテストすることができる:
(381) 782-5259 (511) 545-6132 (220) 476-8339 (837) 516-4312
- チェーン内で、抽出する出力のあるコマンドを選択し、Edit をクリックする。
- 動的出力 を選択し、テスト をクリックする。
- Value to test には、ダイナミック出力で使用されるコマンド出力を示すサンプルコンテンツを入力する。
- 動的出力で使用する正規表現または完全一致の条件を入力します。例えば、サンプルの電話番号から市外局番を抽出する:
- に完全一致:
- 開始 と終了 には、それぞれ、
(
と)
、開始と終了の括弧を入力する。 - 抽出値に括弧を含めるには、開始を含める と終了を含める を選択する。
- 開始 と終了 には、それぞれ、
- 正規表現 (regex) マッチとして:
- Match type に、カッコの間の数字にマッチする正規表現
\(([0-9]*) \)
を入力します。 - Match result で、
$0
を入力すると、 の括弧を含むのマッチした値全体が表示され、$1
を入力すると、の括弧を含まない のマッチした桁のみが表示されます。
- Match type に、カッコの間の数字にマッチする正規表現
- に完全一致:
- Submit をクリックし、結果が希望する出力と一致することを確認する。
完全一致に基づく動的出力を作成する
- チェーン内で、抽出する出力のあるコマンドを選択し、Edit をクリックする。
- ダイナミック出力 を選択し、ダイナミック出力の追加 をクリックする。
- ダイナミック出力の識別に役立つ一意の名前を入力する。
- オリジナル出力 で、どのコマンドの出力から抽出するかを選択する。
- Match type で Exact を選択する。
- 抽出する文字列の開始または終了を示すテキストを入力し、一致したテキストを抽出値に含めるかどうかを選択します。
- 出力の特定の文字列のみにテキストをマッチさせるには、チェックする行を入力する。
- 行の範囲を含めるには、
1-10
のように、-
のダッシュを使用する。 - 行または範囲を区切るには、
、
、1-10,13
のようにカンマを使い、1行目から10行目までと13行目を区切ります。
- 行の範囲を含めるには、
- 出力タイプ で、単一の値を抽出するか、複数の値を抽出するかを選択します。
注: Multipleの出力タイプは、最大1,000項目のJSON配列を作成し、コマンドまたはコマンド・グループの反復で使用できます。
- テキストのマッチング時に文字の大文字小文字を考慮するには、Case sensitive を選択します。
- マッチしたテキストから先頭または末尾のホワイトスペースをトリミングするには、Trim matches を選択します。
- [保存]をクリックします。
正規表現に基づく動的出力の作成
- チェーン内で、抽出する出力のあるコマンドを選択し、Edit をクリックする。
- ダイナミック出力 を選択し、ダイナミック出力の追加 をクリックする。
- ダイナミック出力の識別に役立つ一意の名前を入力する。
- オリジナル出力 で、どのコマンドの出力から抽出するかを選択する。
- Match type で、Regular Expression (regex) を選択する。
- Match text に、抽出する値のマッチに使用する正規表現構文を入力します。
- Match result に、マッチした値を表示する構文を入力する。例:
- マッチした値全体には、
$0
と入力する。 - 括弧で囲まれたマッチした値には、
$1
と入力する。
- マッチした値全体には、
- 出力の特定の文字列のみにテキストをマッチさせるには、チェックする行を入力する。
- 行の範囲を含めるには、
1-10
のように、-
のダッシュを使用する。 - 行または範囲を区切るには、
、
、1~10、13
のようにカンマを使用する。、 13行目。
- 行の範囲を含めるには、
- 出力タイプ で、単一の値を抽出するか、複数の値を抽出するかを選択します。
注: Multipleの出力タイプでは、最大1,000項目のJSON配列が作成され、コマンドまたはコマンド・グループの反復で使用できます。
- [保存]をクリックします。
ダイナミック出力の削除
コマンドからダイナミック出力を削除するには
- チェーン内で、抽出する出力のあるコマンドを選択し、Edit をクリックし、Dynamic Outputs を選択する。
- 削除するダイナミック出力については、Delete をクリックします。