Set Method

This method is used to update information for a specified entity. Multiple information fields may be specified depending on the information to update. The GetFields Method can be used to determine all the available information fields.

The entity must already exist for this to be successful (the exception to this is for Custom Tables where a new row is always created, but this is an advanced feature). Use the Find Method to check for existence first if necessary and/or the Create Method to create a new entity.

Arguments

1. string Reference
2. DataSet RequestDataSet

Reference should contain the Reference returned by the Login Method and is used to identify the user of the Web Service.

RequestDataSet should contain a Parameters DataTable with a single row and the following columns:

• <Category> ID
  ID of entity for whom information is to be set

and a Data DataTable with a single row and the following columns defining which fields are to be set along with their values:

• <Field 1>
  Field value
• <Field 2>
  Field value
• ...

Response

1. DataSet ResponseDataSet

ResponseDataSet will contain a Status DataTable with a single row and the following columns:

• Code
  0 for success or any other value for failure
• Text
  Descriptive status text
• Reference
  A count of the fields successfully set

Example

The following Web Service call to set information about a particular Contact (who has just got married):

Set("18,23", RequestDataSet)

where RequestDataSet contains the following Parameters DataTable:

Contact ID
200044

and the following Data DataTable:

Contact Title	Contact Family Name
Mrs.	Arbuthnot

could produce a DataSet with the following Status DataTable:

Code	Text	Reference
0	OK	2