「RESTアダプタ」をトリガー接続として使用する単一の統合に複数のエントリ・ポイントを公開できます。 各エントリ・ポイントは、必要に応じて異なるリソースURIおよびHTTPアクション/動詞で構成できます。 この機能により、異なる操作を実行するために複数の統合(それぞれが個別のリソースURIおよび動詞を持つ)を作成する必要がなくなります。
この機能は、次のシナリオで役立ちます:
- 「RESTアダプタ」を介して特定の統合で複数のリソースURIおよびアクション/動詞をサポートします。
- 複数の統合パターン(たとえば、同期と非同期)をサポートします。 リソースと動詞の組合せは、操作と呼ばれます。 各操作は、同期または非同期の一方向サービスとして構成できます。 非同期サービスはリクエストを受け入れ、ただちにHTTP
202ステータスを戻します。
ノート:
この機能は、アプリケーション統合を作成する場合にのみ使用できます。
- 「RESTアダプタ」を、アプリケーション統合のトリガー接続としてキャンバスにドラッグします。
これにより、アダプタ・エンドポイントの構成ウィザードが呼び出されます。
- 「基本情報」ページで、次のように指定します:
- 名前とオプションの説明を入力します。
- Select to configure multiple resources or verbs (maximum 11)チェックボックスを選択します。
- 「リソース構成」ページで、操作名、相対リソースURI、実行するアクション/動詞を指定して、「次」をクリックします。
- 操作ページで、「他の操作を追加」をクリックして別のリソースURIとアクション/verbを追加し、「次」をクリックします。
- 「リソース構成」ページで、別の操作名、エンドポイント相対リソースURI、実行するアクション/動詞を指定して、「次」をクリックします。
- 必要な数の操作を追加するために、このプロセスを続行します。
- 操作ページには、すべての操作が表示されていることに注意してください。 各操作は、1つの統合内の異なるブランチを表します。
- Summaryページで選択内容を確認し、「完了」をクリックします。
この例では、6つのブランチ(modifyEmployee、updateEmployee、getEmployee、getEmployeeLocation、deleteEmployeeおよびaddEmployee)があります。
- 各ブランチにカーソルを置くと、操作/リソース名、アクション/動詞およびリソースURIの詳細が表示されます。
- 各操作名の後に適切なアクションをドラッグして、統合をさらに構成します。 「RESTアダプタ」アイコンと操作名の間にアクションを追加することはできません。
- ビジネス識別子トラッキング変数を定義するピック処理操作名として、「アクション」
を選択し、「トラッキング」を選択します。
- 各ピック・アクション操作分岐のトラッキング変数を設定します。 トラッキング変数は操作ごとに移入されます。 統合をアクティブ化するには、すべての操作にプライマリ・トラッキング変数を設定する必要があります。 ブランチがトラッキング変数で構成されていない場合、ノードに赤いエラー・アイコンが表示されます。 エラー・アイコンの上にカーソルを置くと、詳細なエラー・メッセージが表示されます。
- 適切なブランチを実行するには、統合をアクティブ化して起動します。
アクティブ化されると、アダプタ・メタデータ・ページに、構成された各リソースおよび動詞に対応する情報が表示されます。
swaggerでは、構成されているすべてのリソースおよびこのようなリソースごとの動詞が表示されます。 単一のリソースRESTトリガー・エンドポイントのswaggerと同様に、このswaggerを別の起動接続で使用して、実装されたリソースを自動的に検出および参照できます。
ノート:
統合のアクションを編集して、操作ブランチを削除または追加できます。 これにより、単一の操作を持つ標準トリガー・ベースの統合と、複数の操作ブランチを持つ統合の間での変換が可能になります。
