アップサート操作を使用したレコードの挿入または更新

このユースケースでは、統合でのupsert操作の使用方法の概要を示します。

アップサート操作を使用して、Salesforceアプリケーションの新しいレコードを挿入したり、既存のレコードを更新できます。レコードがすでに存在するかどうかを判別するために、アップサート操作ではレコードの照合に一意キーが使用されます。一意キーは、Salesforceアプリケーションで「外部ID」フィールド」として宣言されたカスタム・フィールドです。

キーが一致しない場合は、新しいオブジェクト・レコードが作成されます。
キーが一度一致すると、オブジェクトの既存のレコードが自動的に更新されます。
キーが複数回一致する場合、エラーが生成され、オブジェクト・レコードは挿入または更新されません。

SOAPアダプタおよび「Salesforceアダプタ」接続を作成します。
アプリ駆動オーケストレートされた統合を作成します。
SOAPアダプタ接続をトリガー接続として統合にドラッグします。
SOAPエンドポイントを構成します。
「Salesforceアダプタ」を統合キャンバスにドラッグします。
「Salesforceアダプタ」を次のように構成します。
1. 「基本情報」ページで、エンドポイント名を指定します。
2. アクション・ページで、「情報の作成、更新または削除」を選択します。
3. 操作ページで、「アップサート」操作を選択し、ビジネス・オブジェクト(この例では「アカウント」)を選択します。
4. サマリー・ページで選択内容を確認し、「完了」をクリックします。
マッパーで、ソースの「SOAPリクエスト(SOAP)」入力要素ノードをターゲット「SFDC_Upsertリクエスト(Salesforce)」入力ペイロードにマップします。この例では、input1をAccount_Ext_Idに、input2を「アカウント名」にマップします。
「外部IDフィールド名」をクリックし、「ターゲット・ノードの作成」を次にクリックします。式ビルダーが表示されます。
Salesforceで「外部ID」フィールド」として設定されているものと同じフィールドAPI名を追加します。この例では、次の値が式ビルダーに追加されます:
```
Account_Ext_id_c
```
Salesforceアプリケーションの外部IDフィールドとして作成/指定したものと同じフィールド名を使用していることを確認します。
マッパーで、SFDC_Upsertレスポンス(Salesforce)要素ノードをSOAPレスポンス(SOAP)要素ノードにマップします:
- 「作成日」をoutput1に(新しいアカウントが作成された場合はtrueを返し、アカウントが更新された場合はfalseを返します)
- Idからoutput2 (作成または更新されたアカウントIDを返します)
- 「成功」をoutput3に(操作が正常に実行された場合はtrueを返します)
「検証」をクリックし、「閉じる」を次にクリックします。完了した統合は次のようになります。
トラッキング変数を指定してください。
統合をアクティブ化します。