Table 12 lists each element in update.xml and provides a description of each element along with any requirements or constraints for each element.
Table 12 update.xml File Structure
Element/Attribute |
Description |
---|---|
The configuration of the overall survivor strategy. The SurvivorHelperConfig attributes (module-name and parser-class) define the module name and Java class, and their default values should not be changed. |
|
The Java class that determines how to retrieve values from system records and to set them in the SBR. The default class uses the ePath notation to retrieve and set the values. |
|
The configuration information for the survivor strategy to use as the default. You can define multiple survivor strategies and use different strategy combinations for the candidate fields. Any field that is not assigned a specific survivor strategy in the candidate-definitions list uses the default survivor strategy specified here. |
|
The Java class name of the default strategy. |
|
A list of optional parameters for the default survivor strategy. |
|
A parameter for the default survivor strategy. The default parameter points to another section in update.xml that configures the default class. There can be multiple parameter elements. |
|
An optional element that briefly describes the parameter. |
|
The name of the parameter.
|
|
The Java data type for the parameter value. For both the DefaultSurvivorStrategy and the WeightedSurvivorStrategy, this value is java.lang.String. |
|
The value of the named parameter.
|
|
The configuration information for the fields to be included in the SBR. For any field that does not use the default survivor strategy, an alternate strategy is defined. All field that are included in the SBR must be listed here. |
|
The qualified field name for a field in the SBR (for more information about field notations, see Master Index Field Notations). |
|
A short description of the candidate field (this element is optional). |
|
A field (other than the candidate field) that is evaluated to determine the value for the SBR. One example of this would be to evaluate the last update date of the system records to determine which value is most recent. This element is not currently used by any of the standard survivor strategies provided with the master index application, but might be useful when defining custom strategies. |
|
The name of the field to use to determine the value for the SBR. |
|
An alternate survivor strategy to use for the given field in place of the default strategy defined in the default-survivor-strategy element. If a strategy is not specifically defined for a field, the default strategy is used for that field. |
|
The name of the Java class to use for the alternate survivor strategy. |
|
The configuration of the weighted calculator. By default, this is the strategy specified as the default strategy in the default-survivor-strategy element. The WeightedCalculator attributes (module-name and parser-class) define the module name and Java class, and their default values should not be changed unless you create a custom class. |
|
The configuration information for the default weighted calculator logic for all fields except those whose logic is defined in the candidate-field element below. |
|
A parameter for the default logic of the weighted calculator. |
|
The type of weighted calculation to perform. You can specify any of the following:
For more information about these qualities, see Weighted Calculator. |
|
The preferred value for the specified quality. This element is only used for the SourceSystem quality and must be a source system code. |
|
A value that indicates the reliability of the specified quality for determining the best field value for the SBR. You define the scale for the utility values. |
|
A field for which you want to use custom logic for the weighted calculator. The logic you specify here overrides the logic defined in the default-parameters section, but only for the fields specified. Each candidate field is identified by a name attribute and defines the survivor strategies for one field. |
|
The name of the candidate field for which you want to define override logic. |
|
A parameter configuring the weighted calculator for the candidate field. You can define multiple parameters for each candidate field. |
|
The type of weighted calculation to perform. You can specify any of the following:
|
|
The preferred value for the specified quality. This element is only used for the SourceSystem quality and the preference must be a source system code. |
|
A value that indicates the reliability of the specified quality for determining the best field value for the SBR. You define the scale for the utility values. |
|
The configuration information for the Update Manager. This section defines a list of Java classes to manage custom processing for different types of transactions. You can create the custom classes in the Source Packages folder of the EJB project and then specify those classes here. The UpdateManagerConfig attributes (module-name and parser-class) define the module name and Java class, and their default values should not be changed. |
|
A class that defines additional processing to perform when two enterprise objects are merged. |
|
A class that defines additional processing to perform when two enterprise objects are unmerged. |
|
A class that defines additional processing to perform when a record is updated. |
|
A class that defines additional processing to perform when a new record is created. |
|
A class that defines additional processing to perform when two system objects are merged. |
|
A class that defines additional processing to perform when system objects are unmerged. |
|
A class that defines additional processing to perform when an assumed match transaction is reversed. |
|
An indicator of whether the update policies are carried out if no changes are made to the existing record. Specify “true” to prevent the update policies from being performed when no changes are made to an existing record. |