Record Add Modify Services - Inputs
Command type
The valid command types are:
- Add – Use when the root record in a bundle is being added.
- Modify – Use when the root record in a bundle is being modified.
Set the entity command qualifier to any of the following:
- Validate/Process – Causes the records to be validated before saving. This also initiates New Record Introduction Edit (NRIE) workflows. This is the default.
- Validate/NoProcess – Validates records and save them without starting the NRIE workflows.
- NoValidate/Process – Does not validate the records, but saves them, and also starts NRIE workflows.
- NoValidate/NoProcess – Does not validate the records or start the workflow, but saves them.
- NoValidate/ProcessOnDataChange (only for the Modify command type) – Does not validate records, however processes and saves the records when the data has changed for the specified records. If the data has not changed, an error is returned.
- Validate/ProcessOnDataChange (only for the Modify command type) – Validates the records, however processes and saves the records only when the data has changed for the specified records. If the data has not changed, an error is returned.
Execution Mode
Set the execmode to either SYNCHR or ASYNCHR. For more information, refer to Execution Modes.
Handling File Type Attributes
TIBCO MDM can handle file type attributes either as attachments or as relative paths into the application. To perform this, specify the FILE_TYPE_ATTRIBUTES context variable with the following two valid values:
- ATTACHMENT – Indicates that the client has sent the file type attributes as SOAP attachments.
- HREF – Indicates that the client had already loaded the files onto the server (using HTTP post), and wants the server file type attributes to be processed as relative paths into the application. This is the default.
<Context> <Variable name="FILE_TYPE_ATTRIBUTES" type="string">ATTACHMENT</Attribute> </Context>
Handling System Generated Attributes
You cannot change the following system-generated attributes. If any of the following attributes are specified in the request XML, an error is returned.
Active, creation date, moddate, version number, product keyID, modmemberID, checksum, importtime stamp, ownerID, ownerType, lastConfirmedVersion, processLogID, batchID, parentVersion, catalogVersionNumber
Support for Correction
- New: creates a new version of the record
- Correct: updates the existing version of a record instead of creating a new one
- Optimize: combination of both New and Correct values. TIBCO MDM automatically decides whether or not to correct a record, or create a new version. If the VERSION_POLICY context variable is specified as Optimize, some rules are used. To know about the rules, refer to the VersionPolicy parameter mentioned in workflow activities of the TIBCO MDM Workflow Reference.
<Context> <Variable name="VERSION_POLICY" type="string">Correct</Variable> </Context>For information on the use of theCorrection option on UI, refer to TIBCO MDM User's Guide.
Support for Perspective
<Context> <Variable name="PERSPECTIVENAME" type="string">PerspEmpAddress</Variable> </Context>
- For information on the use of perspective from UI, refer to TIBCO MDM User's Guide.
- For information on the use of PerspectiveName parameter in the workflow activities, refer to TIBCO MDM Workflow Reference.
- For information on the perspective cache, refer to TIBCO MDM Installation and Configuration Guide.
External Keys
Each record in the record bundle must be external keys. The external keys have the following semantics:
RECORD_STATE
The request can provide the state in which the records need to be saved. The state is accepted as an attribute in the entity data with the name RECORD_STATE. The valid states are:
- UNCONFIRMED: If the Validate/NoProcess command type is specified, by default the UNCONFIRMED state is considered.
- CONFIRMED: If the Validate/Process command type is specified, by default the CONFIRMED state is considered.
- DRAFT
If an attribute is a multi-value attribute, it is represented as follows:
<MultiValueAttribute type="string" name="COLOR"> <Value>red</Value> <Value>green</Value> <Value>yellow</Value> </MultiValueAttribute In this example, COLOR is a multi-value attribute.
If an attribute is defined as a relationship attribute, it is represented as follows:
<Relationship>
<RelationType>Contains</RelationType>
<RelatedEntities>
<MasterCatalogRecord etype="Entity">
<ExternalKeys>
<Key name="MASTERCATALOGNAME" type="string">Customer1</Key>
<Key name="PRODUCTID" type="string">a2-demo1TEST3</Key>
<Key name="PRODUCTIDEXT" type="string">a2-demo1TEST3</Key>
</ExternalKeys>
<EntityData>
<Attribute name="QUANTITY" type="integer">1</Attribute>
</EntityData>
</MasterCatalogRecord>
</RelatedEntities>
</Relationship>
In this example, QUANTITY is a relationship attribute.
For a sample of multi-value attributes and relationship attributes, refer to $MQ_HOME/schema/DataService/2.0/samples.
WorkItem Reference
When a record is modified in the context of a work item, the request must contain the context variable WORKITEMREFERENCE that references the work item before the <Transaction> element.
<Context> <Variable name="WORKITEMREFERENCE" type="string">10001</Variable> </Context>
The work item reference is usually obtained from the Record Query/ValidValues or Work Item Query service.