standardizeAndUpdateContactMethod
- Description
- This transaction standardizes and persists an existing contact method (phone numbers only).
- Web Services
Operation name: standardizeAndUpdateContactMethod
Service name: Party
- Example
Standardize the contact method value (416) 555-1212 x2305 and persist the standardized contact method.
- Usage information
Only the contact method identifier (ContactMethodIdPK) is mandatory in the request. The ContactMethodIdPK must reference an existing contact method record that has a ContactMethodType=1 (Telephone Number). Any other contact method information provided in the request is ignored by the standardizeAndUpdateContactMethod transaction.
- Preconditions
The contact method to be standardized should exist in InfoSphere® MDM. The system should be configured with either the default InfoSphere MDM standardizer or a third party phone number standardizer, such as QualityStage.
- Mandatory input
- ContactMethodIdPK
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
This transaction standardizes and updates the given phone number record in the CONTACTMETHOD table.
The transaction standardizes and updates the contact method regardless of the existing value of the standardFormattingIndicator.
If the contact method standardization is successful, a third party phone number standardizer is in use, and the configuration parameter /IBM/ThirdPartyAdapters/IIS/StandardizePhoneNumber/StandardFormattingIndicator/enabled is set to
true, this transaction sets the value of standardFormattingIndicator toY.If the contact method standardization is successful and the default InfoSphere MDM phone number standardizer is in use, then this transaction sets the value of standardFormattingIndicator to
null.If the contact method standardization is unsuccessful, this transaction sets the value of standardFormattingIndicator to
N.If phone number normalization is enabled, then the transaction also returns a TCRMPhoneNumberBObj business object with normalized data.
A note on redundant updates: The standard formatting indicator for Contact Method is included on the ignore list for redundant updates. However, the standardizeAndUpdateContactMethod transaction will be able to standardize and update a record regardless of the redundant update configuration. For example, even if the values before and after a successful standardization are identical, this transaction can still update the record to set the standard formatting indicator toY.- Request message
<TCRMTxType> standardizeAndUpdateContactMethod
<TCRMTxObject> TCRMContactMethodBObj
<TCRMObject> TCRMContactMethodBObj
- Response objects
- TCRMContactMethodBObj
- Special note
- Not applicable