レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、サーベイをSalesforceの連絡先に電子メールで送信するには、SalesforceおよびSurveyMonkeyインスタンスに対して次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle Integrationを使用してSalesforceにアクセスし、Salesforceケースから連絡先の電子メール・アドレスを取得するには、Salesforceインスタンスで特定の構成タスクを実行する必要があります。
Oracle IntegrationのSalesforceにユーザー・アカウントを作成します。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 さらに、Oracle Integrationでレシピをトリガーするアウトバウンド・メッセージを作成し、Salesforceケースがクローズされたときにアウトバウンド・メッセージを送信するワークフロールールを作成します。
「管理者」としてSalesforceインスタンスにログインし、次のタスクを実行します。
ノート:
ここで説明するステップは、SalesforceクラシックUIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
- API対応カスタム・ロールを作成します。 このロールは、後でOracle Integration用に作成するユーザー・アカウントに割り当てます。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインの管理セクションの下にある「ユーザーの管理」を展開します。
-
「プロファイル」をクリックします。
-
- プロファイル・ページで、「新規プロファイル」をクリックします。
- 表示されるページで、次のオプションを選択します。
-
「既存のプロファイル」フィールドで「標準ユーザー」を選択します。
-
新しいプロファイルの名前(
API Enabledなど)を入力し、「保存」をクリックします。
新しいプロファイルが保存され、新しいプロファイルの「プロファイルの詳細」ページが表示されます。
-
- 「プロファイルの詳細」ページで、「編集」をクリックします。
- 「プロファイル編集」ページで:
-
「管理者のアクセス許可」セクションまでスクロールし、「API有効」チェック・ボックスが選択されていることを確認します。
-
「標準オブジェクトのアクセス許可」セクションまでスクロールし、次のアクションを実行します。
-
「アカウント」行で、「読取り」、「作成」、「編集」および「削除」の各ボックスをチェックしたままにします。 さらに、ViewAllチェック・ボックスを選択します。
-
「連絡先」行で、「読取り」、「作成」、「編集」および「削除」の各ボックスをチェックしたままにします。 さらに、ViewAllチェック・ボックスを選択します。
-
「価格台帳」行で、「読取り」ボックスを選択したままにします。 さらに、「作成」、「編集」および「削除」チェック・ボックスを選択します。
-
「製品」行で、「読取り」ボックスを選択したままにします。 さらに、「作成」、「編集」および「削除」チェック・ボックスを選択します。
-
-
ページの最後までスクロールし、「保存」をクリックします。
-
- Salesforce設定ページで、次の手順を実行します:
- Oracle Integrationのユーザー・アカウントを作成し、以前に作成したカスタム・ロールをこのアカウントに割り当てます。
ノート:
Oracle Integrationのユーザー・アカウントをすでに作成している場合は、API対応のカスタム・ロールを既存のアカウントに割り当てることができます。- 「API有効」プロファイルの「プロファイルの詳細」ページで、「ユーザーの表示」をクリックします。
- 結果ページで「新規ユーザー」をクリックします。
- 「新規ユーザー」ページで:
-
ユーザーの名と姓を入力します。 たとえば、
Integration User05です。 -
「Eメール」フィールドに、有効な電子メール・アドレスを入力します。
入力した電子メール・アドレスは、「ユーザー名」フィールドに自動的に移入されます。 このユーザー名を書き留めます。
-
「ユーザー・ライセンス」フィールドで、Salesforceを選択します。
-
「プロファイル」フィールドで、前に作成したプロファイル(「API有効」)を選択します。
-
ページの最後までスクロールし、「新規パスワードを生成し、ユーザーに即時通知」チェック・ボックスが選択されていることを確認して、「保存」をクリックします。
ユーザー・アカウントが作成され、アカウントに指定した電子メール・アドレスに検証電子メールが送信されます。
-
- 対応するEメール・アカウントにログインし、SalesforceからのEメール・メッセージの「アカウントの検証」ボタンをクリックします。 新しいユーザー・アカウントのパスワードを設定するために、Salesforceインスタンスにリダイレクトされます。
- パスワードを設定し、それを書き留めます。その後、新しいアカウントでSalesforceインスタンスにサインインします。
ノート:
ライティング・エクスペリエンスUIが表示された場合は、SalesforceクラシックUIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
- 新しいユーザー・アカウントのセキュリティ・トークンを生成します。 Oracle Integrationを使用してSalesforceにアクセスするには、このセキュリティ・トークンとパスワードが必要です。
-
新しいユーザーとしてサインインし、ページ上部のユーザー名をクリックしてメニューを開きます。
-
メニューで「自分の設定」をクリックします。
-
「自分の設定」ページの「クイック・リンク」セクションで、「個人情報の編集」をクリックします。
-
表示されたページで、左側のナビゲーション・ペインの「セキュリティ・トークンのリセット」をクリックします。
-
「セキュリティ・トークンのリセット」ボタンをクリックします。
新しいセキュリティ・トークンが、アカウントに関連付けられた電子メール・アドレスに送信されます。 セキュリティ・トークンを書き留めます。
-
Salesforceインスタンスで、ユーザー名を再度クリックし、メニューから「ログアウト」を選択します。 「管理者」として再度ログインします。
-
- 現在のSalesforce APIバージョンを特定します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインのBuildセクションまでスクロールします。
-
「開発」を展開し、APIをクリックします。
-
- 「API WSDL」ページで、「エンタープライズWSDLの生成」リンクをクリックします。 WSDLが新しいブラウザ・タブに表示され、現在のAPIバージョンが2行目に存在します。 たとえば:
Salesforce.com Enterprise Web Services API Version 52.0 - APIバージョンを書き留めます。
- Salesforce設定ページで、次の手順を実行します:
- Salesforceインスタンス・タイプを識別します。
- URL https://login.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「本番」です。
- URL https://test.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「サンドボックス」です。
- Salesforceインスタンスで、このレシピの統合フローをトリガーするアウトバウンド・メッセージを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインのBuildセクションまでスクロールします。
-
「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。
「ワークフローについて」ページが表示された場合は、「持続」をクリックします。 -
- 結果ページで「新規アウトバウンド・メッセージ」をクリックします。
- 「新規アウトバウンド・メッセージ」ページで:
-
「オブジェクト」フィールドで「ケース」を選択し、「次」をクリックします。
-
新しいアウトバウンド・メッセージについて次の詳細を入力します:
-
メッセージの名前として
SurveyMonkeyCaseと入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。 - オプションで、メッセージの説明を入力します。
- 「エンドポイントURL」フィールドに、次のURLを入力します。
https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL_R_SFDC_SM_CASE_CLOSE/1.0/.ここで、
OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名とポートです(たとえば、oicinstance.example.com:443)。 -
「送信するユーザー」フィールドで、メッセージを送信するユーザー・アカウントを選択します。
-
「送信するケース・フィールド」で、すべてのフィールドを選択します。
-
「保存」をクリックします。
-
-
新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。 - Salesforce設定ページで、次の手順を実行します:
- 次に、Salesforceケースがクローズされたときに(以前に作成した)アウトバウンド・メッセージを送信するワークフロールールを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインのBuildセクションまでスクロールします。
-
「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。
「ワークフローについて」ページが表示された場合は、「持続」をクリックします。 -
- 結果ページで「新規ルール」をクリックします。
- 「新規ワークフロー・ルール」ページで:
-
「オブジェクト」フィールドで「ケース」を選択し、「次」をクリックします。
-
新しいワークフロー・ルールについて次の詳細を入力します:
-
ルール名として
SurveyMonkeyCaseと入力します。 -
オプションで、ルールの説明を入力します。
-
「評価基準」セクションで、「作成され、編集されるたびに」ラジオ・ボタンを選択します。
-
「ルール基準」セクションで、「基準を満たしています」オプションが選択された状態で、「フィールド」ドロップダウン・リストから「ケース: クローズ済」を選択し、「演算子」フィールドから「等しい」を選択し、「値」フィールドに
Trueと入力します。 -
「保存&次」をクリックします。
-
-
次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
-
「既存の処理の選択」ページで:
- 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
- 「使用可能なアクション」ボックスで、前に作成したアウトバウンド・メッセージ(たとえば、
Outbound Message: SurveyMonkeyCase)を選択します。 - 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
- 「保存」をクリックします。
- 「完了」をクリックします。
新しいワークフロー・ルールが作成され、ブラウザに表示されます。 -
- 「アクティブ化」をクリックしてルールをアクティブ化します。
- Salesforce設定ページで、次の手順を実行します:
SurveyMonkeyの構成
SurveyMonkeyインスタンスで次の前提条件タスクを実行する必要があります。
- SurveyMonkeyアプリケーションを作成および構成します。
- SurveyMonkey Developerコンソール(https://developer.surveymonkey.com/)にログインします。
- SurveyMonkey Developerホームページのタイトル・バーの「自分のアプリケーション」をクリックします。
- 「自分のアプリケーション」ページで、「新しいアプリケーションを追加」をクリックします。
- 表示される「APP CREATION」ダイアログで、アプリケーションの名前を「アプリケーションのニックネーム」フィールドに入力し、「アプリのタイプ」オプションとして「プライベート・アプリ」を選択します。
- 「アプリケーションの作成」をクリックします。SurveyMonkeyは、アプリケーションを作成し、クライアントIDおよびシークレットの詳細をリシュリング・ページに表示します。
- SETTINGSをクリックしてアプリケーション設定を開き、「OAuthリダイレクトURL」フィールドにOracle IntegrationインスタンスのURLを入力します。
- SurveyMonkey API資格証明を取得します。
- SETTINGSをクリックして、アプリケーションの設定を開きます。
- 「資格証明」セクションまでスクロールし、「クライアントID」および「機密」フィールドの値を確認します。
「シークレット」フィールドの目のアイコンをクリックして、値を表示します。 Oracle IntegrationからSurveyMonkey接続を構成する際には、SurveyMonkey API資格証明(クライアントIDおよびシークレット値)が必要です。 - スコープを選択します。
- 「スコープ」セクションで、次のスコープを選択します:
- サーベイの作成/変更
- コレクタの作成/変更
- レスポンスの作成/変更
- 調査の表示
- コレクタの表示
- 回答の表示
- 応答詳細の表示
- 「スコープの更新」をクリックします。
スコープが正常に更新されたという確認メッセージが表示されます。
- 「スコープ」セクションで、次のスコープを選択します:
- 応答を受信するサーベイをSurveyMonkeyに作成します。
- SurveyMonkeyアカウント(https://www.surveymonkey.com/user/sign-in/)にログインします。
- SurveyMonkeyダッシュボードで、タイトル・バーの「CREATE SURVEY」をクリックします。
- 左側の新規サーベイの作成ペインにある次のオプションのいずれかを使用して、サーベイを作成します:
- 一から開始します。
- 過去のサーベイのコピー
- ターゲット・レスポンスの購入
- 質問のインポート
- テンプレートから開始
- ビルド
SurveyMonkeyヘルプ・センター(https://help.surveymonkey.com/)の「設計および管理」トピックで、サーベイの作成および管理に関連する情報を検索します。作成したサーベイの名前を書き留めます。
- 「次」をクリックして、サーベイをプレビューします。
- 「次」をクリックして、「COLLECT RESPONSES」セクションを表示します。
- 「アンケートの送信方法」をクリックします。「COLLECT RESPONSES」セクションには、レスポンスを収集できる様々な方法が表示されます。
- 「サーベイ・リンクの共有」をクリックします。
「COLLECT RESPONSES」セクションには、webリンク・コレクタの詳細が表示されます。 コレクタの名前を書き留めます。 たとえば、
Web Link 1です。