Skip to main content

Display Tables in an Interaction: Torq Interact

Present tables to end-users using Torq Interact and allow real-time data viewing.

Updated this week

Embed tables in Interact for seamless data presentation. Display real-time data from workspace variable tables or workflow-generated JSON tables to enhance user experience and workflow efficiency.

Expose a Workspace Variable Table in Interact

Before a workspace variable table can be displayed in an Interact, you must enable it. This can be done in two ways:

  • Manually: Check the option from the Workspace variable interface.

    • Go to Build > Workspace Variables and select the relevant table.

    • Check the Allow use in Torq Interact box.

    • The table can now be accessed as a display element in any Torq Interaction.

  • Workflow: Use the Expose a table in Interact step during workflow execution.

    • Within a workflow, find the Expose a table in Interact step beneath the Torq steps.

    • Add it to the workflow designer, and fill out the Table name parameter with the relevant table name.

    • Ensure the Exposed parameter is set to True.

    • When the workflow is run, it will set the table's permissions to allow for exposure within a Torq Interact.

Displaying a Table in an Interaction

  1. Drag and Drop: Drag and drop the Table element into the Interaction.

  2. Choose a Type: Pick either Workspace variable or JSON table.

    1. JSON table is ideal for displaying temporary data that does not need to be saved in the workspace as a variable. This option requires you to already have a relevant JSON within your workflow, for example:

      [ 
      { "worker_id": "W001",
      "name": "Alice Brown",
      "email": "alice.brown@company.com",
      "ip_address": "192.168.1.10",
      "login_time": "2025-04-14T08:30:00Z",
      "login_location": "New York, USA"
      },
      { "worker_id": "W002",
      "name": "Bob White",
      "email": "bob.white@company.com",
      "ip_address": "192.168.1.11",
      "login_time": "2025-04-14T09:15:00Z",
      "login_location": "San Francisco, USA"
      },
      { "worker_id": "W003",
      "name": "Charlie Green",
      "email": "charlie.green@company.com",
      "ip_address": "10.0.0.25",
      "login_time": "2025-04-14T07:50:00Z",
      "login_location": "Chicago, USA"
      },
      { "worker_id": "W004",
      "name": "Diana Black",
      "email": "diana.black@company.com",
      "ip_address": "192.168.2.34",
      "login_time": "2025-04-14T10:00:00Z",
      "login_location": "Los Angeles, USA"
      }
      ]

  3. Data Source: If you select Workspace variable, the Data Source parameter will allow you to choose from a selection of Workspace tables that have the Expose in Interact enabled or pass from the workflow context. If you select the JSON table, the Data Source parameter will allow you to add a table from the workflow context.

  4. Show Columns: Pick which columns to display.

    1. If you are displaying a static Workspace variable table, the columns will be displayed in a drop-down menu.

    2. If you are using a table passed through the workflow context, you must manually input the column names.

  5. Sort Columns: Select which column the table will be sorted by and if it will be sorted in ascending or descending order.

  6. Filters: To filter data from the original table, add the desired conditions for the data you wish to present.

Did this answer your question?