トリガー・プロパティおよびサンプル・コード

アダプタ定義ドキュメントのtriggersセクションで、統合を開始できるアクションまたはイベントを定義します。

プロパティ

トリガーごとに、リクエストやレスポンスに使用するエレメントやデータの処理方法など、必要な情報を指定する必要があります。リクエストに使用する要素は、ビジネス・オブジェクト、操作または別の要素です。次の情報が必要です:

プロパティ	説明
`displayName`	Oracle Integrationで統合開発者に対して表示されるトリガーの名前。
`description`	トリガーの説明。
`type`	トリガーのタイプ通知は、外部ソースがメッセージのOracle Integrationに通知するが、レスポンスを必要としないことを示します。
`group`	アダプタ定義ドキュメントのグループ・セクションで定義されているグループの名前。
`execute`	トリガーを実装するフローを参照するUniform Resource Name (URN)。フローは、アダプタ定義ドキュメントのフロー・セクションで定義されます。
`httpMethod`	外部ソースからメッセージを受信するメソッド。たとえば、webフックでは、POSTメソッドを本文とともに使用します。
`request`	このトリガーの受信メッセージのスキーマ。リクエストには、`schemaType`および`schema`情報が含まれます。 `schemaType`はスキーマのタイプを定義し、`application/json`型のみをサポートします。 `schema`は受信メッセージの構造を定義し、構造はダウンストリーム・マッピングの統合に公開されます。これは、インライン・スキーマ、またはアダプタ定義ドキュメントの`schemas`セクションにあるスキーマ定義への参照です。リクエストは、`flows`セクションのフローを参照できます。フローは、`schemaType`と`schema`の両方を含む構造全体の戻り値を実装します。コード例: `"request": { "schemaType": "application/json", "schema": { "$ref": "#/schemas/staticInput" } }, "request": "flow:inputSchemaFlow"`
`webhook`	ヘッダー、パラメータおよび本文を含むサード・パーティの通知メッセージ構造。
`headers`	名前とタイプによって定義されるHTTPヘッダー・パラメータのセット。
`parameters`	名前とタイプによって定義された問合せパラメータのセットで、トリガーするwebフック・リクエストのパラメータをモデル化します。
`body`	スキーマ・タイプおよびスキーマを含むHTTP本文。これは、リクエスト・セクションに似ています。
`subscription`	外部ソースがサブスクリプションをサポートするAPIをサポートしている場合、このオブジェクトはトリガーがイベントにプログラムでサブスクライブする機能をモデル化します。アクティブ化セクションは、統合の非アクティブ化時のサブスクリプションのアクティブ化と削除時のサブスクリプションをモデル化します。このセクションは、フィルタ、レジスタ、および登録解除のプロパティで構成されます。
`filter`	登録によるサーバーでのイベント・フィルタリング、または条件によるクライアントでのイベント・フィルタリングを有効にします。このプロパティでは、pingイベントをフィルタしたり、クライアントおよびレスポンス・フィルタのレスポンス・ステータスを指定することもできます。
`register`	イベントにプログラムで登録するために外部サービスでAPIコールを実行するフローを参照します。
`deregister`	イベントへのプログラムによる登録解除のために外部サービスでAPIコールを実行するフローを参照します。
`validationRequests`	検証リクエストを識別し、そのようなリクエストに対するレスポンス動作の上書きを許可します。検証リクエストで統合フローを実行できません。このプロパティは、受信リクエスト・オブジェクトに対する条件`skipAuthentication`および`response.condition`、jq式で構成されます。 trueまたはfalseを返します。 trueの場合、検証リクエストは無視されます。出力は、レスポンス・ステータス、ヘッダーおよび本文を表すJSONオブジェクトである必要があります。
`configuration`	トリガーの構成に必要な構成オプションをモデル化します。一部のトリガーでは、ランタイムが機能できるようにするためにユーザーが指定する必要がある追加情報が必要になる場合があります。構成プロパティは、フローによって静的に定義および供給されるデータを含むユーザー・インタフェース・ウィジェットとしてモデル化されます。

サンプル・コード

ノート:

ここに示すサンプル・コードは、webフック・トリガー用です。

"triggers": {
   "notificationTypeTrigger": {
     "displayName": "Notification Type Trigger",
     "description": "This trigger detects when an event has been raised.",
     "group": "simpleTrigger",
     "type": "webhook",
     "httpMethod": "POST",
     "request": {
       "schemaType": "application/json",
       "schema": {
         "$ref": "#/schemas/staticInput"
       }
     },
     "webhook": {
       "headers": [
         {
           "name": "http-header-1",
           "type": "string"
         }
       ],
       "parameters": [
         {
           "name": "query-parameter-1",
           "type": "string"
         }
       ],
       "body": {
         "schemaType": "application/json",
         "schema": {
           "$ref": "#/schemas/staticInput"
         }
       }
     }
}