変数は、インテグレーションのタスク、トリガー、エッジとの間でデータを保持と転送を行うインテグレーションの要素です。
- 変数は、設計時に静的に定義するだけでなく、ランタイム時にインテグレーションへ動的に渡すこともできます。
- 変数は、インテグレーション内の他の変数を参照できます。
- 変数は、すべてのタスクに対してグローバルにアクセス可能か、特定のタスクに対してローカルでアクセス可能です。
次の 2 種類の変数が利用できます。
- インテグレーション変数は、インテグレーション実行の全体でデータを追跡します。
- タスク変数は、1 つのタスクの存続期間中にデータを追跡します。
インテグレーション変数
インテグレーション変数は、プログラミング言語で使用される変数と似ています。インテグレーションの実行中に、変数内のデータの読み取りと書き込みを行うことができます。
インテグレーション変数は次のように使用できます。
- インテグレーションの入力(入力変数)として取り込みます。
- インテグレーションの出力(出力変数)として返されます。
- インテグレーションの実行中に一時的な状態を保持するために使用されます。
インテグレーションでは、変数の値を静的に定義する必要はありません。トリガーを使用して変数の値をインテグレーションに渡すことができます。ただし、インテグレーションで変数が静的に定義され、同じ変数がトリガーで動的に指定されている場合、動的値のアサインメントによって静的アサインメントが上書きされます。
インテグレーション変数でサポートされているデータ型
インテグレーション変数では、次のデータ型がサポートされています。
- 文字列と文字列配列
- 整数と整数配列
- Double と Double 配列
- ブール値とブール値配列
- JSON
タスク変数
タスク変数は、タスク用に事前に定義された事前生成の変数です。タスクに出力がある場合、そのような出力はすべてタスク変数で使用できます。タスク変数を削除または編集することはできません。たとえば、Call REST Endpoint タスクでは、レスポンスの本文が responseBody
変数に格納されます。
変数を表示する
[変数] ペインを使用して、インテグレーションの変数を表示、作成、複製、削除できます。[変数] ペインには、インテグレーション内の変数参照の合計数も表示されます。
[変数] ペインを表示するには、デザイナーのナビゲーション バーで、
(切り替えパネル)をクリックします。次の図は、[変数] ペインのサンプル レイアウトを示しています。
変数を作成する
変数を作成するには、次の手順を行います。
- インテグレーション エディタのナビゲーション バーで、 (パネル切り替え)をクリックして [変数] ペインを開きます。
- [+ 作成] をクリックします。
- [変数の作成] ペインで、次の操作を行います。
- 名前: 変数の名前を入力します。
- Data Type: 変数のデータ型を選択します。変数名の横にあるアイコンを使用すると、変数のデータ型を識別できます。
データ型 例 文字列 Alex
整数 30
double 型 30.5
ブール値 true
JSON { "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
文字列配列 Alex, Kai, Raha
整数配列 30, 25, 22
double 配列 30.5, 25.34, 22.134
ブール値配列 true, false, false
サポートされているデータ型については、サポートされているデータ型をご覧ください。
- デフォルト値: 変数のデフォルト値を入力します。このフィールドは省略できます。
- スキーマ: 変数の JSON スキーマを選択します。
- サンプル JSON ペイロードから推測する: サンプル JSON ペイロードから JSON スキーマを生成します。サンプル ペイロードは、スキーマの生成後に破棄されます。 生成されたスキーマのみが保存されます。
- JSON スキーマを入力: JSON スキーマ全体を手動で入力します。
- デフォルト値から推測する: 指定されたデフォルト値を使用して JSON スキーマを生成します。
- None: JSON スキーマなし。
- インテグレーションへの入力として使用: インテグレーションの実行中に変数にカスタム入力値を指定する場合は、このオプションを選択します。
- インテグレーションへの出力として使用: インテグレーションの実行後に変数の出力値を表示するには、このオプションを選択します。
- [作成] をクリックします。
インテグレーションでの変数データの使用
インテグレーションの実行中、インテグレーションまたはタスクに対して宣言された変数としてランタイム データが渡されます。実行が開始されると、入力データはイベントというメモリ内オブジェクトに変換されます。
イベント オブジェクトが作成されると、統合定義を使用してタスクのメモリ内グラフが作成されます。受信した変数の値は、構成に基づいてタスクに渡されます。インテグレーションが実行されるとタスクがデータを読み取り、後続のタスクで使用する際またはインテグレーションの出力データを作成する際に、イベント オブジェクトにデータを書き戻します。