統合接続の構成
Oracle Fusion Serviceとサードパーティ・サーベイ・サプライヤ間の統合を次の順序で完了します。 この手順のステップでは、SurveyMonkeyを例として使用します。
-
パッケージをOracle Integrationにインポート
-
Oracle Fusion Serviceインスタンスへの接続の構成
-
接続を構成します。 この例では、接続はSurveyMonkeyに構成されています。
ノート:SurveyMonkeyを使用している場合は、この章の最後にあるSurveyMonkey API情報を確認してください。
-
Survey Oracle Integration接続の構成
パッケージのインポート
Oracle Integration管理者がパッケージをインポートします。
-
Oracle Integrationにサインインします。
-
ホーム・ページで、「統合」をクリックします。
-
「パッケージ」をクリックします。
-
パッケージ・ページで、「インポート」ボタンをクリックします。
-
パッケージのインポート・ウィンドウで、Oracle Marketplaceからダウンロードした
.par
ファイルを参照します。 -
「インポート」ボタンをクリックします。
-
.par
ファイルがパッケージ・ページにリストされます。パッケージ内の内容を表示するには、「名前」列のパッケージをクリックします。
-
「閉じる」をクリックします。
ノート:パッケージ内のファイルは、サード・パーティ・サーベイ・サプライヤとしてSurveyMonkeyを使用するための具体的な例です。 別のサプライヤを使用する場合は、参照例としてファイルを使用して独自のサプライヤを作成できます。
REST接続の構成
REST接続により、Oracle Integrationは、APIコールを使用してサードパーティ・サーベイ・サプライヤのサーベイ統合接続に接続できます。 サプライヤにはパブリックAPIが必要です。
-
Oracle Integrationホーム・ページから統合ページにナビゲートします。
-
「接続」をクリックします。
-
検索結果を絞り込むには、「検索」フィールドにSurveyと入力します。
-
Connectionsページで、REST接続を見つけてクリックします。 この例では、SurveyMonkeyを使用します。 REST接続「サーベイ統合SurveyMonkey接続」を検索します。
-
接続の構成をクリックし、サイトに適した接続URLの値を入力します。 たとえば、
https://api.surveymonkey.com
です。 -
「OK」をクリックします。
-
詳細ページで、「セキュリティ」に必要な値を入力します。
ノート:続行するには、クライアントIDおよびクライアント・シークレットの値が必要です。 これらの値は、サード・パーティ・サプライヤによって提供されます。 この例では、SurveyMonkeyです。
SurveyMonkeyの「設定」タブで、
OAuth Redirect URL
を次のように変更します:-
https://<Your OIC host>:443/icsapis/agent/oauth/callback
これは、ブラウザから取得したOIC URLです。 入手方法を次に示します。
-
Oracle Integrationにログインします。
-
ブラウザからOICホストをコピーして貼り付けます。 たとえば、
https://oicapps-oicdevqa.integration.ocp.oraclecloud.com
のようになります。
サプライヤSurveyMonkeyの場合、SurveyMonkeyの「設定」タブで次のスコープを選択する必要があります:
-
レスポンスの表示
-
レスポンス詳細の表示
-
ユーザーの表示
-
サーベイの表示
-
担当者の表示
-
回収担当の表示
-
担当者の作成/変更
-
回収担当の作成/変更
ヒント:SurveyMonkeyクライアントIDおよびクライアント・シークレットの値は、https://developer.surveymonkey.com/appsでSurveyMonkeyプライベート・アプリケーションの詳細を表示することで確認できます。
前のステップから続行し、セキュリティに必要な値を入力します。 次の表に値を示します。
必要なセキュリティ・プロパティ
値
セキュリティ・ポリシー
ドロップダウン・リストから
OAuth Custom Three Legged Flow
を選択承認リクエスト
サイトに適した認可リクエストを入力します。 例:
https://api.surveymonkey.com/oauth/authorize?response_type=code&redirect_uri=${redirect_uri}&client_id=xxx
ここで、
xxx
は、SurveyMonkeyから受信したクライアントIDです。アクセス・トークン・リクエスト
サイトに適したアクセス・トークン・リクエストを入力します。 例:
-X POST -H "Content-Type: application/x-www-form-urlencoded" -d "code=${auth_code}&redirect_uri=${redirect_uri}&grant_type=authorization_code&client_id=xxx&client_secret=yyy" https://api.surveymonkey.com/oauth/token
ここで、
xxx
はクライアントID、yyy
はクライアント・シークレットです -
-
「承諾の提供」をクリックします。 詳細は、この章のFAQを参照してください。
続行する前に、成功メッセージ(アクセス許可)が表示されることを確認します。
-
プロンプトが表示されたら、Oracle Integrationユーザー名とパスワードを入力します。
ノート:「認可リクエストが失敗しました」というエラーが発生した場合: リダイレクトURIが無効です。ブラウザURLからredirect_uriパラメータ値をコピーし、前のノートと同じOAuthリダイレクトURLを更新します。
-
SurveyMonkeyのユーザー名とパスワードを入力します。
-
同意の指定ウィンドウで「保存」をクリックします。
-
「テスト」をクリックします。
テストが成功したことを示すメッセージが表示されます。
-
「保存」をクリックします。
接続を使用している統合がリストされたウィンドウが表示されます。
-
ウィンドウで「保存」をクリックします。
-
サーベイ統合Oracle Integration接続ページで「閉じる」をクリックします。
インテグレーションで調査の特定の機能のAPIにアクセスするには、SurveyMonkeyプライベート・アプリケーションでアクティブなスコープ要件が必要です。
Oracle Fusion Serviceインスタンス接続の構成
この接続は、Fusion Serviceからサーベイ詳細を取得するためにOracle Integrationによって使用されます
-
Oracle Integrationホーム・ページで、「接続」をクリックします。
-
接続ページで、サーベイ統合Engagement Cloud接続を見つけます。
-
サーベイ統合Engagement Cloud「接続の詳細」ページに移動します。
-
「接続プロパティ」ウィンドウで、次の表に示すように値を入力します。
次のステップの表の値は、Oracle Integrationのプロビジョニング時に受信する電子メールにあります。
プロパティ名
プロパティ値
OSCサービス・カタログ
Oracle Fusion Serviceインスタンスのサービス・カタログURLを入力します。 次に例を示します : https:// <CRM domain WSDL URL host> /fndAppCoreServices/ServiceCatalogService?wsdl
OSC Event Catalog URL
オプションで、Oracle Fusion Serviceインスタンスのイベント・カタログURLを入力します。 次に例を示します : https:// <CRM domain host> /soa-infra
インタフェース・カタログURL
Oracle Fusion Serviceインスタンスのインタフェース・カタログURLを入力します。 たとえば:
https://<CRM domain host>/helpPortalApi/otherResources/latest/interfaceCatalogs
-
セキュリティ・リージョンで、次の表に示すように値を入力します。
プロパティ名
プロパティ値
ユーザー名
<FUSION SERVICE USER NAME>
パスワード
パスワードを入力します。
パスワードの確認
パスワードを再入力します。
-
「テスト」ボタンをクリックします。
ユーザー<FUSION SERVICE USER NAME>がディレクトリと同期するまでに時間がかかる場合があります。
テストが成功したことを示すメッセージが表示されます。
-
「保存」をクリックします。
接続を使用している統合がリストされたウィンドウが表示されます。
-
「保存」をクリックします。
-
サーベイ統合Oracle Integration接続ページで「閉じる」をクリックします。
サーベイ統合Oracle Integration接続の構成
この接続は、Fusion ServiceでOracle Integrationに接続するために使用されます。
-
Oracle Integrationホーム・ページで、「接続」をクリックします。
-
接続ページで、サーベイOIC接続を見つけます。
-
「サーベイOIC接続」をクリックします。
-
次の表に示すように値を入力します。
接続プロパティ
プロパティ値
接続タイプ
REST APIベースURL
接続URL
ブラウザのアドレス・バーに表示されるOracle Integrationホスト名のURLを入力します。 次に例を示します : https://oicapps-oicdevqa.integration.ocp.oraclecloud.com
-
セキュリティ・リージョンで、Oracle Integrationのユーザー名とパスワードの値を入力します。
-
パスワードが正しいことを確認し、「テスト」をクリックします。
テストが成功したことを示すメッセージが表示されます。
-
「保存」をクリックします。
接続を使用している統合がリストされたウィンドウが表示されます。
-
ウィンドウで「保存」をクリックします。
-
サーベイ統合Oracle Integration接続ページで「閉じる」をクリックします。