1. Oracle Integration Generation 2スタート・ガイド
  2. レシピ・リファレンス
  3. Customer Relationship Management (CRM)レシピ
  4. Oracle CPQトランザクションとSalesforce見積間のデータの同期
  5. レシピをインストールする前に
機械翻訳について

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

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

  1. Oracle CPQの構成
  2. Salesforceの構成

Oracle CPQの構成

Oracle Integrationを使用してOracle CPQインスタンスにアクセスし、データが同期されるようにするには、Oracle CPQインスタンスで特定の構成タスクを実行する必要があります。

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

  1. Oracle CPQサイトからSOAP WSDLを取得します。

    Oracle Integrationは、Oracle CPQトランザクションWSDLを使用して、Oracle CPQで提供される有効なデータと操作を理解します。

    詳細は、「Oracle IntegrationでのOracle CPQアダプタの使用」の「接続を作成するための前提条件」を参照してください。

  2. Oracle CPQのRESTカタログURLを取得します。

    このURLは、アウトバウンド接続用のOracle CPQアプリケーションのビジネス・リソースにアクセスするために使用されます。 これはhttp(s)://site_URL/rest/v3/metadata-catalogとしてフォーマットされます。site_URLはOracle CPQサイトのベースURLです。

    詳細は、「Oracle IntegrationでのOracle CPQアダプタの使用」の「接続を作成するための前提条件」を参照してください。

  3. 「Webサービスのみ」権限を持つOracle Integrationのユーザー・アカウントを作成します。
    1. Oracle CPQホーム・ページで、タイトル・バーの左上にある「管理振出人」をクリックします。
    2. 管理ナビゲーション・ペインで、「ユーザー」を展開し、「内部ユーザー」をクリックします。

      「ユーザー管理リスト」ページが表示されます。

    3. 「ユーザー管理リスト」ページからユーザーを追加します。
      詳細は、Oracle CPQオンライン・ヘルプの「ユーザーの設定」を参照してください。
  4. 統合を作成して、Oracle CPQからOracle Integrationへの接続を作成します。
    1. Oracle CPQホーム・ページで、タイトル・バーの左上にある「管理振出人」をクリックします。
    2. 管理ナビゲーション・ペインで、「統合プラットフォーム」を展開し、「統合センター」をクリックします。
    3. 「統合センター」ページで、「統合の作成」をクリックします。
    4. 「タイプ」ドロップダウン・リストから、Integration Cloud Serviceを選択します。
    5. 表示されるページで、次の詳細を入力し、「テスト」をクリックして接続が機能するかどうかを確認します。
      フィールド 入力する情報
      名前 適切な名前を入力します。
      Variable Name

      このフィールドは自動的に入力されます。

      変数名に含めることができるのは、英数字とアンダースコアのみです。 エントリは保存前に変更できますが、保存後は読取り専用です。

      検出URL Oracle IntegrationインスタンスURLを入力します。
      ユーザー名 Oracle Integrationインスタンスにアクセスするためのユーザー名を入力します。
      パスワード Oracle Integrationインスタンスにアクセスするためのパスワードを入力します。
    6. 「統合の有効化」を選択し、「保存」をクリックします。
  5. 作成した統合を既存のプロセスにリンクします。
    1. Oracle CPQホーム・ページで、タイトル・バーの左上にある「管理振出人」をクリックします。
    2. 管理ナビゲーション・ペインで、「コマースとドキュメント」を展開し、「プロセス定義」をクリックします。
    3. プロセス・ページで、統合をリンクするプロセスを選択します。 「ナビゲーション」ドロップダウン・リストから「統合」を選択し、「リスト」をクリックします。
    4. 結果の統合ページで、「追加」をクリックします。
    5. 「統合タイプの選択」ページで、Integration Cloud Serviceを選択し、「次」をクリックします。
    6. 「統合の編集」ページで、次の詳細を入力し、追加をクリックします:
      フィールド 入力する情報
      名前

      統合クラウド・サービスの名前を入力します。 たとえば、Salesforce Quote Updateです。

      Variable Name 変数名を入力します。 たとえば、salesforceQuoteUpdate
      タイムアウト タイムアウトをミリ秒単位で入力します。 次に例を示します。 30000
      説明 必要に応じて、適切な説明を入力します。
      アクション 「エクスポート」オプションを選択します。
      サービス サービスを選択します。 たとえば、「Oracle CPQ Salesforce Transaction2Quote同期」です。
  6. 統合をトリガーするアクションを指定します。
    1. プロセス・ページで、統合にリンクされたプロセスを選択します。 「ナビゲーション」ドロップダウン・リストから「ドキュメント」を選択し、「リスト」をクリックします。
    2. 「ドキュメント・リスト」ページの「トランザクション」行で、「ナビゲーション」ドロップダウン・リストから「アクション」を選択し、「リスト」をクリックします。
    3. 「アクション・リスト」ページで、「保存のコピー」リンクをクリックします。
    4. 「管理者アクション」ページで、「統合」タブをクリックします。
    5. 「統合リスト」ボックスで、ステップaで作成した統合を選択し、>矢印をクリックして「選択した統合」ボックスに追加します。
    6. 「更新」をクリックします。
  7. Salesforce IDを構成します。
    Salesforce IDを属性として設定し、Oracle CPQトランザクションを更新する必要がある場合に、Salesforce IDを参照として使用して必要な変更を特定できるようにします。
    1. プロセス・ページで、統合にリンクされたプロセスを選択します。 「ナビゲーション」ドロップダウン・リストから「ドキュメント」を選択し、「リスト」をクリックします。
    2. 「ドキュメント・リスト」ページの「トランザクション」行で、「ナビゲーション」ドロップダウン・リストから「属性」を選択し、「リスト」をクリックします。
    3. 「属性リスト」ページで、ページの最後までスクロール・ダウンし、「追加」をクリックします。
    4. 「属性エディタ」ページで、次の詳細を入力し、追加をクリックします:
      フィールド 入力する情報
      ラベル

      属性名を入力します。 たとえば、QuoteIDです。

      Variable Name

      変数名を入力します。 たとえば、quoteIDです。

      属性タイプ

      「テキスト」を選択します。

    5. テキスト属性エディタで、「説明」フィールドに適切な説明を入力し、「更新」をクリックします。
  8. プロセスをデプロイします。
    統合を作成し、必要なアクションと属性で構成したので、統合にリンクされたプロセスをデプロイできます。
    1. プロセス・ページで、統合にリンクされたプロセスを選択します。 「ナビゲーション」ドロップダウン・リストから「デプロイメント・センター」を選択し、「リスト」をクリックします。
    2. 「デプロイメント・センター」ページで、「イベント・タイプ」の下の「デプロイ」を選択し、「イベントの追加」をクリックします。
    3. 「リフレッシュ」をクリックします。
      デプロイメントが完了すると、「最終デプロイ」時間が更新されます。

Salesforceの構成

Oracle Integrationを使用してSalesforceにアクセスし、商談見積りデータが同期されていることを確認するには、Salesforceインスタンスで特定の構成タスクを実行する必要があります。

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

ノート:

ここで説明するステップは、Salesforce Classic UIに適用されます。 SalesforceインスタンスでLightning Experience UIを使用している場合は、クラシックUIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
  1. API対応カスタム・ロールを作成します。
    1. Salesforceの設定ページで:
      1. 左側のナビゲーション・ペインの管理セクションの下にある「ユーザーの管理」を展開します。
      2. 「プロファイル」をクリックします。
    2. プロファイル・ページで新規プロファイルをクリックし、表示されるページで次を完了します:
      1. 「既存のプロファイル」フィールドで「標準ユーザー」を選択します。
      2. 新しいプロファイルの名前を入力します(例: API Enabled)。
      3. 「保存」をクリックします。
    3. 「プロファイルの詳細」ページで、編集をクリックし、結果の「プロファイル編集」ページで次を完了します:
      1. 「管理者のアクセス許可」セクションまでスクロールし、「API有効」チェック・ボックスが選択されていることを確認します。
      2. 「標準オブジェクトのアクセス許可」セクションまでスクロールし、次の情報を入力します:
        • 「アカウント」行で、「読取り」、「作成」、「編集」および「削除」を選択したままにします。 さらに、ViewAllを選択します。
        • 「連絡先」行で、「読取り」、「作成」、「編集」および「削除」を選択したままにします。 さらに、ViewAllを選択します。
        • 「価格台帳」行で、「読取り」を選択したままにします。 さらに、「作成」、「編集」および「削除」を選択します。
        • 「製品」行で、「読取り」を選択したままにします。 さらに、「作成」、「編集」および「削除」を選択します。
      3. ページの最後までスクロール・ダウンして、「保存」をクリックします。
  2. Oracle Integrationのユーザー・アカウントを作成し、ステップ1で作成したカスタム・ロールをこのアカウントに割り当てます。

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

    ノート:

    Oracle Integrationのユーザー・アカウントをすでに作成している場合は、API対応のカスタム・ロールを既存のアカウントに割り当てることができます。
    1. 「API有効」プロファイルの「プロファイルの詳細」ページで、「ユーザーの表示」をクリックします。
    2. 表示されるページで、「新規ユーザー」をクリックします。
    3. ユーザー名とパスワードを作成します。
      1. 「新規ユーザー」ページで、ユーザーの名と姓を入力します。 たとえば、Integration User05です。
      2. 「Eメール」フィールドに、有効な電子メール・アドレスを入力します。

        入力した電子メール・アドレスは、「ユーザー名」フィールドに自動的に移入されます。 ユーザー名に注意してください。

      3. 「ユーザー・ライセンス」フィールドで、Salesforceを選択します。
      4. 「プロファイル」フィールドで、前に作成したプロファイル(「API有効」)を選択します。
      5. ページの最後までスクロールし、「新規パスワードを生成し、ユーザーに即時通知」チェック・ボックスが選択されていることを確認して、「保存」をクリックします。

        ユーザー・アカウントが作成され、検証電子メールが送信されます。

      6. Salesforceの電子メール・メッセージの「アカウントの検証」ボタンをクリックします。 新しいユーザー・アカウントのパスワードを設定するために、Salesforceインスタンスにリダイレクトされます。
      7. パスワードを設定し、それをノートします。
      その後、新しいアカウントを使用してSalesforceインスタンスにサインインします。

      ノート:

      Lighting Experience UIが表示されている場合は、Salesforce Classic UIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
    4. 新しいユーザー・アカウントのセキュリティ・トークンを生成します。 Oracle Integrationを使用してSalesforceにアクセスするには、このセキュリティ・トークンとパスワードが必要です。
      1. 新しいユーザーとしてサインインし、ページ上部のユーザー名をクリックしてメニューを開きます。
      2. メニューから「自分の設定」をクリックします。
      3. 「自分の設定」ページの「クイック・リンク」セクションで、「個人情報の編集」をクリックします。
      4. 表示されたページの左側のナビゲーション・ペインで、「セキュリティ・トークンのリセット」をクリックします。
      5. 「セキュリティ・トークンのリセット」ボタンを選択します。

        新しいセキュリティ・トークンが、アカウントに関連付けられた電子メール・アドレスに送信されます。 セキュリティ・トークンを書き留めます。

      6. Salesforceインスタンスで、ユーザー名を再度クリックし、メニューから「ログアウト」を選択します。 「管理者」として再度ログインします。
  3. 現在のSalesforce APIバージョンを特定します。
    1. Salesforceの設定ページで:
      1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
      2. 「開発」を展開し、APIをクリックします。
    2. 「API WSDL」ページで、「エンタープライズWSDLの生成」リンクをクリックします。
      WSDLが新しいブラウザ・タブに表示され、現在のAPIバージョンが2行目に存在します。 例: 
      Salesforce.com Enterprise Web Services API Version 52.0
    3. APIバージョンを書き留めます。
  4. Salesforceインスタンス・タイプを識別します。
    1. URL https://login.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「本番」です。
    2. URL https://test.salesforce.comを使用してSalesforceアカウントにログインする場合、インスタンス・タイプは「サンドボックス」です。
  5. 標準価格表のSalesforce IDを指定します。
    1. Salesforceの設定ページで、「製品」タブをクリックします。
    2. メンテナンス・セクションまでスクロールし、「価格台帳の管理」をクリックします。
    3. 結果の「価格台帳」ページで、「価格表名」列の「標準価格表」をクリックします。
      標準価格台帳詳細ページが表示されます。
    4. 「標準実習」ページURLで15文字のSalesforce IDを見つけます。 たとえば、URLがhttps://<instance name>.my.salesforce.com/01s0o75956AleUQの場合、Salesforce IDは01s0o75956AleUQです。
      Salesforce IDに注意してください。 Oracle Integrationで参照表を構成するときに必要になります。
  6. Oracle CPQ Cloudの参照値を構成します。
    1. Salesforce設定ページの左側のナビゲーション・ペインで、ビルド・セクションまでスクロールし、「カスタマイズ」、「引用符」の順に展開し、「フィールド」をクリックします。
    2. 結果の「見積りフィールド」ページで、見積カスタム・フィールドの&関係セクションまでスクロールし、「新規」をクリックします。
    3. 「新しいカスタム・フィールド」ページで、「テキスト」ラジオ・ボタンを選択し、「次」をクリックします。
    4. 新しいカスタム・フィールドについて次の詳細を入力し、次をクリックします:
      フィールド 入力する情報
      フィールド・ラベル フィールド名を入力します。 たとえば、TransactionId_CPQです。
      Length テキスト・フィールドに許可する最大長を入力します。 次に例を示します。 255
      フィールド名 このフィールドは自動的に入力されます。
      説明 必要に応じて、カスタム・フィールドの説明を入力します。
    5. フィールド・レベルのセキュリティを確立ページで、「表示可能」を選択し、「次」をクリックします。
    6. 次のページですべてのチェック・ボックスが選択されたままにして、「保存」をクリックします。
    「見積りフィールド」ページでは、見積カスタム・フィールド&の関係セクションに追加された新しいカスタム・フィールドを確認できます。
  7. Salesforceプラットフォーム・イベントを構成します。 プラットフォーム・イベントは、Salesforce商談見積の変更について外部システムに通知します。
    1. Salesforce設定ページの左側のナビゲーション・ペインで、ビルド・セクションまでスクロールし、「開発」を展開し、「プラットフォーム・イベント」をクリックします。
    2. 「プラットフォーム・イベント」ページで、「新規プラットフォーム・イベント」をクリックします。
    3. 「新規プラットフォーム・イベント」ページで、次の情報を入力します:
      フィールド 入力する情報
      ラベル フィールド・ラベルを入力します。 たとえば、TransactionId_CPQです。
      複数形 フィールド・ラベルの複数形を入力します。
      オブジェクト名 このフィールドは自動的に入力されます。
      説明 必要に応じて、新しいプラットフォーム・イベントの説明を入力します。
      行動の公開
      次のオプションのいずれかを選択します。
      • コミット後に公開

        イベント・メッセージは、トランザクションが正常にコミットされた後にのみ公開されます。 その後、データがコミットされると、サブスクライバはイベント・メッセージを受信します。 トランザクションが失敗した場合、イベント・メッセージは公開されません。

      • 即時公開

        イベント・メッセージは、トランザクションが成功したかどうかに関係なく、公開コールの実行時に公開されます。 その後、サブスクライバは、データがコミットされる前にイベント・メッセージを受信します。

    4. 「デプロイメント・ステータス」セクションで、「デプロイ済」を選択します。
    5. 「保存」をクリックします。
      「プラットフォーム・イベント」ページには、イベントの詳細が表示されます。
    6. カスタム・フィールドの作成
      1. 「プラットフォーム・イベント」ページのカスタム・フィールド&の関係セクションで、「新規」をクリックします。
      2. 結果の「新しいカスタム・フィールド」ページで、「テキスト」ラジオ・ボタンを選択し、「次」をクリックします。
      3. 次の詳細を入力します:
        フィールド 入力する情報
        フィールド・ラベル フィールド・ラベルの名前を入力します。 たとえば、QuoteIDです。
        Length テキスト・フィールドに許可する最大長を入力します。 次に例を示します。 255
        フィールド名 このフィールドは自動的に入力されます。
        説明 必要に応じて、カスタム・フィールドの説明を入力します。
      4. 「保存」をクリックします。
    7. ステップaを繰り返して、別のカスタム・フィールドを作成 - fですが、別のラベル名を入力します(例: TransactionId_CPQ)。
  8. プラットフォーム・イベントをトリガーするプロセスを作成およびアクティブ化します。
    1. Salesforce設定ページの左側のナビゲーション・ペインで、ビルド・セクションまでスクロールします。 「作成」、「ワークフローと承認」の順に展開し、Process Builderをクリックします。
    2. プロセスの作成
      1. 「Process Builder」ページで、「新規」をクリックします。
      2. 「新規プロセス」ダイアログに次の詳細を入力します:
        フィールド 入力する情報
        プロセス名 プロセスの名前を入力します。 たとえば、CPQです。
        API名 このフィールドは自動的に入力されます。
        説明 必要に応じて、プロセスに適した説明を入力します。
        プロセスは次の場合に開始されます 「レコードの変更」を選択します。
      3. 「保存」をクリックします。

        「プロセス・ビルダー」ページにデフォルトのプロセス・フローが表示されるようになりました。

      4. フローチャートで「基準の追加」ディシジョン・ボックスをクリックします。

        プロセス・ビルダーには、この「アクション・グループ」セクションの条件の定義が表示されます。

      5. TRUE矢印の横にある「即時アクション」ボックスで、「アクションの追加」をクリックします。

        プロセス・ビルダーに、アクションを追加するための選択および「処理の定義」セクションが表示されます。

      6. 「保存」をクリックします。
    3. プロセス・トリガーを構成します。 前のステップでプロセスを作成したら、プラットフォーム・イベントをトリガーするために必要なルールを構成する必要があります。
      1. プロセス・フローチャートで「オブジェクトの追加」ボックスをクリックします。
      2. オブジェクトの選択およびプロセスの開始時期の指定ペインが開き、次を選択して「保存」をクリックします。
        フィールド 入力する情報
        オブジェクト 「引用符」を選択します。
        プロセスを起動します 「レコードが作成または編集されたとき」を選択します。
    4. プロセス条件を追加します。 関連するアクションを実行するために真にする必要がある条件を指定できます。
      1. ディシジョン・ボックスで「基準の追加」をクリックします。
      2. 開いたこの「アクション・グループ」ペインの条件の定義で、次の情報を指定します。
        フィールド 入力する情報
        条件名 基準の名前を入力します。
        アクションを実行する基準 「条件を満たしています」を選択します。
      3. ユーザーによるプロセスのトリガーを制限する条件を作成します。
        「条件の設定」表で、次を構成します:
        フィールド 入力する情報
        フィールド LastModifiedBy.CommunityNicknameを検索して選択します。
        演算子 「次と等しくない」を選択します。
        タイプ 「文字列」を選択します。
        値 見積を作成または編集するSalesforceユーザーのニックネームを入力します。
      4. 別の条件を作成して、ライン・アイテムが使用可能なときにプロセスがトリガーされるようにします。
        「行の追加」をクリックし、次を構成します:
        フィールド 入力する情報
        フィールド LineItemCountを検索して選択します。
        演算子 「次より大きい」を選択します。
        タイプ 「数値」を選択します。
        値 0と入力します。
      5. 「条件」オプション・リストから、「すべての条件が満たされる(AND)」を選択します。
      6. 「上級」ドロップダウン・リストを展開し、「指定した変更がレコードに対して行われた場合にのみ処理を実行しますか?」の場合はYesを選択します。
      7. 「保存」をクリックします。
    5. プロセスに処理を追加します。
      1. TRUE矢印の横にある「即時アクション」ボックスで、「アクションの追加」をクリックします。
      2. 選択して「処理の定義」ペインで、「アクション・タイプ」ドロップダウン・リストから「レコードの作成」を選択します。
      3. 「レコード・タイプ」ドロップダウン・リストから、ステップ7で作成したプラットフォーム・イベントの名前を入力します。

        「フィールド値の設定」セクションで、次の値を使用して2つの行を作成します:

        行1について、次の値を設定します:

        フィールド 入力する情報
        フィールド ステップ6のサブステップfで作成したカスタム・フィールドの名前を入力します。 たとえば、QuoteIDです。
        タイプ 「フィールド参照」を選択します。
        値 このフィールドをクリックし、結果のフィールドの選択ダイアログで、ドロップダウンから「見積ID」を選択し、「選択」をクリックします。

        行2について、次の値を設定します:

        フィールド 入力する情報
        フィールド ステップ6のサブステップgで作成したカスタム・フィールドの名前を入力します。 たとえば、TransactionId_CPQです。
        タイプ 「フィールド参照」を選択します。
        値 このフィールドをクリックし、結果のフィールドの選択ダイアログで、ドロップダウンからTransactionId_CPQを選択し、「選択」をクリックします。
      4. 「保存」をクリックします。
    6. プロセスをアクティブ化します。
      1. 「Process Builder」ページの右上にある「アクティブ化」をクリックします。
      2. 「バージョンのアクティブ化」ダイアログで、「確認」をクリックします。