レシピをインストールする前に
Salesforceの構成
Oracle IntegrationからSalesforceにアクセスし、アカウント・レコードを作成/読取りするには、Salesforceインスタンスで特定の構成を実行する必要があります。
Oracle IntegrationのSalesforceにユーザー・アカウントを作成します。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 さらに、レシピのOracle Salesforce Zendesk Acc2Org Sync統合フローをトリガーするアウトバウンド・メッセージを作成し、Salesforceアカウントの作成時にアウトバウンド・メッセージを送信するワークフロールールを作成します。 最後に、Zendesk組織IDを格納するSalesforceアカウント・レコードのカスタム・フィールドを作成します。
ノート:
ここで説明するステップは、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組織のインスタンス・タイプの識別」を参照してください。
- Salesforceインスタンスで、このレシピのOracle Salesforce Zendesk Acc2Org Sync統合フローをトリガーするアウトバウンド・メッセージを作成します。
Salesforceの設定ページで、次の手順を実行します。
-
「オブジェクト」フィールドで「アカウント」を選択し、「次」をクリックします。
-
新しいアウトバウンド・メッセージについて次の詳細を入力します:
-
アウトバウンド・メッセージの名前を入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
-
オプションで、メッセージの説明を入力します。
-
「エンドポイントURL」フィールドに、次のURLを入力します:
https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL-R-SFDC_ACC_SYN_TO_ZEN_ORG/1.0/ここで、
OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名およびポートです(たとえば、oicinstance.example.com:443)。 -
「送信者」フィールドで、メッセージの送信に使用するユーザー・アカウントを選択します。
-
「送信するアカウント・フィールド」で、すべてのフィールドを選択し、「追加」をクリックします。
-
「保存」をクリックします。
-
新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。
-
- 次に、Salesforceアカウントの作成時に(以前に作成した)アウトバウンド・メッセージを送信するワークフロー・ルールを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。
-
「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。
「ワークフローについて」ページが表示された場合は、「続行」をクリックします。
-
- 結果ページで「新規ルール」をクリックします。
- 「新規ワークフロー・ルール」ページで:
-
「オブジェクト」フィールドで「アカウント」を選択し、「次」をクリックします。
-
新しいワークフロー・ルールについて次の詳細を入力します:
-
ルールの名前を入力します。
-
オプションで、ルールの説明を入力します。
-
「評価基準」セクションで、「作成済」ラジオ・ボタンを選択します。
-
「ルール基準」セクションで、「式がtrueに評価される」オプションを選択し、次のルール基準を定義します。
(Account: Account Name NOT EQUAL TO null) AND (Account: Description NOT EQUAL TO null) AND (Account: Zendesk_Org_Id EQUALS null) -
「保存&次」をクリックします。
-
-
次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
-
「既存の処理の選択」ページで:
-
「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
-
「使用可能なアクション」ボックスで、以前に作成したアウトバウンド・メッセージを選択します。 たとえば、
Outbound Message: name of your outbound messageです。 -
「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
-
「保存」をクリックします。
-
-
「完了」をクリックします。
新しいワークフロー・ルールが作成され、ブラウザに表示されます。
-
- 「アクティブ化」をクリックしてルールをアクティブ化します。
- Salesforce設定ページで、次の手順を実行します:
- 取引先レコードのカスタム・フィールドを作成します。
このレシピでは、Zendeskの組織レコードに関連付けられた一意のIDを使用して、Zendeskの組織をSalesforceのアカウントと同期します。 Zendesk IDを保持するSalesforceアカウント・レコードのカスタム・フィールドを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。
-
「カスタマイズ」、「アカウント」の順に展開し、「フィールド」をクリックします。
-
- 「取引先フィールド」ページで、「アカウント・カスタム・フィールド&関連」セクションまでスクロールし、「新規」をクリックします。
- 「新しいカスタム・フィールド」ページで:
-
「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。
-
新しいカスタム・フィールドについて次の詳細を入力します:
-
フィールド・ラベルとして
Zendesk_Org_Idと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。 -
長さとして
50と入力します。 -
オプションで、新規フィールドの説明を入力します。
-
「外部ID」チェックボックスを選択します。
-
「次へ」をクリックします。
-
-
フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。 「次へ」をクリックします。
-
すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。
「アカウント・フィールド」ページでは、「アカウント・カスタム・フィールドおよび関係」セクションに追加された新しいフィールドを確認できます。
-
- Salesforce設定ページで、次の手順を実行します: