› User interface › Forms › Form events and actions › Form actions › Update control properties action

Update control properties action

Use the Update control properties action to set properties of a control to dynamically change the display or behavior of the control.

  1. On the form modeling bar, click Actions and click New.

    The New action dialog box is displayed.

  2. On the Type list, select Update control properties.
  3. Change the default Name (UpdateControlProperties1) to something meaningful.
  4. Optional. Enter a Description for the action.
  5. On the Control list, select a control. Available controls for this action are Tile, Chart, Work queue, Workload, and Job list.
  6. Additionally, for a Chart or Tile control, for Query type, select Job query, Work queue query, or System query.

    The filter fields for the selected query are displayed.

    The respective properties available for update appear under Properties. For example, for a Tile control, the DynamicFilterField, DynamicFilterValue, DynamicQueryID, DynamicQueryName, and DynamicQueryType properties are available.

  7. To select a property to update, do the following:
    1. Click .
    2. On the Property list, select a property.
    3. On the Source/Value list, select a form control, form variable, global variable, or filter field, or click the Edit icon and enter an inline value that identifies the field.
      You can dynamically filter query results on the Tile, Chart, Job list, Work queue, and Workload controls. If you select the DynamicFilterField property, a Filter field tab is available for controls and you can select a field to map. See Dynamically filtering work type fields.
    4. Click Add.

      The new property appears under Properties list.

  8. Click Add.

    The newly created action appears on the Actions list.

  9. Associate the action with a control, such as a button, to trigger this action. See Configure actions for form control events.
    When you trigger this action, the properties in the list are applied to the control with the value you supplied.

See also:

Dynamically filtering work type fields

To dynamically filter the work type fields, do the following:

  1. Assign the configured work type in the work queue query.
  2. You can call the "Update control properties" action in the form.
  3. On the Control list, select a work queue control.
  4. Provide the work type filter field names for "DynamicFilterField" and "DynamicFilterValue" to be mapped to pass the dynamic value at runtime.
  5. On the work queue control properties panel, select the Query for Initialize with on the Search tab.
  6. On the Query list, select a query that is used to load the initial list of activities in the work queue. For more information, see Search properties.
  7. Release the form.

    When you open the form at runtime, the work queue control displays the query results, and on executing the update control properties action, you can filter by providing work field values.