レシピをインストールする前に
Oracle Integrationを使用してこれらの外部システムに正常に接続し、SalesforceアカウントをWorkday顧客と同期するには、Salesforce、WorkdayおよびSlackインスタンスに対して次の構成タスクを実行する必要があります。
Salesforceの構成
Oracle Integrationを使用してSalesforceにアクセスし、Salesforceアカウントに関する情報を取得するには、Salesforceインスタンスで特定の構成タスクを実行する必要があります。
Oracle IntegrationのSalesforceにユーザー・アカウントを作成します。 このユーザー・アカウントの資格証明は、Oracle IntegrationでSalesforce接続を構成するときに使用します。
また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンも識別します。 さらに、デフォルト標準チャネルで変更イベント通知を生成するように変更データ取得を構成します。
「管理者」としてSalesforceインスタンスにログインし、次のタスクを実行します。
ノート:
ここで説明するステップは、SalesforceクラシックUIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。- API対応カスタム・ロールを作成します。 このロールは、後でOracle Integration用に作成するユーザー・アカウントに割り当てます。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインの管理セクションの下にある「ユーザーの管理」を展開します。
- 「プロファイル」をクリックします。
- プロファイル・ページで、「新規プロファイル」をクリックします。
- 表示されるページで、次のオプションを選択します。
- 「既存のプロファイル」フィールドで「標準ユーザー」を選択します。
- 新しいプロファイルの名前(たとえば、
API Enabled)を入力し、「保存」をクリックします。新しいプロファイルが保存され、新しいプロファイルの「プロファイルの詳細」ページが表示されます。
- 「プロファイルの詳細」ページで、「編集」をクリックします。
- 「プロファイル編集」ページで:
- 「管理者のアクセス許可」セクションまでスクロールし、「API有効」チェック・ボックスが選択されていることを確認します。
- 「標準オブジェクト権限」セクションまでスクロールし、次のアクションを実行します。
- 「アカウント」行で、「読取り」、「作成」、「編集」および「削除」の各ボックスをチェックしたままにします。 さらに、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バージョンを特定します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「開発」を展開し、APIをクリックします。
- 「API WSDL」ページで、「エンタープライズWSDLの生成」リンクをクリックします。WSDLが新しいブラウザ・タブに表示され、現在のAPIバージョンが2行目に存在します。 たとえば:
CopySalesforce.com Enterprise Web Services API Version 52.0 - APIバージョンを書き留めます。
- Salesforce設定ページで、次の手順を実行します:
- Salesforceインスタンス・タイプを識別します。
- URL
https://login.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「本番」です。 - URL
https://test.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「サンドボックス」です。
- URL
- Salesforceインスタンスで、変更イベント通知を生成する必要があるエンティティ(この場合は「アカウント」)を選択します。 エンティティを選択するには、
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「開発」を展開し、「変更データ取得」をクリックします。
- 「チェンジ・データ・キャプチャ」設定ページで、使用可能なエンティティのリストから「アカウント」をクリックし、右矢印アイコンをクリックします。
- エンティティを選択した後、「保存」をクリックします。
- Salesforce設定ページで、次の手順を実行します:
- Workday_Customer_IDを格納するSalesforceのカスタム・フィールドを作成します。
このレシピでは、WorkdayおよびSalesforceインスタンスに関連付けられた一意のIDを使用して、アカウント/顧客を同期します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「カスタマイズ」、「アカウント」の順に展開し、「フィールド」をクリックします。
- 「取引先フィールド」ページで、「アカウント・カスタム・フィールド」の&「関係」セクションまでスクロールし、「新規」をクリックします。
- 「新しいカスタム・フィールド」ページで:
- 「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。
- 新しいカスタム・フィールドについて次の詳細を入力します:
- フィールド・ラベルとして
Workday_Customer_IDと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。 - 文字長を指定します。
- オプションで、新規フィールドの説明を入力します。
- 「このフィールドを外部システムの一意のレコード識別子として設定」の横にあるチェック・ボックスを選択します。
- 「次へ」をクリックします。
- フィールド・ラベルとして
- フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示」チェック・ボックスを選択して、すべてのプロファイルの新しいフィールドに編集アクセス権を付与します。 「次へ」をクリックします。
- すべてのレイアウト・チェック・ボックスを選択したままにして、「保存」をクリックします。「アカウント・フィールド」ページで、アカウント・カスタム・フィールド&の関係セクションに追加された新しいフィールドを確認できます。
- Salesforce設定ページで、次の手順を実行します:
- Salesforce商談オブジェクトの下にカスタム・フィールドを作成し、WorkdayInvoiceIdを格納します。Salesforce商談のカスタム・フィールドを作成します。
- Salesforce設定ページで、次の手順を実行します:
- 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
- 「カスタマイズ」、「商談」の順に展開し、「フィールド」をクリックします。
- 「商談フィールド」ページで、「商談カスタム・フィールド&関係」セクションまでスクロールし、「新規」をクリックします。
- 「新しいカスタム・フィールド」ページで:
- 新しいカスタム・フィールドについて次の詳細を入力します:
- フィールド・ラベルとして
Workday_Invoice_Idと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。 - 文字長を指定します。
- オプションで、新規フィールドの説明を入力します。
- 「このフィールドを外部システムの一意のレコード識別子として設定」の横にあるチェック・ボックスを選択します。
- 「次へ」をクリックします。
- フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。
- 「次へ」をクリックします。
- すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。
「商談フィールド」ページで、商談カスタム・フィールド&の関係セクションに追加された新しいフィールドを確認できます。
- フィールド・ラベルとして
- 新しいカスタム・フィールドについて次の詳細を入力します:
- Salesforce設定ページで、次の手順を実行します:
- プラットフォーム・イベントのカスタム・フィールドを作成し、統合Oracle Salesforce Workday OpportunityToInvoice SynのSalesforceでapexトリガー・コードを更新します。プラットフォーム・イベントのカスタム・フィールドを作成するには:
- Salesforce設定ページの左側のナビゲーション・ペインで、「ビルド」、「開発」、「Lightningコンポーネント」、「プラットフォーム・イベント」の順にナビゲートします。
- 「プラットフォーム・イベント」ページで、「新規プラットフォーム・イベント」をクリックします。
- 「新規プラットフォーム・イベント」ページで、標準フィールドに入力し、必要に応じて説明を追加します。
- 「公開動作」で、イベント・メッセージがトランザクションで公開されるタイミングを選択します。
- 「コミット後に公開」:トランザクションが正常にコミットされた後にのみイベント・メッセージを公開します。 サブスクライバがパブリッシュ・トランザクションがコミットするデータに依存する場合は、このオプションを選択します。 たとえば、プロセスはイベント・メッセージを公開し、タスク・レコードを作成します。 イベントにサブスクライブされている2番目のプロセスが起動され、タスク・レコードの検索が想定されます。 この動作を選択するもう1つの理由は、トランザクションが失敗した場合にイベント・メッセージを公開しないことです。
- 「即時公開」:パブリッシュ・コールの実行時にイベント・メッセージをパブリッシュします。 トランザクションが成功するかどうかに関係なく、イベント・メッセージを公開する場合は、このオプションを選択します。 また、パブリッシャとサブスクライバが独立しており、サブスクライバがパブリッシャによってコミットされたデータに依存しない場合は、このオプションを選択します。 たとえば、即時公開の動作は、ロギング目的で使用されるイベントに適しています。 このオプションを使用すると、パブリッシャ・トランザクションによってデータがコミットされる前に、サブスクライバがイベント・メッセージを受信することがあります。
- 「保存」をクリックします。
- フィールドを追加するには、「カスタム・フィールド&関係」関連リストで、「新規」をクリックします。
- 「新規カスタム・フィールド」ページで、必要な「データ型」を選択し、「次」をクリックします。
- 新しいカスタム・フィールドに次の詳細を入力します:
- フィールド・ラベルを入力します。 入力したラベルに基づいてフィールド名が自動入力されることに注意してください。
- 文字長を指定します。
- オプションで、新規フィールドの説明を入力します。
- 「レコードを保存するには、常にこのフィールドに値が必要です」の横にあるチェック・ボックスを選択します。
- 各フィールドに必要な追加の詳細を入力し、「保存」をクリックします。
「カスタム・フィールド&関係」セクションに追加された新しいフィールドが表示されます。
- apexトリガー・コードでプラットフォーム・イベント用に作成されたカスタム・フィールドを更新します。コードのダウンロードと表示: ApexCode。