レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、SalesforceとOracle B2C Serviceの間でコンタクト・レコードを同期するには、SalesforceおよびOracle B2C Serviceインスタンスで次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle Integrationを使用してSalesforceにアクセスし、作成または更新されたSalesforceコンタクトに関するデータを取得するには、Salesforceインスタンスで特定の構成を実行する必要があります。
Oracle Integrationのユーザー・アカウントをSalesforceに作成する必要があります。 このユーザー・アカウントの資格証明は、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 APIバージョンを検索」を参照してください。
- Salesforceインスタンス・タイプを識別します。 「Salesforce組織のインスタンス・タイプの識別」を参照してください。
- Oracle B2C Serviceの連絡先IDを格納するカスタム・フィールドを作成します。
- Salesforce設定ページで、次の手順を実行します:
-
左側のナビゲーション・ペインのBuildセクションにスクロールします。
-
「カスタマイズ」、「連絡先」の順に展開し、「フィールド」をクリックします。
-
- 「コンタクト・フィールド」ページで、「コンタクト・カスタム・フィールドおよび関係」セクションまでスクロールし、「新規」をクリックします。
- 「テキスト」ラジオ・ボタンを選択し、「次へ」をクリックします。
- 新しいカスタム・フィールドに次の詳細を入力し、「次へ」をクリックします。
フィールド 入力する情報 フィールド・ラベル フィールド名を入力します。 たとえば、 RNContact_Idです。Length テキスト・フィールドの最大長を入力します。 たとえば、 255です。フィールド名 このフィールドは自動的に入力されます。 説明 カスタム・フィールドの説明を入力します。 - フィールド・レベルのセキュリティを確立ページで、「表示可能」を選択し、「次」をクリックします。
- 次のページですべてのチェック・ボックスが選択されたままにして、「保存」をクリックします。
- Salesforce設定ページで、次の手順を実行します:
- Salesforceプラットフォーム・イベントを構成します。 プラットフォーム・イベントは、Salesforceコンタクト・レコードの変更について外部システムに通知します。
- 「Salesforceの設定」ページの左側のナビゲーション・ペインで、「ビルド」セクションまでスクロールし、「開発」を展開して「プラットフォーム・イベント」をクリックします。
- 「プラットフォーム・イベント」ページで、「新規プラットフォーム・イベント」をクリックします。
- 「新規プラットフォーム・イベント」ページで、次の情報を入力します:
フィールド 入力する情報 ラベル フィールドのラベルを入力します。 たとえば、 ContactCreate_PEです。複数形 ラベル・フィールドの複数形を入力します。 オブジェクト名 このフィールドは自動的に入力されます。 説明 必要に応じて、新しいプラットフォーム・イベントの説明を入力します。 公開動作 次のオプションのいずれかを選択します。 -
- コミット後に公開: イベント・メッセージは、トランザクションが正常にコミットされた後にのみ公開されます。 その後、データがコミットされると、サブスクライバはイベント・メッセージを受信します。 トランザクションが失敗した場合、イベント・メッセージは公開されません。
- 即時パブリッシュ:トランザクションが成功するかどうかに関係なく、パブリッシュ・コールの実行時にイベント・メッセージがパブリッシュされます。 その後、サブスクライバは、データがコミットされる前にイベント・メッセージを受信します。
-
- 「デプロイメント・ステータス」セクションで、「デプロイ済」を選択します。
- 「保存」をクリックします。
- Oracle B2C Service連絡先レコードの詳細を格納するカスタム・フィールドを作成します。
- 「プラットフォーム・イベント」ページの「カスタム・フィールドおよび関係」セクションで、「新規」をクリックします。
- 結果の「新規カスタム・フィールド」ページで、「テキスト」ラジオ・ボタンを選択し、「次へ」をクリックします。
- カスタム・フィールドに次の詳細を入力します。
フィールド 入力する情報 フィールド・ラベル フィールド名を入力します。 たとえば、 ContactId_PEです。フィールド名 このフィールドは自動的に入力されます。 Length テキスト・フィールドの最大長を入力します。 たとえば、 255です。説明 カスタム・フィールドの説明を入力します。 - 「保存」をクリックします。
- ステップa-dを繰り返して、必要な数のカスタム・フィールドを作成します。 たとえば、
FirstName_PE、LastName_PE、MailingCity_PE、PostalCode_PEなどのカスタム・フィールドを作成できます。
- プラットフォーム・イベントをトリガーするプロセスを作成およびアクティブ化します。
- Salesforceの「Setup」ページの左側のナビゲーション・ペインで、「Build」セクションまでスクロールします。 「作成」、「ワークフローと承認」の順に展開し、Process Builderをクリックします。
- プロセスの作成
- 「Process Builder」ページで、「新規」をクリックします。
- 「新規プロセス」ダイアログに次の詳細を入力します:
フィールド 入力する情報 プロセス名 プロセスの名前を入力します。 API名 このフィールドは自動的に入力されます。 説明 必要に応じて、プロセスの説明を入力します。 プロセスは次の場合に開始されます 「レコードの変更」を選択します。 - 「保存」をクリックします。
- プロセス・トリガーを構成します。
- プロセス・フローチャートで「オブジェクトの追加」をクリックします。
- オブジェクトの選択およびプロセスの開始時期の指定ペインが開き、次を選択して「保存」をクリックします。
フィールド 入力する情報 オブジェクト 「連絡先」を選択します。 プロセスを起動します 「レコードが作成または編集されたとき」を選択します。
- プロセス条件を追加します。 関連するアクションを実行するために真にする必要がある条件を指定できます。
- デシジョン・ボックスで「基準の追加」をクリックします。
- 開いたこの「アクション・グループ」ペインの条件の定義で、次の情報を指定します。
フィールド 入力する情報 条件名 基準の名前を入力します。 アクションを実行する基準 「条件を満たしています」を選択します。 - 統合ユーザーがプロセスをトリガーできないようにする条件を作成します。
フィールド 入力する情報 フィールド Contact.FirstNameを検索して選択します。演算子 「NULL」を選択します。 タイプ 「ブール」を選択します。 値 「False」を選択します。 - 別の条件を作成して、統合ユーザーによるプロセスのトリガーを制限します。
フィールド 入力する情報 フィールド Contact.LastNameを検索して選択します。演算子 「NULL」を選択します。 タイプ 「ブール」を選択します。 値 「False」を選択します。 - 「条件」オプション・リストから、「すべての条件が満たされている(AND)」を選択します。
- 「詳細」ドロップダウン・リストを展開し、「指定した変更がレコードに対して行われた場合にのみアクションを実行しますか。」で「はい」を選択します。
- プロセスにアクションを追加します。
- TRUE矢印の横にある「即時アクション」ボックスで、「アクションの追加」をクリックします。 アクションの名前を入力します。 たとえば、
CreateContact_Triggerです。 - 「レコードの作成」ペインの「レコード・タイプ」で、ステップ6で前に作成したプラットフォーム・イベントを選択します。
- 「フィールド値の設定」セクションで、ステップ7で前に作成したすべてのカスタム・フィールドの行を作成します。
カスタム・フィールドの行を作成するには:
- 「フィールド」に、カスタム・フィールドの名前を入力します。
- 「タイプ」で、「フィールド参照」を選択します。
- 「値」で、カスタム・フィールドの対応する値を選択します。
前述のステップを繰り返して、すべてのカスタム・フィールドに行を作成します。
- 「保存」をクリックします。
- TRUE矢印の横にある「即時アクション」ボックスで、「アクションの追加」をクリックします。 アクションの名前を入力します。 たとえば、
- プロセスをアクティブ化します。
- 「Process Builder」ページの右上にある「アクティブ化」をクリックします。
- 「バージョンのアクティブ化」ダイアログで、「確認」をクリックします。
Oracle B2C Serviceの構成
Oracle Integrationを使用してOracle B2C Serviceにアクセスし、Salesforceコンタクトに対応するコンタクト・レコードを作成するには、管理者としてOracle B2C Serviceにログインし、特定の前提条件タスクを完了する必要があります。 「Oracle Integration 3でのOracle Service Cloud (RightNow)アダプタの使用」の「接続を作成するための前提条件」を参照してください。