Available Scalable Forms

Waveset ships the following two scalable user forms, which are described below:

• Dynamic Tabbed User form, which provides an alternative to the default Tabbed User form

• Resource Table User form, which provides an alternative to the default Tabbed User form.

Dynamic Tabbed User Form

Provides an alternative to the default Tabbed User form, which fetches all resources as soon as an administrator begins editing. In contrast, Dynamic Tabbed User form features incremental fetching and editing of multiple resources based on resource type.

---

Note –

For detailed implementation information, see the comments associated with each user form in WSHOME/samples/form_name.xml.

---

Importing and Mapping the Form

Three forms are involved in the substitution of Dynamic Tabbed User form for the default Tabbed User form.

Table 2–20 Forms associated with Dynamic Tabbed User Forms

Form	Description
Dynamic Tabbed User Forms	Contains the features of the default Tabbed User Form but dynamically creates one tab per resource type.
Dynamic User Forms	Contains fields for creating resource type tabs on the user form.
Dynamic Forms Rule Library	Contains the rule library for dynamically printing out attributes for resources that have no specified user form.
Dynamic Resource Forms	Contains all forms that are currently compatible with the Dynamic Tabbed User form. Users can customize this list.

Installing Dynamic Tabbed User form involves two steps: importing the form, and changing the form mapping.

Step 1: Import the Form

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

2. Enter the file name (dynamicformsinit.xml) or click Browse to locate the dynamicformsinit.xml file in the ./sample directory.

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

Step 2: Change Form Mapping

There are two methods of assigning a user form to an end user. Select a method to edit these form mapping depending upon how administrators in your environment will be using these forms. These methods include:

• Assign Scalable User Form as the default User Form for all administrators. If this is your choice, see Step 2: Change Form Mapping. Waveset administrators can assign one form that all administrators will use.

• Separately assign the Scalable User Form to a particular administrator(s). If this is your choice, see Step 2: Change Form Mapping.

Assign Scalable User Form as the Default User Form

1. From the menu bar, select Configure > Configure Form and Process Mappings.

2. In the Form Mappings section, locate userForm under the Form Type column.

3. Specify Dynamic Tabbed User Form in the box provided under the Form Name Mapped To column.

Assign Scalable User Form per Administrator

1. From the menu bar, select Accounts > Edit User.

2. Select a user in one of these two ways:

   • Click on user name, then click Edit

     or

     • Right-click on the user name to display a pop-up menu, then select the Edit menu option

3. After the Default Edit User Form appears, click on the Security tab.

4. Find the User Form field and select Dynamic Tabbed User Form.

5. Click Save to save the settings.

Resource Table User Form

The Resource Table User Form contains most of the driving logic of the scalable version of the Edit User form. This form implements incremental fetching and multiple resource editing based on resource type.

For additional implementation information, see the comments in WSHOME/samples/resourcetableformsinit.xml.

Importing and Mapping the Form

Five forms are involved in the substitution of Resource Table User form for the default Tabbed User form.

Table 2–21 Forms Associated with Resource Table User Form

Form	Description
Resource Table User Form	Contains all globally available fields that are used for navigation, incremental fetching, and form layout. This main form drives all the other resource-related scalable forms.
Resource Table User Form Library	Contains primary fields for the Resource Table User form. Includes bread crumb and navigation fields.
Resource Table Account Info Form	Contains Fields for account information section of Resource Table form.
Resource Table Rule Library	Contains the rule library for retrieving, counting, analyzing a user’s resources. This is mostly used by the User Form Library and to build table data on roles and resources.
Resource Table Utility Library	Contains the rules used during the selection process on Resource Table Form, for example these rules retrieve resources per role or per type.

Installing Resource Table User form involves two steps: importing the form, and changing the form mapping.

Step 1: Import the Form

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

2. Enter the file name or click Browse to locate WSHOME/sample/resourcetableforms.xml. Importing this file also imports:

Step 2: Change Form Mapping

1. From the menu bar, select Configure > Configure Form and Process Mappings.

2. In the Form Mappings section, locate userForm under the Form Type column.

3. Specify Resource Table User Form in the box provided under the Form Name Mapped To column.

Customizing Scalable Forms

After importing and mapping the scalable user form, you must customize it. To enable incremental fetching, you must identify:

• resources accounts that are initially fetched. Use the TargetResources form property to represent the resource names to be included on the fetch.

• operations that are updated when the final save operation occurs.

Both the Dynamic User Forms and the Resource Table User Forms use resource-specific forms for displaying a user’s resource-specific attributes. The following user forms are located in the WSHOME/sample/forms directory and have been adapted for use by scalable forms.

• ./ACF2UserForm.xml

• ./ActivCardUserForm.xml

• ./ADUserForm.xml

• ./AIXUserForm.xml

• ./BlackberryUserForm.xml

• ./ClearTrustUserForm.xml

• ./HP-UXUserForm.xml

• ./NDSUserForm.xml

• ./OS400UserForm.xml

• ./PeopleSoftCompIntfcUserForm.xml

• ./RACFUserForm.xml

• ./SAPPortalUserForm.xml

• ./SolarisUserForm.xml

• ./SunISUserForm.xml

• ./TopSecretUserForm.xml

These forms are automatically imported along with both Dynamic Tabbed User Forms and Resource Table User forms.

If a deployment is using a resource type other than a type listed above, the scalable forms display a default User form that simply lists all attribute name and values specified in the schema mapping. To use an existing customized resource user form other than those listed above, you must make certain modifications in order to ensure compatibility with the scalable forms. The following procedure describes some of the steps necessary to ensure compatibility.

---

Note –

Refer to any one of the forms in this list as an example of this modification.

---

Customizing a Resource Form for Compatibility with Scalable User Forms

To add your own customized resource form for use with either the Dynamic Tabbed or Resource Table user forms, follow these general steps.

Step One: Modify Dynamic Resource Forms

Instructions for adding your own resource form are provided in the dynamicformsinit.xml file. Search within this file for the Dynamic Resource Form and follow the steps provide with the form.

---

Note –

The steps described within the form are presented in comments, and are not displayed in the form once it is imported.

---

Step Two: Modify Your Resource Form

If you are not using a form from the preceding list, you will need to modify your resource form so that it is compatible. Refer to any of the files listed above for examples. Instructions are listed on the top of each resource form.