Example usage of hz_party_search.find_parties API

Question

I have been having errors when trying to execute a search using find_parties. Could someone post example usage? Also, how do I find out what properties/attributes I can put on the records? I am still slightly new to PL/SQL (not new to programming) and I couldn't find out where those type definitions are located (e.g., p_contact_point_list, contact_list, etc.).

Answer 1

Hi,
1) Read about the HZ_PARTY_SEARCH API in the Oracle® Trading Community Architecture, Technical Implementation Guide Release 11I, Part No. B13890-03)
This document clearly explains the usage of the API and description about each parameter. It also gives the sample code for few API’s
1) The properties/attributes which you have pass to the API generally depends upon the Match Rule you want to use for identifying the duplicates. It depends on how you defined the match rule, attributes, score and threshold value.
See the API guide, the P_MATCH_RULE_ID is a mandatory parameter.
3) The type definitions are just PL/SQL record variables. Each record type contains parameter. Generally these PL/SQL records represent the TCA entities
For example, define a Match Rule (Match Rule Id = 1001) with has attributes , score and threshold value as below
Threshold value defined as 100
Party First Name score is 25
Party Last Name score is 25
Party Telephone Number is 25
Party Addess1 is 25
Party Email Address is 100
That means, while searching for parties, if the First Name, Last Name, Telephone Number and Address1 matches to any of the existing TCA party, the score becomes 100 which is equal to threshold, and the API identifies it as duplicate
If the above four attributes don’t match, then the score never reaches 100. Result is No duplicate
In other case, if the Email address match with any of the existing TCA party record, the score is 100 which is equal to threshold, API identifies it as duplicates. I have given the score for Email address as 100 because email address never duplicates.
Now, you can pass the above attributes to the HZ_PARTY_SEARCH.FIND_PARTIES API.
P_PARTY_SEARH_REC.first_name = 'ABC'
P_PARTY_SEARCH_REC.last_name = 'XYZ'
P_CONTACT_POINT_LIST(1).PHONE = '123456789'
P_PARTY_SITE_LIST(1).ADDRESS1 = 'Steet name'
Then call the API. Sorry, I don't have the complete code with me. Here I'm just giving an example with what I recalled on my experience. I have used FIND_PARTIES API successfully in the last assingment.
Regards,
Ram