Salesforce Connector の 10.4 へのアップグレードおよび移行

Salesforce 用 Anypoint Connector (Salesforce Connector) をバージョン 9.x からバージョン 10.x にアップグレードします。

サポートされているアップグレードパス

開始バージョン 終了バージョン

9.x

10.x

変更

10.4

このリリースには、次の変更が含まれています。

  • Retrieve Job Unprocessed Results BulkV2 操作が追加されました。

  • Retrieve Job Failed Results BulkV2 操作と Retrieve Job Successful Results BulkV2 操作でレコードの元の項目が返されるようになりました。

  • すべての操作と接続種別でログが改善されました。

  • Subscribe Streaming Channel および Replay Streaming Channel ソースで、設定済みの組織で使用可能なすべてのイベント種別が表示されるようになりました。

    • 汎用イベント

    • プラットフォームイベント

    • 変更データキャプチャイベント

10.3

このリリースには、次の変更が含まれています。

  • Salesforce API v49.0 のサポートが追加されました。

  • Merge Multiple 操作が追加され、1 回の SOAP コールで最大 200 件のレコードをマージできるようになりました。

10.2

このリリースには、次の変更が含まれています。

  • SAML および JWT 認証メカニズム用に指定された JKS ファイルで複数キーのサポートが追加されました。新しい [Certificate Alias (証明書の別名)] 項目を使用して、使用する証明書を指定します。(CONN-6019、CONN-6020)

  • Invoke APEX SOAP 操作のカスタムヘッダーのサポートが追加されました。(SE-15884)

  • Bulk API V2 操作でレスポンスヘッダーと状況がメッセージ属性として返されるようになりました。

10.1

このリリースには、次の変更が含まれています。

  • API v48.0 のサポートが追加されました。

  • 新しく追加されたプラットフォームイベント (FOStatusChangedEvent、OrderSummaryCreatedEvent、および OrderSumStatusChangedEvent) のサブスクリプションがサポートされるようになりました。

  • クエリで WITH filteringExpression を使用する場合に新しい RecordVisibilityContext 句の使用がサポートされるようになりました。

10.0

このリリースには、次の変更が含まれています。

  • 非推奨の接続種別の削除

  • 一部の操作に対する次の変更

    • 1 つの操作への複数の操作のマージ

    • 一部の操作名およびパラメーター名の変更

    • 一部の操作の戻り値のデータ型の変更

  • 再生 ID 機能の再設計

  • Mule TLS コンテキストの用途の変更

  • エラー種別の改善

  • Dozer ライブラリの連動関係の削除

  • 設定可能なオプションとしてのキープアライブ機能の削除

    コネクタは 14 分 (Salesforce の最小 TTL は 15 分) ごとに 1 つの API コールを自動的に実行するようになったため、セッションの有効期限が切れなくなりました。

接続種別の変更

Salesforce Connector 10.x には、接続種別の次の変更が含まれています。

  • 次の接続種別の削除

    • ユーザー名/パスワード

    • Basic Username Password (基本ユーザー名/パスワード)

  • マルチスレッドのサポートを改善するための接続プール機能の追加。

    この機能により、API に送信される各要求に独自のヘッダーと読み取りタイムアウトが設定され、操作が同時に実行されたときに操作のヘッダーが誤った値で上書きされることを回避できます。

  • TLS を設定するための新しい ​[Security (セキュリティ)]​ タブの追加。

  • より直感的にするためのパラメーターの並び替え。

  • プロバイダー設定からコネクタ設定への [​Read timeout​ (読み取りタイムアウト)] パラメーターの移動。

  • コネクタ設定からの次のパラメーターの削除

    • Advanced reconnection params

    • Allow field truncation support

    • Assignment rule id

    • Batch Sobject max depth

    • Can clear fields by updating field value to null
      Salesforce Connector 10.x で項目をクリアするには、​Update​ または ​Upsert​ 要求を使用して、null にする項目の名前を ​fieldsToNull​ 項目で設定する必要があります。

    • Client id

    • Disable session invalidation

    • Time object store

    • Use default rule

操作、パラメーター、戻り値のデータ型の変更

Salesforce Connector 10.x では、すべての操作に次の新しいパラメーターが含まれます。

  • Time unit

  • Read timeout

次の表に、操作名、入力パラメーター、戻り値のデータ型の他の変更を示します。

Salesforce 9.x の操作 Salesforce 10.x の変更

Abort job v 2

操作名が Abort job bulk api v 2 に変更されました。

Abort query job

  • 操作名が Abort query job bulk api v 2 に変更されました。

  • Query job id​ パラメーターが ​Id​ に変更されました。

Batch result

戻り値のデータ型が Bulk Operation Result (一括操作結果) になりました。これは、Batch スコープに統合できます。

Batch result stream

戻り値のデータ型が InputStream になりました。

Create

戻り値のデータ型が Bulk Operation Result (一括操作結果) になりました。これは、Batch スコープに統合できます。

Delete

戻り値のデータ型が Bulk Operation Result (一括操作結果) になりました。これは、Batch スコープに統合できます。

Find duplicates by ids

戻り値のデータ型が ID リストになりました。

Get all jobs v 2

  • 操作名が Get all jobs bulk api v 2 に変更されました。

  • Is pk chunking enabled​ パラメーターが ​Pk Chunking​ に変更されました。

Get all query jobs

  • 操作名が Get all query jobs bulk api v 2 に変更されました。

  • Is pk chunking enabled​ パラメーターが ​Pk Chunking​ に変更されました。

Get bulk job state bulk v 2

操作名が Get job state bulk api v 2 に変更されました。

Get deleted

  • [Duration (期間)] パラメーターが ​Start Date​ および ​End Date​ パラメーターに置き換わりました。

  • Type​ パラメーターが ​Object type​ に変更されました。

Get query job info

  • 操作名が Get query job info bulk api v 2 に変更されました。

  • Query job​ id パラメーターが ​Id​ に変更されました。

Get query job result

  • 操作名が Get query job result bulk api v 2 に変更されました。

  • Query job id​ パラメーターが ​Id​ に変更されました。

Get updated objects

  • Initial Time Window​ パラメーターが ​Start Date​ および ​End Date​ パラメーターに置き換わりました。

  • Type​ パラメーターが ​Object Type​ に変更されました。

  • Fields​ および ​Update Header​ パラメーターが削除されました。

  • 操作で、更新されたオブジェクトの ID と対象の最新の日付のみが返されるようになりました。

    • 更新されたオブジェクトの項目値を取得するには、この操作を使用した後に Retrieve 操作を使用します。

    • 更新されたオブジェクトが前回照会された時間を追跡するには、Object Store Connector に手動で値を保存し、取得します。

Replay channel

操作名が Replay channel listener に変更されました。

Replay topic

操作名が Replay topic listener に変更されました。

Retrieve record failure bulk v 2

操作名が Retrieve job failed result bulk v 2 に変更されました。

Retrieve record success bulk v 2

操作名が Retrieve job successful result bulk v 2 に変更されました。

Subscribe channel

操作名が Subscribe channel listener に変更されました。

Subscribe topic

操作名が Subscribe topic listener に変更されました。

Update

戻り値のデータ型が Bulk Operation Result (一括操作結果) になりました。これは、Batch スコープに統合できます。

Upsert

Type​ パラメーターが ​Object Type​ に変更されました。

操作のメタデータの変更

キー、入力メタデータ、出力メタデータに変更はありません。

削除された操作

次の操作は、Salesforce Connector 10.x から削除されました。

削除された操作 この機能をカバーする操作

Bulk info

Batch info 操作

Bulk info list

Batch info list 操作

Bulk result

Batch result 操作

Bulk result stream

Batch result stream 操作

Create bulk

insert​ パラメーターを使用した Create job 操作と Create Batch 操作

Create bulk for query

Create batch for query 操作

Create single

Create 操作

Create multiple

Create 操作

Create multiple batch

Create batch 操作

Create multiple batch stream

Create batch stream 操作

Create multiple bulk

create​ パラメーターを使用した Create Job 操作と Create batch 操作

Delete multiple

Delete 操作

Get deleted range

Get deleted objects 操作

Get updated

Get updated objects 操作

Hard delete bulk

hardDelete​ パラメーターを使用した Create Job 操作と Create batch 操作

Hard delete multiple

[​hardDelete​ (物理削除)] パラメーターを使用した Create Job 操作と Create batch 操作

Query multiple result stream

Query result stream 操作

Query single

Query 操作

Non paginated query

Query 操作

Update bulk

update​ パラメーターを使用した Create job 操作と Create Batch 操作

Update multiple

Update 操作

Update multiple bulk

update​ パラメーターを使用した Create Job 操作と Create batch 操作

Update single

Update 操作

Delete multiple

Delete

Upsert bulk

upsert​ パラメーターを使用した Create Job 操作と Create Batch 操作

Upsert multiple

Upsert 操作

Upsert multiple bulk

upsert​ パラメーターを使用した Create Job 操作と Create batch 操作

Get session id

この操作は、コネクタによって使用される内部セッション ID を公開していました。これは、定期的にコネクタを使用する接続のライフサイクルに影響する可能性があります。コネクタ機能を使用して再実装することをお勧めします。

アップグレード前提条件

アップグレードを実行する前に、次の作業を行う必要があります。

  1. 以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、設定のバックアップを作成します。

  2. Salesforce Connector 10.x をインストールし、以前に Salesforce Connector 9.x に含まれていた Salesforce 操作を置き換えます。

アップグレード手順

Salesforce Connector v9.x から Salesforce Connector v10.x にアップグレードする手順は、次のとおりです。

  1. Anypoint Studio で、Mule プロジェクトを作成します。

  2. [Mule Palette (Mule パレット)] ビューで、​[Search in Exchange (Exchange 内を検索)]​ をクリックします。

  3. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ ウィンドウで、検索項目に「​Salesforce​」と入力します。

  4. [Available modules (使用可能なモジュール)]​ セクションで、​[Salesforce Connector - Mule 4 (Salesforce Connector - Mule 4)]​ を選択し、​[Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

  6. pom.xml​ ファイルで ​salesforce-connector​ 連動関係バージョンが ​10.x.x​ であることを確認します。ここで ​x.x​ はマイナーリリースとパッチバージョン番号です。たとえば、v10.0 にアップグレードする場合、​pom.xml​ ファイルの連動関係バージョンは ​10.0.0​ です。

Studio はコネクタを自動的にアップグレードします。

アップグレードを確認する

コネクタの最新バージョンをインストールしたら、次の手順に従ってアップグレードを確認します。

  1. Studio の ​[Problems (問題)]​ または ​[Console (コンソール)]​ ビューでエラーがないことを確認します。

  2. プロジェクトの ​pom.xml​ ファイルをチェックして、問題がないことを確認します。

  3. 接続をテストして、操作が機能することを確認します。

トラブルシューティング

パラメーターおよびメタデータのキャッシュに問題がある場合は、Studio を再起動してください。

アップグレードの復元

以前のバージョンの Salesforce Connector に戻す必要がある場合、プロジェクトの ​pom.xml​ ファイルの ​salesforce-connector​ 連動関係バージョンを以前のバージョンに変更します。

Anypoint Studio でプロジェクトの ​pom.xml​ ファイルを更新する必要があります。