機械翻訳について

統合の作成

統合は、アプリケーションに対して作成した接続を使用し、それらのアプリケーション間での情報の共有方法を定義します。 新しい統合の作成、統合のインポート、統合の変更または削除、メッセージを公開する統合の作成、メッセージをサブスクライブする統合の作成、リクエストおよびレスポンスのエンリッチメント・トリガーの追加や削除を行うことができます。 詳細は、次の各項をクリックして参照してください。

統合の作成

統合の作成には、トリガーおよび呼出しのアプリケーション接続の定義と、2つのアプリケーション間でのデータのマッピング方法の定義が含まれます。 以下の手順では統合を作成する一般的な方法を説明し、特定の手順の詳細情報へのリンクを示します。 各手順を実行するにつれて進捗インジケータが変化して、統合の作成がどれくらい完了に近づいたかがわかります。

データ・マッピングで参照表を使用する場合には、最初に参照を作成します。 手順は、「参照の作成」を参照してください。
統合を作成するには、次のようにします。
  1. Integration Cloud ServiceのツールバーでDesignerをクリックします。

  2. 「Designer Portal」で「Integrations」をクリックします。
  3. Integrationsページで「Create New Integration」をクリックします。
    Create Integration - Select a Patternダイアログが表示されます。
  4. ビジネス・ニーズに該当する統合パターンのタイプを選択します。 詳細は、統合パターンの理解を参照してください。
    New Integration - Informationダイアログが表示されます。
  5. 次の情報を入力します。
    フィールド 説明

    Integration Name

    他のユーザーが統合について理解できるようにわかりやすい名前を指定します。 識別子に使用できるのは、英字、数字、アンダースコアおよびハイフンです。

    Identifier

    デフォルト識別子値を受け入れます。 この識別子は、指定した統合の名前を大文字表記にしたものです。

    Version

    デフォルトのバージョン番号01.00.0000を受け入れます。 または、バージョン番号を変更する場合は、必ずxx.xx.xxxxの形式で数字を使用したバージョンを入力します。

    統合は識別子とバージョンによって一意に識別されます。 バージョンの形式がxx.yy.zzzzの場合、xxはメジャー・バージョン、yy.zzzzはマイナー・バージョンです。

    識別子が同じでもメジャー・バージョンが異なる統合は、同時にアクティブにすることができます。 たとえば、INT-A/1.00.0000INT-A/2.00.0000は同時にアクティブにすることができます。

    ある統合をアクティブ化するときに、同じ識別子と同じメジャー・バージョンの別の統合がすでにアクティブになっている場合は、現在アクティブ化されている統合が非アクティブ化されてから、選択した統合がアクティブ化されます。

    たとえば、2つの統合それぞれが次の状態であるとします。
    • INT-A/2.00.0000 - アクティブではありません

    • INT-A/2.10.0000 - アクティブではありません

    ここで統合INT-A/2.00.0000がアクティブ化されます。
    • 現在INT-A/2.00.0000はアクティブです。

    • INT-A/2.10.0000はアクティブではありません。

    ここで統合2.10.0000がアクティブ化されます。
    • 現在INT-A/2.00.0000はアクティブではありません。

    • 現在INT-A/2.10.0000はアクティブです。

    Package Name

    統合を配置するための新しいパッケージまたは既存のパッケージの名前を入力します。 既存のパッケージの先頭のいくつかの文字を入力すると、対応するパッケージが表示されて選択できます。 パッケージの詳細は、「パッケージの管理」および「Integration Cloud Serviceのパッケージについて」を参照してください。

    Description

    他のユーザーが統合について理解できるようにわかりやすい説明を指定します。

  6. 「Create」をクリックします。
    「Integration Designer」に、前の手順で選択した統合パターンのタイプが表示されます。
  7. 「Save」をクリックします。
  8. 統合パターンを作成する際に、独自のアダプタを追加するためにトリガー接続と呼出し接続を空白にしている場合:
    1. ソース接続の追加の説明に従って、トリガー接続を作成します。
    2. ターゲット接続の追加の説明に従って、呼出し接続を作成します。
    3. 「Oracle Mapperの使用」「マッピング・データ」で説明されているように、2つの接続間のデータをマップします。
  9. Integration Cloud Serviceに公開する統合を作成している場合:
    1. メッセージをIntegration Cloud Serviceに公開する統合の作成の説明に従って、統合を作成し、事前定義済Integration Cloud Service Messaging呼出しを介してIntegration Cloud Serviceにメッセージを公開するトリガー・アダプタを統合に追加します。 トリガーと呼出しとの間のデータ・マッピングは許可されていません。
  10. Integration Cloud Serviceをサブスクライブする統合を作成している場合:
    1. Integration Cloud Serviceをサブスクライブする統合の作成の説明に従って、統合を作成し、Integration Cloud Service Messagingトリガーを介してIntegration Cloud Serviceのメッセージをサブスクライブする呼出しアダプタを統合に追加します。
    2. Oracle Cloud Oracle Mapperの使用データのマッピングに関する項の説明に従って、呼出しアダプタと、サブスクライブ先のIntegration Cloud Service Messagingトリガーの間でデータをマッピングします。
  11. 完了したら、「Save」をクリックし、「Exit Integration」をクリックします。
これで新しい統合が「Integrations」リストに表示され、アクティブ化の準備が整いました。 手順は、「統合のアクティブ化」を参照してください。

統合パターンの理解

Create Integration - Select a Patternダイアログで統合を作成するときは、複数のパターン・タイプから選択できます。

パターン 説明

Map My Data

独自のアダプタを追加するためにトリガーと呼出しを空白にした統合を作成します。

Publish to ICS

統合を作成し、事前定義済Integration Cloud Service Messaging呼出しを介してIntegration Cloud Serviceにメッセージを公開するトリガー・アダプタを統合に追加します。 呼出しサブスクライバの構成は必要ありません。

この統合パターンに参加するパブリッシャとサブスクライバは、それぞれ個別にアクティブ化および非アクティブ化することができます。

詳細は、「メッセージをIntegration Cloud Serviceに公開する統合の作成」を参照してください。

Subscribe to ICS

統合を作成し、Integration Cloud Service Messagingトリガーを介してIntegration Cloud Serviceのメッセージをサブスクライブする呼出しアダプタを統合に追加します。 ユーザーはサブスクライブ先のパブリッシャを選択するように求められます。 サブスクライブ先のパブリッシャをあらかじめ作成しておく必要があります。 パブリッシャがアクティブである必要はありませんが、構成が完了している必要があります。

公開済統合のフィールドに定義されているビジネス識別子(ある場合)は、サブスクライバにコピーされます。 コピーの後で、公開済統合のビジネス識別子に対して変更が行われても、サブスクライバには反映されません。 この統合パターンに参加するパブリッシャとサブスクライバは、それぞれ個別にアクティブ化および非アクティブ化することができます。

詳細は、「Integration Cloud Serviceをサブスクライブする統合の作成」を参照してください。

詳細は、「Integration Cloud Service Messaging」を参照してください。

事前作成済統合のインポート

ご使用のIntegration Cloud Service環境に事前作成済統合をインポートできます。

事前作成済統合には2つのタイプがあります。
  • ユーザーが作成した統合。 これらは自分や他のユーザーが作成した統合です。

  • Oracle Marketplaceにある、オラクル社によって作成された統合。 Oracle Marketplaceの統合はパッケージに含めてインポートします。 これらの統合は、Integrationsページで、統合名の横にBUILT BY ORACLEメッセージが表示されて識別されます。 これらの統合は編集できませんが、マッピングやビジネス識別子などの内容を確認することはできます。 これらの統合の接続を編集して、ビジネス要件に応じたエンドポイントの資格証明を含める必要があります。 また、これらの統合をクローニングして、統合のクローニング・バージョンを編集することができます。
    GUID-5D5D4B71-B079-4D99-A006-8B623D73CD46-default.pngの説明が続きます
    図GUID-5D5D4B71-B079-4D99-A006-8B623D73CD46-default.pngの説明

ユーザー作成統合のインポート

ユーザー作成統合をインポートするには、次のようにします。

  1. Integration Cloud ServiceのツールバーでDesignerをクリックします。
    GUID-0A2469E0-5861-4D97-886D-4397926B1834-default.pngの説明が続きます
    図GUID-0A2469E0-5861-4D97-886D-4397926B1834-default.pngの説明

  2. 「Designer Portal」で「Integrations」をクリックします。

  3. Integrationsリストの上にあるImport Integrationをクリックします。
    GUID-A8C5393E-BF45-4D2B-A8B8-63F78DA6B7C3-default.pngの説明が続きます
    図GUID-A8C5393E-BF45-4D2B-A8B8-63F78DA6B7C3-default.pngの説明

  4. 「Browse」をクリックして、インポートするファイルを選択します。 1つの統合をインポートする場合は、インポートするJARファイルを選択します。 統合のパッケージをインポートする場合は、インポートするPARファイルを選択します。

Oracle Marketplaceの事前作成済統合のインポート

Oracle Marketplaceの事前作成済統合をインポートするには、次のようにします。
  1. ページの右上で「Oracle Marketplace」をクリックします。

  2. 「Oracle Marketplace」が表示されます。

  3. 「Applications」をクリックします。

  4. リストのアプリケーションを参照して、インポートする事前作成済統合パッケージを選択します。

  5. プロンプト表示されたら、事前作成済統合ファイルのアップロード先のサーバーを選択します。

    事前作成済統合はパッケージ・ファイルとしてインポートされ、Integration Cloud ServiceのPackagesページに表示されます。 Integrationsページに移動すると、そのインポートしたパッケージ・ファイルの各統合が統合名の右側の「BUILT BY ORACLE」メッセージによって示されます。

Oracle Marketplaceからインポートした事前作成済統合のマッピングをカスタマイズできます。 事前作成済統合へのカスタマイズ・マッピングの追加を参照してください。

トリガー(ソース)接続の追加

トリガー(ソース)接続はリクエストをIntegration Cloud Serviceに送信します。 アプリケーションに接続するために必要な情報は、接続にすでに定義されています。 ただし、リクエストについて使用するビジネス・オブジェクトと操作や、受け取るデータの処理方法など、具体的な情報を指定する必要があります。

トリガー接続を追加するには、次のようにします。
  1. 「Integration Designer」で、右側の「Connections」パネルまたは「Technologies」パネルからキャンバスの「Source」領域に接続をドラッグします。
  2. Basic Infoページで、この接続の名前と識別子(オプション)を入力します。 手順は、「Basic Info」タブのプロパティを参照してください。
  3. 「Next」をクリックします。
  4. ウィザードの次のページで、選択した接続の情報を入力します。 トリガー(ソース)接続の構成を開始するには、接続タイプに応じて次のトピックを参照してください。
  5. 接続を構成すると、Summaryページが表示されます。
  6. 変更内容を確認して、Doneをクリックします。
    接続情報が、構成された操作を示す矢印と一緒にキャンバスに表示されます。
  7. 「Save」をクリックします。
Oracle Commerce Cloudアダプタを追加するには、Oracle Commerce Cloudアダプタの使用を参照してください。
Oracle E-Business Suiteアダプタを追加するには、Oracle E-Business Suiteアダプタの使用を参照してください。
Oracle Databaseアダプタを追加するには、Oracle Databaseアダプタの使用を参照してください。
Oracle Siebelアダプタを追加するには、Oracle Siebelアダプタの使用を参照してください。
SAPアダプタを追加するには、SAPアダプタの使用を参照してください。

呼出し(ターゲット)接続の追加

Integration Cloud Serviceは、リクエストまたは情報を呼出し(ターゲット)接続に送信します。 アプリケーションに接続するために必要な情報は、接続にすでに定義されています。 ただし、リクエストについて使用するビジネス・オブジェクトと操作やデータの処理方法など、具体的な情報を指定する必要があります。

呼出し(ターゲット)接続を追加するには、次のようにします。
  1. インテグレーション・デザイナで、右側の接続または技術パネルからキャンバスの「ターゲット」領域に接続をドラッグします。
  2. Basic Infoページで、この接続の名前と識別子(オプション)を入力します。 手順は、「Basic Info」タブのプロパティを参照してください。
  3. 「Next」をクリックすると手順が表示されます。
  4. 次のページで、選択した接続の情報を入力します。 接続タイプに対応する以下のトピックを参照してください。
    Eventbriteアダプタを追加するには、Eventbriteアダプタの使用を参照してください。
    Evernoteアダプタを追加するには、Evernoteアダプタの使用を参照してください。
    Facebookアダプタを追加するには、Facebookアダプタの使用を参照してください。
    FTPアダプタを追加するには、FTPアダプタの使用を参照してください。
    Gmailアダプタを追加するには、Gmailアダプタの使用を参照してください。
    Google Calendarアダプタを追加するには、Google Calendarアダプタの使用を参照してください。
    Google Taskアダプタを追加するには、Google Taskアダプタの使用を参照してください。
    LinkedInアダプタを追加するには、LinkedInアダプタの使用を参照してください。
    MailChimpアダプタを追加するには、MailChimpアダプタの使用を参照してください。
    Microsoft Calendarアダプタを追加するには、Microsoft Calendarアダプタの使用を参照してください。
    Microsoft Contactアダプタを追加するには、Microsoft Contactアダプタの使用を参照してください。
    Microsoft Emailアダプタを追加するには、Microsoft Emailアダプタの使用を参照してください。
    MySQLアダプタを追加するには、MySQLアダプタの使用を参照してください。
    Oracle Commerce Cloudアダプタを追加するには、Oracle Commerce Cloudアダプタの使用を参照してください。
    Oracle Databaseアダプタを追加するには、Oracle Databaseアダプタの使用を参照してください。
    Oracle E-Business Suiteアダプタを追加するには、Oracle E-Business Suiteアダプタの使用を参照してください。
    Oracle Siebelアダプタを追加するには、Oracle Siebelアダプタの使用を参照してください。
    SAPアダプタを追加するには、SAPアダプタの使用を参照してください。
    SurveyMonkeyアダプタを追加するには、SurveyMonkeyアダプタの使用を参照してください。
    Twitterアダプタを追加するには、Twitterアダプタの使用を参照してください。
  5. 接続を構成すると、Summaryページが表示されます。
  6. 「Done」をクリックし、「Save」をクリックします。
接続情報が、構成された操作を示す矢印と一緒にキャンバスに表示されます。
GUID-84861421-D3F2-4EB1-B8B6-3C580A536A5E-default.pngの説明が続きます
「図GUID-84861421-D3F2-4EB1-B8B6-3C580A536A5E-default.pngの説明」

メッセージをIntegration Cloud Serviceに公開する統合の作成

統合を作成し、それを使用してIntegration Cloud Serviceにメッセージを公開することができます。 メッセージの公開は、Integration Cloud Service Messagingを使用して行います。

メッセージをIntegration Cloud Serviceに公開する統合を作成するには、次のようにします。

注意:

Integration Cloud Service Messagingでは、512KBを超えるメッセージはサポートされません。 メッセージが512KBを超えるとインスタンスが失敗します。
  1. 統合の作成の説明に従って、Create Integration - Select a PatternダイアログでPublish To ICSを選択します。
  2. 統合の作成の説明に従って、New Integration - Informationダイアログのフィールドを設定します。
    これで、メッセージをIntegration Cloud Serviceに公開できる事前定義済のIntegration Cloud Service Messaging呼出しを含む統合パターンが作成されます。
  3. 「Integration Designer」で、右側の「Connections」パネルからキャンバスのトリガー(ソース)領域にアダプタをドラッグします。 この例では、Oracle Sales Cloudアダプタが選択されています。
    Oracle Sales Cloudアダプタのためのウィザードが表示されます。
  4. Basic Infoページで、この接続のエンドポイント名と識別子(オプション)を入力します。 手順は、「基本情報プロパティの構成」を参照してください。
  5. 「Next」をクリックします。
  6. Requestページで、ビジネス・オブジェクトを選択して「Next」をクリックします(この例では「Account」が選択されています)。
  7. Responseページで、レスポンス・タイプとして「None」を選択し、「Next」をクリックします。
  8. Summaryページで「Done」をクリックします。
    Oracle Sales Cloudアダプタが、Integration Cloud Service Messagingを使用してIntegration Cloud Serviceにメッセージを公開するように構成されました。 このタイプの統合パターンではリクエスト・マッパーは使用できないことに注意してください。

  9. 「Save」をクリックし、「Exit Integration」をクリックします。
    ここで構成したメッセージをサブスクライブするには、Integration Cloud Serviceがパブリッシャとして機能するように構成する必要があります。 こうすることで、Integration Cloud Serviceがメッセージを公開して、他のアダプタがそれをサブスクライブできます。 手順は、「Integration Cloud Serviceをサブスクライブする統合の作成」を参照してください。

Integration Cloud Serviceをサブスクライブする統合の作成

統合を作成し、それを使用してIntegration Cloud Serviceのメッセージをサブスクライブすることができます。 メッセージのサブスクリプションは、Integration Cloud Service Messagingを使用して行います。

Integration Cloud Serviceをサブスクライブする統合を作成するには、次のようにします。
  1. まず、メッセージをIntegration Cloud Serviceに公開する統合の作成の項の手順を完了して、アダプタのメッセージに対するサブスクライバとしてIntegration Cloud Serviceを構成します。
  2. 統合の作成で「ICSにサブスクライブ」を選択 - 「インテグレーションの作成」で説明されているように、パターン・ダイアログを選択します。
  3. 統合の作成の説明に従って、New Integration - Informationダイアログのフィールドを設定します。 これで、Integration Cloud ServiceのメッセージをサブスクライブできるIntegration Cloud Service Messagingを含む統合パターンが作成されます。
    「Select a Publisher」ダイアログが表示されます。
  4. サブスクライブ先の統合を選択し、Useをクリックします。 選択のために統合を表示するには、メッセージをIntegration Cloud Serviceに公開する統合の作成の説明に従って、まずIntegration Cloud Serviceをサブスクライバとして構成する必要があります。 完成率が100%でロック解除されている統合のみが表示されます。 ロックされている統合(編集中の統合)は表示されません。

  5. アダプタを「Integration Designer」の呼出し(ターゲット)領域にドラッグします。 この例では、Oracle RightNow Cloudアダプタが追加されます。
  6. Basic Infoページで、この接続の名前と識別子(オプション)を入力します。 手順は、「Basic Info」タブのプロパティを参照してください。
  7. 「Next」をクリックします。
  8. Operationsページで、適切な操作とビジネス・オブジェクトを選択し、Nextをクリックします。 この例では、CRUDのCreate操作とOrganizationビジネス・オブジェクトが選択されます。

  9. 要約ページで、変更を確認し、「完了」をクリックします。
    このタイプの統合パターンではリクエスト・マッパーを使用できます。
  10. 「Request Mapping」アイコンをクリックし、「Create」をクリックします。
  11. ソース・フィールドを対応するターゲット・フィールドにマッピングします。 詳細は、Oracle Cloud Oracle Mapperの使用データのマッピングに関する項を参照してください。
  12. 完了したら、「Save」をクリックし、「Exit Mapper」をクリックします。
    Oracle RightNow Cloudアダプタが、Integration Cloud Service Messagingを使用してIntegration Cloud Serviceのメッセージをサブスクライブするように構成されました。

  13. 「Save」をクリックし、「Exit Integration」をクリックします。
  14. 「メッセージをIntegration Cloud Serviceに公開する統合の作成」で説明した公開側の統合と、この項で説明したサブスクライブ側の統合をアクティブ化します。 手順は、「統合のアクティブ化」を参照してください。
    公開側の統合とサブスクリプション側の統合が完成すると、次の操作を実行できます。
    • あるアプリケーションでオブジェクトを作成すると、別のアプリケーションでもオブジェクトが作成されます。

    • 複数のアプリケーションがIntegration Cloud Serviceをサブスクライブして、更新に対して登録できるようにします。

    • 他のサブスクライバやパブリッシャに影響を与えることなく、サブスクライバを追加または削除できるようになります。

データを追跡するためのビジネス識別子がコピーされるのはサブスクライバが作成されるときです。 公開側の統合が後で更新されると、サブスクライブ側の統合を更新する必要があります。

たとえば、公開側の統合を作成してから、サブスクライブ側の統合を作成して、公開側の統合のサブスクライブを選択します。 Configurationアイコンを選択し、選択した公開側の統合の追跡属性が表示されていることを確認します。 次に、公開側の統合を編集し、トリガー・アダプタの操作を変更し(例)、保存してから、キャンバスを終了します。 サブスクリプション統合を編集して「構成」アイコンをクリックすると、表示される公開統合のビジネス識別子トラッキング属性は、更新が行われる前に存在していたものであることに注意してください。 公開側の統合の更新によって追跡フィールドは更新されません。 これは予期された動作です。

リクエストおよびレスポンス・エンリッチメントの追加

統合を作成するとき、リクエストおよびレスポンス・メッセージのエンリッチメント・ポイントを統合フロー全体に追加するオプションもあります。 エンリッチメントは統合フロー全体に関係し、トリガーと呼出しとの間のリクエスト・ペイロードまたはレスポンス・ペイロード(あるいは両方)で使用できます。

リクエストおよびレスポンス・エンリッチメントを追加するには、次のようにします。
  1. トリガーと呼出しの接続およびリクエストとレスポンスのマッピングを含む統合を設計します。 この例では、完成した統合は次のようになります。 エンリッチメント・ポイントを示す2つの円があり、1つはインバウンド(リクエスト)側、もう1つはアウトバウンド(レスポンス)側に表示されています。

    この例のリクエストとレスポンスのマッピングを次に示します。
    マッピング ソース ターゲット
    リクエスト HelloRequest/FirstName sayHello/name
    レスポンス sayHelloResponse/sayHelloReturn HelloResponse/Greeting
    これでエンリッチメントを統合に追加する準備が整いました。 この例では、レスポンス・メッセージ・エンリッチメントが、Drag and drop an enrichment source for the response message領域に追加されます。 また、リクエスト・メッセージ・エンリッチメントをリクエスト(インバウンド)側に追加することもできます。

  2. 右の接続パネルから、アダプタを以下に示すレスポンス・メッセージの濃縮領域にドラッグします。
    この例では、SOAPアダプタが、「Drag and drop an enrichment source for the response message」領域にドラッグされます。 この操作によって、SOAPアダプタを構成するためのウィザードが呼び出されます。

  3. ウィザードの各ページの設定を行ってSOAPアダプタを構成し、「Done」をクリックします。 この構成では、タイムスタンプの詳細を選択するために別の操作が選択されます。
    ダイアログが表示され、レスポンス・マッパーで以前に構成したレスポンス・マッピングが影響を受ける場合に削除することができます。 ここで実行したエンリッチメント・レスポンス・アダプタ構成のために、レスポンス・マッパーを更新する必要があります。
  4. 「Yes」をクリックします。 この手順の後でレスポンス・マッピングを再作成します。
  5. 「Save」をクリックします。
    SOAPアダプタのアイコンとレスポンス・エンリッチメント・マッパーが、統合のレスポンス側に追加されます。 前の手順でレスポンス・マッピングを削除したため、そのアイコンの緑色のシェーディングが消えたことに注意してください。 これは、レスポンス・マッピングの構成が必要であることを意味します。
  6. トリガーと呼出しの間の「Response Enrichment Mapping」アイコンをクリックします。
  7. 表示されるCreateアイコンをクリックします。 これによってマッパーが呼び出されます。

  8. レスポンスにタイムスタンプを含めるようにソース要素をターゲット要素にマッピングして、完了したら「Save」をクリックします。
    レスポンス・エンリッチメント・マッピングは次のようになります。
    マッピング ソース ターゲット
    レスポンス・エンリッチメント sayHelloResponse/sayHelloReturn visitTimestampReq > reqMsg
    「Response Mapping」アイコンが緑色で表示され、構成済であることを示します。
  9. Response Mappingアイコンをクリックして、マッパーを再び呼び出します。 実行したエンリッチメント・レスポンス・マッピングのために、このマッパーを更新する必要があります。

  10. レスポンス・マッパーでソース要素をターゲット要素にマッピングし直します。
    レスポンス・マッピングが更新されます。 現在、元のターゲットHelloResponse/Greetingに別のソースがマッピングされることに注意してください。
    マッピング ソース ターゲット
    レスポンス $ResponseEnrichmentApplicationObject > visitTimestampResp > respMsg HelloResponse/Greeting
    「Response Enrichment Mapping」アイコンが緑色で表示され、再構成されたことを示します。
  11. 完了したら「Save」をクリックし、「Exit Mapper」をクリックします。
    レスポンス・エンリッチメントを含む統合が呼出し(ターゲット)領域に追加され、次のように表示されます。

  12. 完了したら「Save」をクリックし、「Exit Integration」をクリックします。
    統合をアクティブ化する準備が整いました。 この例では説明していませんが、下に表示されるリクエスト・メッセージのエンリッチメント領域も構成できます。これを行うには、「Drag and drop an enrichment source for the request message」領域にアダプタをドラッグ・アンド・ドロップします。 これによって、アダプタの構成ウィザードが呼び出されます。

後から、既存のエンリッチメント(アダプタ構成ウィザードで選択されたオブジェクトやエンリッチメント・マッピングなど)を更新することもできます。
エンリッチメントの詳細は、「Integration Cloud Serviceのエンリッチメントについて」を参照してください。

リクエストおよびレスポンス・エンリッチメントの削除

統合に追加されたリクエストおよびレスポンス・メッセージ・エンリッチメント・ポイントのマッピングを削除できます。 エンリッチメント・ポイント・マッピングを削除すると、統合は元のエンリッチメント前の状態に戻ります。

リクエストおよびレスポンス・エンリッチメントを削除するには、次のようにします。
  1. Integrationページで統合を選択します。 この統合はアクティブであってはなりません。
  2. 削除するリクエスト・メッセージまたはレスポンス・メッセージの濃縮領域をクリックします。
  3. 表示される「Delete」アイコンを選択します。
    これによってマッピングが削除されます。
  4. プロンプト表示されたら「Yes」をクリックして確認します。
    「Save」をクリックし、「Exit Canvas」をクリックします。
エンリッチメントの詳細は、「Integration Cloud Serviceのエンリッチメントについて」を参照してください。

統合の2つの異なる呼出しエンドポイントに対するルーティング・パスの作成

2つの異なる呼出しエンドポイントに対してルーティング・パスを定義する統合を作成できます。 実行時に、ルーティング・パスの式フィルタ・ロジックが評価され、その結果に基づいて呼出しエンドポイントのいずれかに対するパスが使用されます。 どちらのルーティング・パスでもフィルタ・ロジックが満たされない場合、どの呼出しエンドポイントにも接続されません。

式ロジックは次のように動作します。
  • 1番目の(上の)呼出しエンドポイントに式フィルタを定義します。

  • 2番目の(下の)呼出しエンドポイントにELSE条件または式フィルタを定義します。

実行時に、1番目の(上の)呼出しエンドポイントの式フィルタ・ロジックがtrueに評価されると、その呼出しエンドポイントに対するパスが使用されます。 式がfalseに評価されると、その呼出しエンドポイントはスキップされ、2番目の(下の)呼出しエンドポイントに対するパスがELSE条件または式フィルタを通じて使用されます。

ルーティング・パスの作成に加え、両方の呼出しエンドポイントにリクエストとレスポンス(およびオプションでエンリッチメント)のマッピングも定義します。

統合の2つの異なる呼出しエンドポイントに対するルーティング・パスを作成するには、次のようにします。

  1. Integrationsページで、ルーティング・フィルタを定義する統合を選択します。 統合が、トリガーと呼出しの接続、ビジネス識別子の追跡およびマッピングで完全に定義されていることを確認します。
  2. 統合のトリガー側のFilterアイコンをクリックし、フィルタ式を作成します。 ルーティングは、定義済のリクエスト・エンリッチメントの後で、最初のリクエスト・マッピングの前に作成されます。
    GUID-87CBBFAC-E79E-462B-A37F-3EEC4D05F366-default.pngの説明が続きます
    図GUID-87CBBFAC-E79E-462B-A37F-3EEC4D05F366-default.pngの説明
  3. 表示されているメニューの「Routing」アイコンをクリックします。
    ルーティング式を作成するための式ビルダーが表示されます。 式ビルダーは、複数のソース構造をサポートします。 両方のソース構造を使用してOR式を作成できます。 また、式に名前を付けたり、「Expression Summary」アイコンを使用して式サマリーを計算したりすることもできます。 ネームスペース接頭辞の有無にかかわらず要素および属性もサポートされます。
  4. 要素を「Source」領域から「Expression」フィールドにドラッグします。
  5. 値を定義します。
    この例では、ClassificationCode要素がOrgに等しいものとして定義されています。 つまり、この式がtrueに評価される場合、Orgが取得されることを意味します。
  6. 式を計算するには、「Expression Summary」アイコンをクリックします。 これにより、式のサマリーが表示され、作成したばかりの式の、よりわかりやすく読みやすいバージョンが定義されます。
  7. その名前が使い勝手が悪い場合は、追加の編集のために式をコピーして「式名」フィールドに貼り付けます。
    GUID-3BF73809-D1B0-488E-8588-B65256C1137C-default.pngの説明が続きます
    「図GUID-3BF73809-D1B0-488E-8588-B65256C1137C-default.pngの説明」
  8. 「Save」をクリックし、「Exit Expression Builder」をクリックします。
    定義した式が統合の上に表示されます。 「フィルタ」アイコンが変更され、式が定義されたことを示します。
    GUID-339675AF-37F6-4FAD-B608-72A1E59969B5-default.pngの説明が続きます
    図GUID-339675AF-37F6-4FAD-B608-72A1E59969B5-default.pngの説明
  9. 統合の右側で、Routing Drawerアイコンをクリックし、2つの潜在パスが含まれるグラフィカル・ルーティング・ダイアグラムを表示します。 前に定義した1番目のルート(上のトリガーと呼出し)は、直線の上の定義済の式を示します。 2番目のルート(下のトリガーと呼出し)は、まだ定義されていないため、点線で表示されます。

    統合をアクティブ化するか(追加のフィルタが不要な場合)、追加のルーティング・フィルタを定義できます。 この例では、2番目のルートを定義します。
  10. 下部のトリガー・アイコンの「雄牛目」アイコンをクリックして、2番目のトリガーと経路を呼び出すための経路を定義します。
    GUID-A3F8891D-E1DA-4A96-8E37-F623AF3BF8AA-default.pngの説明が続きます
    図GUID-A3F8891D-E1DA-4A96-8E37-F623AF3BF8AA-default.pngの説明
    これにより、統合がリフレッシュされ、統合の下のトリガーと呼出しのルートが表示されます。 トリガー側は1番目のルートに定義されているとおりですが、呼出しルートは未定義です。
  11. 「Show Palette」をクリックし、使用可能な接続およびテクノロジのリストを表示します。
  12. アダプタを統合の呼出し(ターゲット)領域にドラッグします(この例では、Oracle RightNowアダプタが追加されます)。
    アダプタ構成ウィザードが呼び出されます。
  13. Oracle RightNowアダプタについてウィザードの各ページを構成します。 この例では、操作ページで「取得」操作および「アカウント」ビジネス・オブジェクトが選択されています。
    GUID-C6F03948-3D9A-4886-AF4F-18ED29D1B785-default.pngの説明が続きます
    「図GUID-C6F03948-3D9A-4886-AF4F-18ED29D1B785-default.pngの説明」
    これで、2番目の呼出しに対して統合が定義されました。 次に、2番目の呼出しに対してフィルタ式を作成する必要があります。
  14. 「Filter」アイコンをクリックしてフィルタ式を作成します。
  15. 追加の式が必要ない場合は、Eアイコンをクリックして(ELSE条件を作成します)。
    GUID-2618C32F-7742-41BE-8D07-5687475D7DEC-default.pngの説明が続きます
    「図GUID-2618C32F-7742-41BE-8D07-5687475D7DEC-default.pngの説明」
    これは2番目のトリガーと呼出しのELSE条件を定義します。 ELSE条件は、1番目のルートがfalseに評価された場合(ClassificationCodeOrgに等しくない場合)に使用されます。 個々の直線のアダプタ・アイコンをクリックして、2つのトリガー・ルートを相互に切り替えることができます。 青色の線は、統合で現在表示されている呼び出しです。
    GUID-BF479DE7-495B-4F97-BB36-FE0819CF231E-default.pngの説明が続きます
    図GUID-BF479DE7-495B-4F97-BB36-FE0819CF231E-default.pngの説明
  16. ELSE条件を使用するかわりに2番目のルートに独自の式フィルタを定義する場合、次の手順を実行します。
    1. 「Filter」アイコンをクリックします。
    2. 「Clear Expression」を選択してELSE条件を削除します。
    3. プロンプト表示されたら「Yes」をクリックして確認します。
    4. 「Filter」アイコンを再度クリックし、「Edit」アイコンを選択して、手順3で実行したように式ビルダーを呼び出します。
    5. 式を定義します。
    6. 「Save」をクリックし、「Exit Expression Builder」をクリックします。
      リクエストとレスポンスのマッピングを定義する必要があります。
  17. 「リクエスト・マッパー」アイコンをクリックしてマッピングを定義します。
    この例では、次のマッピングが定義されます。
    ソース ターゲット

    process > Organization > Organizationid

    Get > Account > ID > id

  18. 「レスポンス・マッパー」アイコンをクリックしてマッピングを定義します。
    この例では、次のマッピングが定義されます。
    ソース ターゲット

    process > GetResponse > Account > ID > LookupName

    processResponse > Organization > Name

    これで、統合の設計は100%完了しました。

  19. 統合をアクティブ化します。

式モードと条件モードの両方でのルーティング式ロジックの作成

2つの異なるユーザー・インタフェース・モードでルーティング条件のXPath式を作成できます。

  • 式モード: このモードは、XPath式全体を作成および表示するためのインタフェースを提供します。

  • 条件モード: このモードは、XPath条件式を作成および表示するための読みやすいインタフェースを提供します。 このモードは、XPath式の使用経験が少ないビジネス・アナリストの役に立ちます。

式を作成および表示する際は、式モードと条件モードを切り替えることができます。 マッピングが必要な要素および属性は、名前の左側の青色のアスタリスク(*)によって識別されます。 マッピングが必要な場合など、要素および属性にカーソルを置いて、特定のスキーマの詳細(データ・タイプなど)を表示できます。 式を作成する際、ツリーにおける次の機能に注意してください。
  • デフォルトで、ツリー内のSource領域に要素の3つのレベルがロードされます。 3番目のレベルに到達すると、Load moreリンクが表示されます。 このリンクをクリックすると、その要素のすべての直接の子が表示されます。 ベース・タイプのみが自動的にロードされます。 ベース・タイプの拡張されたタイプをロードするには、独特なアイコンで識別されるベース・タイプをクリックします。 これにより、拡張されたタイプのメニューが起動し、1つずつ選択してツリーにロードできます。
    GUID-F683F4B2-71E1-413C-9D63-CAAFA180F688-default.pngの説明が続きます
    図GUID-F683F4B2-71E1-413C-9D63-CAAFA180F688-default.pngの説明

  • すでに式にドラッグした「Source」領域のツリーの要素は、緑色のチェック・ボックスで識別されます。 これらの要素は、3つのレベルよりも深いレベルであってもツリー内に表示されます。

  • ツリーにまだロードされていない要素を検索するには、「Find」フィールドに名前を入力して「Search」アイコンをクリックします。 このアクションにより、特定の要素がツリーにロードされます。

この項では、両方のモードを使用して式を作成する例を示します。

式モードと条件モードの両方でルーティング式ロジックを作成するには、次のようにします。

  1. 統合のソース側のFilterアイコンをクリックし、フィルタ式を作成します。
    GUID-87CBBFAC-E79E-462B-A37F-3EEC4D05F366-default.pngの説明が続きます
    図GUID-87CBBFAC-E79E-462B-A37F-3EEC4D05F366-default.pngの説明
  2. 表示されているメニューの「Routing」アイコンをクリックします。
    ルーティング式を作成するための式ビルダーが表示されます。 式モードがデフォルトのモードです。
  3. 「式名」のすぐ下のフィールドに、オプションとして、作成する式の簡単な説明を入力します。

  4. 左側のSource領域から、短い説明フィールドの直下の式フィールドに要素を追加します。 必要に応じて、Componentsセクションから機能を追加することもできます。
    式フィールドに要素を追加する方法は2つあります。
    1. 要素を「ソース」領域からドラッグします。
    2. Source領域で要素の行を選択し、ページの中心にあるMoveアイコンをクリックして要素を移動します。

      選択した要素の式が式フィールドに表示されます(この例では、Country要素の式が追加されています)。 選択された要素は、「ソース」領域の緑のチェックボックスで識別されます。

  5. 追加した式の右側で、演算子と、一重引用符または二重引用符で囲んだ値を定義します(この例では、= “USA”が定義されています)。
  6. Expression Summaryアイコンをクリックし、簡単でわかりやすいバージョンの式を表示します。 読みやすい出力が表示されます。
    GUID-2F29392D-2743-4A82-AD86-7E43453750C9-default.pngの説明が続きます
    図GUID-2F29392D-2743-4A82-AD86-7E43453750C9-default.pngの説明

    注意:

    • 式に要素を追加するには、式の正確な位置にカーソルを置き、「Source」領域内で要素の行を選択し、「Move」アイコンをクリックします。 これらのアクションにより、この要素がカーソルの正確な位置に追加されます。

    • 式内のカーソルの正確な位置に要素をドラッグできます。これにより、要素の式が、要素をドロップする位置ではなく、カーソル位置に追加されます。

    • 要素を既存の式の要素の上にドラッグして置き換えることができます。

  7. 右上隅で、「Condition Mode」をクリックし、条件モードで作成した式を表示します。 条件モードは、式を作成および表示するための読みやすいインタフェースを提供します。

    条件モードへのアクセスに関する次の詳細事項に注意してください。

    • 条件モードにアクセスできるのは、条件フィールドが空であるか、trueまたはfalseを返す式を使用して条件フィールドが完全に定義されている場合のみです。 式を部分的にのみ定義した場合(たとえば、式フィールドに要素をドラッグしたが、式ロジックおよび= “USA”などの値を定義し忘れた場合)、条件モードにアクセスするには有効な条件を指定する必要があるという内容のエラーが表示されます。

    • 「Condition Mode」ボタンが「Expression Mode」に切り替わります。

    注意:

    いつでも「Expression Mode」をクリックしてXPath式全体を表示できます。
  8. 式をクリックします。

    GUID-E1D0F8AA-950E-445C-912C-979591A34E8A-default.pngの説明が続きます
    図GUID-E1D0F8AA-950E-445C-912C-979591A34E8A-default.pngの説明

    これにより、ページがリフレッシュされ、条件および条件グループを追加するためのアイコンが表示されます。 グループを使用すると、複数の条件を単一の論理式に結合できます。


    GUID-6851086F-D4C7-40AE-BAEE-F422BA3DCBAE-default.pngの説明が続きます
    「図GUID-6851086F-D4C7-40AE-BAEE-F422BA3DCBAE-default.pngの説明」
  9. 条件式を追加するには、「条件の追加」アイコン(最初のアイコン)をクリックします。
    これにより、追加の式ロジックを入力するための追加フィールドが作成されます。 このフィールドにDrag and drop or type hereというメッセージが表示されます。
    GUID-0D61CF81-A628-4AD8-B17F-CEDA1ECBF16D-default.pngの説明が続きます
    「図GUID-0D61CF81-A628-4AD8-B17F-CEDA1ECBF16D-default.pngの説明」
  10. 「Source」領域から最初の「Drag and drop or type here」フィールドに要素をドラッグします(この例では、Country要素が再度追加されます)。
  11. 演算子(=>!=など)を選択し、値を追加します(この例では、“Mexico”が追加されます)。
  12. 「Match」リストから、オプションを選択します。 このリストは、少なくとも2つの条件が定義されるまで表示されません。
    • Any of: 追加した任意の式がtrueである必要がある場合に選択します。 これは、式モードで表示されるXPath式全体におけるOR条件に相当します。

    • All of: すべての式がtrueである必要がある場合に選択します。 これは、式モードで表示されるXPath式全体におけるAND条件に相当します。



  13. 「Add Group」アイコン(2番目のアイコン)を選択し、一連の条件をグループ化します。 このオプションを使用すると、単一のグループ内で複数の条件を作成できます。 グループは、グレーの輪郭とインデントによって示されます。
  14. 「Source」領域から要素を追加します。
    次に例を示します。
    • DisplayName要素が最初の「Drag and drop or type here」フィールドに追加されます。

    • 不等号演算子(!=)が選択されます。

    • Country要素が2番目の「Drag and drop or type here」フィールドに追加されます。

  15. 「Add Condition」アイコン(最初のアイコン)をクリックし、グループ内に条件式を追加します。
    次に例を示します。
    • DisplayOrder要素が最初の「Drag and drop or type here」フィールドに追加されます。

    • 小なり演算子(<)が選択されます。

    • 10が2番目の「Drag and drop or type here」フィールドに入力されます。

  16. 必要に応じて、グループ条件の構築を続けます。
    完了すると、式が表示されます。 この例では、CountryUSAであるORCountryMexicoであるOR DisplayNameが国と等しくなく、DisplayCount10未満である場合、統合が続行されます。
    GUID-6C9F8E88-EAF4-470D-891F-4B32845E9E38-default.pngの説明が続きます
    図GUID-6C9F8E88-EAF4-470D-891F-4B32845E9E38-default.pngの説明
  17. 「Expression Mode」をクリックします。
    下部のXPath式全体と式サマリーに注意してください。 選択された要素が表示され(ツリー内のレベルの深さには依存しない)、Source領域内の緑のチェック・ボックスにより識別されます。
    GUID-2325D7F0-B6CC-4908-8C1C-76A1F1D17ADD-default.pngの説明が続きます
    「図GUID-2325D7F0-B6CC-4908-8C1C-76A1F1D17ADD-default.pngの説明」
  18. 必要な場合、XPath式内にカーソルを置き、必要に応じて編集(たとえば、USACanadaに変更)し、「Expression Summary」アイコンをクリックし、計算をリフレッシュします。 XPath式の編集時に間違った(たとえば、値に二重引用符を追加し忘れた)場合、エラー・メッセージが表示されます。
  19. 「Save」をクリックして、読取り専用モードで式を表示します。 また、作成プロセス中にいつでも「Done Editing」をクリックして、読取り専用モードで式を表示できます。
  20. 「Exit Expression Builder」をクリックして、統合に戻ります。 統合の上の青いバナーにわかりやすい式が表示されます。

ルーティング・パスの削除

統合の異なるターゲット・エンドポイントで作成されたルーティング・パスを削除できます。

ルーティング・パスを削除する場合、2つの方法があります。
  • ルーティング・パスと式フィルタを削除します。

  • エンドポイントとルーティング・パスを削除しますが、式フィルタは維持します。

ルーティング・パスと式フィルタの削除

ルーティング・パスと式フィルタを削除するには、次のようにします。

  1. Integrationsページで、ルーティング・パスを削除する統合を選択します。

  2. 「Routing Drawer」アイコンを展開して、ルーティング・パスのダイアグラムを表示します。

  3. 統合の上で、削除するルーティング・パスを選択します。
    GUID-FAA6A13F-18B9-4E42-A7AA-80FF05587F18-default.pngの説明が続きます
    図GUID-FAA6A13F-18B9-4E42-A7AA-80FF05587F18-default.pngの説明

  4. 「Filter」アイコンをクリックします。

  5. 表示されているメニューから「Delete Route」を選択します。


    GUID-126304B0-7FA9-4135-8E3A-ADDD2B0CB6A8-default.pngの説明が続きます
    図GUID-126304B0-7FA9-4135-8E3A-ADDD2B0CB6A8-default.pngの説明
  6. プロンプト表示されたら「Yes」をクリックして確認します。

    このアクションにより、選択したパスの式フィルタおよびリクエスト・マッピングとともに、ルーティング・パスが削除されます。 統合の上のダイアグラムに、ルーティング・パスが削除されたことが示されます。
    GUID-4DD73D66-5704-4ECC-AAE2-EF31A93C6C53-default.pngの説明が続きます
    図GUID-4DD73D66-5704-4ECC-AAE2-EF31A93C6C53-default.pngの説明

エンドポイントとルーティング・パスの削除

エンドポイントとルーティング・パスを削除するには、次のようにします。

  1. 統合で、削除するターゲット・エンドポイントをクリックします。

  2. 表示されているメニューの「Delete」をクリックします。

  3. プロンプト表示されたら「Yes」をクリックして確認します。

    このアクションにより、ターゲット・エンドポイントとルーティング・パスが削除されます。 統合の上のダイアグラムに、ルーティング・パスが削除されたことが示されます。 統合内では、削除されたターゲット・エンドポイントから何も使用していないため、式のみが統合で定義されたままになります。
    GUID-CA8392F4-A169-45AC-A223-AD0CB739F997-default.pngの説明が続きます
    「図GUID-CA8392F4-A169-45AC-A223-AD0CB739F997-default.pngの説明」