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