Manipulates Firmwater LMS object data within the client's organization. Creation of new objects and modification of existing objects is accomplished via the CreateOrUpdate method.

Syntax

SaveResult = lmsBinding.CreateOrUpdate (LmsObject[] lmsObjects);

Usage

One or more objects can be created or updated during a single call. An object's unique identifying attributes are used to determine whether or not a new object is being created. If an object with the identifying information is found, the data is updated. Otherwise, the object is created.

Multiple objects may be created and/or modified during a single call but the the array is restricted in that it may contain only one type of object. Although all editable LMS objects inherit from LmsObject, all elements of the lmsObjects array must be of the same derived type. Calling CreateOrUpdate while passing in mixed object types in the lmsObjects array causes an exception to be thrown, and immediate termination of the request with no processing of data.

The method currently supports the following types of objects:

• LmsLicenseeObject
• LmsLocationObject
• LmsDepartmentObject
• LmsJobTitleObject
• LmsCertificationObject
• LmsPersonObject
• LmsItemObject
• LmsRegistrationObject

Rules and Guidelines

Permissions

Client applications must be logged in with sufficient privilege and access rights to create or modify individual objects passed in as part of the lmsObjects array.

Several objects contain fields referencing other objects. A client application must also be logged in with sufficient privilege and rights to access the objects referenced. Prior to manipulating a particular object, a developer should read the objects description in Firmwater LMS Objects.

Automatically Maintained Fields

Several Firmwater LMS objects contain fields that are automatically maintained. The method populates certain fields accordingly. Examples of fields that are automatically populated include CreatedDatetime, and UpdatedDatetime. The values for these fields cannot be explicitly specified. If a client application specifies a value for a read-only field that is automatically maintained, Firmwater LMS web service will ignore the specified value.

Autonomous Execution

During a single CreateOrUpdate call many objects may be manipulated. Manipulation of objects occurs in an autonomous fashion. The results of manipulating two LmsObjects are mutually exclusive, that is, one action may succeed and one action may fail, but neither result affects the other and all objects passed in are processed regardless.

Valid Data Values

Every field has an associated data type. Values supplied must adhere to specifications for the field's data type as described in Firmwater LMS Web Service Data Types.

Maximum Number of Objects to Manipulate

During a single CreateOrUpdate call a maximum of 200 objects may be manipulated. Any request to modify a number of objects greater than the specified maximum will be terminated immediately and no objects will be processed (the entire operation fails).

Creating Objects

The following basic steps outline the creation of Firmwater LMS objects after successful authentication:

1. Instantiate one or more objects of the same type making sure to populate all identifying and required fields accordingly.
2. Create an array of type LmsObject[] and populate it with the previously instantiated objects. Once again, all instances must be of the same object type.
3. Call CreateOrUpdate passing in the LmsObject[] array and store the returned SaveResult[] array.
4. Process each SaveResult instance contained within the array to ensure all objects were successfully manipulated. Refer to SaveResult for more information on determining the outcome of a single manipulation operation.

Updating Objects

The same basic steps outlined for creating objects apply when updating Firmwater LMS object records. A Firmwater LMS object can be modified by setting the identifying fields and the fields to be updated. Required fields are not necessary if the object already exists. Fields that are not set will not be updated (except for Automatically Maintained Fields).

Arguments

Name	Type	Description
lmsObjects	LmsObject[]	Array of LMS objects to be created/updated.

Return Object

SaveResult[]