addContractAdminSysKey
- Description
- This transaction adds an administration system contract ID, also referred to as a native key, for a given InfoSphere® MDM contract ID.
- Web Services
- Operation name: addContractAdminSysKey
- Example
- A contract is added to the InfoSphere MDM database and assigned a contract ID of 123456. Using this transaction, the back office administration system policy number WL1234 can also be associated with this contract.
- Usage information
- Administration system contract IDs can be added within the addContract transaction when a new contract is added. Administration system keys can also be added to contract components when a new contract component is added, or explicitly using this transaction.
- Preconditions
- A Contract must exist.
- Mandatory input
- ContractId or ContractComponentId
- ContractComponentIndicator must be Y if a ContractComponentId is used
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
- When the contract component indicator is set to N,
the administration system key is associated with the contract; when
this indicator is set to Y, the administration
system key is associated with the contract component.
If administration system keys are added to contract components through the addContract transaction, the respective keys must be included in the corresponding contract component business object for proper association. If the key is added after all the contract components are done, the given AdminContractId will be associated with the Contract itself.
Multiple and identical AdminContractIds are allowed.
The AdminSystemType defaults to type 1.
- Request message
- <TCRMTxType> addContractAdminSysKey
<TCRMTxObject> TCRMAdminNativeKeyBObj
<TCRMObject> TCRMAdminNativeKeyBObj
- Response objects
- TCRMAdminNativeKeyBObj
- Special note
- To delete an AdminContractId added to a contract in error, use
the updateContract or updateContractAdminSysKey transaction
to blank out the erroneous AdminContractId.
To add an AdminContractId to a contract component, use the updateContractComponent transaction.