ノードパラメータ

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

パラメータタイプ

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

• 単一値: フィールドごとに 1 つの値（文字列、数値（整数または浮動小数）、ブール値、またはタイムスタンプ）。値を直接入力するか、前のノードから参照します。

• リスト: タグ、リージョン、フィルターなどのアイテムの配列です。別のノードからリスト全体を参照するか、個々のアイテムを追加することができます（またはその両方）。

• マップ: キーと値のペア（例: タグやラベル）。別のノードからマップ全体や構造体を参照するか、エントリを手動で追加することができます（またはその両方）。

• 構造体: 固定されたフィールド名を持つネストされたオブジェクト（例: name、id、tag を持つリソース）。各フィールドを個別に設定する必要があります。それぞれのフィールドに対して値を直接入力するか、+ ボタンを使用して前のノードから値を参照できます。つまり、構造体全体を一括で参照することはできず、個々のフィールドを参照する必要があります。

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

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

Relative date

Relative date タブでは、フロー実行時点からの相対的なタイムスタンプを設定できます。次のいずれかを行えます。

• 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）および、そのタイムスタンプを参照するフィルター条件内に表示されます。

Specific date

Specific date タブでは、日時ピッカーが開き、特定の日付と時刻を選択できます。

フィールドの参照

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

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

パラメータタイプに応じて、単一値、リスト全体またはマップ全体、あるいは個々のエントリを参照できます。挿入された参照はハイライトされた参照として表示されます。ノードの Output（生成されたもの）または Input（渡されたもの）のどちらも使用できます。Output と input を参照してください。

単一値を参照する

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

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

リスト全体を参照する

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

1. 前のノードからリストを参照したいフィールドで + ボタンを選択します。

2. リストの取得元として、Variables（フローに変数がある場合）、trigger（例: Schedule または Manual trigger）、またはフロー内の前の node（ノード名で表示）を選択します。

   

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

3. リストを選択します。

   

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

   個々のアイテムを参照したい場合は、リストを展開し、含めたいアイテムを個別に選択します。

4. （任意）下に手動でアイテムを追加します。実行時には、これらのアイテムが参照したリストの後ろに追加されます。

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

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

1. 前のノードからマップまたは構造体を参照したいフィールドで + ボタンを選択します。

2. マップまたは構造体の取得元として、Variables（フローに変数がある場合）、trigger（例: Schedule または Manual trigger）、またはフロー内の前の node（ノード名で表示）を選択し、参照するマップまたは構造体フィールドを選択します。

   

3. （任意）パラメータが許可している場合は、参照したマップに加えて、キーと値のペアを追加できます。実行時には、参照したマップまたは構造体と、手動で追加したエントリがマージされます。同じキーが両方に存在する場合、手動で追加したキーと値のペアが参照値を上書きします。

ハイライトされた参照

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

これらは動的参照です。フロー実行時には、それぞれの参照が、表示されているパス（トリガーからのデータ、変数、前のノードの Output や Input など。詳しくは Output と input を参照）から取得された値に解決されます。同じフィールド内のプレーンテキストは入力したとおりに保持されます。

• ツールチップ: ラベルが切り詰められている場合、その参照にカーソルを合わせると、フルパスが表示されます。一部の変数参照では、ホバー時に変数の現在値が表示される場合があります。

• 参照の削除: X を使用して、周囲のテキストに影響を与えずに参照を削除できます。

• リスト: リストを期待するパラメータでは、参照されたリストアイテムが角括弧形式で表示されることがあります。HTTP node を参照してください。

インライン変換

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

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

Transformation	Description	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

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

インライン変換を削除するには、変換済みの参照を右クリックし、Remove transform を選択してください。参照は元の未変換の状態に戻ります。

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

注意

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

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

出力と入力

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

• Output: ノードが実行されたときに生成された結果（例：API レスポンス（ID、リスト、ステータスなど））です。ノードの実行によって取得されたデータが必要な場合に使用します。

• Input: ノードが実行時に送信した値そのものです。これは、参照が評価された後の、そのノードの Parameters タブにおける最終的な解決済みパラメータ値です。別のノードが実際に受け取った内容（例：前のノードが使用したリージョンのリスト）を再利用したい場合に使用します。

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

関連情報

• Nodes — すべてのノードタイプの概要
• AWS node — Waiter やリージョンなどの AWS 固有の設定
• Google Cloud node — GCP 固有の設定
• DoiT node — スレッドの作成などの DoiT 固有のアクション
• HTTP node — 外部 API への HTTP リクエスト
• Filter node — 前のノードのフィールドに対する条件の評価
• Branch node — if/else の分岐ロジック
• Transform node — ノード間でデータの形状変更や再フォーマットを実行
• Date/time node — タイムスタンプフィールドに対する日付・時刻の計算
• Notification node — データをメールや Slack に送信
• Threads node — Jira や Linear などの ITSM ツールに課題を作成
• LLM node — 大規模言語モデルを使用したデータ処理
• Policy node — コンプライアンスポリシーに対するリソースの評価
• SQL node — 請求データに対する SQL クエリの実行
• Datastore node — 構造化データの保存および取得
• Code node — カスタム JavaScript または Python コードの実行
• CLI node — サンドボックス内でのシェルスクリプトの実行
• Sub Flow node — フロー内から別のフローを呼び出し
• Sleep node — 指定した期間だけフローを一時停止
• Test — ノードのテスト