Description

The <attr-name-map> element is the top level element for the schema mapping rules. All other elements in the document are subordinate to this element.

Mapping rules map specified eDirectory class definitions and attributes with corresponding attribute and class definitions in the external application. Mapping rules are kept in an DirXML-Rule object and associated with your driver through the DirXML-MappingRule attribute of your driver's DirXML-Driver object.

Definition

  <!ELEMENT attr-name-map (attr-name | class-name)*>
  
  <!ELEMENT attr-name (nds-name, app-name)>
  <!ATTLIST attr-name 
            class-name    CDATA    #IMPLIED>
  
  <!ELEMENT class-name (nds-name, app-name)>
  
  <!ELEMENT nds-name (#PCDATA)>
  
  <!ELEMENT app-name (#PCDATA)>
  

Attributes

class-name

Specifies the class definition which the attribute belongs to in the <attr-name> element.

Elements

<attr-name>

Specifies an attribute mapping between the eDirectory name space and the application name space.

<class-name>

Specifies a class mapping between the eDirectory name space and the application name space.

<nds-name>

Specifies either the attribute or class name in the eDirectory name space. The attribute names specified must be unique to the class. The class names specified must be unique in the rules.

<app-name>

Specifies either the attribute or class name in the application name space. The attribute names specified must be unique to the class. The class names specified must be unique in the rules.

Parent

• Top element

Examples

The following example contains three mapping rules.

  <attr-name-map>
  <!-- map NDS class User application class inetOrgPerson -->
  
     <class-name>
        <nds-name>User</nds-name>
        <app-name>inetOrgPerson</app-name>
     </class-name>
  
  <!-- map NDS attribute Given Name to application attribute-->
  <!-- givenName for class User                            -->
  
     <attr-name class-name="User">
        <nds-name>Given Name</nds-name>
        <app-name>givenName</app-name>
     </attr-name>
  
  <!-- map NDS attribute Surname to application attribute  -->
  <!-- sn for all classes that don’t have a                -->
  <!-- class-specific mapping                              -->
  
     <attr-name>
        <nds-name>Surname</nds-name>
        <app-name>sn</app-name>
     </attr-name>
  </attr-name-map>
  

For another example, see the mapping_rule.xml file used by the VRTest driver.