変数 by Workato
Workato変数は、データ値を含む、ユーザーが宣言したデータピルです。 ユーザーが宣言したこれらの変数は、標準のデータピルとは異なり、宣言した変数がミュータブルである点が特徴です。変数の値はレシピ内で変更できます。
変数の有効期間は1つのジョブの実行中(ジョブスコープ)です。永続化されず、異なるジョブ間でこれにアクセスできるメカニズムはありません。
Workato変数には型があります。 変数を使用するには、まず変数を作成アクションを使用して宣言する必要があります。 変数を更新するには、変数を更新アクションを使用します。
例
レポート内の特定のエントリ、つまり最大のARRを持つエントリを見つけたい場合。
ARRという変数を作成します。- 各項目に対してアクションを実行し、より高い値が見つかるたびに
ARRを更新します。 - その後、
ARR値を使用して、その特定のエントリを呼び出します。
最高ARRを見つけるためにレポートを反復処理
コネクション設定
コネクションの設定は不要です。 開始するには、App > 変数 by Workatoを選択するだけです。
変数 by Workato
変数を作成
このアクションは、指定されたデータ型で変数を作成します。 各変数は、使用目的に合ったデータ型(例:integer、string)に設定する必要があります。

変数作成ダイアログボックス
変数を追加をクリックすると、このステップで複数の変数を作成できます
複数の変数の作成
| 入力フィールド | 説明 |
|---|---|
| ラベル | 変数の名前。 |
| データ型 | 変数のデータ型。 |
| デフォルト値 | 変数のデフォルト値。 デフォルト値をnilに設定するには、これを空白のままにします。 |
変数を更新
このアクションは既存の変数を更新します。 変数を作成アクションで以前に作成した変数のみ更新できます。 それ以外の場合、このアクションは使用できません。
変数を更新
| 入力フィールド | 説明 |
|---|---|
| 変数名 | 更新する変数を選択します。 |
| 入力モード | フィールド入力を個別に更新するにはStructuredを選択し、単一の完全なペイロード入力にはRawを選択します。 プリミティブ変数(文字列、数値、ブール値)は構造化する個別のフィールドを持たない単一の値であるため、Objectデータ型の変数にのみ適用されます。 |
Variable | 変数の新しい値。 |
メモ
このアクションはデータピルを生成しません。 この変数を別のアクションで使用するには、変数を作成ステップの変数データピルを使用します。
変数の値をリセット
変数の既存の値を削除するには、変数を更新アクションで変数にnil値を設定できます。 これはFormulaモードで行う必要があります。
リストを作成
このアクションはカスタムスキーマを持つリストを作成します。 空のリストを作成することも、既存のアイテムを含むリストを作成することもできます。
リストを作成
| 入力フィールド | 説明 |
|---|---|
| リスト名 | リストの名前。 |
| リストアイテムスキーマ | このリスト内の各アイテムのプロパティを定義します。 |
| Items | (任意) リストにデータを入力するためのリストデータピルを指定します。 後からさらにアイテムを追加できます。 |
リストアイテムスキーマを定義
リストアイテムスキーマは、出力データツリーに使用可能な変数のリストとして表示されます。 これらの変数は、後続のレシピステップにマッピングできます。 新しいフィールドを定義するには、フィールドを追加を使用します。
新しいフィールドを追加
| 入力フィールド | 説明 |
|---|---|
| 名前 | 新しいフィールドの名前。 |
| データ型 | 新しいフィールドのデータ型。 |
| 任意 | この新しいフィールドが必須かどうかを選択します。 |
| ヒント | この新しいフィールドの説明。 |
リストアイテムを移動
リスト内のアイテムを反復処理するには、変数リストを作成アクションの出力にあるリストインデックスデータピルと、Repeat whileループなどのページネーションをサポートするメソッドを使用します。 詳細については、Repeat whileループのドキュメントを参照してください。
リストにアイテムを追加
このアクションは、既存のリストに新しいアイテムエントリを追加します。 更新できるのは、変数 by Workatoで作成されたリストのみです。
アイテムの一括追加
リストデータピルがある場合は、リストに一括追加します。
一部のアイテムフィールドは必須です。 このアクションを使用する前に、必須フィールドに有効な入力があることを確認します。
リストにアイテムを追加
| 入力フィールド | 説明 |
|---|---|
| リスト名 | 新しいエントリを追加するリストを選択します。 |
| 挿入位置 | 新しいエントリの場所を選択します。 |
| リストアイテム | 新しいエントリの値を定義します。 |
リストにアイテムを追加(一括)
このアクションは、既存のリストに複数のアイテムを追加します。 更新できるのは、変数 by Workatoで作成されたリストのみです。
一部のアイテムフィールドは必須です。 このアクションを使用する前に、必須フィールドに有効な入力があることを確認します。
リストにアイテムを追加
| 入力フィールド | 説明 |
|---|---|
| リスト名 | 新しいエントリを追加するリストを選択します。 |
| 挿入位置 | 新しいエントリの場所を選択します。 |
| リストアイテム | リストデータピルを指定します。 各リストアイテムのマッピング方法を定義します。 |
リストからすべてのアイテムをクリア
このアクションは、既存のリスト内のすべてのエントリを削除します。 このアクションは、リストを作成アクションとリストにアイテムを追加アクションの後に使用する必要があります。 クリアできるのは、変数 by Workatoで作成されたリストのみです。
| 入力フィールド | 説明 |
|---|---|
| リスト名 | すべてのエントリをクリアするリストを選択します。 |
Last updated: