レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、それらの間でレコードを同期するには、SalesforceおよびShopifyインスタンスに対して次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle IntegrationからSalesforceにアクセスし、アカウント・レコードを作成または読み取るには、Salesforceインスタンスで特定の構成を実行する必要があります。
Oracle Integrationのユーザー・アカウントをSalesforceに作成する必要があります。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 さらに、レシピの「Oracle Salesforce Shopifyアカウントと顧客との同期」統合フローをトリガーするアウトバウンド・メッセージを作成し、Salesforceアカウントの作成時にアウトバウンド・メッセージを送信するワークフロー・ルールを作成します。 最後に、Shopify顧客IDを格納するSalesforceアカウント・レコードのカスタム・フィールドを作成する必要があります。
「管理者」としてSalesforceインスタンスにログインし、次のタスクを実行します。
ノート:
ここで説明するステップは、SalesforceクラシックUIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。- API対応カスタム・ロールを作成します。 このロールは、後でOracle Integration用に作成するユーザー・アカウントに割り当てます。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインの管理セクションの下にある「ユーザーの管理」を展開します。
- 「プロファイル」をクリックします。
- プロファイル・ページで、「新規プロファイル」をクリックします。
- 表示されるページで、次のオプションを選択します。
- 「既存のプロファイル」フィールドで「標準ユーザー」を選択します。
- 新しいプロファイルの名前(たとえば、
API Enabled)を入力し、「保存」をクリックします。
新しいプロファイルが保存され、新しいプロファイルの「プロファイルの詳細」ページが表示されます。
- 「プロファイルの詳細」ページで、「編集」をクリックします。
- 「プロファイル編集」ページで:
- 「管理者のアクセス許可」セクションまでスクロールし、「API有効」チェック・ボックスが選択されていることを確認します。
- 「標準オブジェクトのアクセス許可」セクションまでスクロールし、次のアクションを実行します。
- 「アカウント」行で、「読取り」ボックスにチェックマークを入れたままにします。 さらに、「作成」ボックス、「編集」ボックスおよび「削除」ボックスを選択します。
- ページの最後までスクロールし、「保存」をクリックします。
- 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 Shopifyアカウントと顧客との同期」統合フローをトリガーするアウトバウンド・メッセージを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。
「ワークフローについて」ページが表示された場合は、「続行」をクリックします。
- 結果ページで「新規アウトバウンド・メッセージ」をクリックします。
- 「新規アウトバウンド・メッセージ」ページで:
- 「オブジェクト」フィールドで「アカウント」を選択し、「次」をクリックします。
- 新しいアウトバウンド・メッセージについて次の詳細を入力します:
- アウトバウンド・メッセージの名前を入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
- オプションで、メッセージの説明を入力します。
- 「エンドポイントURL」フィールドに、次のURLを入力します:
https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v2/flows/salesforce/project/ORCL-R-SFDC_SHOPIFY_ACC_CUSTOMER/ORCL-R-SFDC_ACC_SYN_TO_SHOPY_CUS/1.0ここで、
OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名とポートです(たとえば、oicinstance.example.com:443)。 - 「送信者」フィールドで、メッセージの送信に使用するユーザー・アカウントを選択します。
- 「送信するアカウント・フィールド」で、必須フィールドを選択し、「追加」をクリックします。
- 「保存」をクリックします。
新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。 - Salesforce設定ページで、次の手順を実行します:
- 次に、Salesforceアカウントが作成または更新されたときに(以前に作成した)アウトバウンド・メッセージを送信するワークフロー・ルールを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。
- 結果ページで「新規ルール」をクリックします。
- 「新規ワークフロー・ルール」ページで:
- 「オブジェクト」フィールドで「アカウント」を選択し、「次」をクリックします。
- 新しいワークフロー・ルールについて次の詳細を入力します:
- ルールの名前を入力します。
- オプションで、ルールの説明を入力します。
- 「評価基準」セクションで、「作成され、編集されるたびに」ラジオ・ボタンを選択します。
- 「ルール基準」セクションで、「計算式はtrueに評価されます」オプションを選択し、次のルール基準を定義します:
(Account: Account Name STARTS WITH Shop) AND (Account: ShopifyCustomer_id EQUALS empty) - 「保存&次」をクリックします。
- 次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
- 「既存の処理の選択」ページで:
- 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
- 「使用可能なアクション」ボックスで、以前に作成したアウトバウンド・メッセージ(
Outbound Message: <name of your outbound message>など)を選択します。 - 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
- 「保存」をクリックします。
- 「完了」をクリックします。
新しいワークフロー・ルールが作成され、ブラウザに表示されます。
- 「アクティブ化」をクリックしてルールをアクティブ化します。
- Salesforce設定ページで、次の手順を実行します:
- 取引先レコードのカスタム・フィールドを作成します。
このレシピでは、Shopifyの顧客レコードに関連付けられた一意のIDを使用して、Shopifyの顧客をSalesforceアカウントと同期します。 Shopify IDを保持するSalesforceアカウント・レコードのカスタム・フィールドを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「カスタマイズ」、「アカウント」の順に展開し、「フィールド」をクリックします。
- 「取引先フィールド」ページで、「アカウント・カスタム・フィールド」の&「関係」セクションまでスクロールし、「新規」をクリックします。
- 「新しいカスタム・フィールド」ページで:
- 「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。
- 新しいカスタム・フィールドについて次の詳細を入力します:
- フィールド・ラベルとして
ShopifyCustomer_idと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。 - 長さとして
50と入力します。 - オプションで、新規フィールドの説明を入力します。
- 「外部ID」チェックボックスを選択します。
- 「次へ」をクリックします。
- フィールド・ラベルとして
- フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。 「次へ」をクリックします。
- すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。
- 前述のステップa、bおよびcを繰り返して、「Eメール」という別のカスタム・フィールドを作成します。 ただし、ステップcで、サブステップを除外して「外部ID」チェック・ボックスを選択します。
「アカウント・フィールド」ページで、アカウント・カスタム・フィールド&の関係セクションに追加された新しいフィールドを確認できます。 - Salesforce設定ページで、次の手順を実行します: