メインコンテンツへスキップ

変数を使用する

フローで定義するアクションやオペレーションによって、グローバル変数やローカル変数をフローに追加する方法はいくつかあります。

接続変数はアクションノードとCLI ノードで使用できます。ノードでクラウド接続が必要な場合は、アクションノードではノードの Connection タブの Connection variables セクションから、CLI ノードでは Connection ドロップダウンリストから直接、接続変数を選択してください。詳しくは、Use a connection variable in an action node を参照してください。

Add variables to parameters​

アクションノードで変数を使用できます。

注意

接続変数はノードのパラメータではサポートされていません。

  1. フローにアクションノードを追加するか、既存のノードを編集します。

  2. アクションで利用可能なパラメータに応じて、変数を追加したいパラメータの横にあるプラスボタン (+) を選択します。

  3. Variables を選択し、要件に応じて Global Variables または Local Variables を展開し、使用したい変数を選択します。

    Add a variable as data

マップ（キーと値の構造）を期待するパラメータの場合は、マップ全体を含む変数や前のノードの出力を参照できます。フローは実行時にマップ全体を使用するため、各キーと値のペアを手動で入力する必要はありません。

Use variables in Code and CLI nodes​

Code ノードとCLI ノードでは、組み込みの変数オブジェクトを使用して、スクリプト内でグローバル変数とローカル変数を直接参照できます。これは、リージョン名、閾値、フラグなど、フロー変数として管理されている値にスクリプトのロジックが依存する場合に便利です。

  • Code node (JavaScript): $variables.globalVariables.<name> または $variables.localVariables.<name> を使用します。
  • Code node (Python): variables["globalVariables"]["<name>"] または variables["localVariables"]["<name>"] を使用します。
  • CLI node: $variables.globalVariables.<name> または $variables.localVariables.<name> を使用します。

Code ノードでは、$variables と $nodes はスクリプト内の実行時オブジェクトです（フローデータは実行開始時にロードされます）。CloudFlow はソーステキストを書き換えないため、値は文字列やオブジェクト、クォートに関する通常の JavaScript や Python のルールに従います。Code ノードエディタは、$nodes、変数スコープ、および個々の変数名に対するオートコンプリート候補を提供します。

CLI ノードでは、スクリプトはシェルによって実行されます。CloudFlow はコマンドの実行前にテキストインジェクションを使用して $variables と $nodes を処理します。各値は、自動的にラップされ、スペースや特殊文字が適切に処理されます。Code ノードとは異なり、これらの参照はライブオブジェクトではありません。プレーンテキストに置き換えられます。独自のクォートやバックスラッシュを追加する場合は、CloudFlow の内部フォーマットを囲むことになり、パースエラーの原因となる可能性があるため注意してください。

注意

接続変数は $variables では使用できません。CLI ノードの場合は、ノードの Connection ドロップダウンリストから接続を選択してください。固定の接続または接続変数を選択できます。Code ノードの場合は、該当する値を前のノードまたは接続以外の変数を通して渡してください。

Add a connection variable in an action node​

接続変数は、その値が組織の AWS・GCP・OpenAI・Anthropic 接続のいずれかである変数です。アクションノードでは、各ノードで個別に接続を選択する代わりに、プロバイダに一致する接続変数を使用できます。CLI ノードは AWS または GCP の接続変数を使用できます。Azure 接続は Azure ノード上で直接選択する必要があります。接続は 1 か所を更新するだけで済むため、クラウドターゲットや環境間でフローを再利用しやすくなり、ターゲット接続が変わるたびに各ノードを編集する手間が省けます。

注意

接続変数はアクションノードとCLI ノードで使用できます。その他のノードタイプでは使用できません。

  1. Type が connection の変数を作成します。

  2. フローにアクションノードを追加するか、既存のノードを編集します。

  3. ノードの Connection タブを選択します。

  4. Connection ドロップダウンリストを展開します。Connection variables セクションが表示されます。

    Add a connection variable to an action node

    利用可能な接続は、設定中のアクションに一致します。たとえば、AWS アクションでは AWS の接続変数のみが表示されます。

  5. Connection variables の下で、使用したいグローバルまたはローカルの接続変数を選択します。

    A an action node with a selected connection variable

Add a connection variable in a CLI node​

CLI ノードでも接続変数を使用できます。

  1. Type が connection の変数を作成します。

  2. フローに CLI ノードを追加するか、既存のノードを編集します。

  3. Parameters で、Cloud connection provider の下から Google Cloud (GCP) または Amazon Web Services (AWS) を選択します。

  4. Connection ドロップダウンリストを開きます。Connection ドロップダウンリストには、接続と接続変数の両方が表示されます。

  5. 使用したい接続変数を選択します。実行時に、CloudFlow は変数をその基になる接続 ID に解決します。接続変数を更新すると、ノード自体を編集することなく、CLI ノードが使用する接続が変更されます。

Filter using variables​

フロー内で変数を条件としてフィルタリングできます。

  1. フローに Filter ノードを追加するか、既存のノードを編集します。

  2. +Add a new filter を選択するか、既存のフィルターを編集します。

  3. Value の横にあるプラスボタン (+) を選択します。

  4. Variables を選択し、要件に応じて Global Variables または Local Variables を展開し、使用したい変数を選択します。

    Filter a variable

Add variables to messages​

承認が必要なアクションノードがある場合は、そのアクションの承認をリクエストする通知メッセージに変数を追加できます。

  1. フローに承認が必要なノードを追加するか、既存のノードを編集します。

  2. Parameters で Require approval for this action を選択します。

  3. Message にメッセージを入力します。変数を追加したい箇所でプラスボタン (+) を選択します。

  4. Variables を選択し、要件に応じて Global Variables または Local Variables を展開し、メッセージに追加したい変数を選択します。

    Add a variable to a message

に最終更新