Working with the Java API

Sun Master Index provides several Java classes and methods to use to transform and process data in a master index Project. The master index API is specifically designed to help you maintain the integrity of the data in the database by providing specific methods for updating, adding, and merging records in the database. This chapter discusses the following topics:

• Overview

• Java Class Types

• Dynamic Web Service Methods

• Web Services Helper Classes

Overview

This chapter provides an overview of the Java API for a Sun master index application, and describes the dynamic classes and methods that are generated based on the object structure of the master index application. For detailed information about the static classes and methods, refer to the Sun Master Index Javadocs, available at http://developers.sun.com/docs/javacaps/api/javadocs/SunMasterIndex/index.html. Unless otherwise noted, all classes and methods described in this chapter are public. Methods inherited from classes other than those described in this chapter are listed, but not described.

Java Class Types

Sun Master Index provides a set of static API classes that can be used with any object structure and any Sun master index application. Sun Master Index also generates several dynamic API classes that are specific to the object structure of each master index application. The dynamic classes contain similar methods, but the number and names of methods change depending on the object structure.

Static Classes

Static classes provide the methods you need to perform basic data cleansing and processing functions against incoming data, such as performing searches, reviewing potential duplicates, adding and updating records, and merging and unmerging records. The primary class containing these functions is the MasterController class, which includes the executeMatch methods. Several classes support the MasterController class by defining additional objects and functions. Documentation for the static methods is provided in Javadoc format.

Dynamic Web Services Classes

When you generate a master index Project, several dynamic methods are created in the Master Index EJB project that are specific to the object structure defined for the master index application. This includes classes that define each parent and child object in the object structure and that allow you to work with the data in each object. If the object structure is modified, regenerating the Project updates the dynamic methods for the new structure.

The EJB class that defines the primary web service methods is named after the parent object, and defines the main methods you use to transform and manipulate data between external systems and the master index database. There are also several helper classes that define the objects that are used as parameters and results for the primary web services, and that define the objects involved in Master Index processing.

The dynamic web services classes are located in the Master Index EJB project in the com.sun.mdm.index.webservice package under Source Packages. You can view the primary EJB class under Web Services in the EJB project. Additional supporting API classes are generated in the remaining Java packages under Source Packages.

Dynamic Web Service Methods

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.

Dynamic API Method Descriptions

activateEnterpriseRecord

Description

This method changes the status of a deactivated enterprise object back to active.

Syntax

void activateEnterpriseRecord(String euid)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

activateSystemRecord

Description

This method changes the status of a deactivated system object back to active.

Syntax

void activateSystemRecord(String systemCode, String localId)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

addSystemRecord

Description

This method adds the system object to the enterprise object associated with the specified EUID.

Syntax

void addSystemRecord(String euid, SystemObjectName sysObjBean)

where ObjectName is the name of the parent object.

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

deactivateEnterpriseRecord

Description

This method changes the status of an active enterprise object to inactive.

Syntax

void deactivateEnterpriseRecord(String euid)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

deactivateSystemRecord

Description

This method changes the status of an active system object to inactive.

Syntax

void deactivateSystemRecord(String systemCode, String localId)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

executeMatch

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.

  ---

Syntax

MatchColResult executeMatch(SystemObjectName sysObjBean)

where ObjectName is the name of the parent object.

Parameters

Returns

A match result object containing the results of the matching process.

Throws

• ProcessingException

• UserException

executeMatchUpdate

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.

Syntax

MatchColResult executeMatchUpdate(SystemObjectName sysObjBean)

where ObjectName is the name of the parent object.

Parameters

Returns

A match result object containing the results of the matching process.

Throws

• ProcessingException

• UserException

getEnterpriseRecordByEUID

Description

This method returns the enterprise object associated with the specified EUID.

Syntax

EnterpriseObjectName getEnterpriseRecordByEUID(String euid)

Parameters

Returns

An enterprise object associated with the specified EUID or null if the enterprise object is not found.

Throws

• ProcessingException

• UserException

getEnterpriseRecordByLID

Description

This method returns the enterprise object associated with the specified system code and local ID pair.

Syntax

EnterpriseObjectName getEnterpriseRecordByLID(String systemCode, String localid)

Parameters

Returns

An enterprise object or null if the enterprise object is not found.

Throws

• ProcessingException

• UserException

getEUID

Description

This method returns the EUID of the enterprise object associated with the specified system code and local ID.

Syntax

String getEUID(String systemCode, String localid)

Parameters

Returns

A string containing an EUID or null if the EUID is not found.

Throws

• ProcessingException

• UserException

getLIDs

Description

This method retrieves the local ID and system pairs associated with the given EUID.

Syntax

SystemObjectNamePK[] getLIDs(String euid)

Parameters

Returns

An array of system object keys (SystemObjectNamePK objects) or null if no results are found.

Throws

• ProcessingException

• UserException

getLIDsByStatus

Description

This method retrieves the local ID and system pairs that are of the specified status and that are associated with the given EUID.

Syntax

SystemObjectNamePK[] getLIDsByStatus(String euid, String status)

Parameters

Returns

An array of system object keys (SystemObjectNamePK objects) or null if no system object keys are found.

Throws

• ProcessingException

• UserException

getSBR

Description

This method retrieves the single best record (SBR) associated with the specified EUID.

Syntax

SBRObjectName getSBR(String euid)

Parameters

Returns

An SBR object or null if no SBR associated with the specified EUID is found.

Throws

• ProcessingException

• UserException

getSystemRecord

Description

This method retrieves the system object associated with the given system code and local ID pair.

Syntax

SystemObjectName getSystemRecord(String systemCode, String localid)

Parameters

Returns

A system object containing the results of the search or null if no system objects are found.

Throws

• ProcessingException

• UserException

getSystemRecordsByEUID

Description

This method returns the active system objects associated with the specified EUID.

Syntax

SystemObjectName[] getSystemRecordsByEUID(String euid)

Parameters

Returns

An array of system objects associated with the specified EUID.

Throws

• ProcessingException

• UserException

getSystemRecordsByEUIDStatus

Description

This method returns the system objects of the specified status that are associated with the given EUID.

Syntax

SystemObjectName[] getSystemRecordsByEUIDStatus(String euid, String status)

Parameters

Returns

An array of system objects associated with the specified EUID and status, or null if no system objects are found.

Throws

• ProcessingException

• UserException

lookupLIDs

Description

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.

Syntax

SystemObjectNamePK[] lookupLIDs(String sourceSystemCode, String sourceLID, 
String destSystemCode, String status)

Parameters

Returns

An array of system object keys (SystemObjectNamePK objects).

Throws

• ProcessingException

• UserException

lookupPotentialDuplicates

Description

This method returns an array of potential duplicate result records based on the criteria contained in the potential duplicate search object.

Syntax

PotentialDuplicateResult[] lookupPotentialDuplicates(PotentialDuplicateSearchObjectBean pdsoBean)

Parameters

Returns

An array of PotentialDuplicateResult objects representing the matches to a potential duplicate search.

Throws

• ProcessingException

• UserException

• PageException

• RemoteException

mergeEnterpriseRecord

Description

This method merges two enterprise objects, specified by their EUIDs.

Syntax

MergeObjectNameResult mergeEnterpriseRecord(String fromEUID, String toEUID, 
boolean calculateOnly)

Parameters

Returns

A merge result object containing the results of the merge.

Throws

• ProcessingException

• UserException

mergeSystemRecord

Description

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.

Syntax

MergeObjectNameResult mergeSystemRecord(String systemCode, String sourceLID, 
String destLID, boolean calculateOnly)

Parameters

Returns

A merge result object containing the results of the merge.

Throws

• ProcessingException

• UserException

searchBlock

Description

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.

Syntax

SearchObjectNameResult[] searchBlock(ObjectNameBean objBean)

Parameters

Returns

An array of search result records.

Throws

• ProcessingException

• UserException

searchExact

Description

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.

Syntax

SearchObjectNameResult[] searchExact(ObjectNameBean objBean)

Parameters

Returns

An array of search result records.

Throws

• ProcessingException

• UserException

searchPhonetic

Description

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.

Syntax

SearchObjectNameResult[] searchPhonetic(ObjectNameBean objBean)

Parameters

Returns

An array of search result records.

Throws

• ProcessingException

• UserException

transferSystemRecord

Description

This method transfers a system record from one enterprise record to another enterprise record.

Syntax

void transferSystemRecord(String toEUID, String systemCode, String localID)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

updateEnterpriseRecord

Description

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.

Syntax

void updateEnterpriseRecord(EnterpriseObjectName eoBean)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

updateSystemRecord

Description

This method updates the existing system object in the database with the given system object.

Syntax

void updateSystemRecord(SystemObjectName sysObjBean)

Parameters

Returns

None.

Throws

• ProcessingException

• UserException

Web Services Helper Classes

Helper classes include objects that can be passed as parameters to a primary web services method. They also include the methods that you can access through the systemObjectName variable in Java clients or Business Processes (where ObjectName is the name of a parent object. The helper classes include:

• SystemObjectName

• Parent Beans

• Child Beans

• DestinationEO

• SearchObjectNameResult

• SourceEO

• SystemObjectNamePK

Helper classes are located in the Master Index EJB project in the com.sun.mdm.index.webservice package.

Enterprise Object Classes

A Java class is created to represent the entire object, which includes the single best record (SBR) and any associated system objects. The methods in this class provide the ability to retrieve, set, and delete system objects, and to retrieve and set attributes of the enterprise object.

The name of the enterprise object class is the same as the name of the application, with the word “Enterprise” prepended. For example, if the application name is “Person”, the name of the enterprise object class is “EnterprisePerson”. The methods in this class include a constructor method for the enterprise object, get and set methods for object attributes, and get, set, and delete methods for the system objects. Many methods have dynamic names based on the name of the parent object. In the following methods described for the enterprise object, ObjectName indicates the name of the parent object.

Definition

class ObjectNameObject

Methods

EnterpriseObjectName

Description

This is the constructor method for the enterprise object class. You can instantiate this class to create a new instance of the enterprise object.

Syntax

new EnterpriseObjectName()

Parameters

None.

Returns

An instance of the enterprise object.

Throws

None.

countSystemObjectName

Description

This method counts the system objects (class SystemObjectName) in the enterprise object. Use this method to loop through the system objects.

Syntax

int countSystemObjectName()

Parameters

None.

Returns

An integer representing the number of system objects.

Throws

None.

deleteSystemObject

Description

This method marks a system object for deletion from an instance of EnterpriseObjectName. The system object is deleted when the enterprise object is updated.

Syntax

void deleteSystemObject(String system, String lid)

Parameters

Returns

None.

Throws

ObjectException

deleteSystemObjectBean

Description

This method marks a system object for deletion from an instance of EnterpriseObjectName. The system object is deleted when the enterprise object is updated.

Syntax

void deleteSystemObjectBean(String system, String lid)

Parameters

Returns

None.

Throws

ObjectException

getEUID

Description

This method retrieves the EUID from an instance of EnterpriseObjectName.

Syntax

String getEUID()

Parameters

None.

Returns

A string containing the EUID of the enterprise object.

Throws

ObjectException

getSBRObjectName

Description

This method retrieves the SBR from an instance of EnterpriseObjectName.

Syntax

SBRObjectName getSBRObjectName()

Parameters

None.

Returns

The SBR object from the enterprise object.

Throws

None.

getStatus

Description

This method retrieves the status of the enterprise object.

Syntax

String getStatus()

Parameters

None.

Returns

The status of the enterprise object.

Throws

ObjectException

getSystemObjectName

Description

This method retrieves all of the system objects associated with the enterprise object.

Syntax

SystemObjectName[] getSystemObjectName()

Parameters

None.

Returns

A collection of system objects.

Throws

None.

getSystemObjectName

Description

This method retrieves a system object based on its index in a list of system objects.

Syntax

SystemObjectName getSystemObjectName(int index)

Parameters

Returns

The system object at the specified index.

Throws

None.

getSystemObjectNameCount

Description

This method returns the number of system objects in a collection of system objects.

Syntax

int getSystemObjectNameCount()

Parameters

None.

Returns

An integer indicating the number of system objects in an enterprise object.

Throws

None.

removeSystemObject

Description

This method removes a system object from an enterprise object. Use this to remove the system object from the in-memory instance of EnterpriseObjectName. This does NOT result in the deletion of the system object from the database (see deleteSystemObject).

Syntax

void removeSystemObject(String system, String lid)

Parameters

Returns

None.

Throws

ObjectException

removeSystemObjectBean

Description

This method removes a system object from an enterprise object. Use this to remove the system object from the in-memory instance of EnterpriseObjectName. This does NOT result in the deletion of the system object from the database (see deleteSystemObjectBean).

Syntax

void removeSystemObjectBean(String system, String lid)

Parameters

Returns

None.

Throws

ObjectException

setEUID

Description

This method sets the value of the EUID field in an enterprise object.

Syntax

void setEUID(String euid)

Parameters

Returns

None.

Throws

ObjectException

setStatus

Description

This method sets the status of the enterprise object.

Syntax

void setStatus(String status)

Parameters

Returns

None.

Throws

ObjectException.

setSystemObjectName

Description

This method sets a collection of system objects in an enterprise object.

Syntax

void setSystemObjetName(SystemObjectName[] systemObjectName)

Parameters

Returns

None.

Throws

ObjectException.

SystemObjectName

In order to run executeMatch or executeMatchUpdatefrom a client application, you must define a variable of the class type SystemObjectName, where ObjectName is the name of a parent object. This class is passed as a parameter to the execute match methods. The class contains a constructor method and several get and set methods for system fields. It also includes one field that specifies the value of the clear field character (for more information, see Clear Field Indicator).

In the methods described in this section, ObjectName indicates the name of the parent object, Child indicates the name of a child object, and Field indicates the name of a field defined for the parent object.

Definition

class SystemObjectName

Methods

Inherited Methods

The following methods are inherited from java.lang.Object.

• equals

• hashcode

• notify

• notifyAll

• toString

• wait()

• wait(long arg)

• wait(long timeout, int nanos)

Clear Field Indicator

The clear field indicator allows you to specify whether to treat a field in the parent object as null when performing an update from an external system. When an update is performed in the master index application, empty fields typically do not overwrite the value of an existing field. You can specify to nullify a field that already has an existing value in the master index application by entering an indicator in that field. This indicator is specified by the clear field indicator. By default, the clear field indicator is set to double-quotes (“”), so if a field is set to double-quotes, that field will be blanked out in the master index if the incoming record has a field value of null and the record being updated has a field value other than null. If you do not want to use this feature, set the clear field indicator to null.

SystemObjectName

Description

This method is the user-defined system class for the parent object. You can instantiate this class to create a new instance of the system class.

Syntax

new SystemObjectName()

Parameters

None.

Returns

An instance of the SystemObjectName class.

Throws

ObjectException

getClearFieldIndicator

Description

This method retrieves the value of the clear field indicator.

Syntax

Object getClearFieldIndicator()

Parameters

None.

Returns

The clear field indicator.

Throws

None.

getField

Description

This method retrieves the value of the specified system field. There are getter methods for the following fields: LocalId, SystemCode, Status, CreateDateTime, CreateFunction, CreateUser, and UpdateUser.

Syntax

String getField()

or

Date getField()

Parameters

None.

Returns

The value of the specified field. The type of value returned depends on the field from which the value was retrieved.

Throws

ObjectException

getObjectName

Description

This method retrieves the system record JavaBean.

Syntax

ObjectNameBean getObjectName()

Parameters

None.

Returns

A JavaBean containing the system record.

Throws

None.

setClearFieldIndicator

Description

This method sets the value of the clear field indicator. By default, this is set to double quotes (“”).

Syntax

void setClearFieldIndicator(String value)

Parameters

Returns

None.

Throws

None.

setField

Description

This method sets the value of the specified system field. There are setter methods for the following fields: LocalId, SystemCode, Status, CreateDateTime, CreateFunction, CreateUser, and UpdateUser.

Syntax

void setField(value)

Parameters

Returns

None.

Throws

ObjectException

setObjectName

Description

This method sets the system object JavaBean.

Syntax

void setObjectName(ObjectNameBean aObjectName)

Parameters

Returns

None.

Throws

ObjectException

Parent Beans

A JavaBean is created to represent the parent object defined in the object structure of the master index application. The methods in this class are generated based on the object structure and provide the ability to create a parent object Bean and to set or retrieve the field values for that JavaBean.

The name of the parent JavaBean class is the same as the name of the parent object, with the word “Bean” appended. For example, if the parent object in your object structure is “Person”, the name of the associated parent Bean class is “PersonBean”. The methods in this class include a constructor method for the parent object Bean, get and set methods for each field defined for the parent object, and methods to manipulate child objects. Most methods have dynamic names based on the name of the parent object and the fields and child objects defined for that object. In the methods described in this section, ObjectName indicates the name of the parent object, Child indicates the name of a child object, and Field indicates the name of a field defined for the parent object.

Definition

final class ObjectNameBean

Methods

Inherited Methods

The following methods are inherited from java.lang.Object.

• equals

• hashcode

• notify

• notifyAll

• toString

• wait()

• wait(long arg)

• wait(long timeout, int nanos)

ObjectNameBean

Description

This method is the user-defined object Bean class. You can instantiate this class to create a new instance of the parent object Bean class.

Syntax

new ObjectNameBean()

Parameters

None.

Returns

An instance of the parent object Bean.

Throws

ObjectException

countChild

Description

This method returns the total number of child objects contained in a system object. The type of child object is specified by the method name, such as countPhone or countAddress.

Syntax

int countChild()

Parameters

None.

Returns

An integer indicating the number of child objects in a collection.

Throws

None.

countChildren

Description

This method returns a count of the total number of child objects belonging to a system object.

Syntax

int countChildren()

Parameters

None.

Returns

An integer representing the total number of child objects.

Throws

None.

countChildren

Description

This method returns a count of the total number of child objects of a specific type that belong to a system object.

Syntax

int countChildren(String type)

Parameters

Returns

An integer representing the total number of child objects of the specified type.

Throws

None.

deleteChild

Description

This method removes the specified child object from the system object. The type of child object to remove is specified by the name of the method, and the specific child object to remove is specified by its unique identification code assigned by the master index application.

Syntax

void deleteChild(String ChildId)

Parameters

Returns

None.

Throws

ObjectException

getChild

Description

This method retrieves an array of child object JavaBeans. Each getter method is named according to the child objects defined for the parent object. For example, if the parent object contains a child object named “Address”, the getter method for this object is named getAddress. A getter method is created for each child object in the parent object.

Syntax

ChildBean[] getChild()

Parameters

None.

Returns

An array of JavaBeans containing the type of child object specified by the method name.

Throws

None.

getChild

Description

This method retrieves a child object JavaBean based on its index in a list of child objects. Each getter method is named according to the child objects defined for the parent object. For example, if the parent object contains a child object named “Address”, the getter method for this field is named getAddress. A getter method is created for each child object in the parent object.

Syntax

ChildBean getChild(int i)

Parameters

Returns

A JavaBean containing the child object specified by the index value. The method name indicates the type of child object returned.

Throws

ObjectException

getField

Description

This method retrieves the value of the field specified in the method name. Each getter method is named according to the fields defined for the parent object. For example, if the parent object contains a field named “FirstName”, the getter method for this field is named getFirstName.

Syntax

String getField()

The syntax for the getter methods depends on the type of data specified for the field in the object structure. For example, the getter method for a date field would have the following syntax:

 Date getField

Parameters

None.

Returns

The value of the specified field. The type of data returned depends on the data type defined in the object structure.

Throws

ObjectException

getObjectNameId

Description

This method retrieves the unique identification code (primary key) of the parent object, as assigned by the master index application.

Syntax

String getObjectNameId()

Parameters

None.

Returns

A string containing the unique ID of the parent object.

Throws

ObjectException

setChild

Description

This method adds a child object to the system object.

Syntax

void setChild(int index, ChildBean child)

Parameters

Returns

None.

Throws

None.

setChild

Description

This method adds an array of child objects of one type to the system object.

Syntax

void setChild(ChildBean[] children)

Parameters

Returns

None.

Throws

None.

setField

Description

This method sets the value of the field specified in the method name. Each setter method is named according to the fields defined for the parent object. For example, if the parent object contains a field named “DateOfBirth”, the setter method for this field is named setDateOfBirth. A setter method is created for each field in the parent object, including any fields containing standardized or phonetic data.

Syntax

void setField(value)

Parameters

Returns

None.

Throws

ObjectException

setObjectNameId

Description

This method sets the value of the ObjectNameId field in the parent object.

This ID is set internally by the master index application. You should never set this field manually.

Syntax

void setObjectNameId(String value)

Parameters

Returns

None.

Throws

ObjectException

Child Beans

A JavaBean is created to represent each child object defined in the object structure of the master index application. The methods in these classes provide the ability to create a child object Bean and to set or retrieve the field values for that object Bean.

The name of each child object JavaBean class is the same as the name of each child object, with the word “Bean” appended. For example, if a child object in your object structure is named “Address”, the name of the corresponding child class is AddressBean. The methods in this class include a constructor method for the child object JavaBean, and get and set methods for each field defined for the child object. Most methods have dynamic names based on the name of the child object and the fields defined for that object. In the following methods, Child indicates the name of a child object and Field indicates the name of a field defined for the child object.

Definition

final class ChildBean

Methods

These JavaBeans also include two countChildren methods, which are not currently used.

Inherited Methods

The following methods are inherited from java.lang.Object.

• equals

• hashcode

• notify

• notifyAll

• toString

• wait()

• wait(long arg)

• wait(long timeout, int nanos)

ChildBean

Description

This method is the constructor for the user-defined object JavaBean class. You can instantiate this class to create a new instance of the JavaBean.

Syntax

new ChildBean()

Parameters

None.

Returns

An instance of the child object Bean.

Throws

ObjectException

delete

Description

This method removes the child object from its corresponding parent object. This is used with the executeMatchUpdate function to update a system object by deleting one of the child objects from the object being processed.

Syntax

void delete()

Parameters

None.

Returns

None.

Throws

ObjectException

getField

Description

This method retrieves the value of the field specified in the method name. Each getter method is named according to the fields defined for the child object. For example, if the child object contains a field named “ZipCode”, the getter method for this field is named getZipCode.

Syntax

String getField()

The syntax for the getter methods depends on the type of data specified for the field in the object structure. For example, the getter method for a date field would have the following syntax:

 Date getField

Parameters

None.

Returns

The value of the specified field. The type of data returned depends on the data type defined in the object structure.

Throws

ObjectException

getChildId

Description

This method retrieves the unique identification code (primary key) of the object, as assigned by the master index application.

Syntax

String getChildId()

Parameters

None.

Returns

A string containing the unique ID of the child object.

Throws

ObjectException

setField

Description

This method sets the value of the field specified in the method name. Each setter method is named according to the fields defined for the child object. For example, if the child object contains a field named “Address”, the setter method for this field is named setAddress. A setter method is created for each field in the child object, including any fields containing standardized or phonetic data.

Syntax

void setField(value)

Parameters

Returns

None.

Throws

ObjectException

setChildId

Description

This method sets the value of the ChildId field in the child object.

This ID is set internally by the master index application. You should never set this field manually.

Syntax

void setChildId(String value)

Parameters

Returns

None.

Throws

ObjectException

DestinationEO

This class represents an enterprise object involved in a merge. This is the enterprise object whose EUID was kept in the final merge result record. A DestinationEO object is used when unmerging two enterprise objects.

Definition

class DestinationEO

Methods

getEnterpriseObjectName

Description

This method retrieves the surviving enterprise object from a merge transaction in order to allow the records to be unmerged.

Syntax

EnterpriseObjectName getEnterpriseObjectName()

where ObjectName is the name of the parent object.

Parameters

None.

Returns

The surviving enterprise object from a merge transaction.

Throws

ObjectException

setEnterpriseObjectName

Description

This method sets the surviving enterprise object of a merge transaction.

Syntax

void setEnterpriseObjectName(EnterpriseObjectName eo)

where ObjectName is the name of the parent object.

Parameters

Returns

None.

Throws

ObjectException

MergeObjectNameResult

This class represents the return values for a call to the merge-related functions of the ObjectNameEJB class, where ObjectName is the name of the parent object.

Definition

class MergeObjectNameResult

Methods

MergeObjectNameResult

Description

This is the constructor method for the MergeObjectNameResult class.

Syntax

new MergeObjectnameResult()

where ObjectName is the name of the parent object.

Parameters

None.

Returns

A new instance of MergeObjectNameResult.

Throws

None.

getDestinationEO

Description

This method retrieves the surviving enterprise object from a merge result.

Syntax

DestinationEO getDestinationEO()

Parameters

None.

Returns

The surviving enterprise object from a merge result.

Throws

None.

getSourceEO

Description

This method retrieves the nonsurviving enterprise object from a merge result.

Syntax

SourceEO getSourceEO()

Parameters

None.

Returns

The nonsurviving enterprise object from a merge result.

Throws

None.

setDestinationEO

Description

This method sets the surviving enterprise object in a merge result.

Syntax

void setDestinationEO(DestinationEO eom)

Parameters

Returns

None.

Throws

None.

setSourceEO

Description

This method sets the nonsurviving enterprise object in a merge result.

Syntax

void setSourceEO(SourceEO eom)

Parameters

Returns

None.

Throws

None.

SBRObjectName

This class represents an SBR object in an enterprise object. The SBR (single best record) represents the data about an entity that is considered to be the most accurate information from all external systems. Many of the methods in this class are named based on the name of the parent object, which is represented by ObjectName in the method descriptions below.

Definition

class SBRObjectName

Methods

SBRObjectName

Description

This is a constructor method for an empty SBRObjectName class.

Syntax

new SBRObjectName()

Parameters

None.

Returns

A new instance of SBRObjectName.

Throws

None.

SBRObjectName

Description

This is a constructor method for an SBRObjectName class. It takes an SBR object as its input.

Syntax

new SBRObjectName(SBR sbr)

Parameters

Returns

None.

Throws

ObjectException

getObjectName

Description

This method retrieves the parent object in the SBR.

Syntax

ObjectNameBean getObjectName()

Parameters

None.

Returns

The ObjectNameBean object associated with the SBR.

Throws

ObjectException

getStatus

Description

This method retrieves the status of the SBR.

Syntax

String getStatus()

Parameters

None.

Returns

The status of the SBR.

Throws

ObjectException

setObjectName

Description

This method sets the parent object in the SBR.

Syntax

void setObjectName(ObjectNameBean aObjectName)

Parameters

Returns

None.

Throws

ObjectException

setStatus

Description

This method sets the status of the SBR.

Syntax

voide setStatus(String status)

Parameters

Returns

None.

Throws

ObjectException

SearchObjectNameResult

This class represents the results of a search. A SearchObjectNameResult object (where ObjectName is the name of the parent object) is returned as a result of a call to searchBlock, searchExact, or searchPhonetic.searchBlock

Definition

class SearchObjectNameResult

Methods

getEUID

Description

This method retrieves the EUID of a search result record.

Syntax

String getEUID()

Parameters

None.

Returns

A string containing an EUID.

Throws

None.

getComparisonScore

Description

This method retrieves the weight that indicates how closely a search result record matched the search criteria.

Syntax

Float getComparisonScore()

Parameters

None.

Returns

A comparison weight.

Throws

None.

getObjectName

Description

This method retrieves an object bean for a search result record.

Syntax

ObjectNameBean getObjectName()

where ObjectName is the name of the parent object.

Parameters

None.

Returns

An object bean.

Throws

None.

setEUID

Description

This method sets the EUID of a search result record.

Syntax

void setEUID(String euid)

Parameters

Returns

None.

Throws

None.

setComparisonScore

Description

This method sets the weight that indicates how closely a search result record matched the search criteria.

Syntax

void setComparisonScore(float score)

Parameters

Returns

None.

Throws

None.

setObjectName

Description

This method sets an object bean as a search result record.

Syntax

void setObjectName(ObjectNameBean bean)

where ObjectName is the name of the parent object.

Parameters

Returns

None.

Throws

None.

SourceEO

This class represents an enterprise object involved in a merge. This is the enterprise object whose EUID was not kept in the final merge result record. A SourceEO object is used when unmerging two enterprise objects.

Definition

class SourceEO

Methods

getEnterpriseObjectName

Description

This method retrieves the nonsurviving enterprise object from a merge transaction in order to allow the records to be unmerged.

Syntax

EnterpriseObjectName getEnterpriseObjectName()

where ObjectName is the name of the parent object.

Parameters

None.

Returns

The nonsurviving enterprise object from a merge transaction.

Throws

None.

SetEnterpriseObjectName

Description

This method sets the nonsurviving enterprise object from a merge transaction in order to allow the records to be unmerged.

Syntax

void setEnterpriseObjectName(EnterpriseObjectName eo)

where ObjectName is the name of the parent object.

Parameters

Returns

None.

Throws

ObjectException.

SystemObjectNamePK

This class represents the primary keys in a system object, which include the processing code for the originating system and the local ID of the object in that system. The class is named for the primary object. For example, if the primary object is named “Person”, this class is named SystemPersonPK. If the primary object is named “Company”, this class is named SystemCompanyPK. The methods in these classes provide the ability to create an instance of the class and to retrieve the system processing code and the local ID.

Definition

class SystemObjectNamePK

where ObjectName is the name of the parent object.

Methods

SystemObjectNamePK

Description

This method is the user-defined system primary key object. This object contains a system code and a local ID. Use this constructor method to create a new instance of a system primary key object.

Syntax

new SystemObjectNamePK()

where ObjectName is the name of the parent object.

Parameters

None.

Returns

An instance of the system primary key object.

Throws

None.

getLocalId

Description

This method retrieves the local identifier from a system primary key object.

Syntax

String getLocalId()

Parameters

None.

Returns

A string containing a local identifier.

Throws

None.

getSystemCode

Description

This method retrieves the system’s processing code from a system primary key object.

Syntax

String getSystemCode()

Parameters

None.

Returns

A string containing the processing code for a system.

Throws

None.