Writing Tachyon Instructions
Integrating with Tachyon
Tachyon .NET Consumer SDK
Tachyon PowerShell Toolkit
Response Visualization Definition
A response visualization definition must be provided in each instruction definition that requires a custom response visualization. This is because it is tightly coupled to instruction definition schema. The configuration is JSON based.
From the JSON above we can see it has three properties.
This property is the name of a template. Tachyon comes with one default template named "default".
This property contains an array of one or more template configurations. Each configuration defines how the specified template will be used, which aggregated response columns are used, and which processors are used to render the specified visualization.
This property contains an array of processor definitions. Each definition specifies the configuration of a single processor. The same processor can be used by multiple visualizations.
This property is the name of a template. Tachyon comes with one default template named "default". At the moment, only "default" template is available and that template handles various types of charts and graphs. In future it would be possible to create custom templates.
This property contains an array of one or more template configurations. Each configuration defines how the specified template will be used, which aggregated response columns are used, and which processors are used to render the specified visualization. At this time "default" is the only supported type of template, which provides an array of chart and graph types. Therefore, each definition describes what chart or graph can be created, which response columns are plotted, where the chart will be positioned and also how its data is to be processed using a PostProcessor.
Unique chart id. It must be unique in the array of charts.
The id is a name, and it helps if it relates to the position on the screen (row, size) when multiple configurations (eg chart) are used within a single definition. For example, TopLeft.
Title to be displayed for the chart.
Supported charts are:
Column name used for label, which must be present in aggregation schema. The label can be any datatype, except for time series processors which must be a valid date time.
Column name used for quantity, which must be present in aggregation schema. The quantity must be a numeric dataype.
Column name used for grouping, which if used, must be present in aggregation schema. The grouping can be any datatype.
Used only for Line, Bar, Column, Area and StackedArea types.
Name of the PostProcessor used to prepare responses to be consumed by the chart. The PostProcessor must be defined in the PostProcessors arrray.
Row number in which the chart will be displayed. This is an integer value. One row can contain more than one chart.
How much space the vizualization occupies in proportion to other vizualizations in the same row. This is an integer value. Ignored if there is only one vizualization in a row.
This property contains an array of processor definitions. Each definition specifies the configuration of a single processor. The same processor can be used by multiple visualizations. Each response processor prepares data to be consumed by a visualization and must produce data in a format expected by that visualization. V isualizations expect all the data preparation and formatting to be done by the processors and they will not do any themselves. They will simply take the processor output and attempt to use it directly as their data source. In case of charts this means attempting to plot chart specified in the visualization using the data provided by the processor.
Unique name of the processor. This name is referenced in the PostProcessor field of TemplateConfigurations property.
The call to a built-in processor function, used to process response data. Consists of processor name followed by a list of parameters inside parentheses. Parameters are specific to each built-in processor .
Cannot be used in conjuction with Script.
Custom C# code, used to process response data.
Cannot be used in conjuction with Function.
Please note that Function and Script are mutually exclusive.
In the above example, the instruction that has aggregation schema with 3 columns: "Sum", "Count" and "ProcessName".