Introduction

You can set facets of a point with a dedicated column.

You have two ways for defining facets

  • Using the simplified notation
  • Using templates and the dedicated manager (recommended)


Example

Using the simplified notation

It’s a simplified syntax for facets where you specify pairs of key=value separated by semi columns:

  • For units, you just need to put the unit symbol, and you don’t have to put the unit for the number values and the range.
  • For booleans, add a b: 
  • For strings, add s: 
  • For Reltime add r:
  • For Integer add i:


Example: units=€;precision=2;range=aaphp:AaPhpDataTypesEnum;allowNull=b:true;falseText=s:falseText. The string values are unescaped at the export and escaped at the import, so you can write unescaped values in the cells.

You can put a facet into a variable in the dedicated part of the ~Variables Sheet

Simply call then $temp


Using the facets manager in the templates

The facets manager is located in the facets.bog in the Workbench User Home (shared/excel/templates). You can just double-click on the facets.bog file to display it. This manager allows you to create, edit and delete FacetsComponents.

To reuse those facets simply set the cell value to the path to the FacetsComponent.

Example:


To use the temperature FacetsComponent, simply call temperature in the cell.

Since the 46.17, the "facets/" prefix is not needed anymore to target a component in the facets.bog


Example of syntaxes

Facets




units=°C;precision=i:2;min=30.0;max=120.0
$temp
temperature


Columns syntax

Create a column and give the name "Facets". There is no need for subcolumns.

Accepted values (by priority during the export)

  • Variable

  • Path to a template (in the facets.bog)

  • Encoded facet value

Try it yourself !

Here is the file used in the above import example. Download it, try importing it and see the result.

For the third syntax, you will need to create a FacetComponent named temperature in the facets.bog (located in your "User Home" in the shared/excel/templates folder).

setFacets.xlsx