フロー定義の概要
アダプタ定義ドキュメントのflowsセクションは、アダプタが可能なランタイム・アクティビティと設計時アクティビティを定義します。
次の例は、アダプタでフローを使用する方法を示しています:
設計時の例
- 統合開発者がアダプタに基づいて接続を構成している場合、フローは外部アプリケーションからデータをプルし、ユーザー・インタフェースにデータを表示できます。
- 統合開発者が統合デザイナでカスタム・オブジェクトを選択すると、フローで動的スキーマを制御できます。
ランタイムの例
- APIを起動します。
- JSONペイロードからavro文字列への変換など、前処理アクティビティを開始します。
- avroでエンコードされたデータをJSONキー値に変換するなど、後処理を実行します。
フロー定義の機能
フロー定義では、次の機能がサポートされています:
- Cloud Native Computing Foundation (CNCF)サーバーレス・ワークフロー仕様(DSL)
CNCFサーバーレス・ワークフローは、ワークフローを定義するためのオープンソースのベンダーに依存しないDSLを提供します。
- サーバーレス・ワークフローのガイドラインに従った式および追加のカスタム機能
- カスタム・サーバーレス・ワークフロー機能によるロギングおよびアウトバウンド・コール
- jq式言語
- 前処理と後処理を簡素化するカスタムjq関数
- ドット(.)表記法を使用した入力および出力コンテキストへのアクセス
- 複数の状態、状態遷移およびフィルタリング
ノート:
アダプタ定義ドキュメントでは、使用可能なサーバーレス・ワークフロー構造のサブセットのみがサポートされます。 Rapid Adapter Builderプラットフォームにより、フロー定義がアダプタ定義ドキュメント仕様に準拠していることが保証されます。アダプタ定義ドキュメントでは、次の場所でフロー定義を使用できます:
-
接続のテスト
フローを使用して、接続のテスト動作を表します。 フローは、出力でtrueまたはfalseを返す必要があります。 たとえば、テスト接続が成功した場合、フローはtrueを返すことができます。
-
アクション
-
実行: 統合の実行中にアクションを処理します。
-
入力: 設計時のアクションの入力スキーマを作成します。
-
出力: 設計時のアクションの出力スキーマを作成します。
-
構成: 設計時に構成プロパティの動的値をフェッチします。
-
-
Triggers
-
リクエスト・スキーマ: 設計時にOracle Integrationのリクエストのスキーマを定義します。
-
Webフック・スキーマ: 設計時にwebフック・リクエストのスキーマを定義します。
-
構成: 設計時に構成プロパティの動的値をフェッチします。
- サブスクリプション
-
webフックをターゲット・アプリケーションに登録します。
-
ターゲット・アプリケーションからwebフックを登録解除します。
-
- 検証リクエスト
-
検証リクエストを識別します。
-
検証リクエストのレスポンス/帯域外確認を作成します。
-
-
インバウンド認証シグネチャ・ポリシー(HMAC_SIGNATURE_VALIDATION、RSA_SIGNATURE_VALIDATION、JWT_VALIDATIONなど)
-
実行シナリオのフロー定義
アダプタ開発者は、フロー定義のドット(.)表記を使用して、リクエスト、オーケストレーション入力、アクション/トリガー構成および接続プロパティをコンテキスト・アイテムとしてアクセスできます。 さらに、「臨時の」コンテキスト変数を追加できます。 フロー定義で出力を定義した後、Oracle Integrationは出力を消費して解釈できます。