Workiva サポートセンター

複数のチェーンや1つのチェーン内のコマンドに繰り返し現れる入力の値を設定するには、変数 を使用することができる。複数のチェーンやコマンドに同じ値を入力するのではなく、変数として定義し、その値を一箇所で管理することができる。

• ワークスペース変数 複数のチェーンにまたがって現れる値を定義する。
• チェーン変数 チェーンの複数のコマンドに現れ、頻繁に変更される可能性のある値を定義する。
• 動的変数 チェーンの実行時や実行中に、以前のコマンドの出力に基づいて設定する値を定義します。

追加トレーニングあり
Workivaラーニングハブのセルフペースコースでチェーンの力を学ぶことができます。この包括的なコースは、チェーンビルダー・プラットフォームの実践的なエクスペリエンスと深い理解を提供しながら、チェーンの作成プロセスを最初から最後までガイドします。

Workivaラーニングハブを見る

ワークスペース変数の管理

ワークスペースから、複数のチェーンで使用される変数を定義することができます：

1. チェーンビルダー で、左上の設定 を選択する。
2. 変数 の右側にある追加 をクリックする。
   
3. 変数の識別をヘルプするために、その名称と、必要であればデフォルト値と説明を入力する。これらのデフォルト値は、個々のチェーンに合わせて後でカスタマイズすることができる。
4. セキュリティを追加するには、Encrypt （パスワードなどの機密値を隠す）を選択します。
5. [保存]をクリックします。

ワークスペースに変数を追加したら、必要に応じてその名称、値、暗号化を編集できる。ワークスペースから変数を削除するには、Delete をクリックする。

チェーンの変数管理

チェーン内の複数のコマンドに登場し、頻繁に変更される値については、チェーンの変数として追加する。チェーンの変数数に明確な制限はないが、チェーンが1000変数に近づくと反応性が低下することが確認されています。

1. チェーンについては、チェーン設定をクリックします。 
2. 変数 の下で、追加 をクリックする。
   
3. 変数とその意図の識別をヘルプするために、ユニークな名称と説明を入力する。
4. 変数のデフォルト値を入力する。
5. パスワードなど、管理者のみが変数の値を閲覧できるようにするには、Encrypt を選択します。
6. [保存]をクリックします。

変数を更新するには、チェーンの編集をクリックし、変数の下でで値を調整します。

不要になった変数を削除するには、Delete をクリックする。

チェーンの動的変数の管理

チェーンの実行時に値を設定したり、他のコマンドの出力を基に値を設定したりするには、チェーンの動的変数として追加する。

注: 連続実行を容易にするため、ダイナミック変数はチェーンの前へ実行時に設定された値を保持します。

1. チェーンについては、チェーン設定をクリックします。
2. 動的変数 の下で、追加 をクリックする。
3. 変数とその意図を識別するのに役立つユニークな名称を入力する。

   メモ： 開始値フィールドはここでは適用されないので、空白のままにしておく。

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

注： チェーンの実行開始時にダイナミック変数の値を設定するには、ランタイム入力トリガーイベントで開始します。次のステップへ進む前に、チェーンを一時停止してダイナミック変数の値を定義するには、 Set Dynamic Chain Variables イベント を追加する。

不要になった変数を削除するには、Delete をクリックする。

コマンド入力として変数を使う

コマンドのテキストベースの入力として変数を使用するには：

1. チェーンから、変数を使用するコマンドを選択する。
2. 変数を使用するテキストベースの入力で、変数 をクリックし、変数を選択する。

   メモ： 入力値内で複数の変数を連結するには、使用する変数を選択し、それぞれの前後に表示するテキストを入力する。

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

   注： コマンド入力として使用するために変数を修正または書式設定するには、変数変換を適用します。

ランタイム変数

チェーンの実行時間に関連するデータを含むには、いくつかの実行時変数を使うことができる。