機械翻訳について

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

Oracle Integrationを使用してこれらの外部システムに正常に接続し、見積添付をインポートするには、SalesforceおよびAdobe Signインスタンスで次の構成タスクを実行する必要があります。

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のトグルまたは切替え」を参照してください。
  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. 対応するEメール・アカウントにログインし、SalesforceからのEメール・メッセージの「アカウントの検証」ボタンをクリックします。 新しいユーザー・アカウントのパスワードを設定するために、Salesforceインスタンスにリダイレクトされます。
    5. パスワードを設定し、同じことを書き留めます。

      その後、新しいアカウントでSalesforceインスタンスにサインインします。

      ノート:

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

      5. 「セキュリティ・トークンのリセット」ボタンをクリックします。

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

      6. Salesforceインスタンスで、ユーザー名を再度クリックし、メニューから「ログアウト」を選択します。 「管理者」として再度ログインします。
  3. 現在のSalesforce APIバージョンを特定します。 「Oracle Integration 3でのSalesforceアダプタの使用」の「現在のSalesforce APIバージョンを検索」を参照してください。
  4. Salesforceインスタンス・タイプを識別します。 「Oracle Integration 3でのSalesforceアダプタの使用」の「Salesforce組織のインスタンス・タイプの識別」を参照してください。
  5. Salesforceインスタンスで、このレシピの統合フローをトリガーするアウトバウンド・メッセージを作成します。
    1. Salesforceの設定ページで、次の手順を実行します。
      1. 左側のナビゲーション・ペインのBuildセクションまでスクロールします。
      2. 「作成」、「ワークフロー&承認」の順に展開し、「アウトバウンド・メッセージ」をクリックします。

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

    2. 結果のページで「新規アウトバウンド・メッセージ」をクリックします。
    3. 「新規アウトバウンド・メッセージ」ページで:
      1. 「オブジェクト」フィールドで「見積り」を選択し、「次へ」をクリックします。
      2. 新しいアウトバウンド・メッセージについて次の詳細を入力します:
        • アウトバウンド・メッセージの名前をOracle SFDC Adobe Esign Quote SOとして入力します。 「一意の名前」フィールドは、入力した名前に基づいて自動的に移入されます。
        • オプションで、メッセージの説明を入力します。
        • 「エンドポイントURL」フィールドに、https://<OIC_FQDN:OIC_SSL_PORT>/ic/api/integration/v2/flows/rest/project/ORCL-R-SFDC_ADOBE_ESIGN_SO/ORCL-R-SFDC_ESIGN_SIGN_HANDLER/1.0/と入力します。

          ここで、OIC_FQDNおよびOIC_SSL_PORTは、Oracle Integrationインスタンスの完全修飾ドメイン名およびポートです。

          たとえば: oicinstance.example.com:443

        • 「フィールドとして送信するユーザー」で、メッセージの送信に使用するユーザー・アカウントを選択します。
        • 「送信する見積フィールド」で、すべてのフィールドを選択し、「追加」をクリックします。
        • 「保存」をクリックします。

    新しいアウトバウンド・メッセージが作成され、ブラウザに表示されます。

  6. 次に、Salesforce見積の作成時に(以前に作成した)アウトバウンド・メッセージを送信するワークフロールールを作成します。
    1. Salesforce設定ページで、次の手順を実行します:

      1. 左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。

      2. 「作成」、「ワークフロー&承認」の順に展開し、「ワークフロー・ルール」をクリックします。

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

    2. 結果ページで「新規ルール」をクリックします。
    3. 「新規ワークフロー・ルール」ページで:

      1. 「オブジェクト」フィールドで「見積り」を選択し、「次へ」をクリックします。

      2. 新しいワークフロー・ルールについて次の詳細を入力します:

        • ルールの名前を入力します。 たとえば、Oracle SFDC Adobe Esign Quote SOです。

        • オプションで、ルールの説明を入力します。

        • 「評価基準」セクションで、「作成済で、編集されるたびに」ラジオ・ボタンを選択します。

        • 「ルール基準」セクションで、「基準を満たす」オプションを選択し、次のルール基準を定義します。

          • 「フィールド」ドロップダウンで、「見積: ステータス」を選択します。
          • 「演算子」ドロップダウンで、「等しい」を選択します。
          • 「値」ドロップダウンで、「レビュー中」を選択します

        • 「保存&次」をクリックします。

      3. 次のページで、「ワークフロー・アクションの追加」ボタンをクリックし、「既存のアクションを選択」を選択します。

      4. 「既存の処理の選択」ページで:

        • 「検索」フィールドで「アウトバウンド・メッセージ」を選択します。

        • 「使用可能なアクション」ボックスで、以前に作成したアウトバウンド・メッセージを選択します。 たとえば、Oracle Adobe Sign Quote Messageです。

        • 「追加」をクリックして、選択内容を「選択したアクション」ボックスに移動します。

        • 「保存」をクリックします。

      5. 「完了」をクリックします。

      新しいワークフロー・ルールが作成され、ブラウザに表示されます。

    4. 「アクティブ化」をクリックしてルールをアクティブ化します。
  7. ドキュメントIDとステータスを保持するカスタム・フィールドを作成します。
    1. Salesforce設定ページで、次の手順を実行します:

      1. 左側のナビゲーション・ペインの「ビルド」セクションまでスクロールします。

      2. 「カスタマイズ」、「見積」の順に展開し、「フィールド」をクリックします。

    2. 「見積フィールド」ページで、「見積カスタム・フィールドおよび関係」セクションまでスクロールし、「新規」をクリックします。
    3. 「新しいカスタム・フィールド」ページで:

      1. 「テキスト」ラジオ・ボタンを見つけて選択し、「次」をクリックします。

      2. 新しいカスタム・フィールドについて次の詳細を入力します:

        • フィールド・ラベルとしてAdobeAggreementIDと入力します。 フィールド名は、入力したラベルに基づいて自動的に移入されることに注意してください。

        • 長さとして50と入力します。

        • オプションで、新規フィールドの説明を入力します。

        • 「次へ」をクリックします。

      3. フィールド・レベル・セキュリティの設定ページで、ヘッダー行の「表示可能」チェック・ボックスを選択して、すべてのプロファイルの新規フィールドへの編集アクセス権を付与します。 「次へ」をクリックします。

      4. すべてのレイアウト・チェック・ボックスが選択されたままにして、「保存」をクリックします。

      「見積フィールド」ページでは、「見積カスタム・フィールドおよび関係」セクションに追加された新しいフィールドを確認できます。

    同様に、契約ステータスを格納するカスタム・フィールドを作成します。 フィールド・ラベルとして Oracle_Adobe_eSign_Agreement_Statusと入力します。

Adobe Signの構成

Oracle Integrationを使用してAdobe Signにアクセスし、アグリーメントを送信するには、Adobe Signインスタンスで特定の構成タスクを実行する必要があります。

  1. Adobe SignインスタンスにOAuthアプリケーションを作成し、アプリケーションのアクセス・キーを取得します。 「Oracle Integration 3でのAdobe Signアダプタの使用」の「接続を作成するための前提条件」を参照してください。
  2. webフックを作成します。 「webフックの構成」を参照してください。
    webフックの構成中に次の詳細を入力します。
    フィールド 入力する情報
    名前 webフックの名前を入力します。
    スコープ 「アカウント」を選択します。
    URL https://<username>:<password>@<OIC_Host_Name>/ic/api/integration/v2/flows/rest/project/ORCL-R-SFDC_ADOBE_ESIGN_SO/ORCL-R-SFDC_ESIGN_SIGN_HANDLER/1.0/と入力します。 ここで、<username>および<password>を、Adobeインスタンスのユーザー名とパスワードに置き換えます。
    イベント ハンバーガ・アイコンをクリックし、「契約参加者完了」を選択します。
    通知パラメータ 次のチェック・ボックスを選択: 契約情報, 契約文書情報, 契約参加者情報, 契約署名済文書.

    「保存」をクリックします。