getRevisionHistory

Description
This transaction provides the user with a list of dates when history data changed for a specified business object over a specified period of time.
Web Services
Operation name: getRevisionHistory
Service name: ProductServices
Example
View all dates that John Smith's address changed on, between January 1, 2007 and December 31, 2007.
Usage information
The InquireFromDate element in the control object must also be provided. The InquireToDate element in the control object is optional, and if not provided is defaulted to the end of the day for InquireFromDate. The length of the date range can be limited through an external validation.
If theInquireFromDate is provided, with or without an InquireToDate, the InquireAsOfDate cannot be provided. The business objects that are the input for this transaction must be recorded in the InfoSphere® MDM Metadata V_GROUP table.
The business objects currently supported are PartyBObj, PersonBObj, OrganizationBObj and ContractBObj. Depending on the GroupInquiryLevel, the response can include the list of dates where the history changed for requested business object or for requested business object and its first level child business objects.
Preconditions
The getRevisionHistory transaction requires the presence of historical records in the history database. If database triggers are altered, the getRevisionHistory function is affected.
Mandatory input
  • InquireFromDate
  • Business object name
  • Business object IdPK
  • GroupInquiryLevel
Inquiry levels
Only inquiry levels 0 and 1 are supported.
Note: Level 1 returns are different depending on the business object being queried.
GroupInquiryLevel:
  • Level 0 - returns a list of dates showing when the business object being inquired on has changed
  • Level 1 for PartyBObj and for PersonBObj - returns:
    • Person
    • PersonName
    • AccessDateValue
    • PartyAddress and Address
    • PartyContactMethod and ContactMethod
    • PartyBankAccount
    • PartyChargeCard
    • PartyPayrollDeduction
    • IncomeSource
    • PartyIdentification
    • PartyRelationship
    • alerts for PartyAlert
    • AdminContEquiv
    • PartyLobRelationship
    • PartyPrivPref
    • PartyValue
    • AccessDateValue
  • Level 1 for PartyBObj and OrganizationBObj - returns:
    • Organization
    • OrganizationName
    • PartyAddress and Address
    • PartyContactMethod and ContactMethod
    • PartyBankAccount
    • PartyChargeCard
    • PartyPayrollDeduction
    • IncomeSource
    • PartyIdentification
    • PartyRelationship
    • alerts for PartyAlert
    • AdminContEquiv
    • PartyLobRelationship
    • PartyPrivPref
    • PartyValue
    • AccessDateValue
  • Level 1 for ContractBObj - returns:
    • ContractComponent
    • AdminNativeKey
    • ContractAlert
    • ContractRelationship
Filter values
Not applicable
Transaction behavior
Using the date range, the history tables associated with the object specified in the request are queried to determine when changes occurred during the time specified. Supported ContractInquiryLevels are 0 and 1.
Request message
<InquiryType> getRevisionHistory
<tcrmParam name="GroupName">
<tcrmParam name="InstancePK">
<tcrmParam name="GroupInquiryLevel">
Response objects
TCRMRevisionHistoryBObj
Special note
Not applicable