レシピをインストールする前に

Oracle Integrationを使用してこれらの外部システムに正常に接続し、SalesforceコンタクトをServiceNowユーザーと同期するには、SalesforceインスタンスおよびServiceNowインスタンスに対して次の構成タスクを実行する必要があります。

Salesforceの構成

Oracle Integrationを使用してSalesforceにアクセスし、作成または更新されたSalesforceコンタクトに関するデータを取得するには、Salesforceインスタンスで特定の構成を実行する必要があります。

Oracle Integrationのユーザー・アカウントは、Salesforce Salesforceに作成する必要があります。このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。

また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンを識別する必要があります。さらに、レシピの統合フローをトリガーするアウトバウンド・メッセージを作成し、Salesforceコンタクトが作成または更新されたときにアウトバウンド・メッセージを送信するワークフロー・ルールを作成します。最後に、ServiceNowユーザーIDを格納するSalesforceコンタクト・レコードのカスタム・フィールドを作成します。

「管理者」としてSalesforceインスタンスにログインし、次のタスクを実行します。

ノート:

ここで説明するステップは、SalesforceクラシックUIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。

API対応カスタム・ロールを作成します。このロールは、後でOracle Integration用に作成するユーザー・アカウントに割り当てます。
1. Salesforce設定ページで、次の手順を実行します:
  1. 左側のナビゲーション・ペインの「管理」セクションの下の「ユーザーの管理」を展開します。
  2. 「プロファイル」をクリックします。
2. プロファイル・ページで、「新規プロファイル」をクリックします。
3. 表示されるページで、次のオプションを選択します。
  1. 「既存のプロファイル」フィールドで「標準ユーザー」を選択します。
  2. 新しいプロファイルの名前(API Enabledなど)を入力し、「保存」をクリックします。
  新しいプロファイルが保存され、新しいプロファイルの「プロファイルの詳細」ページが表示されます。
4. 「プロファイルの詳細」ページで、「編集」をクリックします。
5. 「プロファイル編集」ページで:
  1. 「管理者のアクセス許可」セクションまでスクロールし、「API有効」チェック・ボックスが選択されていることを確認します。
  2. 「標準オブジェクトのアクセス許可」セクションまでスクロールし、次のアクションを実行します。
    - 「連絡先」行で、「読取り」、「作成」、「編集」および「削除」の各ボックスをチェックしたままにします。さらに、ViewAllチェック・ボックスを選択します。
  3. ページの最後までスクロールし、「保存」をクリックします。
Oracle Integrationのユーザー・アカウントを作成し、以前に作成したカスタム・ロールをこのアカウントに割り当てます。

ノート:
Oracle Integrationのユーザー・アカウントをすでに作成している場合は、API対応のカスタム・ロールを既存のアカウントに割り当てることができます。
1. 「API有効」プロファイルの「プロファイルの詳細」ページで、「ユーザーの表示」をクリックします。
2. 結果ページで「新規ユーザー」をクリックします。
3. 「新規ユーザー」ページで:
  1. ユーザーの名と姓を入力します。たとえば、Integration User05です。
  2. 「Eメール」フィールドに、有効な電子メール・アドレスを入力します。
    
    入力した電子メール・アドレスは、「ユーザー名」フィールドに自動的に移入されます。このユーザー名を書き留めます。
  3. 「ユーザー・ライセンス」フィールドで、Salesforceを選択します。
  4. 「プロファイル」フィールドで、前に作成したプロファイル(「API有効」)を選択します。
  5. ページの最後までスクロールし、「新規パスワードを生成し、ユーザーに即時通知」チェック・ボックスが選択されていることを確認して、「保存」をクリックします。
    
    ユーザー・アカウントが作成され、アカウントに指定した電子メール・アドレスに検証電子メールが送信されます。
4. 対応するEメール・アカウントにログインし、SalesforceからのEメール・メッセージの「アカウントの検証」ボタンをクリックします。新しいユーザー・アカウントのパスワードを設定するために、Salesforceインスタンスにリダイレクトされます。
5. パスワードを設定し、同じことを書き留めます。
  その後、新しいアカウントでSalesforceインスタンスにサインインします。
  
  ノート:
  
  ライティング・エクスペリエンスUIが表示された場合は、SalesforceクラシックUIに切り替えます。「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
6. 新しいユーザー・アカウントのセキュリティ・トークンを生成します。 Oracle Integrationを使用してSalesforceにアクセスするには、このセキュリティ・トークンとパスワードが必要です。
  1. 新しいユーザーとしてサインインし、ページ上部のユーザー名をクリックしてメニューを開きます。
  2. メニューで「自分の設定」をクリックします。
  3. 「自分の設定」ページの「クイック・リンク」セクションで、「個人情報の編集」をクリックします。
  4. 表示されるページで、左側のナビゲーション・ペインの「セキュリティ・トークンのリセット」をクリックします。
  5. 「セキュリティ・トークンのリセット」ボタンをクリックします。
    
    新しいセキュリティ・トークンが、アカウントに関連付けられた電子メール・アドレスに送信されます。セキュリティ・トークンを書き留めます。
  6. Salesforceインスタンスで、ユーザー名を再度クリックし、メニューから「ログアウト」を選択します。「管理者」として再度ログインします。
現在のSalesforce APIバージョンを特定します。「Oracle Integration 3でのSalesforceアダプタの使用」の「現在のSalesforce APIバージョンを検索」を参照してください。
Salesforceインスタンス・タイプを識別します。「Oracle Integration 3でのSalesforceアダプタの使用」の「Salesforce組織のインスタンス・タイプの識別」を参照してください。
コンタクト・レコードのカスタム・フィールドを作成します。

このレシピでは、ServiceNowのユーザー・レコードに関連付けられた一意のIDを使用して、ServiceNowユーザーとSalesforceコンタクトを同期します。 ServiceNow IDを保持するSalesforceコンタクト・レコードのカスタム・フィールドを作成します。
1. Salesforce設定ページで、次の手順を実行します:
  1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
  2. 「カスタマイズ」、「連絡先」の順に展開し、「フィールド」をクリックします。
2. 「担当者フィールド」ページで、「連絡先カスタム・フィールド&関係」セクションまでスクロールし、「新規」をクリックします。
3. 「新しいカスタム・フィールド」ページで:
  1. 「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。
  2. 新しいカスタム・フィールドについて次の詳細を入力します:
    - フィールド・ラベルとしてServiceNowUserIdと入力します。フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。
    - 長さとして50と入力します。
    - オプションで、新規フィールドの説明を入力します。
    - 「外部ID」チェックボックスを選択します。
    - 「次へ」をクリックします。
  3. フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。「次へ」をクリックします。
  4. すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。
「担当者フィールド」ページで、「アカウント・カスタム・フィールド&関係」セクションに追加された新しいフィールドを確認できます。
Salesforceインスタンスで、このレシピの統合フローをトリガーするアウトバウンド・メッセージを作成します。
1. Salesforce設定ページで、次の手順を実行します:
  1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
  2. 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。
  「ワークフローについて」ページが表示された場合は、「続行」をクリックします。
2. 結果ページで「新規アウトバウンド・メッセージ」をクリックします。
3. 「新規アウトバウンド・メッセージ」ページで:
  1. 「オブジェクト」フィールドで「担当者」を選択し、「次」をクリックします。
  2. 新しいアウトバウンド・メッセージについて次の詳細を入力します:
    - アウトバウンド・メッセージの名前を入力します。「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
    - オプションで、メッセージの説明を入力します。
    - エンドポイントURLフィールドに、次のURLを入力: https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL-R-SFDC_CON_TO_SNOW_USER_SYC/1.0/
      
      ここで、OIC_FQDNおよびOIC_SSL_PORT は、Oracle Integrationインスタンスの完全修飾ドメイン名およびポートです(たとえば、oicinstance.example.com:443)。
    - 「送信者」フィールドで、メッセージの送信に使用するユーザー・アカウントを選択します。
    - 「送信するコンタクト・フィールド」で、すべてのフィールドを選択し、「追加」をクリックします。
    - 「保存」をクリックします。
新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。
次に、Salesforceコンタクトが作成または更新されたときに(以前に作成した)アウトバウンド・メッセージを送信するワークフロー・ルールを作成します。
1. Salesforce設定ページで、次の手順を実行します:
  1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
  2. 「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。
  「ワークフローについて」ページが表示された場合は、「続行」をクリックします。
2. 結果ページで「新規ルール」をクリックします。
3. 「新規ワークフロー・ルール」ページで:
  1. 「オブジェクト」フィールドで「担当者」を選択し、「次」をクリックします。
  2. 新しいワークフロー・ルールについて次の詳細を入力します:
    - ルールの名前を入力します。
    - オプションで、ルールの説明を入力します。
    - 「評価基準」セクションで、「作成され、編集されるたびに」ラジオ・ボタンを選択します。
    - 「ルール基準」セクションで、計算式はtrueに評価されますオプションを選択し、次のルール基準を定義: Contact: First NameCONTAINSSF
    - 「保存&次」をクリックします。
  3. 次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
  4. 「既存の処理の選択」ページで:
    - 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
    - 「使用可能なアクション」ボックスで、以前に作成したアウトバウンド・メッセージ(Outbound Message: <name of your outbound message>など)を選択します。
    - 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
    - 「保存」をクリックします。
  5. 「完了」をクリックします。
  新しいワークフロー・ルールが作成され、ブラウザに表示されます。
4. 「アクティブ化」をクリックしてルールをアクティブ化します。

ServiceNowの構成

Oracle IntegrationでServiceNow接続を構成するときに、管理アカウント資格証明またはカスタム・アカウント資格証明を使用できます。

管理アカウントを使用しない場合は、カスタム統合ユーザーを作成し、必要なロールと権限をユーザーに割り当てます。カスタム・ユーザーの作成の詳細は、「Oracle Integration 3でのServiceNowアダプタの使用」の「接続を作成するための前提条件」を参照してください。