standardizeAndUpdatePersonName
- Description
This transaction standardizes and persists an existing person name.
- Web Services
Operation name: standardizeAndUpdatePersonName
Service name: Party
- Example
Standardize the name Jim Van der Kamp and persist the standardized person name.
- Usage information
The person name identifier (PersonNameIdPK) of an existing name is required in the request. Other name information provided in the request is ignored by this service.
- Preconditions
The person name to be standardized should exist in InfoSphere® MDM. The system should be configured with either the default InfoSphere MDM standardizer or a third party name standardizer, such as QualityStage.
- Mandatory input
- PersonNameIdPK
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
This service standardizes the last name and given names of a specified person name record, and updates the names in the PERSONSEARCH table.
The service standardizes and updates the person name regardless of the existing value of the /IBM/Party/ExcludePartyNameStandardization/enabled configuration setting, and regardless of the existing value for the standardFormattingIndicator. Any existing standardized values in the PERSONSEARCH table are overwritten with results from the standardizer.
If the person name standardization is successful and a third party name standardizer is in use, then this service sets the value of standardFormattingIndicator to
Y
.If the person name standardization is successful and the default InfoSphere MDM name standardizer is in use, then this service sets the value of standardFormattingIndicator to
null
.If the person name standardization is unsuccessful, this service sets the value of standardFormattingIndicator to
N
.If the phonetic key generator is configured on, then the service also updates the phonetic keys for the provided name.
A note on redundant updates: The standard formatting indicator for Person Name is included on the ignore list for redundant updates. However, the standardizeAndUpdatePersonName 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> standardizeAndUpdatePersonName
<TCRMTxObject> TCRMPersonNameBObj
<TCRMObject> TCRMPersonNameBObj
- Response objects
- TCRMPersonNameBObj
- Special note
- Not applicable