Using the Domino® Directory to create an LDAP auxiliary object class

Use an auxiliary object class to add one set of attributes to multiple structural object classes. To use the Domino® Directory to create an LDAP auxiliary object class, create a subform to define the auxiliary object class, and then insert the subform into the $xxxExtensibleSchema subform of each structural object class to which you want to add the auxiliary object class. The superior object class for an auxiliary object class you add is Top.

About this task

The preferred method for extending the LDAP schema is to use the Domino® LDAP Schema database. Use the Domino® Directory to extend the schema only if Notes® or Web users require access to the new schema elements through documents in the directory.

Creating a subform to define an auxiliary object class

Procedure

  1. Make sure that you are working in a copy of the Domino® Directory template (ACMENAMES.NTF) and that you have Designer or Manager access in the ACL.
  2. From the Domino® Designer, open ACMENAMES.NTF.
  3. In the first pane, select Shared Elements and then Subforms.
  4. Right-click New Subform. For the subform name, type a name for the auxiliary object class, for example, building. Click OK.
  5. Do the following to specify the properties for the new subform:
    1. Keep the Options property Include in Insert Subform... dialog selected.
    2. Deselect the Options property Render pass through HTML in Notes.
    3. Leave the other properties the same, and close the Subform Properties box.
    4. Save and close the new subform.
  6. Do the following to add a field to define the auxiliary object class:
    1. Open the subform you just created.
    2. Choose Create > Field.
    3. Next to Name on the Basics tab of the Field dialog box, specify any name, but precede the name with a dollar sign ($) to indicate that the field is an operational field -- for example $building.
    4. Next to Text on the Basics tab of the Field dialog box, select Computed when composed.
    5. Specify the formula for the field as follows. You must enclose the subform name in quotations marks (" ").
      FIELD $objectclass := $objectclass : "subform";1

      Where subform is the name of the subform you specified earlier -- for example: 

      FIELD $objectclass := $objectclass : "building";1
  7. Complete the procedure Using the Domino® Directory to define an LDAP attribute for a new object class in the related information to add the attributes to the new auxiliary object class.
  8. Save the new subform.
  9. Do the following:
    1. In the first pane, select Shared Elements and then Subforms.
    2. Select the new subform, click Properties > Design, and select Prohibit design refresh or replace to modify.

Adding the new auxiliary object class to a structural object class

About this task

After you create subform to define a new auxiliary object class, complete this procedure to add the auxiliary object class to a structural object class. You can add the auxiliary object class to a new structural object class you have created, or a default structural object class.

Procedure

  1. From a subform you created to define an auxiliary object class, ACMENAMES.NTF, for example, open a $xxxExtensibleSchema subform or a form, as described in the following table:
    Table 1. Adding the auxiliary object class to a structural object class

    To add the auxiliary object class to

    Open this subform or form

    dominoPerson

    $PersonExtensibleSchema

    dominoGroup

    $GroupExtensibleSchema

    dominoOrganization, dominoOrganizationalUnit, and dominoInternetCertifier

    $CertifierExtensibleSchema

    dominoServerResource

    $ResourceExtensibleSchema

    locality

    $LocalityExtensibleSchema

    organization

    $organizationExtensibleSchema

    organizationalUnit

    $organizationUnitExtensibleSchema

    a structural object class defined in the default schema that doesn't have a corresponding $xxxExtensibleSchema subform

    The form used to define the object class

    a structural object class you defined in the Domino® Directory

    $xxxExtensibleSchema

    Where xxx is the name of the new structural object class
  2. Choose Create > Resource > Insert Subform.
  3. Select the subform you created for the auxiliary object class -- for example, building.
  4. Click OK.
  5. Close and save the subform or form you opened in step 1.

What to do next

Complete the procedure Applying template customizations to the Domino® Directory database.