Change Field action

Use the Change Field action in:

• Active links

The Change Field action changes specified characteristics of fields in the current window. (This action does not change field properties in the database.) You can define a workflow to attach custom context-menus to tables during run-time using Change Field actions. The Change Field acts on the fieldId that is defined in the Field Value.

Based on conditions when the active link executes and on the field type, you can:

• Change the field access type.
• Change the label font.
• Hide or display the field.
• Expand or collapse tree levels.
• Expand or collapse a panel field.
• Specify a different menu for a character field.
• Change the field label.
• Change the color of the field label. (Not supported for tree view table fields.)
• Hide or show the field borders, Expand Box and Menu Box.
• Change the field entry mode to Required.
• Move the focus (cursor) to the field.
• Refresh a list view or tree view table field.

To define a Change Field active link action

1. Right-click the If Action or the Else Action panel header.
2. Select Add Action > Change Field.
3. In the Field list, select Field Name or Field Value:
   • Field Name — Click the ellipsis button. In the Field Selector dialog box, select the field whose characteristics you want to change.
   • Field Value — Select a field whose runtime value will be the ID of the field to change. This option enables you to select the field to change dynamically by using workflow. See Creating a dynamic Change Field action.
4. Set the following field attributes as necessary.
    If you selected Field Name in step 3, the list of attributes is determined by the selected field's type.
    If you selected Field Value, all field characteristics appear. Attributes that are not applicable to the field type selected at runtime are ignored.
    To leave an attribute unchanged, select Unchanged (the default).
   • Field Access — Changes the Field Access field property to Read Only, Read/Write, or Disabled (for data fields) or to Enabled or Disabled (for trim, control, and tree view table fields).
   • Field Font — Changes the field label font to the specified AR Fonts style, such as Edit Field or Header Text (I). Not supported for tree view table fields.
   • Field Visibility — Changes the visibility of a field. To show a hidden field, select Visible. To hide a visible field, select Hidden.
      To be made visible, the field must be in the form view. If it is not in the current view, changing visibility has no effect. Not supported for tree view table fields.
   • Expand Collapse Tree Levels — Expands (Expand All Levels) or collapses (Collapse All Levels) all levels of a tree view table field.
      Collapse All Levels closes all levels of the tree view so that only the root node and the first level are displayed. If the root node is a level (that is, it contains non-collapsible items), the tree is not collapsed.
   • Expand Collapse Panel — Opens or closes a panel field (a panel in a panel holder.)
   • Menu — Changes the menu attached to a field: Select Changed, and either enter the name of the new menu or click the ellipsis button to select the new menu from the Menu/Keyword Selector.
      If a menu is not attached to the field, you cannot change to a different menu.
      To hide the menu icon, select the $NULL$ keyword from the Menu/Keyword Selector. This allocates space on the form for the icon. If you later use the Change Field action to attach a different menu, the menu icon reappears without affecting the form layout. For information about creating menus, see Creating-packing-lists.

   • Field Label — Changes the field label: Select Changed, and either enter a new label in the text box or click the ellipsis button and select a field reference from Field Selector. If you leave the text box empty, the field label appears blank.

     Warning

     Changing field labels can affect the layout of the form. For example, long labels might be truncated or the field might change position on the form. Leave enough room around the field to handle the changed label size.

   • Label Color — Changes the field label color: Select Custom, and select a color from the color palette. To reset the color to its default setting, select Default.
   • Field Drag — Enables or disables a field configured to be dragged (the source field). See Allowing data to be dragged and dropped.
   • Field Drop — Enables or disables a field configured to be dropped on (the target field). If you use this action to disable a field, the field is not highlighted when users perform drag operations. See Allowing data to be dragged and dropped.
   • Field Border — Changes the visibility of the field border. To show the field border, select Visible. To hide the field border, select Hidden.

   • Field Menu Box — Changes the visibility of the menu box that is attached to the field. To show the menu box, select Visible. To hide the menu box, select Hidden.

     Note

     To hide or show a menu on the browser, the menu must be attached to the field in BMC Remedy Developer Studio.

   • Field Expand Box — Changes the visibility of the expand box that is attached to the field. To show the expand box, select Visible. To hide the expand box, select Hidden. To reset the Expand Box property to its default setting, select Unchanged.

     Note

     For Field Expand Box, the attribute value set at design time does not overrides the value set at runtime.

   • Process Entry Mode — Changes a nonrequired field to a required field (Required) or reinstates the field's Optional entry mode (Not Required).
   • Set Focus to Field — When selected, moves the focus (cursor) to the field.
   • Refresh Tree/Table — When selected, refreshes a list view or tree view table field.
5. Save the active link.