SFAdd (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Possible error cases:

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SFAdd (Function)

In french: SFAjoute

Creates a record in a file of a Salesforce database. This file can be a preset file or a custom file.

Remark: A "Salesforce record" is also called a "Salesforce object".

Versions 20 and later

This function is now available for WINDEV applications in Linux.

This function is now available for iPhone/iPad applications.

New in version 20

This function is now available for WINDEV applications in Linux.

This function is now available for iPhone/iPad applications.

This function is now available for WINDEV applications in Linux.

This function is now available for iPhone/iPad applications.

Versions 24 and later

This function is now available for WEBDEV sites in Linux.

New in version 24

This function is now available for WEBDEV sites in Linux.

Example

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

// Define the records
MyRecords is array of sfObjects
ARecord is sfObject
ARecord..ObjectType = "Mileage__c"
ARecord..Date__c = "2009-02-14"
ARecord..Miles__c = 333
Add(MyRecords, ARecord)

ARecord..Date__c = "2009-02-15"
ARecord..Miles__c = 222
Add(MyRecords, ARecord)

// Add the records
arrRes is array of sfSaveResult
arrRes = SFAdd(Cnt, MyRecords)

// Read the result
res is sfSaveResult
err is sfError
FOR EACH res OF arrRes
Trace("---------- " + res..ID + ": " + res..Success + " ----------")
FOR EACH err OF res..Error
Trace("Error: " + err..ErrorCode + " -> " + err..Message + "(" + err..Item + ")")
END
END

Syntax

<Result> = SFAdd(<Salesforce connection> , <Records to create>)

<Result>: Array variable

Array of sfSaveResult variables containing the result data, especially the identifiers of records actually created.

<Salesforce connection>: sfConnection variable

Name of the sfConnection variable to use.

<Records to create>: Array variable

Array of sfObject variables corresponding to the records (Salesforce objects) to create.

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: wd260ggl.dll