Configuring Master Index MIDM Implementation Information

Certain configuration information is defined automatically in the implementation details section of midm.xml based on information you specify in the wizard. Other information in this section must be customized by modifying the XML file directly.

You can customize the implementation details by performing any of the following tasks.

• Specifying the Master Controller JNDI Class

• Specifying the Master Index Report Generator JNDI Class

• Specifying Master Index Validation Services

• Setting Master Index Debug Options

• Specifying a Master Index Field Masking Class

Specifying the Master Controller JNDI Class

The MIDM must know the name of the Master Controller interface for the Oracle Java CAPS Master Index implementation. Only change this value if you create a custom Master Controller.

To Specify the Master Controller JNDI Class

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click midm.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the impl-details element, and then to the master-controller-jndi-name element.
3. Modify the value of the master-controller-jndi-name element to the name of the Master Controller JNDI class for your server.

   For example:

   <master-controller-jndi-name>ejb/CustomerMasterController
   </master-controller-jndi-name>

4. Save and close the file.

Specifying the Master Index Report Generator JNDI Class

The MIDM must know the name of the class used to generate reports for the MIDM. Only change this value if you create a custom report generator.

To Specify the Report Generator JNDI Class

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click midm.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the impl-details element, and then to the reportgenerator-jndi-name element.
3. Modify the value of the reportgenerator-jndi-name element to the name of the report generator JNDI class to use.

   For example:

   reportgenerator-jndi-name>ejb/CustomerReportGenerator
   </reportgenerator-jndi-name>

4. Save and close the file.

Specifying Master Index Validation Services

Validation services verify processing codes for data entered into the master index database. Only change the names of the validation services if you created custom code list validators.

To Specify the Validation Service

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click midm.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the impl-details element, and then to the validation-service-jndi-name element.
3. To change the name of the validator for processing codes stored in sbyn_common_header, modify the value of the validation-service-jndi-name element to the name of the JNDI class used for validation.

   For example:

   <validation-service-jndi-name>ejb/CustomerCodeLookup
   </validation-service-jndi-name>

4. To change the name of the validator for processing codes stored in sbyn_user_code, modify the value of the usercode-jndi-name element to the name of the JNDI class used for validation.

   For example:

   <usercode-jndi-name>ejb/CustomerUserCodeLookup
   </usercode-jndi-name>

5. Save and close the file.

Setting Master Index Debug Options

When you first implement Oracle Java CAPS Master Index, you might want to view detailed debug information until you are certain the application is working as required. You can set debug options in the implementation details.

To Set Debug Options

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click midm.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the impl-details element, and then to the debug-flag element.
3. Modify the value of the debug-flag element to indicate whether you want debug information logged.

   For example:

   <debug-flag>true</debug-flag>

   Specify true to log debug information; specify false to turn logging off.

4. Modify the value of the debug-dest element to indicate where to print debug information.

   For example:

   <debug-dest>console</debug-dest>

   Specify console to log debug information to a monitor; specify file to print to a file.

5. Save and close the file.

Specifying a Master Index Field Masking Class

If you implement a custom class to define field masking logic, you must specify the new class in the implementation details. The custom class must be created as a custom plug-in in the Oracle Java CAPS Master Index project. This class can be used to mask the value of any field for which the is-sensitive element is set to “true”.

To Specify a Field Masking Class

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click midm.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the impl-details element.
3. Change the value of the object-sensitive-plug-in-class element to the name of the custom class.

   For example:

   <object-sensitive-plug-in-class>
    com.sun.mdm.index.user.customfieldmasker
   </object-sensitive-plug-in-class>

4. Save and close the file.