The properties of the Manager Service are defined in the Threshold file in XML format. The information entered into the default configuration file is standard across all implementations, so the file will require some customization.
The following topics provide information about working with the Threshold file:
You can modify the Threshold file at any time, but you must regenerate the application and redeploy the project after making any changes to the file. Use caution when updating this file after moving into production, since changing certain properties, such as the blocking query, can cause unexpected matching and weighting results. Most of the configuration options in this file cannot be modified using the Configuration Editor. The exceptions are the match and duplicate thresholds. The possible modifications to this file are restricted by the schema definition, so be sure to validate the file after making any changes.
Table 10 lists each element in the Threshold file and provides a description of each element along with any requirements or constraints for each element.
Table 10 Threshold File Structure
Element/Attribute |
Description |
---|---|
The configuration class for the Manager Service. The attributes define the module name and Java class. The default values should not be changed. |
|
A custom plug-in that defines custom processing logic for the execute match functions that can be called from Collaborations and Business Processes. This element is optional. |
|
A custom plug-in that defines custom processing logic for the execute match function that is called from the Enterprise Data Manager (EDM). This element is optional. |
|
An indicator of whether to recalculate potential duplicates when a record is updated. Specify Pessimistic to recalculate potential duplicates; specify Optimistic to prevent potential duplicate recalculation on updates. |
|
An indicator of whether records with a status of Merged can be updated. Specify Enabled to allow updates of merged records; specify Disabled to ensure that records with a Merged status are not updated. |
|
Specifies the blocking query to use for match processing. |
|
The name of the blocking query to use for match processing. The name must match a query defined in the Candidate Select file. |
|
Optional parameters for the blocking query. Currently parameters are not used by any predefined blocking queries. |
|
A parameter for the blocking query. |
|
The value of the key specified by the corresponding key attribute. |
|
The configuration class for the Decision Maker. The attributes define the module name and Java class. The default values should not be changed. |
|
The Java class that contains the methods used by the Decision Maker class. The default value, com.stc.eindex.decision.impl.DefaultDecisionMaker, should not need to be changed, but you can implement a custom Decision Maker class. The default class accepts the parameters described below. |
|
A list of parameters for the Decision Maker class. |
|
A definition of a Decision Maker parameter. The parameters element can contain multiple parameter elements, each defining one parameter. |
|
A brief description of the parameter. This element is optional. |
|
The name of the parameter. The default Decision Maker class takes the following parameters (see Decision Makerfor more information about these parameters).
|
|
The type of parameter. Valid values are java.lang.Long, java.lang.Short, java.lang.Byte, java.lang.String, java.lang.Integer, java.lang.Boolean, java.lang.Double, or java.lang.Float. |
|
The value of the parameter. For OneExactMatch and SameSystemMatch, this must be a Boolean value. For MatchThreshold and DuplicateThreshold, this must be a Float value. |
|
The configuration class for the EUID Generator. The attributes define the module name and Java class. The default values should not be changed. |
|
The Java class used by the master index application to generate new EUIDs. The default class is com.stc.eindex.idgen.impl.DefaultEuidGenerator, which assigns sequential EUIDs based on the three parameters described below. |
|
A list of parameters for the EUID Generator class. |
|
A parameter definition. The parameters element can contain multiple parameter elements, each defining one parameter. |
|
A brief description of the parameter. This element is optional. |
|
The name of the parameter. The default EUID Generator class takes the following parameters (see EUID Generator for more information about these parameters).
|
|
The type of parameter. Valid values are java.lang.Long, java.lang.Short, java.lang.Byte, java.lang.String, java.lang.Integer, java.lang.Boolean, java.lang.Double, or java.lang.Float. |
|
The value of the parameter. For the default parameters, the values are all integers. |
Below is a sample of the Threshold file configuration.
<MasterControllerConfig module-name="MasterController" parser-class="com.stc.eindex.configurator.impl.master.MasterControllerConfiguration"> <logic-class>CustomMatchLogic</logic-class> <logic-class-gui>CustomMatchLogicEDM</logic-class-gui> <update-mode>Pessimistic</update-mode> <merged-record-update>Disabled</merged-record-update> <execute-match> <query-builder name="BLOCKER-SEARCH"></query-builder> </execute-match> </MasterControllerConfig> <DecisionMakerConfig module-name="DecisionMaker" parser-class="com.stc.eindex.configurator.impl.decision.DecisionMakerConfiguration"> <decision-maker-class> com.stc.eindex.decision.impl.DefaultDecisionMaker </decision-maker-class> <parameters> <parameter> <parameter-name>OneExactMatch</parameter-name> <parameter-type>java.lang.Boolean</parameter-type> <parameter-value>false</parameter-value> </parameter> <parameter> <parameter-name>SameSystemMatch</parameter-name> <parameter-type>java.lang.Boolean</parameter-type> <parameter-value>true</parameter-value> </parameter> <parameter> <parameter-name>DuplicateThreshold</parameter-name> <parameter-type>java.lang.Float</parameter-type> <parameter-value>7.25</parameter-value> </parameter> <parameter> <parameter-name>MatchThreshold</parameter-name> <parameter-type>java.lang.Float</parameter-type> <parameter-value>29.0</parameter-value> </parameter> </parameters> </DecisionMakerConfig> <EuidGeneratorConfig module-name="EuidGenerator" parser-class= "com.stc.eindex.configurator.impl.idgen.EuidGeneratorConfiguration"> <euid-generator-class> com.stc.eindex.idgen.impl.DefaultEuidGenerator </euid-generator-class> <parameters> <parameter> <parameter-name>IdLength</parameter-name> <parameter-type>java.lang.Integer</parameter-type> <parameter-value>10</parameter-value> </parameter> <parameter> <parameter-name>ChecksumLength</parameter-name> <parameter-type>java.lang.Integer</parameter-type> <parameter-value>0</parameter-value> </parameter> <parameter> <parameter-name>ChunkSize</parameter-name> <parameter-type>java.lang.Integer</parameter-type> <parameter-value>1000</parameter-value> </parameter> </parameters> </EuidGeneratorConfig> |