動的入力
誰かがフローでアクションを構成するたびに、アクションの入力または入力値のリストを生成します。動的入力では、関連するアクション入力のリスト、レコードのフィールドのリスト、または選択リストで利用可能なオプションのリストを表示できます。
注:
動的入力はベースシステムでは使用できません。で動的入力 フローデザイナーを使用するには、次のことを行う必要があります。 を要求する 統合ハブ プラグイン.
フロー設計時に動的入力によって値が取得され、アクション内の入力として動的に表示されます。このようなタイプの動的入力は、アクション作成者が使用できます。
- ダイナミック選択肢
- ダイナミック選択肢タイプの入力では、表示する選択値のリストを収集します。動的選択肢を構築する方法の詳細については、「動的選択肢のデータ収集アクションの作成」を参照してください。
- 動的入力
- 動的入力タイプの入力では、表示する追加のアクション入力のリストを収集します。動的入力を使用して、任意の入力をアクションに追加します。動的入力の構築の詳細については、次の項目を参照してください。
- 動的テンプレート
- 動的テンプレートタイプ入力では、動的に選択されたレコードタイプからフィールドのリストを収集します。その後フロー作成者が、フローに含めるフィールドを選択できます。フィールドのリストは動的に生成されるため、ソーステーブルでフィールドが追加または削除されたときにアクションを変更する必要はありません。動的テンプレートを構築する方法の詳細については、「動的テンプレートのデータ収集アクションの作成」を参照してください。
動的入力を使用するための一般的な手順は 3 つあります。
- アクション作成者が、動的データを生成するデータ収集アクションを作成します。
- アクション作成者が、動的入力を使用してアクションを作成し、データ収集アクションを呼び出すように動的入力を構成します。
- フロー作成者が、アクションをフローに追加し、動的に収集されたデータを使用してアクションを構成します。
データ収集アクション
データ収集アクションは、他のアクションで使用されるデータを収集します。データ収集アクションは、フローに直接追加するというよりは、動的入力から呼び出されることを意図しています。データ収集アクションは通常、REST コールを使用してサードパーティシステムからデータを収集しますが、次の基準を満たすアクションであればどのようなアクションでもかまいません。
- JSON タイプの出力変数を含むスクリプトステップがある。
- スクリプトステップの JSON 出力変数から派生する値を持つ JSON タイプの output という名前のアクション出力がある。注:アクションには複数の出力を含めることができますが、含めることが可能なタイプは JSON のみです。
- スクリプトステップでペイロードをフォーマットして、
dataという名前のプロパティが含まれるようにする。 - ペイロードが返すアイテムは 5,000 を超えない。注:フローデザイナー は動的データの最初の 5,000 アイテムのみを表示します。
- データを収集してタイムアウトになるまで最大 300 秒 (5 分) 待機する。 注:データ収集アクションのタイムアウト期間を変更するには、sn_flow_designer.sync_action_execution_timeout_in_seconds システムプロパティの値を変更します。
デザインの検討
- サードパーティ統合の動的入力を検討する
- 動的入力を使用すると、外部ソースからデータを動的にフェッチするフローを作成できます。サードパーティ統合では、動的入力によって特定のエンドポイントに関連するデータ値を提供できます。フローデザイナー を使用したサードパーティ統合の設定の詳細については、「IntegrationHub」を参照してください。
- 大量のデータの取得に要する時間に注意する
- デフォルトでは、タイムアウトになるまでの動的入力によるデータ収集時間は最大 300 秒です。データ収集アクションでデータ収集にそれ以上の時間がかかる場合は、sn_flow_designer.sync_action_execution_timeout_in_seconds のシステムのプロパティをより高い値に設定します。ただし、エンドユーザーが値を入力または選択する必要があるインタラクティブフローには長いタイムアウト値を使用しないでください。
- スクリプトエラーに注意する
- すべてのデータ収集アクションはスクリプトステップを使用するため、スクリプティングによってエラーが発生する可能性があります。スクリプトを使用して動的入力の JSON 変数を出力すると、入力で必要な JSON 値を受信できなくなるエラーが発生する可能性があります。動的入力スクリプティングエラーが発生すると、次の警告メッセージが表示されることがあります。
図 : 1. スクリプティングエラーに対して表示されるメッセージ 
- 動的入力を 5000 アイテムに制限する
- フローデザイナー では、動的入力の表示が最大 5000 アイテムに制限されています。5000 アイテム制限により、データ収集アクションでアイテムをレンダリングするときにインスタンスでパフォーマンスの問題が発生するのを防ぎます。