Create Method

This method is used to create a new entity of a specified category. The GetCategories Method can be used to determine all the available entity categories.

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
  Name of category

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:

• <Category> ID
  ID of newly created entity

Example

The following Web Service call to create a new Contact:

Create("18,23", RequestDataSet)

where RequestDataSet contains the following Parameters DataTable:

Category
Contact

could produce a DataSet with the following Status DataTable:

Code	Text
0	OK

and the following Data DataTable:

Contact ID
200477