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

Update


Updates records with a new value.

Usage

You use the Update method to update one or more records of a particular object in an Oracle CRM On Demand instance.

NOTE:  If the company administrator customizes a record type to add a required field, Oracle CRM On Demand does not check for the required field when existing records are updated. When you update the record without the required field through a Web services request, or merge it with a record that does not have the required field, the record is updated or merged without error. This is the intended behavior; when a field is made required, it is the responsibility of the administrator to update all existing records to populate the required field. On inserting new records however, Oracle CRM On Demand checks for the required field.

Table 26 outlines how the Update method acts on parent and child objects to update an object instance.

Table 26. Effect of Update on Parent and Child Objects
Method
New Parent
New Child
Existing Parent
Existing Child Record
Existing Child Record But Not in Input

Update

Error

New child

Update parent

Update child

Child is removed

Arguments

Table 27 describes the arguments taken by the Update method.

Table 27. Arguments Taken by the Update Method
Name
Description
Required
Default
I/O

ListOf(Object). For example, ListOfAccount

The object instance to be updated.

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 updated records.

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.