Oracle Waveset 8.1.1 Deployment Reference

Sample Forms and Form Fields

This section provides examples of the default forms that ship with the product. It also describes how to incorporate sample forms in your environment.


Note –

The versions of forms that ship with your version of Waveset may differ slightly from these samples.


User Form Library

A form can be used as a container for a collection of fields rather than being used in its entirety. Waveset supports this use of forms with an object called User Form Library, which contains complex fields related to granular resource selection, such as those used for changing passwords.

The following list summarizes each library associated with User Library.

User Library

The primary user form library. It includes the other libraries in this table and also defines the AuthenticationAnswers field for the display and editing of authentication question answers. 

Password Library

Fields related to password specification and synchronization. 

Account Summary Library

Fields that display read-only summary information about the accounts associated with a user. 

Account Link Library

Fields related to account linking, and multiple accounts per resource. 

User Security Library

Fields related to user security including capabilities, form assignment, and approval forwarding. 

User Form Library

This library contains only fields that are related to the Resource Accounts views which include:

The library primarily consists of tables that display information about the resource accounts associated with an Waveset user and allows them to be selected for various operations.

Using the Sample Forms Library

You can include the sample forms shipped with Waveset in any of the forms you are customizing through the use of the <FormRef> element.

Follow these general steps to add sample forms to your environment:

Step 1: Import the Rule

Step 2: Import the Form

Step 3: Create a New Form from the Default Form (Add Include References and Add the Form Reference)

Step 1: Import the Rule

Use the Waveset Administrator Interface to load the sample rules. :

ProcedureTo Load a Rule

  1. From the Waveset menu bar, select Configure > Import Exchange File.

  2. Enter the sample file name or click Browse to locate the file in the idm\sample\rules directory.

    Sample common rule file names are:

    • sample\rules\ListGroups.xml

    • sample\rules\NamingRules.xml

    • sample\rules\RegionalConstants.xml

    Sample resource rule file names are:

    • sample\rules\ADRules.xml

    • sample\rules\NDSRules.xml

    • sample\rules\NTRules.xml

    • sample\rules\OS400UserFormRules.xml

    • sample\rules\RACFUserFormRules.xml

    • sample\rules\TopSecretUserFormRules.xml

  3. Click Import. Waveset responds with a message indicating that the import was successful.

Step 2: Import the Form

Use the Waveset Administrator Interface to load the sample form.

ProcedureTo Import the Form

  1. From the Waveset menu bar, select Configure > Import Exchange File.

  2. Enter the sample file name or click Browse to locate the file in the idm\sample\forms directory. Sample form file names are:

    • sample\forms\ACF2UserForm.xml

    • sample\forms\ AIXUserForm.xml

    • sample\forms\HP-UXUserForm.xml

    • sample\forms\NDSUserForm.xml

    • sample\forms\OS400UserForm.xml

    • sample\forms\SecurIDUserForm.xml

    • sample\forms\SolarisUserForm.xml

    • sample\forms\TopSecretUserForm.xml

    • sample\forms\vitalStatform.xml

  3. Click Import. Waveset responds with a message indicating that the import was successful.

Step 3: Update the Tabbed User Form (Add Include References)

Add an include reference to the sample form from the Tabbed User Form or a main form you created.

ProcedureTo Update the User Form

  1. Copy the Tabbed User Form and rename it (for example, <CompanyName>tabbedUserForm).

  2. In your Web browser address line, type this URL, and then press Enter.

    http://ApplicationServerHost:Port/idm/debug

  3. After you authenticate, Waveset displays the System Settings page.

  4. Select the UserForm option from the Type list, and then click List Objects.

  5. Click Edit next to the <CompanyName>tabbedUserForm (or the main form you created).

  6. Change the includes area of the form to add each sample form, shown in the following example in bold text:


    <Include>
      <ObjectRef type=’UserForm’ id=’#ID#UserForm:UserformLibrary’ name=’UserForm Library’/>
      <ObjectRef type=’UserForm’ name=’UserFormName’/>
    <Include>

    Values for UserFormName can be:

    • ACF2 User Form

    • AIX User Form

    • HP-UX User Form

    • LDAP Active Sync User Form

    • Netegrity Siteminder Admin Form

    • Netegrity Siteminder LDAP User Form

    • Netegrity Siteminder ExampleTable User Form

    • NDS User Form

    • NT User Form

    • Open Networks User Form

    • OS400 User Form

    • Oracle ERP User Form

    • RACF User Form

    • RSA ClearTrust User Form

    • SecurID User Form

    • Skeleton Database Active Sync User Form

    • Solaris User Form

    • Tivoli Access Manager

    • Top Secret User Form

    • Global Attributes (vitalStatform.xml)

      Continue with the next section before saving the form.

Step 4: Update the Tabbed User Form (Add the Form)

Add a FormRef for each sample form to add it to the main form.

ProcedureTo Add a FormRef

  1. Add the following line for each sample form in an appropriate location in the main form:


    <FormRef name=’UserFormName’/>
  2. Remove the following line:


    <FormRef name=’MissingFields’/>
  3. Click Save to save form changes.