レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、ケースのチケットを作成するには、SalesforceおよびZendeskインスタンスで次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle IntegrationからSalesforceにアクセスし、ケース・レコードを読み取るには、Salesforceインスタンスで特定の構成を実行する必要があります。
Oracle IntegrationのSalesforceにユーザー・アカウントを作成します。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 さらに、レシピの統合フローをトリガーするアウトバウンド・メッセージを作成し、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設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「開発」を展開し、APIをクリックします。
- 「API WSDL」ページで、「エンタープライズWSDLの生成」リンクをクリックします。WSDLが新しいブラウザ・タブに表示され、現在のAPIバージョンが2行目に存在します。 たとえば:
Salesforce.com Enterprise Web Services API Version 52.0 - APIバージョンを書き留めます。
- Salesforce設定ページで、次の手順を実行します:
- Salesforceインスタンス・タイプを識別します。
- URL https://login.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「本番」です。
- URL https://test.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプはサンドボックスです。
- Salesforceインスタンスで、このレシピの統合フローをトリガーするアウトバウンド・メッセージを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。
「ワークフローについて」ページが表示された場合は、「続行」をクリックします。 - 結果ページで「新規アウトバウンド・メッセージ」をクリックします。
- 「新規アウトバウンド・メッセージ」ページで:
- 「オブジェクト」フィールドで「ケース」を選択し、「次」をクリックします。
- 新しいアウトバウンド・メッセージについて次の詳細を入力します:
- アウトバウンド・メッセージの名前を入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
- オプションで、メッセージの説明を入力します。
- エンドポイントURLフィールドに、次のURLを入力:
https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL-R-SFDC_CASETOZEN_TICKET_SYN/1.0/ここで、
OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名とポートです(たとえば、oicinstance.example.com:443)。 - 「送信するユーザー」フィールドで、メッセージを送信するユーザー・アカウントを選択します。
- 「送信するアカウント・フィールド」で、すべてのフィールドを選択し、「追加」をクリックします。
- 「保存」をクリックします。
新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。
- Salesforce設定ページで、次の手順を実行します:
- 次に、Salesforceケースの作成時に(以前に作成した)アウトバウンド・メッセージを送信するワークフロー・ルールを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。
「ワークフローについて」ページが表示された場合は、「続行」をクリックします。
- 結果ページで「新規ルール」をクリックします。
- 「新規ワークフロー・ルール」ページで:
- 「オブジェクト」フィールドで「ケース」を選択し、「次」をクリックします。
- 新しいワークフロー・ルールについて次の詳細を入力します:
- ルールの名前を入力します。
- オプションで、ルールの説明を入力します。
- 「評価基準」セクションで、「作成され、編集されるたびに」ラジオ・ボタンを選択します。
- 「ルール基準」セクションで、「計算式はtrueに評価されます」オプションを選択し、次のルール基準を定義します:
(Case: Number NOT EQUAL TO null) - 「保存&次」をクリックします。
- 次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
- 「既存の処理の選択」ページで:
- 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
- 「使用可能なアクション」ボックスで、以前に作成したアウトバウンド・メッセージを選択します。たとえば、
.Outbound Message: <name of your outbound message> - 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
- 「保存」をクリックします。
- 「完了」をクリックします。
新しいワークフロー・ルールが作成され、ブラウザに表示されます。 - 「アクティブ化」をクリックしてルールをアクティブ化します。
- Salesforce設定ページで、次の手順を実行します:
Zendeskの構成
Oracle IntegrationからZendeskにアクセスし、チケットを作成するには、ZendeskインスタンスにOAuthクライアントを作成する必要があります。 「Oracle Integration 3でのZendeskアダプタの使用」の「OAuthクライアントの作成」を参照してください。