MultipleSet Method

This method is used to update information for a specified entity. It differs from the Set Method in that it is used in cases where there may be more than one piece of information associated with an entity. For instance, if the entity were an author they may have more than one book associated with them. Multiple information fields may be specified depending on the information to update. For instance, if updating information on books written by a particular author you may wish to set the title and publication date for particular books. The GetFields Method can be used to determine all the available information fields.

The entity information must already exist for this method to be successful. You can use the MultipleGet Method to determine what information already exists for a particular entity or the MultipleFind Method to search for information relating to a particular entity. The MultipleCreate Method can be used to create new information for an 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:

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

Response
  1. DataSet ResponseDataSet

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

Example

The following Web Service call to set information about a particular Contact:

MultipleSet("18,23", RequestDataSet)

where RequestDataSet contains the following Parameters DataTable:

Contact ID
200044

and the following Data DataTable:

ID Book Title Book Publication Date
17 The Sound of Squirrels May 9 2002
43 Twelve Angry Squirrels July 15 2005

could produce a DataSet with the following Status DataTable:

Code Text Reference
0 OK 2