Table Tool

The Table tool creates a data or pivot table to output in a report via the Render tool.

Table headers and footers

To include a header or footer to your table, add a Report Text Tool directly below the Table tool and select Attach Text to Existing Field.

Configure the tool

Table Mode: Select a type of table. Options are: Basic or Pivot (Cross Tab). Use the Pivot mode when using data from a Cross Tab Tool.

Group By: Select the fields to group by. A separate table is created for each group of records.

Table Width: Select the width of the table.

  • Automatic: Sets the minimum width for the data contained within a table to display.
  • Percentage: Sets the percentage of the page for the table to be displayed, where 100% is the entire width of the page.
  • Fixed: Sets the width of the table in inches.

Pivot Style: Select the style for displaying the data in the table. This option is only available when using data from a Cross Tab tool. Compare the beginning data example to the example output for each option.

  • Methodology over Variable: The method for aggregating the data displays above the data field selected.
  • Variable over Methodology: The data field selected displays above the method for aggregating the data.
  • Pivot Methodology to the Left: The method for aggregating the data displays on the left side for each row of data in the table.
  • Pivot Variable to the Left: The data displays in the table on the left side of the method for aggregating the data.

Bar Graph: Specify the data field to create a bar graph for in the table. This option is only available for a basic table. Click Settings to modify the style of the bar graph.

Show Column Headings: Displays column headings in the table. This option cannot be deselected for a pivot table.

Per Column/Methodology Configuration: If the table mode is Basic, configure the columns and if the table mode is Pivot, then configure the methodologies.

  • Select the data fields to include in the table.
  • Click a data field and use the up and down arrows to change the order the data displays in the table.
  • Click a data field to configure the following attributes:
    • Rename Field: Type a new name for the data field.
    • Width: Select Automatic, Percentage or Fixed for the width of the data within a column.
    • Alignment (H): Select the horizontal alignment of left, center, or right.
    • Borders: Select to have borders on the left or right sides, or both sides, or to not have any borders.
    • Prefix: Type text to add before the data.
    • Suffix: Type text to add after the data.
    • Dec. Places: Select the number of decimal places to include.
    • Column Rules: Create or edit a rule to apply to a column of data. For style options, see Table Style Rules.

    Default Table Settings: Modify style options for the table. For style options, see Table Settings Style Editor.

    Create/Edit Row Rule: Create or edit a rule to apply to a column of data. For style options, see Table Style Rules.

    Because this tool includes an expression editor, an additional input anchor displays when the tool is used in an app or macro workflow. Use the Interface tools to connect to a Question anchor. See Interface Tools.