Search Results hz_match_rule_3
Overview
HZ_MATCH_RULE_3 is an Oracle Applications (APPS) PL/SQL package that belongs to the Oracle Trading Community Architecture (TCA) and, more specifically, to the Data Quality Management (DQM) subsystem of Oracle E-Business Suite. Its principal business function is to implement duplicate identification and party matching logic across the HZ schema. When customers, organizations, contacts, or contact points are entered or imported, the package evaluates them against defined match rules stored in HZ_MATCH_RULES_B and determines whether the records represent duplicates or matches of existing parties.
In the context of the user search "hz_party_search," HZ_MATCH_RULE_3 is directly relevant because it is a dependency of HZ_PARTY_SEARCH. The party search infrastructure invokes the matching routines in HZ_MATCH_RULE_3 to return scored and ranked candidate parties rather than relying on exact-key lookups alone. This relationship is documented in the ETRM dependency metadata, which lists APPS.HZ_PARTY_SEARCH as a referencing object and HZ_MATCH_RULE_3 as a referenced object, with mutual dependency. The package status is VALID in the APPS schema and is classified as an OTHER API.
Key Procedures and Functions
The documented API exposes 29 procedures and functions, organized around retrieval and matching of different TCA entity types.
- MAP_* procedures — MAP_PARTY_REC, MAP_PARTY_SITE_REC, MAP_CONTACT_REC, and MAP_CONTACT_POINT_REC map incoming record structures into the internal representations used by the matching engine.
- GET_* functions — GET_PARTY_REC, GET_PARTY_SITE_REC, GET_CONTACT_REC, and GET_CONTACT_POINT_REC retrieve the mapped or matched record data for a given entity.
- CHECK_* functions — CHECK_PRIM_COND, CHECK_PARTY_SITE_COND, CHECK_CONTACT_COND, and CHECK_CONTACT_POINT_COND evaluate individual match conditions against candidate records.
- FIND_* functions — FIND_PARTIES, FIND_PERSONS, and FIND_PARTY_DETAILS perform the primary duplicate searches for party entities.
- Deduplication searches — FIND_DUPLICATE_PARTY_SITES, FIND_DUPLICATE_CONTACTS, FIND_DUPLICATE_CONTACT_POINTS, and FIND_DUPLICATE_PARTIES locate existing duplicate records for each entity type.
- GET_MATCHING_PARTY_SITES — returns party sites that match a supplied set of criteria, supporting the party search flow.
No parameter lists are asserted here; only documented names and purposes are described.
Tables Accessed
The package reads and writes the following documented tables via APPS synonyms:
- HZ_PARTIES — the master party entity; central to FIND_PARTIES and duplicate detection.
- HZ_MATCH_RULES_B — stores the match rule definitions that drive CHECK_* and FIND_* logic.
- HZ_DUP_SETS and HZ_DUP_SET_PARTIES — persist identified duplicate sets and their member parties.
- HZ_DQM_PARTIES_GT and HZ_MATCHED_PARTIES_GT, HZ_MATCHED_CONTACTS_GT, HZ_MATCHED_CPTS_GT, HZ_MATCHED_PARTY_SITES_GT — global temporary tables holding intermediate and final matched results for parties, contacts, contact points, and party sites.
- HZ_ORG_CONTACTS and HZ_CONTACT_POINTS — source contact and contact-point records.
- HZ_LOCATIONS and HZ_ORGANIZATION_PROFILES — address and organization attributes used in match scoring.
- HZ_MERGE_BATCH_S — sequence supporting merge batch processing.
- CTX_QUERY — Oracle Text query infrastructure used for fuzzy text matching.
Usage Notes
HZ_MATCH_RULE_3 is not intended for direct end-user invocation. It is called from HZ_PARTY_SEARCH, which in turn supports the TCA party search and duplicate prevention flows surfaced in the Customers, Suppliers, and TCA administration forms. It is also invoked by DQM concurrent programs such as duplicate identification and merge batch processes, and by the party import interfaces. The mutual dependency between HZ_MATCH_RULE_3 and HZ_PARTY_SEARCH means changes to either object can affect the other. Custom code should call the public party search API rather than HZ_MATCH_RULE_3 directly, since the package is classified as OTHER and its internal record-mapping structures are not part of a supported public interface.
-
PACKAGE: APPS.HZ_MATCH_RULE_3
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_MATCH_RULE_3, status:VALID,
-
PACKAGE: APPS.HZ_MATCH_RULE_3
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_MATCH_RULE_3, status:VALID,
-
PACKAGE BODY: APPS.HZ_MATCH_RULE_3
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:HZ_MATCH_RULE_3, status:VALID,
-
PACKAGE BODY: APPS.HZ_MATCH_RULE_3
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:HZ_MATCH_RULE_3, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_SEARCH
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_SEARCH, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_STAGE
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_STAGE, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_STAGE
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_STAGE, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_SEARCH
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_SEARCH, status:VALID,
-
SYNONYM: APPS.CTX_QUERY
12.2.2
owner:APPS, object_type:SYNONYM, object_name:CTX_QUERY, status:VALID,
-
SYNONYM: PUBLIC.CONTAINS
12.1.1
owner:PUBLIC, object_type:SYNONYM, object_name:CONTAINS, status:VALID,
-
SYNONYM: APPS.HZ_SEARCH_CTX_S
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_SEARCH_CTX_S, status:VALID,
-
SYNONYM: APPS.HZ_MATCH_RULES_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCH_RULES_B, status:VALID,
-
OPERATOR: CTXSYS.CONTAINS
12.1.1
owner:CTXSYS, object_type:OPERATOR, object_name:CONTAINS, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_PARTY_SITES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_PARTY_SITES, status:VALID,
-
SYNONYM: APPS.CTX_QUERY
12.1.1
owner:APPS, object_type:SYNONYM, object_name:CTX_QUERY, status:VALID,
-
SYNONYM: APPS.HZ_DUP_SETS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_DUP_SETS, status:VALID,
-
PACKAGE BODY: APPS.HZ_PARTY_SEARCH
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:HZ_PARTY_SEARCH, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_ACQUIRE
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_ACQUIRE, status:VALID,
-
SYNONYM: APPS.HZ_DQM_PARTIES_GT
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_DQM_PARTIES_GT, status:VALID,
-
SYNONYM: APPS.HZ_PARTY_SCORE_DTLS_GT
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_PARTY_SCORE_DTLS_GT, status:VALID,
-
PACKAGE: APPS.HZ_PARTY_ACQUIRE
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_PARTY_ACQUIRE, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_CPTS_GT
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_CPTS_GT, status:VALID,
-
SYNONYM: APPS.HZ_MERGE_BATCH_S
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_MERGE_BATCH_S, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_PARTY_SITES_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_PARTY_SITES_GT, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_PARTIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_PARTIES, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_CPTS_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_CPTS_GT, status:VALID,
-
SYNONYM: APPS.HZ_DQM_PARTIES_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_DQM_PARTIES_GT, status:VALID,
-
SYNONYM: APPS.HZ_PARTY_SCORE_DTLS_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_PARTY_SCORE_DTLS_GT, status:VALID,
-
PACKAGE: APPS.HZ_TRANS_PKG
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_TRANS_PKG, status:VALID,
-
PACKAGE: APPS.HZ_DQM_SEARCH_UTIL
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_DQM_SEARCH_UTIL, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_CONTACTS_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_CONTACTS_GT, status:VALID,
-
SYNONYM: APPS.HZ_MATCH_RULES_B
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCH_RULES_B, status:VALID,
-
PACKAGE: APPS.HZ_DQM_SEARCH_UTIL
12.2.2
owner:APPS, object_type:PACKAGE, object_name:HZ_DQM_SEARCH_UTIL, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_PARTY_SITES_GT
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_PARTY_SITES_GT, status:VALID,
-
SYNONYM: APPS.HZ_DUP_SET_PARTIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_DUP_SET_PARTIES, status:VALID,
-
SYNONYM: PUBLIC.CONTAINS
12.2.2
owner:PUBLIC, object_type:SYNONYM, object_name:CONTAINS, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_CONTACT_POINTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_CONTACT_POINTS, status:VALID,
-
PACKAGE BODY: APPS.HZ_PARTY_SEARCH
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:HZ_PARTY_SEARCH, status:VALID,
-
SYNONYM: APPS.HZ_SEARCH_CTX_S
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_SEARCH_CTX_S, status:VALID,
-
SYNONYM: APPS.HZ_MERGE_BATCH_S
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MERGE_BATCH_S, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_CONTACTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_CONTACTS, status:VALID,
-
SYNONYM: APPS.HZ_DUP_SET_PARTIES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_DUP_SET_PARTIES, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_PARTY_SITES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_PARTY_SITES, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_CONTACTS_GT
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_CONTACTS_GT, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_CONTACT_POINTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_CONTACT_POINTS, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_CONTACTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_CONTACTS, status:VALID,
-
SYNONYM: APPS.HZ_MATCHED_PARTIES_GT
12.1.1
owner:APPS, object_type:SYNONYM, object_name:HZ_MATCHED_PARTIES_GT, status:VALID,
-
SYNONYM: APPS.HZ_STAGED_PARTIES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:HZ_STAGED_PARTIES, status:VALID,
-
OPERATOR: CTXSYS.CONTAINS
12.2.2
owner:CTXSYS, object_type:OPERATOR, object_name:CONTAINS, status:VALID,
-
PACKAGE: APPS.HZ_TRANS_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:HZ_TRANS_PKG, status:VALID,