<sfConnection variable>.Modify (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

Salesforce functions

Prefix syntax

Modify

Presentation

Example

Possible error cases

See also

<sfConnection variable>.Modify (Function)

In french: <Variable sfConnexion>.Modifie

Modifies the records of a file defined in Salesforce. This file can be a preset Salesforce file or a custom file.

Example

// Connect to Salesforce
Cnt is sfConnection
Cnt..Login = "vince@gmail.com"
Cnt..Password = "qwerty" + "XXB12VCZ54"
IF Cnt.Connect() =False THEN
Error("The connection failed")
RETURN
END

arrObjects is array of sfObject
ResQuery is sfExecuteQueryResult
sQueryText is string = "SELECT RecordTypeId, Recipient__c, "...
"ID, Subscript_of_mobiliot__c FROM BCM__c WHERE NAME='" + sSearch + "'"

ResQuery = Cnt.ExecuteQuery(sQueryText)

ARecord is sfObject
FOR EACH ARecord OF ResQuery.Object
ARecord.Subscript_of_mobiliot__c = "698" // Modification
Add(arrObjects, ARecord)
END

arrRes is array of sfSaveResult
arrRes = Cnt.Modify(arrObjects)
FOR EACH res OF arrRes
Trace("Success = "+res..Success)
END

Syntax

Modifying the existing records Hide the details

<Result> = <Salesforce connection>.Modify(<Records to modify>)

<Result>: Array variable

Array of sfSaveResult variables containing the result data, especially the identifiers of the objects actually modified.

<Salesforce connection>: sfConnection variable

Name of the variable of type sfConnection to be used.

<Records to modify>: Array variable

Array of sfObject variables corresponding to the Salesforce records to modify. This array can contain up to 200 elements.

Modifying the existing records or creating records Hide the details

<Result> = <Salesforce connection>.Modify(<Records to modify or create> , <Mode> , <External identifier>)

<Result>: Array variable

Array of sfSaveResult variables containing the result data, especially the identifiers of the objects actually modified.

<Salesforce connection>: sfConnection variable

Name of the variable of type sfConnection to be used.

<Records to modify or create>: Array variable

Array of sfObject variables corresponding to the Salesforce records to modify or create. This array can contain up to 200 elements.

<Mode>: Integer

Modification mode used:
sfCreationIfNotFound The record is automatically created if it does not exist.

<External identifier>: Character string

For a custom file, name of the item defined as unique item identifier from an external system.
This item is also used to identify the record to modify.
This item and its value are found in the sfObject object to modify.
The record will be automatically created if the value does not exist.
The record is updated if the value exists once.
An error is returned if the value exists several times.

Remarks

Possible error cases

The Internet connection is not valid.
The authentication was not performed properly.
The XML response of the server cannot be read.

To find out whether an error occurred, use the ErrorOccurred variable.

Component: wd270ggl.dll