Expressão junto com Formato

Formatadores de Valores Utilizando Resultado de uma Expressão

O resultado de uma expressão pode ser formatado diretamente na expressão (caso este resultado seja objeto de apresentação em algum recurso).

Supondo que o valor de $value seja igual a 10, existem dois formatadores possíveis para aplicar um formato ao resultado da expressão, conforme os exemplos de sintaxes:

Formatador

Exemplo

Resultado

Pipe “|”

value | %.2f ºC

10.00 ºC

Pipe “|”

${value * 1000} | %.3f kg

10.000 Kg

Função “format”

$format($value, “%.2f ºC”)

10.00 ºC

Função “format”

$format($value * 1000, “%.3f Kg”)

10.000 Kg

Nota

Para mais informações de Formatador de Dado, acesse: Formato de apresentação de um valor.

Atenção

Utilize este recurso apenas quando o campo Formato não estiver disponível. Caso a configuração de formatação seja definida diretamente no campo Formato, ela terá prioridade sobre a formatação aplicada internamente na expressão, garantindo consistência e evitando conflitos na apresentação dos Dados.

Utilizando Vários Atributos na Mesma Expressão

É possível combinar múltiplos atributos do Conector ou do Dispositivo em uma única expressão, permitindo a criação de rótulos personalizados e informativos.

Exemplo de Sintaxe

Para exibir o nome do recurso, o valor e a unidade de medida na mesma linha:

${data.name}:  ${value.toFixed(2)}  ${data.unity_label}

Resultado esperado: Temperatura: 23.45 ºC

Nota

${}: É utilizado para converter o conteúdo do atributo em texto (String), permitindo a concatenação de diferentes tipos de Dados.

.toFixed(): Uma função JavaScript que fixa a quantidade de casas decimais especificada entre os parênteses.

Configuração de Formato

Para que expressões que concatenam textos e valores funcionem corretamente, o sistema precisa interpretar o resultado final como um texto (String).

Atenção

Certifique-se de que o campo Formato esteja vazio ou utilize o formatador de string: %s.

Caso contrário, ao utilizar um formatador numérico, o sistema tentará interpretar os atributos textuais como números, resultando na exibição de NaN para cada atributo da expressão.