接続の作成の前提条件
Oracle Service Cloud (RightNow)アダプタとの接続を作成するには、次の前提条件を満たす必要があります:
- Oracle Service Cloud (RightNow)にサブスクライブします。 このアクションにより、正しい権限を持つOracle Service Cloud (RightNow)ユーザー・アカウントを作成できます。 接続ページで「Oracle Service Cloud (RightNow)アダプタ」接続を作成するときに、このユーザー・アカウントを指定します。 Oracle Service Cloudを参照してください。 「接続セキュリティの構成」を参照してください。
- 必要なOracle Service Cloud (RightNow)サービス・カタログ・サービスのWSDL URLを取得します。 このWSDLに、ビジネス・オブジェクトとイベント・サブスクリプションの両方のサポートを含めることができます。 「Oracle Service Cloud (RightNow) WSDLの取得」を参照してください。 「接続プロパティの構成」を参照してください。
-
イベントを交換するには、いくつかの構成ステップを実行する必要があります。 Oracle Service Cloud (RightNow)と別のアプリケーション間でイベントを交換する方法の例については、「Oracle Service Cloud (RightNow)アダプタでイベント・サブスクリプションを有効化」を参照してください。
-
トリガー「Oracle Service Cloud (RightNow)アダプタ」接続がビジネス・オブジェクトを選択する統合を作成する場合は、カスタム・イベント・ハンドラPHPスクリプトを作成するか、SOAPクライアントを使用して統合を起動する必要があります。
Oracle Service Cloud (RightNow) WSDLの取得
Oracle Service Cloud (RightNow) WSDLを取得する必要があります。 標準WSDLのみがサポートされています。 パートナWSDLはサポートされていません。
標準のWSDLに、ビジネス・オブジェクトとイベント・サブスクリプションの両方のサポートを含めることができます。 これにより、ビジネス・オブジェクトまたはイベント・サブスクリプションのいずれかを、Oracle Service Cloud (RightNow)アプリケーションからのリクエストとして受信できます。 イベント・サブスクリプションは、Oracle Service Cloud (RightNow)アプリケーションのバージョンが15.5のバージョン以上の場合にのみサポートされます(2015年5月リリース)。 そうでない場合は、構成ウィザードで選択のためにビジネス・オブジェクトのみが表示されます。
ノート:
次の詳細に注意してください。
-
Oracle Service Cloud (RightNow)リリース17.8のイベント・サブスクリプションの場合、Oracle Service Cloud (RightNow) WSDLバージョン1.3のみを使用してください。
-
Oracle Service Cloud (RightNow) Connect Web Services for SOAP APIを使用可能にするには、ユーザー・アカウントでPublic SOAP APIの権限が有効になっている必要があります。 公開SOAP APIのパーミッションによって、このプロファイルを持つスタッフ・メンバーは、アカウントまたはセッションの認証を通じて公開SOAP APIにアクセスできます。
-
「Oracle Service Cloud (RightNow)アダプタ」はパートナWSDL/一般WSDLをサポートしていません。 したがって、次のURLはサポートされません。
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services /soap?wsdl=generic
-
Oracle Service Cloud (RightNow) Cxアカウントから次の詳細を収集します:
-
ホスト
-
インタフェース名
-
ユーザー名とパスワード
-
-
Webブラウザを開き、次のURLのホスト名とインタフェースの詳細を適切に置き換えて入力し、標準WSDLを取得します。
For Oracle Service Cloud (RightNow) Sites On... 次の形式は、アダプタがアクセスできるようにします... 2017年5月以前のバージョン
-
Oracle Service Cloud (RightNow) WSDLの最新バージョン:
https://host_name/cgi-bin/interface.cfg/services/soap?wsdlたとえば:
https://integration-test.rightnowdemo.com/cgi-bin/integration_ test.cfg/services/soap?wsdl -
特定のAPIバージョンに関連するWSDL。 この形式は、新しいAPIバージョンで導入可能な後方互換性のない変更の影響から統合を保護するために推奨されます。
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typedたとえば:
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typed_v1.3
2017年8月以降のバージョン
-
Oracle Service Cloud (RightNow) WSDLの最新バージョン:
https://host_name/services/soap/connect/soap?wsdlたとえば:
https://integration-test.rightnowdemo.com/services/soap/connect/soap?wsdl -
特定のAPIバージョンに関連するWSDL。 この形式は、新しいAPIバージョンで導入可能な後方互換性のない変更の影響から統合を保護するために推奨されます。
https://host_name/services/soap/connect/soap?wsdl=typedたとえば:
https://integration-test.rightnowdemo.com/services/soap/connect/soap?wsdl=typed_v1.3 https://integration-test.rightnowdemo.com/services/soap/connect/soap?wsdl=typed_v1.4
-
ノート:
2017年8月以前に存在していた「URL」形式は、APIバージョンを明示的に指定すれば、引き続き動作します。 たとえば、次のURL形式を使用してOracle Integrationで作成されたOracle Service Cloud (RightNow)接続は、Oracle Service Cloud (RightNow)サイトが2017年8月以降にアップグレードされた後も引き続き機能します:https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typed_v1.3Oracle Service Cloud (RightNow)サイトが2017年8月以降にアップグレードされている場合、特定のAPIバージョンを持たない次の形式で作成されたOracle Service Cloud (RightNow)接続は機能しません:
https://host_name/cgi-bin/interface.cfg/services/soap?wsdlhttps://host_name/services/soap/connect/soap?wsdl=typed
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typedたとえば:
https://integration-test.rightnowdemo.com/services/soap/connect/soap?wsdl=typed_v1.3
https://integration-test.rightnowdemo.com/cgi-bin/integration_test.cfg/services/soap?wsdl=typed_v1.3Oracle Service Cloud (RightNow)アダプタでのイベント・サブスクリプションの有効化
「Oracle Service Cloud (RightNow)アダプタ」を使用してイベントをサブスクライブするには、一連の構成タスクを実行する必要があります。
ビジネス・イベントを公開する機能の検証
この統合は、Oracle Service Cloud (RightNow) Release 15.8と連携するように設計されています。
ビジネス・イベントを公開する機能を確認するには:
-
管理者権限を持つユーザーとしてOracle Service Cloud (RightNow)アプリケーションにログインします。
-
ナビゲーション・ペインで、「構成」→サイト構成→「構成の設定」をクリックします。
検索ページが表示されます。
-
構成ベース・セクションで、「サイト」オプションのみを選択します。
-
「キー」フィールドに、
EVENT%などのワイルドカード文字列を入力します。 -
「検索」をクリックします。
この検索により、EVENTで始まるすべての文字列が返されます。
EVENT_で始まる複数の構成パラメータが表示されている場合(たとえば、EVENT_NOTIFICATION_ENABLED)、イベントを公開する機能はOracle Service Cloud (RightNow)アプリケーションのこのバージョンで使用できます。
データ同期に関連付けられたすべての構成パラメータの表示
-
次の構成パラメータが表示されることを確認します。
-
EVENT_NOTIFICATON_ENABLED
-
EVENT_NOTIFICATION_MAPI_SEC_IP_RANGE
-
EVENT_NOTIFICATION_MAPI_USERNAME
-
EVENT_NOTIFICATION_MAPI_PASSWD
-
EVENT_NOTIFICATION_SUBSCRIBER_USERNAME
-
EVENT_NOTIFICATION_SUBSCRIBER_PASSWD
-
データ同期機能の有効化
データ同期機能を有効にするには:
デフォルトでは(新規にプロビジョニングされたOracle Service Cloud (RightNow)インスタンスでは)、データ同期機能は有効になっていません。 手動で有効にする必要があります(必要な場合)。
-
「結果」ページで、EVENT_NOTIFICATION_ENABLEDを選択します。
EVENT_NOTIFICATION_ENABLEDはブール・パラメータです。 これは、Oracle Service Cloud (RightNow)のビジネス・イベントを他の(外部)アプリケーションに公開するかどうかを制御するグローバル・スイッチです。 デフォルト値は「いいえ」で、これは、イベントは外部アプリケーションに公開されないことを意味します。
-
「EVENT_NOTIFICATION_ENABLED」タブで、「必須」リストから「はい」を選択します。
-
「保存して閉じる」ボタンをクリックします。
受信メッセージのIP範囲の設定(このステップはオプションです)
デフォルトでは、構成パラメータEVENT_NOTIFICATION_MAPI_SEC_IP_RANGEは空です。 このパラメータにより、指定したIPアドレスから送信されている場合にのみ着信メッセージを受信するようにできます。 これはオプションのパラメータです。 設定しない場合は、IP制限は強制されず、すべてのIPアドレスからのリクエストが受け入れられます。 パラメータに1つでも値がある(つまり、nullでない)場合は、指定したIPアドレスからのリクエストのみが受け入れられます。 リクエストを受け入れるアドレスを制限するには、アドレスをカンマ区切りの値として入力します。
-
構成パラメータのリストで、EVENT_NOTIFICATION_MAPI_SEC_IP_RANGEという名前のアイテムをクリックします。
-
表示されたページで、IPアドレスのリストをカンマ区切りの値として入力します。
-
「保存して閉じる」ボタンをクリックします。
受信リクエストに使用する資格証明の設定
ノート:
既存の(実際の)ユーザーと関連付けられていないユーザー名を指定する必要があります。 実際のユーザー名を指定すると、次のような詳細を含むエラー・メッセージが表示されます。Fault String : Invalid Field While processing Contact->ExternalReference(string). Fault Details : Oracle Integrationは、Oracle Service Cloud (RightNow)と通信するために資格証明を要求すると、EVENT_NOTIFICATION_MAPI_USERNAMEおよびEVENT_NOTIFICATION_MAPI_PASWDに関連付けられた資格証明を使用してOracle Service Cloud (RightNow)にメッセージを送信します。
-
EVENT_NOTIFICATION_MAPI_USERNAMEには、受信リクエストのヘッダーで指定されたユーザー名が保存されます。
-
EVENT_NOTIFICATION_MAPI_PASWDには、指定されたユーザー名に関連付けられたパスワードが保存されます。 パスワードは暗号化された形式で保存されます。
-
構成パラメータのリストで、EVENT_NOTIFICATION_MAPI_USERNAMEをクリックします。
-
ユーザー名を指定し、変更を保存します。
-
EVENT_NOTIFICATION_MAPI_PASSWDのパスワードを指定し、変更を保存します。
送信リクエストに使用する資格証明の設定
EVENT_NOTIFICATION_SUBSCRIBER_USERNAMEおよびEVENT_NOTIFICATION_SUBSCRIBER_PASSWDパラメータは、外部サブスクライバにイベント通知を送信する際にOracle Service Cloud (RightNow)が使用する資格証明を格納します。 いずれのパラメータにもデフォルト値はなく、それぞれに値を指定する必要があります。
-
EVENT_NOTIFICATION_SUBSCRIBER_USERNAMEには、イベントにサブスクライブされている外部アプリケーションに送信されるイベント通知メッセージで使用するユーザー名が保存されます。
-
EVENT_NOTIFICATION_SUBSCRIBER_PASSWDには、指定されたユーザー名に関連付けられたパスワードが保存されます。 パスワードは暗号化された形式で保存されます。
-
構成パラメータのリストで、EVENT_NOTIFICATION_SUBSCRIBER_USERNAMEをクリックします。
-
ユーザー名を指定し、変更を保存します。 ユーザーがOracle Integrationで定義されていることを確認します。
-
EVENT_NOTIFICATION_SUBSCRIBER_PASSWDのパスワードを指定します。
-
変更を保存します。