Bookshelf Home | Contents | Index | PDF     

Oracle Web Services On Demand Guide > Web Services On Demand API Calls > Web Services v1.0 API Calls >

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.

Table 18 outlines how the Insert method acts on parent and child objects to create or update an object instance.

Table 18. Effect of Insert on Parent and Child Objects
Method
New Parent
New Child
Existing Parent
Existing Child Record

Insert

New parent instance

New child instance

Error

Associate to new parent instance

Arguments

Table 19 describes the arguments taken by the Insert method.

Table 19. 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.

Related Topic

Update.

    
Oracle Web Services On Demand Guide, Version 25.0 (Oracle CRM On Demand Release 37) Copyright © 2018, Oracle and/or its affiliates. All rights reserved. Legal Notices.