MultipleCreate Method

This method is used to create a new set of information for a specified entity. It differs from the Create 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 and this method could be used to create a new book for a specified author. In this example, an information set might consist of book title and publication date. The MultipleSet Method can be used to update information values thereafter.

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 a new information set is required

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

and, if successful, a Data DataTable with a single row and the following columns:

• ID
  ID of newly created information set

Example

The following Web Service call to create a new information set for a Contact:

MultipleCreate("18,23", RequestDataSet)

where RequestDataSet contains the following Parameters DataTable:

Contact ID
200477

and the following Data DataTable:

Book Title	Book Publication Date
Citizen Squirrel	January 7 1978

could produce a DataSet with the following Status DataTable:

Code	Text
0	OK

and the following Data DataTable:

ID
29