ノードパラメータ

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

パラメータタイプ

パラメータは次のいずれかになります。

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

タイムスタンプパラメータ

ノードパラメータやフィルター値でタイムスタンプが必要な場合、フロー実行時に解決される相対日付か、特定の日時のいずれかを設定できます。タイムスタンプフィールドを選択するとピッカーが開き、相対日付 と 特定の日付 の 2 つのタブが表示されます。

Node parameter/filter value timestamp picker

相対日付

相対日付 タブでは、フローが実行されるタイミングを基準にしたタイムスタンプを設定できます。次のいずれかを行うことができます。

Custom チェックボックスをオンにして、数値・時間単位(秒・分・時間・日・週・月・年)・方向(ago または from now) の任意の組み合わせを入力します。例えば、5 Days ago や 45 Minutes from now のように指定できます。Custom が選択されている場合、その下のプリセットオプションは選択解除されます。
次のいずれかのプリセット相対日付を選択します。
- Start of the flow — 現在の実行が開始された瞬間
- 1 hour ago
- 1 day ago
- 1 week ago
- 30 days ago
- 1 month ago
- 3 months ago
- 6 months ago
- 1 year ago
プリセットを選択すると Custom チェックボックスはオフになります。選択した相対日付は、フィールド内のラベル(例: 5 Days ago)およびそのタイムスタンプを参照する任意のフィルター条件に表示されます。

特定の日付

特定の日付 タブでは、正確な日時を選択できる日時ピッカーが開きます。

Node parameter/filter value timestamp picker showing specific date

フィールドの参照

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

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

パラメータタイプに応じて、単一値・リストやマップ全体・個々のエントリのいずれかを参照できます。挿入された参照はハイライトされた参照として表示されます。ノードの Output(そのノードが出力したもの)または Input(そのノードに渡されたもの)を使用できます。詳しくは Output vs input を参照してください。

単一値を参照する

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

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

リスト全体を参照する

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

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

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

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

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

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

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

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

ハイライトされた参照

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

これらは動的な参照です。フロー実行時には、各参照が、そのパス(トリガーからのデータ・変数・前のノードの output または input)から取得された値に解決されます(Output vs input を参照)。同じフィールド内のプレーンテキストは入力したとおりに保持されます。

CloudFlow referenced text

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

インライン変換

別の Transform node を追加せずに、参照に対して直接データ変換を適用できます。これは、下流のパラメータに渡す前に、文字列値を整数に変換するなど、簡単な変換が必要な場合に便利です。

変換を適用するには、ハイライトされた参照を右クリックします。その参照のデータタイプに使用できる変換オプションが表示されます。適用したい変換を選択してください。次の表は、各ソースデータタイプで利用可能なインライン変換を示しています。Source types 列には、各変換をサポートするデータタイプが表示されます。

Transformation	説明	Source types
Transform to integer	値を整数に変換	`string`
Transform to float	値を小数に変換	`string`, `integer`
Transform to string	値をテキストに変換	`integer`, `float`, `boolean`
Transform to formatted date	タイムスタンプを日付文字列としてフォーマット	`timestamp`
Transform to human-readable bytes	数値を人が読みやすいバイトサイズとしてフォーマット	`integer`, `float`
Round to integer	最も近い整数に丸める	`float`
Round to 2 decimal places	小数点第 2 位に丸める	`float`
Trim whitespace	先頭と末尾の空白を削除	`string`
Capitalize first letter	先頭の文字を大文字に変換	`string`
Transform to uppercase	すべての文字を大文字に変換	`string`
Transform to lowercase	すべての文字を小文字に変換	`string`
Transform to Unix seconds	タイムスタンプまたはタイムスタンプ文字列を Unix エポック秒に変換	`timestamp`, `string`
Transform to Unix milliseconds	タイムスタンプまたはタイムスタンプ文字列を Unix エポックミリ秒に変換	`timestamp`, `string`
Join to comma-separated string	リストのアイテムを 1 つのカンマ区切り文字列に結合	`list`

CloudFlow 参照変換

変換を適用すると、変換が有効であることを示すように参照が更新されます。参照にカーソルを合わせると、その変換の説明を含むツールチップが表示されます。変数参照の場合、ツールチップには元の値と変換後の値のプレビューも表示されます。

インライン変換を削除するには、変換された参照を右クリックし、Remove transform を選択します。参照は変換前の元の状態に戻ります。

参照を置き換える場合（+ ボタンで別のフィールドを選択するなど）、以前に適用された変換は自動的にクリアされます。

注意

上流ノードの出力タイプが変更され、保存された変換が互換性を失った場合、参照にはエラーが表示されます。参照を右クリックして互換性のない変換を削除するか、上流ノードを更新して互換性のあるタイプを復元してください。

文字列の連結、正規表現による抽出、合計や平均といった集計など、より複雑な変換には、Transform node を使用してください。

出力と入力

前のノードを参照する際、そのノードの output（出力）か input（入力）のどちらを使用するかを選択します。

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

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

パラメータタイプ​

タイムスタンプパラメータ​

相対日付​

特定の日付​

フィールドの参照​

単一値を参照する​

リスト全体を参照する​

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

ハイライトされた参照​

インライン変換​

出力と入力​

関連項目​