Pinboard TSL specification
Scriptability for Answers and Pinboards is in beta. To enable Scriptable Answers and Pinboards, contact ThoughtSpot Support.
To work with Scriptable Pinboards in ThoughtSpot, you can download Pinboards to a flat file in
TSL, ThoughtSpot’s Scripting Language, modify it, and subsequently upload this file either to the same cluster, or to a different cluster.
To learn how to export, change, and update Pinboards, see Migrate or restore Pinboards.
Starting with ThoughtSpot release 6.3, ThoughtSpot Scripting Language (TSL) is called ThoughtSpot Modeling Language (TML). Files from version 6.3 and later have a
Syntax of the Pinboard TSL file
TSL file for Scriptable Pinboards has a specific syntax.
See the Parameters section for details about the keywords used in this example.
You may not see each of these parameters in your own TSL files, depending on whether each variable is explicitly defined.
For example, if you do not have any filters on your Pinboard, the
filters parameter does not appear.
You can add that variable to the TSL file to specify filters for your Pinboard.
pinboard : name : <pinboard_name> description : This is a multi-line description of the pinboard Description line 2 visualizations : - answer : This section includes all the Answer specification for a visualization, from name to display_mode, in the Answer syntax section of TSL Answer Specification. id : <viz_id_1> - answer : This section includes all the Answer specification for a second visualization. In this case, the visualization is a headline. id : <viz_id_2> display_headline_column : <headline_column> filters : - column : <filtered_column_name_1> oper : <filter_operator> values : <filtered_values> - value 1 - value 2 - column : <filtered_column_name_2> layout : tiles: - visualization_id : <visualization_id_1> size : <viz_id_1_size> - visualization_id : <visualization_id_2>
Parameters of the Pinboard TSL file
This section includes all the Answer specification for a visualization, from name to display_mode, in the Answer syntax section of TSL Answer Specification.
The id of the column being filtered on.
The text that describes an object: a
pinboard, and so on.
If the visualization is a headline, this parameter specifies the column the headline comes from.
Contains specifications for Pinboard and Worksheet filters.
Specifies the id of an object, such as an answer, in a Pinboard.
Specifies the Pinboard layout, in the order that a visualization_id is listed.
The name of an object. Applies to
pinboardand so on.
The operator of the Pinboard or Worksheet filter. Accepted operators are
Top-level container for all object definitions within the Pinboard.
The size of a visualization in a Pinboard. The options are
The values being filtered (excluded or included) in a Pinboard or Worksheet.
The visualizations in a Pinboard: tables, charts, and headlines.
The id of a visualization. Used to specify the Pinboard’s layout.
Limitations of working with TSL files
There are certain limitations to the changes you can apply by editing a Pinboard through TSL.
Formulas and columns can either have a new name, or a new expression. You cannot change both, unless migrating or updating the Pinboard two times.
It is not possible to reverse the join direction in the TSL script.
You cannot create Scriptable representations of R- or Python-powered visualizations.