AX1011
Using symbols in Formatted Grids
You can use the Symbol content tag within a Grid data source to display symbols in the grid. The Symbol tag has no effect within the source file itself, but when the file is viewed as an Axiom form, the tag will be resolved as a symbol.
Content tag syntax for symbols
The syntax for the Symbol content tag is as follows:
[Symbol=SymbolName; Href=URL; UseNewWindow=True/False; Tooltip=Text; ColumnStyle=StyleName; Columns=Number;]
Parameters can be listed in any order. Optional parameters can be omitted.
(missing or bad snippet)Parameter | Description |
---|---|
Symbol | The name of the symbol to display. The name must be a valid name from the symbol library. For more information on how to browse symbols and find specific symbol names, see the following section. Alternatively, you can use a bracketed cell reference to read the symbol name from the referenced cell. This approach is useful if you want to dynamically determine the symbol, because then the formula can be in the referenced cell instead needing to construct the tag using a formula. For more information, see Referencing cells in content tag parameters. If you use a cell reference, and the referenced cell currently contains a valid symbol name, then that symbol will be shown in the dialog. |
HREF | Optional. The URL to a target file or web page. This can be used to display symbols that open a file or a web page when clicked. For more information on how to generate a URL to a file within the Axiom database, see the discussion in Using hyperlinks in Formatted Grids. Alternatively, you can use a bracketed cell reference to read the URL from the referenced cell. This approach is useful if you want to dynamically determine the URL, because then the formula can be in the referenced cell instead needing to construct the tag using a formula. For more information, see Referencing cells in content tag parameters. |
Tooltip | (missing or bad snippet) |
UseNewWindow | (missing or bad snippet) |
Columns | (missing or bad snippet) |
ColumnStyle | (missing or bad snippet) |
Browsing available symbols
When using the Data Source Assistant / Tag Editor, you can browse the available symbols and have Axiom Financial Institutions Suite automatically create the tag for you with the appropriate symbol name.
For the Symbol parameter, click the Browse button [...] to open the Choose Symbol dialog. Within this dialog, you can scroll through the available symbols, or you can use the filter box at the top to find symbols based on symbol names. For example, you can type file
to see all of the symbols that have the word "file" in the name, or you can type fa-file-o
to find the symbol with that specific name. To find out the name for a particular symbol, hover your cursor over the symbol to see the symbol name in a tooltip.
When you have found the symbol that you want to use, select it and then click OK to add it to the Symbol tag.
NOTE: If you are using a cell reference for the Symbol field, then you should note the desired symbol name and then click Cancel to exit the dialog. If you click OK, the selected symbol name will overwrite the cell reference. After finding the symbol name, you can then go to the referenced cell and manually place the symbol name into that cell.
Tag examples
[Symbol=fa-filter]
This example displays the filter icon within the grid, when the file is viewed as an Axiom form.
[Symbol=fa-exclamation;ColumnStyle=[N];]
This example reads the column style from column N, in the row that contains the tag. The cell in column N could contain a formula that changes the style based on some criteria (for example, to show the symbol in red if the value is exceeds a certain threshold).
="[Symbol=fa-bar-chart;Href="&GetFormDocumentURL(G23)&";UseNewWindow=True]"
In this example the HREF parameter is used so that the user can double-click the bar chart icon to open the specified Axiom form.