Expose Variables

SKIP AHEAD TO
What does it mean to expose variables?
How to expose variables for FORM block fields
How to expose variables for the YN and LIST blocks
How to expose variables for the TABLE and COMP Table blocks
How to expose variables for the JS block
Limitations

 

What does it mean to expose variables?

Exposing variables allows variables inside an App to be displayed on the dashboard.

Note: You must have a premium feature licence to customise your widgets on your dashboard. Please contact your Account Manager for more details.

 

How to expose variables for FORM block fields

To expose the variables within a Form page:

  1. Click on the relevant Form page on the Studio grid

  2. In the Property Editor on the right panel, click Open Form Builder

  3. Click on a variable type that has been added to the Form (which appears on the white pane in the centre of the Form)

    4.png


  4. On that variable’s Property Editor, click Expose variable for list view and chart

    5.png

 

How to expose variables for the YN and LIST blocks

To expose the variables within LIST pages:

  1. Click on the relevant page on the Studio grid

    List.png


  2. In the Property Editor on the right panel, click the Other heading

    2.png
  3. Click Expose variable for list view and chart.
    3.png

 

How to expose variables for TABLE and COMP Table blocks

To expose the names of variables within Table and Computation pages:

  1. Click on the relevant Table or Computation page on the Studio grid

  2. In the Property Editor on the right panel, click Open Table Builder or Open Computation Builder

  3. Click on a cell that contains or will capture a data point that you want to include in your Project Team’s dashboard table or chart

    6.png


  4. Click Expose variable for list view and chart.

    7.png

 

How to expose variables for the JS Block

  1. Using the drop-down, select the output variable type (i.e. Text, Number, List or User) and click "+Add variable" to add the output variable from the JS snippet

    v1.22_Release_Notes_and_Wiki_2021-02-11_19-04-59.png



  2. Insert the variable name used in the JS snippet in the "Variable in JavaScript" field

    Note: The variable name that will be used in Checkbox for the output JS variables can be renamed (i.e., TXT86 in the screenshot below can be renamed)

    v1.22_Release_Notes_and_Wiki_2021-02-11_19-06-09.png


  3. Expose the output JS variable by checking the checkbox in the same row

    v1.22_Release_Notes_and_Wiki_2021-02-11_19-06-38.png

  4. Click “SAVE” once changes have been made

 

Limitations

Note that compatibility with Table and Computation cells has two exceptions:

  1. The cell cannot have a List page dynamically referenced inside of it (i.e. the cell cannot have {{LIST##}} typed inside of it). This will make the expose variable checkbox disappear.

    8.png


  2. The cell cannot be inside of a row where User can add rows is enabled.

    9.png