HCLSoftware Business Partner
Domino Consulting Services
CRUCIAL Notes Tools
+1 212-599-2048

Domino Consulting Services
CRUCIAL Notes Tools
Domino administration
Notes development

Facebook Twitter YouTube
Chat now       
.
ProductsDownloadsNewsAbout usContact


Need a Domino Consultant? Call NotesMail +1 212-599-2048 - HCLSoftware Business Partner

CONFIGURING

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:


    a. Keep the Options property Include in Insert Subform... dialog selected.

    b. Deselect the Options property Render pass through HTML in Notes.

    c. Leave the other properties the same, and close the Subform Properties box.

    d. Save and close the new subform.


6. Do the following to add a field to define the auxiliary object class:

    a. Open the subform you just created.

    b. Choose Create -> Field.

    c. 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.

    d. Next to Text on the Basics tab of the Field dialog box, select Computed when composed.

    e. 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:


    a. In the first pane, select Shared Elements and then Subforms.

    b. 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 toOpen 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 subformThe 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.

Related concepts
Using the Domino Directory to extend the LDAP schema

Related tasks
Using the Domino Directory to define an LDAP attribute for a new object class