UpdateSingleSalesforceObject

概要

連携された Salesforce アカウントのオブジェクトのレコードを更新します。AND 句の一部として複数の追加のフィールドと値のペアを指定できます。成功した場合は 1、失敗した場合は 0 を返します。

:::注意 UpdateSingleSalesforceObject 関数は、CloudPage またはメッセージ内のコードをプレビューするときに実行されます。その結果、Sales Cloud と Service Cloud の統合組織のレコードがコードプレビューによって更新される可能性があります。これを防止するには、次のとおり UpdateSingleSalesforceObject 関数を実行する前に、メッセージまたはページがプレビューコンテキストに読み込まれていないことをチェックできます。 :::

1%%[
2IF _messagecontext != 'PREVIEW' THEN
3]%%
4
5!<--Add your UpdateSingleSalesforceObject function call here. This code will not get executed in Preview. -->
6
7%%[
8ENDIF
9]%%

構文

UpdateSingleSalesforceObject(1, 2, 3, 4)

関数のプロパティ

序数	型		説明
1	string	必須	更新するオブジェクトの種別 (Lead、CustomObject など)。
2	string	必須	更新するオブジェクトの ID。
3	string	必須	更新するフィールドの名前。
4	string	必須	フィールドの更新で使用する値。

使用状況

1%%[
2var @result
3set @result = UpdateSingleSalesforceObject('Lead','00Q00003yAEj','Email','jcc@example.com')
4]%%
5The system updates the Email field on the Lead with ID 00Q00003yAEj to contain jcc@example.com.

既存のレコード内の値を NULL に設定する (この例では、Phone 値を NULL に設定する):

1%%[
2var @result
3set @result = UpdateSingleSalesforceObject('Lead','00Q00003yAEj','fieldsToNull','Phone')
4]%%
5The system updates the Phone field for the Lead with ID 00Q00003yAEj to a blank/NULL value.