リストに関するFAQ ​

一部の入力フィールドでは、データツリーからリストデータピルを直接選択できません。これらのフィールドにリストデータピルをマッピングするには、入力をFormulaモードに切り替えます。 Formulaモードでは、テキストモードで選択できないリストやオブジェクトを参照できます。

Formulaモードでのリストデータピルのマッピング

リストは配列とも呼ばれ、アプリケーション間で構造化データを処理できます。たとえば、レシピで注文の明細項目、連絡先、製品のリストを処理する必要がある場合があります。 Workatoは、個々のリスト項目を操作したり、バッチ全体を処理したりするためのツールを提供します。

BoxコネクターのNew CSV file in folderトリガーを使用して、CSVファイルを読み取り、行のリストに解析できます。列ヘッダーは、レシピで使用できる変数になります。サンプルファイルを使用した例については、リストデータピルの使用方法を参照してください。

リストデータピルをアクションにマッピングする方法は3つあります:

• リスト処理を行わずに、アクションでデータピルを直接使用します。この方法では、リスト内の最初の項目のみが使用されます。
• Salesforce bulk insertなど、リストを入力として受け付けるアクションを使用します。
• Repeatステップを追加してリストをループし、各項目を処理します。

詳細はリストデータピルの使用方法を参照してください。

リスト入力をサポートしていないアクションにリストデータピルをマッピングすると、そのアクションは最初の項目のみを使用します。すべての項目を処理するには、Repeatステップまたはリスト入力を受け付けるアクションを使用します。詳細については、リスト処理なしの直接使用を参照してください。

Salesforce bulk insertやNetSuite batch actionsなどの一部のアクションには、リストデータピルを受け付けるSource list入力があります。これらのアクションはリスト全体を自動的に処理します。詳細については、リスト入力を受け付けるアクションを参照してください。

アクションがリスト入力をサポートしていない場合は、Repeatステップを使用します。 Repeatステップはリスト内の各項目をループするため、項目を1つずつ処理できます。詳細については、明示的なリスト処理でのRepeatステップの使用を参照してください。

ループ内で変数を使用する場合は、Clear step outputをYesに設定します。そうしないと、以前の反復処理の値が予期せず残る場合があります。ガイダンスについては、Clear step outputを参照してください。

変数 by Workatoコネクターは、次のアクションを含む高度なリスト操作をサポートしています。

• Create list
• Add item to list
• Add item to list (batch)
• Clear all items from list

これは、新しいレシピでリストを管理するための推奨アプローチです。

リスト by Workatoコネクターは非推奨です。新しいレシピの作成時には選択できなくなり、バグ修正や改善も提供されません。

このコネクターを使用している既存のレシピは引き続き動作しますが、リスト管理の改善と長期サポートのために変数 by Workatoコネクターへの移行をお勧めします。

非推奨コネクターのドキュメントについては、リスト by Workatoを参照してください。