Skip Navigation Links | |
Exit Print View | |
Oracle Java CAPS Master Index Processing Reference Java CAPS Documentation |
Oracle Java CAPS Master Index Processing Reference
Understanding Operational Processes
A set of Java methods are created in the Master Index EJB project for use in the client applications that call Master Index functions. These methods wrap static Java API methods, allowing them to work with the dynamic object classes. Many of these methods return objects of the dynamic object type, or they use these objects as parameters. In the following methods described for web services, ObjectName indicates the name of the parent object.
This method changes the status of a deactivated enterprise object back to active.
void activateEnterpriseRecord(String euid)
|
None.
ProcessingException
UserException
This method changes the status of a deactivated system object back to active.
void activateSystemRecord(String systemCode, String localId)
|
None.
ProcessingException
UserException
This method adds the system object to the enterprise object associated with the specified EUID.
void addSystemRecord(String euid, SystemObjectName sysObjBean)
where ObjectName is the name of the parent object.
|
None.
ProcessingException
UserException
This method changes the status of an active enterprise object to inactive.
void deactivateEnterpriseRecord(String euid)
|
None.
ProcessingException
UserException
This method changes the status of an active system object to inactive.
void deactivateSystemRecord(String systemCode, String localId)
|
None.
ProcessingException
UserException
executeMatch is one of two methods you can call to process an incoming system object based on the configuration defined for the Manager Service and associated runtime components (the second method is executeMatchUpdate). This process searches for possible matches in the database and contains the logic to add a new record or update existing records in the database. One of the two execute match methods should be used for inserting or updating a record in the database.
The following runtime components configure executeMatch.
The Query Builder defines the blocking queries used for matching.
The Threshold file (master.xml) specifies which blocking query to use and specifies matching parameters, including duplicate and match thresholds.
The pass controller and block picker classes specify how the blocking query is executed.
Note - If executeMatch determines that an existing system record will be updated by the incoming record, it replaces the entire existing record with the information in the new record. This could result in loss of data; for example, if the incoming record does not include all address information, existing address information could be lost. To avoid this, use the executeMatchUpdate method instead.
MatchColResult executeMatch(SystemObjectName sysObjBean)
where ObjectName is the name of the parent object.
|
A match result object containing the results of the matching process.
ProcessingException
UserException
Like executeMatch, executeMatchUpdate processes the system object based on the configuration defined for the Manager Service and associated runtime components. It is configured by the same runtime components as executeMatch. One of these two execute match methods should be used for inserting or updating a record in the database.
The primary difference between these two methods is that when executeMatchUpdate finds that an incoming record matches an existing record, only the changed data is updated. With executeMatch, the entire existing record would be replaced by the incoming record. The executeMatchUpdate method differs from executeMatch in the following ways:
If a partial record is received, executeMatchUpdate only updates fields whose values are different in the incoming record. Unless the clearFieldIndicator field is used, empty or null fields in the incoming record do not update existing values.
The clearFieldIndicator field can be used to null out specific fields.
Child objects in the existing record are not deleted if they are not present in the incoming record.
Child objects in the existing record are updated if the same key field value is found in both the incoming and existing records.
To allow a child object to be removed from the parent object when using executeMatchUpdate, a new “delete” method is added to each child object bean.
MatchColResult executeMatchUpdate(SystemObjectName sysObjBean)
where ObjectName is the name of the parent object.
|
A match result object containing the results of the matching process.
ProcessingException
UserException
This method returns the enterprise object associated with the specified EUID.
EnterpriseObjectName getEnterpriseRecordByEUID(String euid)
|
An enterprise object associated with the specified EUID or null if the enterprise object is not found.
ProcessingException
UserException
This method returns the enterprise object associated with the specified system code and local ID pair.
EnterpriseObjectName getEnterpriseRecordByLID(String systemCode, String localid)
|
An enterprise object or null if the enterprise object is not found.
ProcessingException
UserException
This method returns the EUID of the enterprise object associated with the specified system code and local ID.
String getEUID(String systemCode, String localid)
|
A string containing an EUID or null if the EUID is not found.
ProcessingException
UserException
This method retrieves the local ID and system pairs associated with the given EUID.
SystemObjectNamePK[] getLIDs(String euid)
|
An array of system object keys (SystemObjectNamePK objects) or null if no results are found.
ProcessingException
UserException
This method retrieves the local ID and system pairs that are of the specified status and that are associated with the given EUID.
SystemObjectNamePK[] getLIDsByStatus(String euid, String status)
|
An array of system object keys (SystemObjectNamePK objects) or null if no system object keys are found.
ProcessingException
UserException
This method retrieves the single best record (SBR) associated with the specified EUID.
SBRObjectName getSBR(String euid)
|
An SBR object or null if no SBR associated with the specified EUID is found.
ProcessingException
UserException
This method retrieves the system object associated with the given system code and local ID pair.
SystemObjectName getSystemRecord(String systemCode, String localid)
|
A system object containing the results of the search or null if no system objects are found.
ProcessingException
UserException
This method returns the active system objects associated with the specified EUID.
SystemObjectName[] getSystemRecordsByEUID(String euid)
|
An array of system objects associated with the specified EUID.
ProcessingException
UserException
This method returns the system objects of the specified status that are associated with the given EUID.
SystemObjectName[] getSystemRecordsByEUIDStatus(String euid, String status)
|
An array of system objects associated with the specified EUID and status, or null if no system objects are found.
ProcessingException
UserException
This method first looks up the EUID associated with the specified source system and source local ID. It then retrieves the local ID and system pairs of the specified status that are associated with that EUID and are from the specified destination system. Note that both systems must be of the specified status or an error will occur.
SystemObjectNamePK[] lookupLIDs(String sourceSystemCode, String sourceLID, String destSystemCode, String status)
|
An array of system object keys (SystemObjectNamePK objects).
ProcessingException
UserException
This method returns an array of potential duplicate result records based on the criteria contained in the potential duplicate search object.
PotentialDuplicateResult[] lookupPotentialDuplicates(PotentialDuplicateSearchObjectBean pdsoBean)
|
An array of PotentialDuplicateResult objects representing the matches to a potential duplicate search.
ProcessingException
UserException
PageException
RemoteException
This method merges two enterprise objects, specified by their EUIDs.
MergeObjectNameResult mergeEnterpriseRecord(String fromEUID, String toEUID, boolean calculateOnly)
|
A merge result object containing the results of the merge.
ProcessingException
UserException
This method merges two system objects, specified by their local IDs, from the specified system. The system objects can belong to a single enterprise object or to two different enterprise objects.
MergeObjectNameResult mergeSystemRecord(String systemCode, String sourceLID, String destLID, boolean calculateOnly)
|
A merge result object containing the results of the merge.
ProcessingException
UserException
This method performs a blocking query against the database using the blocking query specified in the master.xmland the criteria contained in the specified object bean.
SearchObjectNameResult[] searchBlock(ObjectNameBean objBean)
|
An array of search result records.
ProcessingException
UserException
This method performs an exact match search using the criteria specified in the object bean. Only records that exactly match the search criteria are returned in the search results object.
SearchObjectNameResult[] searchExact(ObjectNameBean objBean)
|
An array of search result records.
ProcessingException
UserException
This method performs search using phonetic values for some of the criteria specified in the object bean. This type of search allows for typographical errors and misspellings.
SearchObjectNameResult[] searchPhonetic(ObjectNameBean objBean)
|
An array of search result records.
ProcessingException
UserException
This method transfers a system record from one enterprise record to another enterprise record.
void transferSystemRecord(String toEUID, String systemCode, String localID)
|
None.
ProcessingException
UserException
This method updates the fields in an existing enterprise object with the values specified in the fields the enterprise object passed in as a parameter. When updating an enterprise object, attempting to change a field that is not updateable will cause an exception. This method does not update the SBR; the survivor calculator updates the SBR once the changes are made to the associated system records.
void updateEnterpriseRecord(EnterpriseObjectName eoBean)
|
None.
ProcessingException
UserException
This method updates the existing system object in the database with the given system object.
void updateSystemRecord(SystemObjectName sysObjBean)
|
None.
ProcessingException
UserException