配列

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

配列はOrchestratorワークフローで一般的に使用されるデータ構造であり、トリガーやアクションから取得できます。

配列はOrchestratorワークフローにおける強力なツールであり、配列から値を抽出する方法を理解することは有益です。トリガー、アクション、変数のいずれを扱う場合でも、配列内の特定の値を参考資料として指定できることは、より効率的で効果的なワークフローを構築するのに役立ちます。

トリガーでの配列の使用

トリガーを使用する場合は、特定の配列値でフィルタリングして構成します。

トリガーが以下のデータを持っていると仮定します。

{
  "locales": [
    {"name": "de"},
    {"name": "en"},
    {"name": "fr"}
  ]
}

トリガーのペイロードにロケール名の配列が含まれている場合、最初のロケール名がdeである場合にのみワークフローをトリガーするようにトリガーフィルタを作成します。これを実現するには、String Equals比較演算子を使用し、値として{{ $.data.locales.0.name }}を入力します。配列内のインデックスはドットで区切られます。

アクションでの配列の使用

アクションが配列を返し、その配列内の特定の値を次のアクションで動的に使用する必要がある場合は、適切なインデックスを使用してその値を参考資料として指定します。

例として、アクションがトリガーの例と同じデータを返す場合を考えます。配列から最初のロケール名を取得するには、{{ $.locales[0].name }}と入力します。配列内のインデックスは角括弧で区切られます。パス内にデータもありません。