動的出力
フロー設計時に、動的に生成されたデータピルとしてアクションとサブフローの出力にアクセスします。また、データ収集アクションをビルドして Now Platform と統合ハブの出力から複合オブジェクトを生成できます。
注:
動的出力はベースシステムでは使用できません。ワークフロースタジオ で動的出力を使用するには、次のことを行う必要があります 要求 統合ハブ プラグイン.
フロー設計時に動的出力によって複合オブジェクトのスキーマ値が取得され、データピルとしてデータパネルに表示されます。
動的出力は、表示されたデータを収集するデータ収集アクションをポイントする必要があります。たとえば、データ収集アクションは、 統合ハブ スポーク.ワークフロースタジオ で動的出力を使用するには、以下の手順を実行します。
- アクションデザイナーはデータ収集アクションを作成します。
- アクションデザイナーは、子データ収集アクションをポイントする動的出力を使用して親アクションを作成します。
- フローデザイナーは親アクションをフローに追加します。
データ収集アクション
データ収集アクションは、他のアクションで使用されるデータを収集します。データ収集アクションは、フローに直接追加するというよりは、動的入力から呼び出されることを意図しています。データ収集アクションは通常、REST コールを使用してサードパーティシステムからデータを収集します。すべてのデータ収集アクションは、これらの要件と制約を満たす必要があります。
- JSON タイプの出力変数を含むスクリプトステップがある。
- スクリプトステップの JSON 出力変数から派生する値を持つ JSON タイプの output という名前のアクション出力がある。注:アクションには複数の出力を含めることができますが、含めることが可能なタイプは JSON のみです。
- スクリプトステップで JSON 出力をフォーマットして、
dataという名前のプロパティが含まれるようにする。 - データが動的選択または動的テンプレート入力を目的としている場合、JSON 出力は 5,000 を超える選択オプション、フィールドテンプレート値、またはアレイ要素項目を返してはなりません。注:動的選択および動的テンプレート入力では、JSON 出力から最大 5,000 個の選択オプションまたは 5,000 個のテンプレート値のみを表示できます。
- データを収集してタイムアウトになるまで最大 300 秒 (5 分) 待機する。 注:すべてのアクションのタイムアウト期間を変更するには、sn_flow_designer.sync_action_execution_timeout_in_seconds システムプロパティの値を変更します。
動的オブジェクト
動的オブジェクトは、複合オブジェクトまたは複合オブジェクトのアレイのいずれかです。アクションデザイナーは、ハードコーディングするのではなく、データ収集アクションを使用してオブジェクト構造を動的にビルドします。動的オブジェクトをビルドする方法の詳細については、「動的オブジェクトのデータ収集アクションの作成」を参照してください。
一般的なガイドライン
- サードパーティ統合の動的出力を使用する
- 動的出力を使用して、フロー設計時に外部システムのデータをイントロスペクトしてフェッチします。たとえば、特定のエンドポイント API とやり取りするサービスエンドポイントまたは呼び出しアクションを指定できます。ワークフロースタジオ を使用したサードパーティ統合の設定の詳細については、「統合ハブ」を参照してください。
- 大量のデータの取得に要する時間に注意する
- デフォルトでは、システムで停止されるまでの動的出力によるデータ収集時間は最大 300 秒です。データ収集アクションでデータ収集にそれ以上の時間がかかる場合は、sn_flow_designer.sync_action_execution_timeout_in_seconds のシステムのプロパティをより高い値に設定します。エンドユーザーが値を入力または選択することが想定されるインタラクティブフローに長いタイムアウト値は避けてください。
- スクリプトエラーに注意する
- すべてのデータ収集アクションはスクリプトステップを使用するため、スクリプティングによってエラーが発生する可能性があります。スクリプトエラーにより、出力で必要な JSON 値を受信できない場合があるため、JSON 変数を出力するために使用されるスクリプトを確認します。動的出力スクリプティングエラーが発生すると、次の警告メッセージが表示されることがあります。
図 : 1. スクリプティングエラーに対して表示されるメッセージ 