Oracle® Fusion Middleware Oracle Cloud Adapter for Oracle RightNow Cloud Serviceユーザーズ・ガイド 12c (12.1.3) E59443-02 |
|
前 |
次 |
この章では、Oracle RightNowアダプタの使用例について手順を追って説明します。
次の各使用例によって、Oracle RightNowアダプタを使用して、SOA SuiteからOracle RightNow Cxに統合するアクティビティを実行する方法を説明します。
これらの各使用例の手順に従う前に実行する一般的な操作に関する情報は、3.1項「JDeveloperでの一般的な構成手順の実行」を参照してください。
Oracle RightNowアダプタでは、次のことを実行できます。
同期アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってRightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの単一オブジェクトにCRUD操作を実行します。
これは、同期リクエスト・レスポンス・シナリオであり、クライアントは、RightNow Cxインスタンスにオブジェクトを作成するようOracle RightNowアダプタ・サービスにリクエストします。
アダプタ構成ウィザードのOracle RightNowアダプタを使用して、アウトバウンド・サービスを設計します(3.1項「JDeveloperでの一般的な構成手順の実行」を参照)。これらの手順は操作画面で開始します。
RightNowアダプタでは、CRUDおよびROQL操作がサポートされます。最初の使用例を実行するには、操作画面で「CRUD」を選択します。
画面でCreate操作を選択します。(使用可能な他のCRUDオプションは、Read、UpdateおよびDeleteです。)「次へ」をクリックします。
Oracle RightNowアダプタに、使用可能なRightNow Cxビジネス・オブジェクトが表示されます。
オブジェクトを選択するには、オブジェクトを「選択可能」リストから「選択済」リストに移動します。フィルタ・オプションを使用すると、基準に基づいてオブジェクトを見やすく表示できます。Oracle RightNowアダプタ構成ウィザードに、標準オブジェクトとカスタム・オブジェクトの両方が表示されます。
実行する処理オプションを選択できます。これらを使用して、操作の実行時にサーバー側の処理機能を有効化または無効化できます。次のものが含まれます。
外部イベントの抑制。このオプションを選択して、Create
、Update
またはDelete
操作の完了後に外部イベントを実行しないことを指定します。
ルールの抑制。このオプションを選択して、Create
、Update
またはDelete
操作の完了後にビジネス・ルールを実行しないことを指定します。
この使用例では、「外部イベントの抑制」および「ルールの抑制」オプションを選択します。
「終了」オプションを選択して、Service Cloudサービスの起動の構成を完了します。
「終了」オプションを選択すると、ウィザードによって次の処理が行われます。
統合中心型のWSDLが生成されます。
厳密に型指定されたスキーマ定義が生成されます。
接続情報を含むJCA構成ファイルが生成されます。
SCAコンポジットの参照エンドポイントが生成されます。
このシナリオでは、アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってOracle RightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの複数のビジネス・オブジェクトに作成操作を実行します。
この使用例は、同期リクエスト・レスポンス・シナリオであり、クライアントは、RightNow Cxインスタンスにオブジェクトのセットを作成するようアダプタ・サービスにリクエストします。
Oracle RightNowアダプタを使用して、複数のオブジェクトとともに動作するアウトバウンド・サービスを設計します。
複数のビジネス・オブジェクトに対してCRUD操作を実行するアウトバウンド・サービスを設計するには、次の手順を実行します。
操作画面では、複数のビジネス・オブジェクトを選択できます。複数のオブジェクトを選択するには、それらを「選択可能」で選択し、矢印を使用して「選択済」に移動します。
複数のオブジェクトの選択を完了したら、この画面の「次へ」をクリックします。
構成ウィザードにサマリー画面が表示されます。アダプタによって、BPELなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。アダプタによって、すべてのバッチ操作が構成された統合中心型のWSDLが生成されます。アダプタによって、BPELなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。
このシナリオでは、アウトバウンド通信の一部として、Oracle RightNowアダプタは、Connect Web Services for SOAP APIの支援によってRightNow Cxインスタンスに接続し、そのRightNow Cxインスタンスの複数のビジネス・オブジェクトが含まれるバッチ操作を実行します。これは同期リクエストです。複数のビジネス・オブジェクトと複数の操作によるバッチ操作を実行するには、次の手順を実行します。
操作固有の詳細を構成します。操作画面で「バッチ操作」オプションを選択します。
「リストに操作を追加」をクリックして複数の操作を追加します。
図9-2 バッチ内の複数の操作が選択されたOracle RightNowアダプタの操作構成画面
操作タイプとビジネス・オブジェクトを選択します。
バッチ操作の構成は、単一操作(最初の使用例で説明)の構成と似ています。
バッチ操作の操作構成では、特定の操作に対してバッチ専用オプションの「後でコミット」を指定することもできます。この場合、「後でコミット」が指定されている操作の後にのみトランザクション全体がコミットされます。
「OK」ボタンをクリックして操作の構成を完了します。
Oracle RightNowアダプタを使用して、ROQL (RightNow Query Language)の支援によってRightNow Cxインスタンスの標準オブジェクトとカスタム・オブジェクトを問い合せるアウトバウンド・サービスを設計します。
Oracle RightNowアダプタを使用したROQL問合せの実行については、3.3項「ROQLの使用」を参照してください。3.1項「JDeveloperでの一般的な構成手順の実行」で指定した一般的な操作ステップの完了後、この手順を行います。
操作画面で、「操作タイプの選択」リストから「ROQL」を選択します。
「問合せ文」テキスト・ボックスに、ROQL問合せを入力します。
ウィザードの手順を完了する前に問合せ構文をテストします。「問合せのテスト」をクリックします。
問合せ操作の構成が完了したら、「次の手順」をクリックします。アダプタによって、問合せ操作と入力および出力メッセージを含む統合中心型のWSDLが生成されます。アダプタによって、BPELやメディエータなどの他のコンポーネントからワイヤ接続できる参照エンドポイントも作成されます。
Oracle RightNow Cxには、CRUD操作を実行できる標準ビジネス・オブジェクトとカスタム・オブジェクトという2つの異なるタイプの関連オブジェクトがあります。この使用例では、カスタム・オブジェクトに対してGet
操作を実行し、適切なWSDLおよびJCAファイルを生成します。
カスタム・オブジェクトに対してGet操作を実行するには、次の手順を実行します。
操作画面の「使用可能」の下で、CRUD操作のために選択するカスタム・オブジェクトを見つけます。表記規則では、標準オブジェクト名(Contact
など)の後にCustomObj
が続きます(Contact_CustomObj
など)。
「選択可能」の下で例としてContact_CustomObj
を使用し、矢印を使用して選択したオブジェクトを「選択済」に移動します。
選択したオブジェクトにGet
操作を実行するようにCRUD操作をGet
に変更します。
「次の手順」をクリックします。ウィザードにサマリー画面が表示されます。
「終了」をクリックしてWSDLおよびJCAファイルを生成します。
チェーンは、単一のバッチ・リクエスト内で複数の操作を相互に関連付けるために使用できるOracle RightNowアダプタの機能です。
チェーンの基礎となる概念と結果のコードの詳細は、3.2.1.3項「チェーン」を参照してください。
チェーンの使用例では、次の手順の実行について説明します。
Contact
の作成
Incident
の作成(このIncidentのプライマリContact
は最初の手順で作成したものです。)
Incident
の取得(作成したIncident
を返す必要があります。)
3.2.1.4項「チェーンの使用」では、Oracle RightNowアダプタのユーザー・インタフェースでチェーンを使用する方法と、それを行う場合の使用例について説明します。使用例では、変換中にチェーンを実行する方法について説明し、XSLTマッパーを使用します。
注意: チェーンは、常にバッチとともに使用され、Oracle RightNowアダプタのバッチ構成ウィザードで特別の手順を必要としません。 |