IBM Support

A packageutil command to set web dependent fields in IBM Rational ClearQuest

Question & Answer


Question

How can a field be made to be web dependent in IBM Rational ClearQuest without using a Drop-down List Box or Drop-down Combo box?

Answer

Prior to version 8.0.1.07, ClearQuest supported web form refresh when the user changed a field value that was associated with a Drop-down List Box or Drop-down Combo box. To enable this feature, the ClearQuest Designer was used to select some fields in a form control property's Web Dependent Fields tab. But this feature was only available for certain form controls. For example, there was no way to cause the web form to refresh in response to a radio button changing.

In ClearQuest version 8.0.1.07, the web dependency property is generalized to apply to any field. With this change, the property can apply to any field of any type, and is no longer associated with a particular type of form control. By using the command "packageutil setwebdependentfields", a ClearQuest administrator can modify a schema to make any fields be web dependent no matter what type of form control is used for the field.

The ClearQuest designer still supports the old method of setting web dependency on a form control but does not yet support the new method on any field. Until the designer is updated, the web dependency property can be set or shown with new packageutil commands.

For example, to set the "headline" and "severity" fields to be web dependent in the "Defect" record type in the DefectTracking schema in the schema repository for the dbset named "Alpha", use the following commands, which include the best-practice of including the "-nocheckin" option:


packageutil setwebdependentfields -dbset Alpha admin "" DefectTracking Defect headline 1 severity 1 -nocheckin

Note:

1. The value "1" means to set the field to be web dependent, and value "0" means to clear the field as a web dependent field.

2. Make sure the schema is not open in the designer when the packageutil commands are run.

3. This packageutil command is only supported for setting web field's web dependent property.

4. The schema rev that was modified has to be validated and checked in and then a user database upgraded to use that new schema rev with the web dependency changes.

Another packageutil command is also available to show all the web dependent fields set by the packageutil setwebdependentfields command:

packageutil showwebdependentfields -dbset Alpha admin "" DefectTracking defect

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Command Line Tools","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.0.1.7;8.0.1.8;8.0.1.9","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21695325