1. Oracle Integration Generation 2スタート・ガイド
  2. レシピ・リファレンス
  3. Customer Relationship Management (CRM)レシピ
  4. SalesforceからDocuSignにドキュメントを送信
  5. レシピをインストールする前に
機械翻訳について

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

Oracle Integrationを使用してこれらの外部システムに正常に接続し、SalesforceからDocuSignにドキュメントを転送するには、SalesforceおよびDocuSignインスタンスで次の構成タスクを実行する必要があります。

  1. Salesforceの構成
  2. DocuSignの構成

Salesforceの構成

Oracle Integrationを使用してSalesforceにアクセスし、商談に添付されたドキュメントを取得するには、Salesforceインスタンスで特定の構成タスクを実行する必要があります。

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

また、Salesforceインスタンス・タイプおよび現在のSalesforce APIバージョンを識別します。 さらに、Oracle Integrationでレシピをトリガーするアウトバウンド・メッセージを作成し、Salesforce商談がステータス「クローズ済受注」に移動されたときにアウトバウンド・メッセージを送信するワークフロー・ルールを作成します。 最後に、レコードへの添付ファイルのSalesforceファイルとしてアップロードを有効にします。

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

ノート:

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

    ノート:

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

        入力した電子メール・アドレスは、「ユーザー名」フィールドに自動的に移入されます。 このユーザー名を書き留めます。

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

        ユーザー・アカウントが作成され、アカウントに指定した電子メール・アドレスに検証電子メールが送信されます。

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

      ノート:

      Lighting Experience UIが表示されている場合は、Salesforce Classic UIに切り替えます。 「Lightning ExperienceとSalesforce Classicのトグルまたは切替え」を参照してください。
    6. 新しいユーザー・アカウントのセキュリティ・トークンを生成します。 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インスタンスで、このレシピの統合フローをトリガーするアウトバウンド・メッセージを作成します。
    1. Salesforceの設定ページで:
      1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
      2. 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。

      「ワークフローについて」ページが表示された場合は、「持続」をクリックします。

    2. 結果ページで「新規アウトバウンド・メッセージ」をクリックします。
    3. 「新規アウトバウンド・メッセージ」ページで:
      1. 「オブジェクト」フィールドで「商談」を選択し、「次」をクリックします。
      2. 新しいアウトバウンド・メッセージについて次の詳細を入力します:
        • メッセージの名前としてOpportunityDocusignと入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
        • オプションで、メッセージの説明を入力します。
        • 「エンドポイントURL」フィールドに、次のURLを入力します:

          https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL-R-SFDC_DOCUSIGN_OPPO_DOCSIG/1.0/。

          ここで、OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名とポートです(例:oicinstance.example.com:443)。

        • 「送信者」フィールドで、メッセージの送信に使用するユーザー・アカウントを選択します。
        • 「送信する商談フィールド」で、Idが「選択したフィールド」ボックスに追加されていることを確認します。
        • 「保存」をクリックします。
    新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。
  6. 次に、Salesforce商談がステータス「クローズ済受注」に移動したときにアウトバウンド・メッセージ(以前に作成)を送信するワークフロー・ルールを作成します。
    1. Salesforceの設定ページで:
      1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
      2. 「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。

      「ワークフローについて」ページが表示された場合は、「持続」をクリックします。

    2. 結果ページで「新規ルール」をクリックします。
    3. 「新規ワークフロー・ルール」ページで:
      1. 「オブジェクト」フィールドで「商談」を選択し、「次」をクリックします。
      2. 新しいワークフロー・ルールについて次の詳細を入力します:
        • ルール名としてOpportunityDocusignと入力します。
        • オプションで、ルールの説明を入力します。
        • 「評価基準」セクションで、「作成され、その後基準を満たすように編集されるたびに作成されます」ラジオ・ボタンが選択されていることを確認します。
        • 「ルール基準」セクションで、最初のドロップダウン・フィールドで「式がtrueに評価」を選択し、式フィールドに次の式を追加: IsWon = True。
        • 「保存&次」をクリックします。
      3. 次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。
      4. 「既存の処理の選択」ページで:
        • 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。
        • 「使用可能なアクション」ボックスで、前に作成したアウトバウンド・メッセージ(たとえば、Outbound Message: OpportunityDocusign)を選択します。
        • 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。
        • 「保存」をクリックします。
      5. 「完了」をクリックします。
      新しいワークフロー・ルールが作成され、ブラウザに表示されます。
    4. 「アクティブ化」をクリックしてルールをアクティブ化します。
  7. Salesforceファイルとしてレコードへの添付のアップロードを有効にします。 「ファイルは添付ではなくSalesforceファイルとしてアップロードされます」を参照してください。

    ノート:

    この機能は、「ノート&添付」セクションを使用してクラシックUIでドキュメントをアップロードする場合にのみ有効にする必要があります。 Lightning UIでは、レコードの「ノート&添付」セクションでアップロードしたドキュメントが、デフォルトでSalesforceファイルとして追加されます。

DocuSignの構成

Oracle IntegrationからDocuSignに接続してドキュメントを送信するには、DocuSignインスタンスにOAuthアプリケーションを作成し、アプリケーションのアクセス・キーを取得する必要があります。

  1. DocuSign Developerアカウントにhttps://appdemo.docusign.com/homeでログインします。
  2. タイトル・バーの「設定」タブをクリックします。
  3. 表示されたページで、左側のナビゲーション・メニューのINTEGRATIONSセクションまでスクロールし、「アプリとキー」をクリックします。
  4. アプリケーションとキー・ページで、ADD APP AND INTEGRATION KEYをクリックします。
  5. 「統合キーの追加」ダイアログで、アプリケーションの名前を入力し、CREATE APPをクリックします。
  6. アプリケーション・ページで:
    1. 「一般情報」セクションで、「クリップボードにコピー」アイコンを使用して表示された「統合キー」をコピーします。
    2. 認証セクションで、次の手順を実行します:
      1. 「ユーザー・アプリケーション」の下で、「許可コード権限付与」を選択します。
      2. 「秘密キー」の下で、ADD SECRET KEYをクリックします。 秘密キーが追加されたら、「クリップボードにコピー」アイコンを使用してその値をコピーします。
    3. 追加設定セクションの「リダイレクトURI」で、ADD URIをクリックし、次のリダイレクトURIを入力します。
      https://{OIC_HOST}:{OIC_SSL_PORT}/icsapis/agent/oauth/callback

      OIC_HOSTおよびOIC_SSL_PORTを、Oracle Integrationインスタンスに固有の値に置き換えます。

    4. 「保存」をクリックします。
    Apps and Keysページに戻ります。 新しく作成したアプリケーションがAppsおよび「統合キー」セクションに表示されます。
  7. オプションで、アプリケーションとキー・ページで、DocuSignアカウントのAPIアカウントIDを取得します。 特定のユーザーの複数のアカウントにログインする場合は、このIDが必要です。
    My Account情報セクションで、対応する「クリップボードにコピー」アイコンを使用して、表示されている「APIアカウントID」をコピーします。
  8. DocuSignアカウントIDを取得します。
    1. ページの右上隅にあるプロファイル・イメージをクリックします。
    2. 表示されるメニューで、名前の下にアカウントIDを確認します。