24.1 Customizing Property Pages

You can customize the object property forms that your assistant administrators use in their Active Directory management roles by object type. This includes creating and customizing new object pages that are based on object types that are built into DRA. You can also modify properties for the built-in object types.

Property objects are clearly defined in the Customization > Property Pages list in the Web Console, so you can easily identify which object pages are built-in, which built-in pages are customized, and which pages are not built-in and were created by an administrator.

24.1.1 Customizing an Object Property Page

You can customize object property forms by adding or removing pages, modifying existing pages and fields, and by creating custom handlers for property attributes. The custom handlers on a field are executed whenever that field's value is modified. The timing can be configured as well, so the administrator can specify if the handlers should be run immediately (on every key press), when the field loses focus, or after a specified time delay.

The object list in Property Pages provides operation types for each object type, Create Object and Edit Properties. These are the principal operations your assistant administrators perform in the Web Console. They perform these operations by navigating to Management > Search or Advanced Search. Here they can create objects from the Create pull-down menu or edit existing objects selected in the search results table through the Properties icon.

To customize an object property page in the Web Console:

  1. Log in to the Web Console as DRA Administrator.

  2. Navigate to Administration > Customization > Property Pages.

  3. Select an object and operation type (Create Object or Edit Object) in the Property Pages list.

  4. Click the Properties icon .

  5. Customize the object property form by doing one or more of the following, and then applying your changes:

    • Add a new property page: + Add Page

    • Reorder and delete property pages

    • Select a property page and customize the page:

      • Reorder configuration fields in the page:

      • Edit fields or subfields:

      • Add one or more fields: or Insert a new Field

      • Remove one or more fields:

    • Create custom handlers for properties by using scripts, message boxes, or queries (LDAP, DRA, or REST)

      For more information about using custom handlers, see Adding Custom Handlers.

Defining Custom Filters

You can use filters to customize the information that is displayed for each object type by adding the Managed Object Browser field to a property page. When configuring the field settings, you can add filters in the settings via the Managed Object Browser Options tab. By defining custom filters, you can restrict the information that is displayed in object browsers for assistant administrators. Assistant administrators can view only those objects that meet the filter conditions that you have defined.

To define a filter, in the Managed Object Browser Options tab, enable the Specify Object Filters check box. For each filter condition, specify the object type, attribute to be filtered, filter condition, and attribute value that will be used to filter the information. When you create multiple filters for the same object type, they are combined with the AND operator. With all the predefined filters in the Managed Object Browser, assistant administrators can perform the search operation.

NOTE:

  • Only cached attributes can be used to define filters.

  • If you create a custom handler using a custom script for the custom filter, you must also define the custom filter manually in Managed Object Browser Options tab for the custom handler to work.

24.1.2 Creating a New Object Property Page

To create a new object property page:

  1. Login to the Web Console as DRA Administrator.

  2. Navigate to Administration > Customization > Property Pages.

  3. Click Create.

  4. Create the initial object properties form by defining action name, icon, object type, and operation configuration.

    Create actions are added to the Create drop-down menu while Property actions display in object form when the user selects and edits an object from the search list.

  5. Customize the new form as required. See Customizing an Object Property Page.