Formatação das variáveis

Algumas variáveis são fornecidas com opções de formatação que permitem especificar o formato da saída.

Data

A opção do formato da data permite especificar o formato das datas.

{variable | date:'format'}

Em que variable é uma das variáveis e format especifica o formato da data. Por exemplo:

{rfq.createdAt | date:'MM DD, YYYY'}

Consulte Moment.js para obter mais formatos de data.

Booleano

A opção do formato booleano permite que você use um operador booleano para produzir texto personalizado.

{variable | bool:'true value': 'false value': 'N/A value'}

Em que variable é uma das variáveis. Por exemplo:

{rfq.properties['is approved'] | bool:'Y': 'N'}
{rfq.properties['is approved'] | bool:'GOOD': 'BAD': 'NA'}

Crie uma caixa de seleção para um exemplo de atributos personalizados:

{rco.properties["checkbox3-1"]| bool : “☒”:”☐”}

Número

A opção do formato do número permite que você especifique o formato das saídas numéricas.

{variable | number:'decimal points': 'group separator': 'fraction separator'}

Em que variable é uma das variáveis, decimal points especifica o número de pontos decimais após o separador de fração, group separator especifica o símbolo a ser usado para o separador de grupo e fraction separator especifica o símbolo a ser usado para o separador de fração, por exemplo:

{rco.approved | number:'2': ',': '.'}

retornaria um número como 10,050.89.

Você pode adicionar moeda escrita às variáveis de formato de número usando o formato writtenCurrency:'USD'. Por exemplo:

{contract.awarded | writtenCurrency:'USD'}

em que é possível substituir USD pela moeda real do contrato concedido.

Funções matemáticas

É possível aplicar funções matemáticas e arredondamentos às variáveis dos documentos. Todas as operações são compatíveis: adição, subtração, multiplicação e divisão.

Exemplos:

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

Exemplo de função matemática e arredondamento:

{rfq.approved | divide: 1.5 | rounding: '0.1': 'half-up'}

Você também pode criar variáveis matemáticas mais avançadas, que podem ser úteis ao trabalhar com templates de documento para pedidos de pagamento. Por exemplo:

Variáveis Descrição
{ previousQuantity | add: quantity | rounding: '0.01': 'half-up' } Retorna a Quantidade total acumulada do pedido de pagamento
{ previousAmount | add: amount | rounding: '0.01': 'half-up' } Retorna o Valor total acumulado do pedido de pagamento
{ payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up’ } Retorna o Valor total geral do pedido de pagamento

Texto

As opções do formato do texto permitem que você controle o uso de maiúsculas e minúsculas das palavras pela variável.

{variable | case}

Em que variable é uma das variáveis e case representa um dos itens a seguir:

Por exemplo:

{owner.name | uppercase}

Retorna o nome da empresa do proprietário com todas as letras maiúsculas.

Composto

A opção de formato composto permite que você combine dois outros formatos.

{variable | format1 | format2}

Em que variable é uma das variáveis e format1 e format2 representam duas opções de formato diferente acima. Por exemplo:

{rco.approved | written | uppercase}

Ordenação

Quando você tem uma lista ou coleção de dados, é possível classificá-las em ordem crescente (asc) ou decrescente (desc) por número.

Use o seguinte formato:

{#variable | sortBy:'number':'order'} {/variable | sortBy:'number':'order'}

Por exemplo:

{#oco.pco | sortBy:'number':'asc'} {/oco.pco | sortBy:'number':'asc'}

Apara

É possível remover a extensão de arquivo dos documentos gerados. Por exemplo, se você estiver utilizando a variável {{{-w contract.exhibits}{targetName}{/contract.exhibits}}}, ela poderá incluir a extensão de nome de arquivo .docx ou .pdf no documento gerado.

Se todos os seus arquivos estiverem no formato .docx, você pode remover a extensão utilizando a função trimEnd:

{targetName | trimEnd:'.docx'}

Se você tiver arquivos .docx e .pdf e desejar remover ambas as extensões, poderá encadear a função trimEnd desta forma:

{targetName | trimEnd:'.docx' | trimEnd:'.pdf'}

Dividir

A função split permite separar uma sequência de caracteres em diferentes partes com base em um caractere específico ou conjunto de caracteres, também conhecido como delimitador.

Veja a seguir um exemplo:

{ number | split:'-' | get:'1' }

Este comando dividirá a sequência de caracteres armazenada na variável number em cada - e então obter a segunda parte da sequência de caracteres de divisão (desde que a contagem comece em 0).

Digamos que sua variável number contenha a sequência de caracteres "1.1-001-ABC 01-CD EF 00FF-1.9G". Veja o que cada comando get retornará:

Como alternativa, você pode utilizar a função slice ou o comando last para extrair partes da sequência de caracteres: