Oracle® Fusion Middleware Oracle Cloud Adapter for Oracle RightNow Cloud Serviceユーザーズ・ガイド 12c (12.1.3) E59443-02 |
|
前 |
次 |
この章には次の項があります。
Oracle BPEL Process Managerと統合するには、ユーザーが組織のエンタープライズWSDLを使用できる必要があります。基礎となるアダプタ・サービスは、WSDLファイルとして公開されます(これらのファイルは、Oracle RightNowアダプタ構成ウィザードで設計時に生成されます)。
生成されたWSDLファイルを使用して、アウトバウンド・アダプタ・サービスの適切なBPELプロセスを設計します。完成したBPELプロセスは、JDeveloperで正常にコンパイルされ、SOA Suiteサーバーにデプロイされる必要があります。SOA Suiteサーバーにデプロイすると、新しくデプロイされた各プロセスは、すぐにOracle Enterprise Manager Fusion Middleware Controlで表示可能となり、そこでBPELプロセスの実行、モニター、管理、およびアダプタ・イベントのモニターを行うことができます。
アカウント・オブジェクトを作成し、WSDLをOracle BPEL Process Managerに統合します。アカウントは、RightNowによって提供される標準オブジェクトの1つで、RightNow Cxシステムのスタッフ・メンバーに対して生成されるアカウントです。顧客サービス担当、販売代理店およびサイト管理者は、アカウントを使用します。
具体的には、RightNow Cxのアカウント・オブジェクトは、ビジネスに関連付けられた個人またはビジネスを表します。
Oracle RightNowアダプタによって、RightNow Cxでアカウント・オブジェクトを作成できます。
Oracle Enterprise Manager Fusion Middleware ControlでのCSFキーの構成手順については、付録A「RightNow資格証明を管理するための資格証明ストアの構成」を参照してください。
次の手順では、Oracle Fusion Middlewareアプリケーションを開発するための総合ツールであるOracle JDeveloper Studio Editionを使用してコンポジットを設計する方法について説明します。これにより、統合を効率的に作成できる使いやすい統合開発環境が提供されます。
BPELおよびメディエータのコンポジットを定義するには、次の手順を実行します。
JDeveloperの「ファイル」メニューで、「新規」をクリックして「アプリケーション」を選択します。
JDeveloperに「新規ギャラリ」ページが表示されます。「項目」リストから「SOAアプリケーション」を選択します。
アプリケーションに適切な名前を指定します。
「次へ」をクリックしてプロジェクトに適切な名前を指定します。
「次へ」をクリックします。
「標準コンポジット」リストから「BPELプロセスを使用するコンポジット」を選択します。
「終了」をクリックします。
「テンプレート」ドロップダウン・リストから「同期BPELプロセス」を選択し、「OK」をクリックします。
composite.xml
が表示されます。
アプリケーション・ナビゲータの「スキーマ」フォルダに、Oracle JDeveloperは、BPELプロセスの作成後にBPELProcess1.xsd
という名前でXMLスキーマ・ファイルを表示します。
ビジネス・ニーズに応じてこのスキーマ・ファイルを編集します。データ検証の強制と、SOAからOracle RightNow Cxサーバーに送信される入力にエラーがないことの確認は、フロントエンド・アプリケーションが担当します。
この使用例でのスキーマの構造は、次のとおりです。
新しいOracle RightNowアダプタを構成するには、次の手順を実行します。
composite.xml
ファイルの「外部参照」スイムレーンで、右クリックして「Oracle RightNowアダプタ」を選択します。
Oracle JDeveloperに基本情報画面が表示されます。
わかりやすい名前とオプションの説明を入力します。
「次へ」をクリックします。
JDeveloperに「接続」ページが表示されます。WSDL URL/場所、セキュリティ・ポリシーおよび認証キーの詳細を指定する必要があります。
ファイル・システムで使用できるWSDLが存在する場合、画面のWSDLの右側にある「既存のWSDLを検索します。」アイコンをクリックします。
JDeveloperに「WSDLチューザ」ダイアログが表示されます。ダウンロードしたエンタープライズWSDLを検索して選択し、「OK」をクリックします。
「OK」をクリックします。
「OK」をクリックします。「接続」ページに戻ります。
別の方法として、MDSの場所にWSDLを格納してアクセスできます。次のスクリーンショットは、MDSの場所にWSDLを格納する方法を示しています。
「IDE接続」→「SOA-MDS」に移動します。エンタープライズWSDLを配置した適切なSOA-MDS接続を選択します。アダプタ構成で使用するWSDLファイルを選択し、「OK」をクリックします。
WSDLが次の形式であることを確認します。
oramds:/apps/SOA/WSDLs/Integration/rightnowAPI.wsdl
別の方法として、https URLを直接指定します。
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl
「OK」をクリックします。
「+」ボタンをクリックして新しい認証キーを作成します。
適切な名前とRightNow資格証明を指定し、「OK」をクリックします。
「テスト」ボタンをクリックして認証キーを検証します。
「次へ」をクリックします。
Oracle JDeveloperに「操作」ページが表示されます。
RightNowでアカウントを作成する必要があるため、「操作タイプの選択」リストからCRUD操作とCreate操作を選択します。
同じ画面で、「選択可能」オブジェクトのリストから「選択済」オブジェクトのリストにAccount
を移動します。
画面の右上隅で、「処理オプション」リンクをクリックします。
要件の処理オプションを選択します。このページに表示されるプロパティは、前のページで選択した操作に応じて異なります。この場合、「レスポンスの抑制」チェック・ボックスが選択され、レスポンスの抑制が無効化されて、falseになります。これを選択すると、Create
操作によって、作成中のバッチ操作インスタンスの有効なIDが返されます。
「次へ」をクリックします。JDeveloperに、選択した操作の完全な概要、操作対象のオブジェクト、およびその操作に選択したヘッダーが示された「サマリー」ページが表示されます。
「終了」をクリックして、Oracle RightNowアダプタ構成ウィザードを完了します。
図5-16 「外部参照」スイムレーンにアダプタが表示された「サービス」、「コンポーネント」および「外部参照」画面
BPELとの統合を実現するには、次の手順を実行します。
ワイヤを使用してBPELProcess1
とServiceCloudCreateAccount
を接続します。
図5-17 ワイヤを使用して接続されたBPELProcess1とRightNowAccount外部参照
ワイヤでの接続後、コンポジットが表示されます。
図5-18 サービス、BPELProcessおよび参照がワイヤ接続されたコンポジット・アプリケーション
BPELProcess1
をダブルクリックして開きます。Oracle RightNowアダプタは、パートナ・リンクの一部として表示されます。
invokeアクティビティを追加してServiceCloudCreateAccount
パートナ・リンクを起動します。invokeアクティビティを追加するには、次の手順を実行します。
BPELコンストラクトからinvokeアクティビティをドラッグ・アンド・ドロップします。
キャンバスにinvokeプロパティをドロップしたら、invokeアクティビティをServiceCloudAdapter
パートナ・リンクにワイヤ接続します。
パートナ・リンクへの入力変数を作成するため、「変数」セクションの「入力」テキスト・ボックスの横にある「+」ボタンをクリックします。JDeveloperに「変数の作成」ダイアログが表示されます。
パートナ・リンクからの出力変数を作成するため、「変数」セクションの「出力」テキスト・ボックスの横にある「+」ボタンをクリックします。ウィザードに「変数の作成」ダイアログが表示されます。
2つのtransformアクティビティを、1つはinvokeアクティビティの前に、もう1つはその後に配置します。
Transform1の値をreceiveアクティビティの入力変数からinvokeアクティビティの入力変数にマップします。
図5-24 Transform1の値をreceiveアクティビティの入力変数からinvokeアクティビティの入力変数にマップする方法
「マッパー・ファイル」テキスト・ボックスの横にある「+
」ボタンをクリックしてTransformation_1.xslファイルを開きます。
inputVariableとInvoke1_create_InputVariableを次のようにマップします。
Account_NameとNameをマップします。
PhoneとPhoneをマップします。
WebsiteとWebsiteをマップします。
DescriptionとDescriptionをマップします。
図5-25 inputVariableとInvoke1_create_InputVariableのマップ
Transform2の値をinvokeアクティビティの出力変数からreplyアクティビティの入力変数にマップします。
図5-26 Transform2の値をinvokeアクティビティの出力変数からreplyアクティビティの入力変数にマップする方法
出力変数をマップします。
これで、プロジェクトの作成は完了です。JDeveloperにcomposite.xml
が表示されます。
コンポジット・アプリケーションをデプロイするには、次の手順を実行します。
アプリケーション・ナビゲータ・ペインで、「Project1」を右クリックして「デプロイ」→「Project1」を選択します。
「アプリケーション・サーバーへのデプロイ」オプションを選択して指示に従います。このオプションを使用すると、サーバーの詳細を指定してアプリケーション・サーバーにコンポジットをデプロイできます。
Oracle Fusion Middleware Controlコンソールで、デプロイしたSOAコンポジット・アプリケーションのインスタンスを実行およびテストできます。これを実行することで、コンポジット・アプリケーションの管理、コンポジットのインスタンスの開始と追跡、および詳細なコンポーネント・インスタンス監査証跡の表示を行うことができます。
次の手順は、コンポジットをテストする方法を示しています。