Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Defining refresh conditions for UI areas

Updated on February 7, 2022

Ensure that your users have access to relevant and up-to-date information by defining conditions that cause their UI to refresh.

For example, you can configure the layout that holds your order summary to refresh every time the user edits the list of items in the shopping cart.
Before you begin: Create or identify a layout, embedded section, or a view to which you want to add an action. For more information, see Layouts and Creating views for case types.

The system uses the refresh condition to determine when to refresh the section. When the condition evaluates to true, the section refreshes. The condition comprises a property and an operator, such as equals (=) or does not equal (!=). In addition, the condition builder includes two out-of-the-box operators:

  • AddDelete, which evaluates to true if a new page is added or removed from the condition's list property.
  • Changes, which evaluates to true if the condition's property changes.
  1. Search for and open a section that holds the target layout or the target view.

  2. Open the settings of the target UI area:

    • To edit the settings pane of a view in App Studio, access the view, and then, in the pane on the right side of the screen, click Settings.
    • To open the properties dialog box of a layout or an embedded section in Dev Studio, in the Dynamic layout header, click the View properties icon.
    Note: If the section that you want to open is based on a template, open that section either as a view in App Studio, or as an embedded section. For more information, see Accessing views in your application.
  3. In the settings of the UI area, in the Refresh condition field, define when you want the area to reload:

    1. Click the Open condition builder icon.

    2. In the Refresh when dialog box, in the empty field, enter the name of the property on which you want to base your expression.

      Note: For applications that do not use Cosmos React UI, the property must be in the same thread, or you must move it to requestor or node level.
    3. In the operator list next to the property field, select the condition that you want to use in your expression.

      For example: Enter ItemList() in the empty field and select AddDelete in the operator list to create an expression that reloads the UI whenever the user adds or removes entries in the ItemList list property.
    4. To add a second condition, in the logical operator list below the property field, select the logical operator that you want to use to connect the conditions, and then repeat steps 3.b through 3.c for the new condition.

    5. Click Save.

  4. To run an additional operation on refresh, perform the following actions:

    • To run a data transform, select the Run data transform check box, and then provide the name of the data transform.
    • To run an activity, select the Run activity check box, and then provide the name of the activity.
  5. Save the changed settings by clicking Apply or Submit.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

100% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us