Customizing the Driver by Modifying Driver Rules and Style Sheets

This section contains information to help you understand how the driver's rules and style sheets are implemented, as well as information about how you can modify these objects. Topics include the following:


Modifying the Driver Mapping Rule

The Mapping rule is a Novell® eDirectoryTM object that defines the relationship between data fields defined in the PeopleSoft application and eDirectory attributes. The Mapping rule is located in the driver object container and is used by both the Publisher and Subscriber channels of the driver.

A default, preconfigured Mapping rule is delivered with the driver product. The mappings defined in the Mapping rule are designed in coordination with the preconfigured PeopleSoft application Component Interface (CI) that is also delivered with the driver product.

The default CI is called DIRXML_SCHEMA01 and represents a set of employee data. The data fields in this CI are mapped to similar attributes of the eDirectory User object.

The following is a short sample of the delivered Mapping rule. The nds-name represents the name of the class or attribute in eDirectory and the app-name represents the class or field name of the PeopleSoft CI.

<?xml version="1.0" encoding="UTF-8"?> <attr-name-map> 
     <class-name> 
          <nds-name>User</nds-name> 
          <app-name>DIRXML_SCHEMA01</app-name> 
     </class-name>      <attr-name classname="User"> 
          <nds-name>Given Name</nds-name> 
          <app-name>First Name</app-name> 
     </attr-name>      ... </attr-name-map > 

When you modify or create a Mapping rule, verify that the PeopleSoft field names appear identically (spelling and capitalization) in the mapping rule and PeopleSoft message definition. If you use the DirXML® Mapping rule editor, correct mapping behavior is ensured. It is also important to note that if new attributes are included or removed from the Mapping rule, the new attribute set should be reflected in the respective Publisher and Subscriber filters. If mapped attributes are not included in the filters, they cannot be synchronized.


Using the Schema Query to Refresh PeopleSoft Schema CI

The schema that the driver reads from PeopleSoft consists of the data fields defined on the DIRXML_SCHEMA01 Component Interface. If the data elements are modified or the CI is renamed, it will be necessary to refresh the PeopleSoft application schema definition. The following steps describe the refresh operation.

If the name of the schema CI has changed:

  1. In ConsoleOne, select the driver, right-click the Mapping rule, then click Properties.

  2. Modify the Driver Setting's Schema CI Name value to reflect the correct name of the CI to be synchronized.

To modify matched attributes that use the schema:

  1. In ConsoleOne, select the driver, right-click the Mapping rule, then click Properties.

  2. Modify the attribute mappings as desired, then click Apply.