機械翻訳について
  1. Oracle Integration 3でのSalesforceアダプタの使用
  2. Salesforceアダプタを使用した共通パターンの実装
  3. 大きいデータ・セットを異なるバルク2.0データ操作と非同期的に処理

大きいデータ・セットを異なるバルク2.0データ操作と非同期的に処理

Salesforce一括APIを使用すると、様々な一括操作でリード・データ・セットを非同期で処理できます。 一括操作ごとに、Salesforceアプリケーションでは、バッチで処理されるジョブが作成されます。 ジョブには、各バッチが個別に処理される1つ以上のバッチが含まれます。 バッチは空でないCSVファイルです。

このユースケースでは、Salesforceクラウドで多数のアカウント・レコードを作成するように「Salesforceアダプタ」を構成する方法について説明します。

この操作を実行するには、Oracle IntegrationでFTPアダプタおよび「Salesforceアダプタ」接続を作成します。

このユースケースでは、CSVファイルが入力として使用されます。 ただし、他のフォーマット・ファイルを使用することもできます。 「Salesforceアダプタ」は、ファイルの内容をSalesforce-recognizable形式に変換します。


このイメージは、左上にあるcsv Fileというラベルのボックスを示しています。 その下にはここから開始というラベルが付いた円があります。 どちらのボックスも、.csvファイルをOracle Integrationにダウンロードというラベルのボックスを指しています。 このボックスは、ステージ・ファイルというラベルの付いたボックスを指しています - セグメント操作でファイルを読み取ります。 そのボックス内には、Salesforce Cloud Adapterというラベルの付いた、バルク2.0操作を含む内側のボックスがあります。 右側には、Salesforce Application Cloudというラベルの付いたクラウドからのSends File in Segmentsというラベルの付いた着信矢印があります。 ステージ・ファイル - セグメントの読取り操作ボックスのファイルは、最終ジョブ操作というラベルのボックスに下向きを示します。Salesforce。

  1. スケジュール済オーケストレーション統合を作成します。
  2. FTPアダプタを統合キャンバスにドラッグします。
  3. FTPアダプタを次のように構成します:
    1. 「基本情報」ページで名前を指定します。
    2. 操作ページで、「操作の選択」リストから「ファイルのダウンロード」を選択します。
    3. 「転送モードの選択」リストから「バイナリ」を選択します。
    4. 入力ディレクトリ、ファイル名およびダウンロード・ディレクトリを指定します。
    5. サマリー・ページで、選択内容を確認します。
  4. ステージ・ファイル・アクションをFTPアダプタの下の統合キャンバスにドラッグします。 ステージ・ファイル・アクションは、「Salesforceアダプタ」がセグメントの形式でデータをフェッチするのに役立ちます(単一のセグメントに200レコードが含まれます)。
    1. 「基本情報」ページで名前を指定します。
    2. 「操作の構成」ページで、「ステージング・ファイル操作の選択」フィールドから「セグメント内のファイルの読取り」を選択します。
    3. 「ファイル名を指定」フィールドにファイル名のXPath式を指定します。
    4. 「読み込むディレクトリを指定」フィールドにディレクトリ名を指定します(FTPを使用してOracle Integrationにダウンロード)。
    5. 「スキーム・オプション」ページの「ファイルの内容の構造を指定しますか?」フィールドでYesを選択し、「ファイル・コンテンツの構造を記述するために、次のいずれかの選択肢が使用されます」フィールドで「サンプル区切り文書(CSVなど)」を選択します。
    6. 「フォーマット定義」ページで、「ファイルを選ぶ」をクリックし、「新規デリミタ付きデータ・ファイルの選択」フィールドにサンプルのCSVファイルをアップロードします。
    7. レコード名とレコード・セット名を入力します。
    8. サマリー・ページで、選択した項目を確認します。
  5. ステージ・ファイル・アクション内に「Salesforceアダプタ」をドラッグし、必要な一括操作で構成します。
    1. 「基本情報」ページで名前を指定します。
    2. アクション・ページで、「一括データ操作の実行」を選択します。
    3. 操作ページで、「バルクv2.0、」を選択し、「操作の選択」フィールドで必要な操作(この例では「作成」)を選択します。
    4. 「ビジネス・オブジェクトの選択」フィールドで、必要なビジネス・オブジェクト(この例ではアカウント)を選択します。
    5. サマリー・ページで、選択内容を確認します。
  6. マッパーで、ステージ・ファイル・アクションの要素をSalesforce入力ペイロードにマップします。

    マッパーには、ソース・ツリーのレコード、名前、電話および外部IDがターゲット・ツリーのアカウント、Account_Ext_Id、アカウント名およびアカウント電話にそれぞれマップされています。 中央にはマッピング・キャンバス列があります。

  7. 「Salesforceアダプタ」をステージ・ファイル・アクションの下にドラッグし、「最終ジョブ」操作で構成します。
    1. 「基本情報」ページで名前を指定します。
    2. アクション・ページで、「一括データ操作の実行」を選択します。
    3. 操作ページで、「バルクv2.0」を選択し、「操作の選択」フィールドで「最終ジョブ」を選択します。

      ノート:

      この「Salesforceアダプタ」接続は、ステージング・ファイル・アクション内のSalesforceエンドポイントに対して構成された操作に対してアクティビティを実行するため、操作を実行するオブジェクトを選択できません。
    4. サマリー・ページで選択内容を確認します。
  8. FTPアダプタ接続を「Salesforceアダプタ」の下にドラッグし、FTPエンドポイントを構成して、将来使用できるようにSalesforce最終バッチ・レスポンスをファイルに書き込みます。
    1. 「基本情報」ページで名前を指定します。
    2. 操作ページで、「選択操作からのファイルの書込み」リストを選択します。
    3. 「転送モードの選択」リストから「バイナリ」を選択します。
    4. 出力ディレクトリ、ファイル名パターン、ダウンロード・ディレクトリを指定します。
    5. スキーム・ページで、「ファイル・コンテンツの構造を記述するために、次のいずれかの選択肢が使用されます」リストから「XMLスキーマ(XSD)ドキュメント」を選択します(XMLメッセージを記述する場合)。
    6. 「ファイルの競合-定義」ページで、「ファイルを選ぶ」をクリックし、「新規ファイルの選択」フィールドにスキーマ・ソース・ファイルをアップロードします。
    7. サマリー・ページで選択内容を確認します。
  9. マッパーで、Salesforceの最終的なバッチ・レスポンスをFTPの書込みリクエストにマップします。
    完了した統合は次のようになります。


    統合には、スケジュール、マップ、起動、ステージ・ファイル、マップ、起動、マップ、起動および終了の各アイコンが表示されます。

  10. トラッキング変数を指定してください。
    1. 「ビジネス識別子」 ビジネス識別子アイコンをクリックします。
    2. トラッキング参照に使用する必要な変数をドラッグします(この例では、startTimeが選択されています)。
  11. 統合をアクティブ化します。
    アクティブ化が正常に終了したら、統合を送信し、Oracle Integrationでランタイムを監視できます。 バルク操作ごとに、SalesforceアプリケーションによってジョブIDが作成されます。 最終バッチ・レスポンスで参照バルク・ジョブIDを受信したら、Bulk v2.0で使用可能なすべてのバッチ操作について、成功したレコードの取得、失敗したレコードの取得および未処理レコードの取得操作を使用して、レコードの詳細を取得することもできます。 「一括2.0操作を使用したSuccessful/Failed/Unprocessedレコードの取得」を参照してください。