Reporting tags

IntelliSurvey's survey programming language (SPL) includes several tags or widgets that can be used to customize how data is handled in our reporting applets. These tags can be used to create variables specifically for reporting; add alternate descriptions to questions, variables, or responses; organize questions or variables into sections; and more. While some of these tags and widgets should be applied before your survey is in field, others can be added during or after the collection of respondent data.

The following table includes some of the more commonly used tags and widgets that can used to customize your reporting experience. For a list of tags associated with quotas and using our quota management applets, see Common quota tags.

Tags

The following tags can be used to enhance a report's legibility and usefulness.

Tag	Description
`chapter` `define chapters`	Organizes a survey into distinct sections, much like a table of contents. Reports reflect this organization by grouping questions and variables by chapter. Surveys may contain user-defined chapters, in addition to default system chapters. User-defined chapters are created in two ways - globally, via the `define chapters` widget, and locally, with the `chapter` tag attached directly to a widget
`collection punch summary`	New for r9; automates the creation of summary variables to "roll up" or summarize data selected in large lists with multiple collections (collection headers). This tag can be used on the multi-punch question types `type: checkbox` or `type: coded multiple select`
`create closed`	Recodes an open-ended question as a closed-end, hidden variable in order to ease data analysis. This tag specifies a variable ID and a list from which it can assign open-ended responses into various ranges. If need be, the tag may be applied multiple times on a question to create different closed-ended variations from a single open-ended variable.
`create timers` (alias, `timers`)	Creates a variable to record the amount of time elapsed within a certain section of a survey. For use with `start group` or `define chapters` widgets, and can also be applied to all named groups if used with the `set defaults` widget.
`desc`	Provides alternative question text to reports when added to a widget. This applies to both question and table widgets, as well as blocks and loops.
`export as non-verticalized`/`export as verticalized`	Switches a question's classification in Verticalized (Tableau) reports, allowing it to be exported in a file outside of its typical designation.
`export unseen options as`	New for r9; renders options unseen by respondents as "blanks" in data exports rather than as '0'. Input options are '0' (default) or 'blank'. This tag can be applied to `type: checkbox` questions, either before or after fielding.
`mark as` (alias `mark`)	Apply (while programming) to a question to define a variable based on existing options to be referenced later as a shortcut. For closed-end options only. Survey Programmers (SPs) may also apply a variation of this tag as an element decorator, or apply multiple `mark` tags to a single variable.
`metric`	Permits SPs to add custom metrics to Crosstab Reports. Multiple `metric` tags permit the addition of multiple custom metrics. SPs can invoke one or more `metric` tags on a question or list widget. In the case of a list, all questions utilizing the list will have the defined metric(s) available.
`named timer`	New for r9; creates a variable that records the time for every page in a group, whether or not it has a question, including all introductory and other standalone text. For use with `start group`. Cannot be used on `set defaults`, chapters, or other widget types.
`rankingdesc`	Specifies the iterative description which appears for each rank as the rows in the RANK summary tile.
`ranksdesc`	Specifies the title for the derived RANK summary tile.
`report options`	Specifies the display options which will be loaded every time the tile for that question appears in a Topline report. All of the options which can be selected from the Gear menu on a given tile can be edited via this tag.
`report placement` (alias, `reporting placement`)	Alters a `reporting only` variable's location in the reporting field tree, which is helpful when these variables are added after the survey has collected data.
`reporting only`	New for r9; specifies that a variable is for reporting purposes only. Reporting-only variables employ a dynamic, real-time data retrieval mechanism, harnessing the software's system resources to continuously display the latest data in reports while keeping user experience seamless.
`row punch summary`	Creates a summary variable on tables with rows and options. Condition and `desc` decorators control the qualifying criteria and reporting descriptions, and `rows` details which row IDs from the table should be included in the variable. Multiple `rowpunchsummary` tags are permitted on a single table.

Related to

Search

Tags

Comments