機械翻訳について
  1. Oracle Integration 3での統合の使用
  2. アプリケーション統合の作成
  3. インバウンド・トリガーおよびアウトバウンド起動の定義

インバウンド・トリガーおよびアウトバウンド起動の定義

統合では、単一のインバウンド・トリガーと1つ以上のアウトバウンド起動を定義します。

  1. 統合キャンバスにトリガー接続を追加するには、統合キャンバスの+をクリックするか、キャンバスの横にある「トリガー」 トリガー・アイコンをクリックします。 どちらのオプションでも、使用可能なトリガー接続のリストが表示されます。 このアイコンは、トリガーを定義すると消えます。

    使用するアダプタ接続が存在しない場合は、「トリガー」 トリガー・アイコン、+の順にクリックして新しい接続を作成します。


    「+」記号の付いたセクションをトリガーして、新しいアダプタ接続を追加

    接続を作成するための接続の作成パネルが表示されます。 アダプタ接続が構成され、テストされ、100%完了したことを示すメッセージが表示されたら、ページを保存して閉じます。 新しいアダプタ接続がパネルに表示されます。 100%完了しないように接続を編集してから接続ページを保存してクローズすると、100%完了しておらず、パネルに表示できないことを示すメッセージがバナーに表示されます。 パネルに接続を再度表示するには、接続ページに戻り、接続を100%完了するように構成する必要があります。

  2. 構成済アダプタを追加するには、統合キャンバスで+をクリックし、リストから選択します。

    「Adapter Endpoint Configuration」ウィザードが表示されます。

  3. ウィザードの各ページに入力して、選択したアダプタを構成します。 「トリガー接続と起動接続の理解」を参照してください。

    完了したら、構成されたトリガーがキャンバスに表示されます。 構成されていないマッパー・アイコンは、トリガーの直後に表示されます。 このトリガーはこの例でレスポンスを送信するように構成されているため、戻りアイコンが統合キャンバスに表示されます。 統合ではトリガーを削除できません。トリガーをクリックして「アクション」 「アクション」アイコンを選択すると、削除オプションは使用できません。

    ノート:

    キャンバスの横にある「トリガー」 トリガー・アイコンアイコンは、「起動」 使用可能な起動アイコンアイコンに置き換えられ、統合に複数のアウトバウンド起動接続を追加できます。

    「起動」 使用可能な起動アイコンの後に「アクション」 統合アクション・アイコンアイコンが表示されるようになりました。 このセクションを展開すると、統合に追加できる次の処理が表示されます:

    アクション:

    • 割り当て: 式ビルダーを使用して変数と値を割り当てます。

    • B2B: メッセージを統合内の電子データ交換(EDI)形式との間で変換します。 このアクションは、EDIドキュメントをOracle Integrationメッセージに変換するか、またはその逆に変換します。

    • データ・ステッチ: 1つ以上の既存のペイロードからメッセージ・ペイロードを増分的に作成します。 ステッチ・アクションは、変数に値を割り当てるためのエディタを提供します。

    • ログ出力: 統合の任意の時点でロガー・アクションを追加して、アクティビティ・ストリームおよびログにメッセージをログに記録します。 式ビルダーで、静的メッセージまたは可変移入メッセージであるログ・メッセージを作成できます。

    • マップ: 必要に応じて、統合にマッピングを追加します。 また、トリガー、起動および一部のアクションを統合に追加すると、マッピングも自動的に追加されます。 ほとんどの場合、統合内のアプリケーション間で転送するメッセージのデータ構造は異なります。 マッピングを使用すると、アプリケーション間でのデータの転送またはマップ方法を定義できます。

    • ノート: スティッキー・ノートに似たプレースホルダー・ノートを統合に追加します。 たとえば、起動接続をまだ定義しておらず、後で起動接続を定義する予定のイン・プレースホルダー・ノートを統合に追加する必要があります。

    • 通知: 統合処理の特定の時点で、関連するユーザーに通知電子メールを送信します。 Eメールの宛先、送信者および件名の各部分を設定できます。 式ビルダーで定義されたパラメータを使用して、電子メールの本文の部分を作成することもできます。

    • ステージ・ファイル: 統合内のファイルを処理します。 ステージ・ファイル・アクションでは、FTPアダプタによってダウンロードされた各ファイルを処理できます。 ステージ・ファイル・アクションは、Oracle Integrationと呼ばれるステージ統合で、ファイルの読取り(およびトレーラの削除)、書込み、zipおよび解凍を行うことができます。

    • 待機: 指定された期間、統合の処理を遅延します。 このアクションの一般的なユース・ケースは、特定の操作を特定の時間に起動することです。

    エラー処理:
    • フォルトの再スロー: さらに分析するために、失敗したメッセージをエラー・ホスピタルに送信します。 統合に定義済のグローバル・フォルトが含まれている場合、再スロー・フォルト・アクションによって取得されたエラーは、グローバル・フォルトにより送信され、分析のためエラー・ホスピタルに送信されます。 グローバル・フォルトが定義されていない場合は、フォルトが送信されます。
    • 新規フォルトのスロー: エラーを生成し、統合の処理中に特定の時点でそのエラーのコード、理由、詳細およびスキップ条件を構成します。
    ロジック:

    • 各: 繰返し要素をループし、for-eachアクションの範囲内で1つ以上のアクションを処理します。 ループ反復の数は、ユーザーが選択した繰返し要素に基づきます。

    • パラレル: タスクを並行して処理して、統合のパフォーマンスとレスポンス時間を向上させます。 パラレル・アクションを使用すると、統合のパスを複数のブランチに分割できます。

    • スコープ: アクションのグループを管理します。 スコープ・アクションは、独自のフォルト・ハンドラを持つことができる子アクションおよび起動のコレクションです。 スコープ処理によって、子処理の動作コンテキストが提供されます。 親スコープで定義されたアクションは、スコープ内でローカルに可視性を持ちます。

    • 切替え: 統合にルーティング式を追加するブランチを定義します。 1つ以上のブランチを定義します。 初期ブランチのルーティング式がtrueに解決されない場合は、otherwiseブランチが使用されます。

    • While: 特定の条件が満たされた場合に、アクションをループするか、接続を起動します。 式ビルダーにwhileループの条件を定義します。

    Call:
    • ファイル・サーバー: ファイルのリストを取得し、ファイルをファイル・サーバーに書き込みまたは移動し、どこからでもファイルをダウンロードして読み込み、ファイル・サーバー上のファイルを削除します。
    • 統合: 統合から別の統合を起動します。 このアクションを統合にドラッグすると、起動するアクティブな統合を選択するように求められます。

    • Javascript: JavaScript関数を統合に追加します。 これにより、統合からJavaScriptファンクションをコールできます。

    • OCIファンクション: ネイティブのOracle Cloud Infrastructure関数を起動します。
    • OCIオブジェクト・ストレージ: Oracle Cloud Infrastructureオブジェクト・ストレージを起動します。
    • イベントの公開: サブスクリプション統合がサブスクライブできる統合でイベントを公開します。 「イベントの公開およびサブスクライブについて」を参照してください。
    終了:

    • コールバック: プロセスを終了し、トリガーに戻ります。 たとえば、切り替えアクティビティを追加してブランチを定義し、そこでCallbackを追加できます。 定義された式ロジックを満たしていない場合、このブランチが使用されます。 統合は停止され、トリガーは統合が続行されないことを示すレスポンスを受け取ります。

    • 障害返却: 障害を返します。 トリガーが少なくとも1つのフォルトと同期する場合、fault returnアクションを使用できます。 トリガーで複数の障害が定義されている場合は、障害を選択するように求められます。 トリガーが1つ以上のフォルトで非同期の場合、fault returnアクションを使用できます。 障害が追加されると、そのタイプの障害定義を持つマッパーも追加されます。 このアクションは、トリガーにフォルトが1つ以上ある場合にのみ有効です。

    • 戻る: 即時レスポンスを返します。

    • 停止: 統合を終了します。 トリガーにレスポンス・メッセージは返されません。

  4. キャンバスの横にある「起動」 使用可能な起動アイコンをクリックしてパネルを展開します。 トリガー接続と同様に、+記号をクリックして新しい起動接続を作成できます。 詳細については、「ステップ1」を参照してください。

  5. アダプタ・タイプ(RESTアダプタなど)をクリックして、そのアダプタの構成済接続を表示します。

  6. 特定の構成済アダプタ接続を統合キャンバスの+サインにドラッグします。

  7. アダプタを削除します。

    これにより、アダプタ・エンドポイントの構成ウィザードが呼び出されます。

  8. ウィザードのページを完了して、起動接続を構成します。

    完了すると、構成された起動接続が統合キャンバスに表示されます。

    トリガーおよび呼出し接続をクリックして、その内容を編集または表示できます。 アダプタ・エンドポイント構成ウィザードで選択した接続を再編集し、(変更を加えずに) 「完了」をクリックすると、構成を更新してアーティファクトを再生成するように求められます。

    • 小さな変更のみを加えた後に「Yes」を選択すると、フローが検証されて警告およびエラーが(ある場合)表示され、潜在的な問題を修正できます。

    • トリガー接続に大きな変更を行った後(たとえば、トリガーのメッセージ交換パターンの同期から非同期への変更)Yesを選択すると、すべてのマッピング、返信および停止要素は、統合の終了時にシステム生成の返信または停止要素を除き、統合から削除されます。 追跡情報も削除されます。

      呼出し接続を編集すると、大きな変更になる可能性もあります。 ただし、影響はトリガーの編集より小さくなります。 編集を起動すると、マップなどのフロー全体の結果が削除されることはありません。

    必要に応じて、キャンバス内の任意の場所にカーソルを置き、統合を移動できます。 右上隅にある大きいボックス内から統合を移動することもできます。