Algumas variáveis são fornecidas com opções de formatação que permitem especificar o formato da saída.
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.
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 : “☒”:”☐”}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.
É 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 |
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:
uppercaselowercasecapitalizetitlecasePor exemplo:
{owner.name | uppercase}Retorna o nome da empresa do proprietário com todas as letras maiúsculas.
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}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'}É 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'}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á:
get:'0': 1.1get:'1': 001get:'2': ABC 01get:'3': CD EF 00FFget:'4': 1.9GComo alternativa, você pode utilizar a função slice ou o comando last para extrair partes da sequência de caracteres:
{sco.number | slice':-3'}.{sco.number | split:'-' | last} para obter a última parte da sequência de caracteres de divisão.