Tag
When requesting the text content of a panel through any of the web endpoints, the content returned is formatted and tags are replaced. These tags can be general tags, values of attributes and globals, as well as TQL Select statements.
Tags should always be preceded by a dollar sign ($), for example:
$SELECT_GLOBAL_WHERE_NAME_IS_FOO
$TQL Tags
Select queries can also be added to a text panel to obtain Project Session data. These select queries must always be preceded by a dollar sign ($) and are allowed to end with a dollar sign ($) as well. Adding or adjusting select queries require a Calculation to be updated. Once the results of the defined select queries are calculated, the queries are replaced with the calculated values.
For example, the $TQL tags for obtaining the name of a Neighborhood with Item ID 4, that will be replaced successfully are $SELECT_NAME_WHERE_NEIGHBORHOOD_IS_0 and $SELECT_NAME_WHERE_NEIGHBORHOOD_IS_0$.
HTML, CSS and Javascript
Text panel content is always returned as HTML; if it isn't already, <html> and <body> tags are automatically added. Javascript can defined and used inside <script> tags.
General Tags
| Name | Description |
|---|---|
| $PROJECT_NAME | Formatted project name |
| $PLATFORM_DESCRIPTION | Client description of the Tygron Platform |
| $LIB_CUSTOM | Lower-case underscored project name |
| $TITLE | Title of the panel |
| $CSS | Replaced with relative stylesheet link: <link rel=\"stylesheet\" type=\"text/css\" href=\"tygron.css?token=$TOKEN\">
|
| $LIB_PLOTLY | Replaced with header script entry for Plotly; <script src=\"plotly.js?token=$TOKEN\" type=\"text/javascript\"></script>
|
| $TOKEN | Web token or Api token, depending on the context. |
| $STAKEHOLDER_ID | id of the stakeholder; Stakeholder is obtained from the accessing web stakeholder or from a specified stakeholder id in the end point. |
| $STAKEHOLDER_SHORT | short name of the stakeholder; Stakeholder is obtained from the accessing web stakeholder or from a specified stakeholder id in the end point. |
| $STAKEHOLDER | name of the stakeholder; Stakeholder is obtained from the accessing web stakeholder or from a specified stakeholder id in the end point. |
Legacy Tags
The following tags are deprecated and not to be used anymore, but kept for backwards compatibility.
| Name | Description |
|---|---|
| $SESSION | Replaced with empty string |
| $SLOT | Replaced with empty string |
| $ID | Replaced with the id of the linked item. |
| $NAME | Replaced with the name of the linked item. |
| $ATTRIBUTE_ | Replaced with the value for the attribute specified after $ATTRIBUTE_, obtained from the linked item.
|
| $GLOBAL_ | Obtains the value of the Global specified after $GLOBAL_ from the linked item.
|
Limitations
Tags, Globals, attributes, and TQL Select statements are only replaced in the text content and cannot be generated dynamically via JavaScript.
Generally only capital letters, numbers, underscores are supported for tags. Characters such as , ( ) [ ] { } < and > cannot be used.
In the following example, the Select statements are not properly replaced and will therefore not work.
const tableData = [];
for (const nh of neighborhoods) {
const nameQuery = `$SELECT_NAME_WHERE_NEIGHBORHOOD_IS_${nh.id}`;
const valueQuery = `$SELECT_ATTRIBUTE_WHERE_NEIGHBORHOOD_IS_${nh.id}_AND_NAME_IS_INHABITANTS`;
tableData.push({
name: nh.name,
inhabitants: valueResult[0] // TQL returns an array of results
});
}Instead, the select statement should be written as follows:
const neighborhoodNames = [ $SELECT_NAME_WHERE_NEIGHBORHOOD_IS_X ];
const neighborhoodInhabitants = [ $SELECT_ATTRIBUTE_WHERE_NEIGHBORHOOD_IS_X_AND_NAME_IS_INHABITANTS ];
const tableData = [];
for(let n = 0; n < neighborhoodNames.length && n < neighborhoodInhabitants.length; n++){
tableData.push({
name: neighborhoodNames[n];
inhabitants: neighborhoodInhabitants[n];
});
}For further specification details, see Global, Attribute and Select (TQL) respectively.
Notes
- Tags can also be used in the output of Panels based on an Excel, and in Indicators.