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 these variables to be displayed in a Widget, selectively exported within a CSV file, and retrieved from other Apps using Lookup fields.  

Notes:

  • By default, all variables in a Data App are exposed. Variables in a Flow App must be manually exposed by ticking the expose variable checkbox.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.

    Note: Exposed LIST variables cannot be added as a variable in the 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. If a cell is exposed and holds a List variable and is added as a variable for the list view or charts, it will show an empty value

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

    9.png