4.21 Adding Prompts to a Driver Configuration File

Several node types are defined for driver configuration files. These extensions were made to support the following:

  • Prompting once for a value that is used repeatedly throughout a single driver configuration file.

  • Prompting once for a value that is used across multiple driver configuration files, as part of the Import Drivers Wizard.

  • Allowing the user to select a value from a drop-down list of values.

  • Global modification of the driver configuration file according to a contained XSL style sheet.

  • Built-in variables that can be referenced without declaring them, in order to access information about the driver and its environment (a tree name, driver set name, driver set DN, server name, server DN, driver name and driver DN).

  • The ability to “layer” prompts. It is possible to ask the user multiple sets of questions, with the second and later sets being controlled by the user's responses to prior sets. For more information, refer to Editing Driver Configuration Files in the NetIQ Identity Manager 4.0.2 Common Driver Administration Guide.

The primary new node types are variable-decl, variable-ref, and xsl-modify.

Table 4-30 New Node Types

New Node Type

Description

variable-decl

Allows you to define driver configuration variables that are prompted for (optionally) and replaced into a driver configuration file during its import. Multiple variable-decl blocks can be used to define a “layered” set of prompts. Refer to Editing Driver Configuration Files in the NetIQ Identity Manager 4.0.2 Common Driver Administration Guide.

variable-ref

Used to reference a variable defined in a variable-decl within your driver configuration files.

xsl-modify

Used to globally modify the driver configuration file after all variables (and prompting) have been resolved. The contents of this node are extracted and used as an XSL style sheet that is applied to the patched driver configuration file.

For information on adding prompts to a sample configuration file, see Editing Driver Configuration Files in the NetIQ Identity Manager 4.0.2 Common Driver Administration Guide.