ノードパラメータ

フロー内のほとんどのノードは、前のノードからのフィールドを参照できます。AWS・Google Cloud・DoiT のアクションノードなど、多くのノードが含まれます。このページでは、ノードで設定するパラメータの種類、表示されるフィールドタイプ、およびフロー内の前のノードから値を参照する方法について説明します。

パラメータタイプ

パラメータは次のいずれかです。

単一値（Single value）: 各フィールドにつき 1 つの値（文字列・数値（整数または浮動小数点）・ブール値・タイムスタンプ）。値を直接入力するか、前のノードから参照します。
リスト（List）: タグ・地域・フィルターなどのアイテムの配列です。別のノードからリスト全体を参照するか、個々のアイテムを追加する（または両方を行う）ことができます。
マップ（Map）: キーと値のペア（例：タグやラベル）です。別のノードからマップや構造体全体を参照するか、エントリを手動で追加する（または両方を行う）ことができます。
構造体（Structure）: 固定されたフィールド名を持つネストされたオブジェクトです（例：name・id・tag を持つリソース）。各フィールドを個別に設定する必要があります。各フィールドについて、値を入力するか、+ ボタンを使用して前のノードから値を参照します。言い換えると、構造体全体を一度に参照することはできず、フィールド単位で参照する必要があります。

フィールドの参照

多くのノードは、フロー内の別の場所からパラメータ値を利用できます。+ ボタンまたは @ を使用してピッカーを開き、必要なフィールドをブラウズまたは検索して見つけてください。

フィールドを参照するとは、トリガーノード・変数・上流ノードからのデータに対するパスを選択することを意味します。実行時には、CloudFlow がそれぞれの参照を、そのパスから取得した実際の値に置き換えます。

パラメータタイプによって、単一値・リストまたはマップ全体・個々のエントリのいずれかを参照できます。挿入された参照はハイライト表示された参照として表示されます。ノードの Output（そのノードが生成したもの）または Input（そのノードに渡されたもの）のいずれかを利用できます。Output と Inputを参照してください。

単一値を参照する

パラメータの横にある + ボタンを使用して、前のノードの output または input からフィールドを選択してください。フロー実行時には、その選択した値が使用されます。これは単一値フィールドだけでなく、リスト・マップ・構造体パラメータ内の個々のアイテムやエントリにも利用できます。

テキストと参照の両方を受け付けるパラメータ（例：通知メッセージ、HTTP リクエストボディ、メールの件名）では、@ を入力して参照ピッカーを開き、参照を挿入することもできます。参照はインラインで挿入されます。同じフィールドにテキストや追加の参照を続けて入力できます。

リスト全体を参照する

パラメータがリストを想定している場合、次の 2 つの方法があります。前のノードからリスト全体を参照するか、リスト内の個々のアイテムを参照するかです。

前のノードからリストを参照したいフィールドで、+ ボタンを選択します。
リストの取得元を選択します。Variables（フローに変数がある場合）、trigger（例：Schedule または Manual trigger）、またはフロー内でそれ以前にある ノード（ノード名で指定）から選択します。

リスト全体を参照する場合、追加のマッピングは不要です。
リストを選択します。

リスト全体を参照する場合、追加のマッピングは不要です。

個々のアイテムを参照したい場合は、リストを展開し、含めたいアイテムを個別に選択します。
（任意）その下に手動でアイテムを追加します。実行時には、これらのアイテムは参照されたリストの後に追加されます。

マップまたは構造体全体を参照する

パラメータがマップ（キーと値のペア）を想定している場合、前のノードからマップまたは構造体全体を参照するか、キーと値のエントリを追加して、それぞれの値を参照または入力できます。マップパラメータでは、先頭にマップ全体を参照するためのエントリが表示され、その下にキーと値のエントリを追加できます。

前のノードからマップまたは構造体を参照したいフィールドで、+ ボタンを選択します。
マップまたは構造体の取得元を選択します。Variables（フローに変数がある場合）、trigger（例：Schedule または Manual trigger）、またはフロー内でそれ以前にある ノード（ノード名で指定）から選択し、その後、参照するマップまたは構造体フィールドを選択します。
（任意）パラメータが許可している場合、参照したマップに加えて、さらにキーと値のペアを追加できます。実行時には、参照されたマップまたは構造体に、手動で追加したエントリがマージされます。同じキーが両方に存在する場合は、手動で追加したキーと値のペアが参照値を上書きします。

ハイライト表示された参照

+ ボタンまたは @ を使用してフィールドへの参照を挿入すると、その参照されたフィールドは、上流ノードのステップと名前、およびフィールドパス（ネストされたフィールドはドットで区切られる）を示すラベル付きのハイライト表示された参照として表示されます。

これらは動的な参照です。フローが実行されると、それぞれの参照は、トリガー・変数・前のノードの output または input（Output と Input を参照）のように、表示されているパスからの値に解決されます。同じフィールド内のプレーンテキストは、そのままの内容が保持されます。

CloudFlow referenced text

ツールチップ: ラベルが省略表示されている場合は、その参照の上にカーソルを合わせると完全なパスが表示されます。一部の変数参照では、カーソルを合わせると変数の現在の値が表示されることがあります。
参照の削除: 周囲のテキストに影響を与えずに参照だけを削除するには、X を使用します。
リスト: リストを想定しているパラメータでは、参照されたリストアイテムが角括弧付きの形式で表示される場合があります。HTTP node を参照してください。

Output と Input

前のノードを参照する場合、そのノードの output と input のどちらを使用するかを選択します。

Output: ノードが実行されたときに生成した結果です。たとえば、API レスポンス（ID・リスト・ステータスなど）が含まれます。ノードを実行した結果として得られたデータが必要な場合に使用します。
Input: ノードが実行されたときに送信した正確な値です。これは、そのノードの Parameters タブで、参照が評価された後の最終的な解決済みパラメータ値です。別のノードが実際に受け取った内容（例：前のノードが使用した地域のリスト）を再利用したい場合に使用します。

+ ボタンでソースノードを選択すると、両方のオプションが表示されます。必要なデータを保持している方を選択してください。

パラメータタイプ​

フィールドの参照​

単一値を参照する​

リスト全体を参照する​

マップまたは構造体全体を参照する​

ハイライト表示された参照​

Output と Input​

関連項目​