Insert
Inserts new records in the Oracle CRM On Demand database.
Usage
You use the Insert method to create one or more records of a particular object in an Oracle CRM On Demand instance.
When inserting a batch of records, the batch is treated as a single transaction. If one record fails to insert during a batch insertion, the entire operation is rolled back and no records are inserted.
Insert calls must include values for fields that are required for the object. Fields can be conditionally required, that is they become required if the data specified for other fields on the record meets the criteria defined in an expression for the field. For more information about conditionally-required fields, see Oracle CRM On Demand Online Help.
The following table outlines how the Insert method acts on parent and child objects to create or update an object instance.
| Method | New Parent | New Child | Existing Parent | Existing Child Record |
|---|---|---|---|---|
Insert |
New parent instance |
New child instance |
Error |
Associate to new parent instance |
Arguments
The following table describes the arguments taken by the Insert method.
| Name | Description | Required | Default | I/O |
|---|---|---|---|---|
ListOf(Object). For example, ListOfAccount |
The list of object instances to be inserted. |
Yes |
Not applicable |
Input/Output |
Echo |
Controls whether data sent to Oracle CRM On Demand through integration Web services are recorded as transactions. |
No |
On |
Input |
Return Value of the Call
The status key for each of the Oracle CRM On Demand objects.