レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、それらの間でレコードを同期するには、SalesforceおよびZendeskインスタンスで次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle IntegrationからSalesforceにアクセスし、コンタクト・レコードを作成/読取りするには、Salesforceインスタンスで特定の構成を実行する必要があります。
Oracle IntegrationのSalesforceにユーザー・アカウントを作成します。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 また、Salesforceコンタクト・レコード用のカスタム・フィールドを作成してZendeskユーザーIDを格納し、コンタクト・エンティティの変更イベント通知の生成を構成します。
ノート:
ここで説明するステップは、SalesforceクラシックUIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。管理者としてSalesforceインスタンスにログインし、次のタスクを実行します:
- 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に切り替えます。 - 新しいユーザー・アカウントのセキュリティ・トークンを生成します。 Oracle Integrationを使用してSalesforceにアクセスするには、このセキュリティ・トークンとパスワードが必要です。
- 新しいユーザーとしてサインインしたまま、ページ上部のユーザー名をクリックしてメニューを開きます。
- メニューで「自分の設定」をクリックします。
- 「設定(個人)」ページの「クイック・リンク」セクションで、「個人情報を編集」をクリックします。
- 表示されたページで、左側のナビゲーション・ペインの「セキュリティ・トークンのリセット」をクリックします。
-
「セキュリティ・トークンのリセット」ボタンをクリックします。
新しいセキュリティ・トークンが、アカウントに関連付けられた電子メール・アドレスに送信されます。 セキュリティ・トークンを書き留めます。
- Salesforceインスタンスで、ユーザー名を再度クリックし、メニューから「ログアウト」を選択します。 「管理者」として再度ログインします。
- 現在のSalesforce APIバージョンを特定します。 「Oracle Integration 3でのSalesforceアダプタの使用」の「現在のSalesforce APIバージョンを検索」を参照してください。
- Salesforceインスタンス・タイプを識別します。 「Oracle Integration 3でのSalesforceアダプタの使用」の「Salesforce組織のインスタンス・タイプの識別」を参照してください。
- コンタクト・レコードのカスタム・フィールドを作成します。
このレシピでは、Zendeskのユーザー・レコードに関連付けられた一意のIDを使用して、Zendeskユーザー・アカウントをSalesforceのコンタクトと同期します。 Zendesk IDを保持するSalesforceコンタクト・レコードのカスタム・フィールドを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。
-
「カスタマイズ」、「連絡先」の順に展開し、「フィールド」をクリックします。
-
- 「コンタクト・フィールド」ページで、「コンタクト・カスタム・フィールドおよび関係」セクションまでスクロールし、「新規」をクリックします。
- 「新しいカスタム・フィールド」ページで:
-
「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。
-
新しいカスタム・フィールドについて次の詳細を入力します:
-
フィールド・ラベルとして
Zendesk_User_Idと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。 -
長さとして
50と入力します。 -
オプションで、新規フィールドの説明を入力します。
-
「外部ID」チェックボックスを選択します。
-
「次へ」をクリックします。
-
-
フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。 「次へ」をクリックします。
-
すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。
「コンタクト・フィールド」ページでは、「コンタクト・カスタム・フィールドおよび関係」セクションに追加された新しいフィールドを確認できます。
-
- Salesforce設定ページで、次の手順を実行します:
- 連絡先エンティティの変更イベント通知の生成を構成します。この構成は、レシピのアプリケーション駆動統合フロー(Oracle Salesforce Zendesk Contact2User Sync)を正常に実行するために必要です。 この構成では、新しいコンタクトがSalesforceに作成されると、レシピのアプリケーションドリブン統合フローをトリガーする変更イベント通知が生成されます。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。
- 「開発」を展開し、「変更データ取得」をクリックします。
- 「チェンジ・データ・キャプチャ」ページで、使用可能なエンティティのリストから「連絡先」を選択し、「追加」をクリックします。
- 「保存」をクリックします。
- Salesforce設定ページで、次の手順を実行します: