Formato de variables

Algunas variables presentan opciones de formato que permiten especificar el formato de la salida.

Fecha

La opción de formato de fecha permite especificar el formato con el que se generan las fechas.

{variable | date:'format'}

Donde variable es una de las variables y format especifica el formato de la fecha. Por ejemplo:

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

Consulte Moment.js para obtener más formatos de fecha.

Booleano

La opción de formato booleano permite utilizar un operador booleano para generar texto personalizado.

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

Donde variable es una de las variables. Por ejemplo:

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

Creación de una casilla de verificación para atributos personalizados:

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

Número

La opción de formato de número permite especificar el formato de las salidas numéricas.

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

Donde variable es una de las variables, decimal points especifica el número de decimales después del separador de la fracción, group separator especifica el símbolo que se va a utilizar para el separador de grupo, fraction separator especifica el símbolo que se va a utilizar para el separador de fracción. Por ejemplo:

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

devolverá un número como, por ejemplo, 10.050,89.

Puede añadir moneda escrita a las variables de formato numérico mediante el formato writtenCurrency:'USD'. Por ejemplo:

{contract.awarded | writtenCurrency:'USD'}

donde puede reemplazar USD por la divisa real del contrato adjudicado.

Funciones matemáticas

Se pueden aplicar funciones matemáticas y redondeo a las variables de los documentos. Se admiten las operaciones sumar, restar, multiplicar y dividir.

Ejemplos:

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

Ejemplo de cálculo y redondeo:

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

También puede crear variables matemáticas más avanzadas, lo que puede ser útil cuando se trabaja con plantillas de documento para aplicaciones de pago. Por ejemplo:

Variables Descripción
{ previousQuantity | add: quantity | rounding: '0.01': 'half-up' } Returns Total to Date Quantity of the payment application
{ previousAmount | add: amount | rounding: '0.01': 'half-up' } Devuelve el total hasta la fecha Importe de la solicitud de pago
{ payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up’ } Devuelve el total general de la solicitud de pago

Texto

Las opciones de formato de texto permiten controlar la distinción entre mayúsculas y minúsculas de la salida de palabra en función de la variable.

{variable | case}

Donde variable es una de las variables y case representa uno de los siguientes elementos:

Por ejemplo:

{owner.name | uppercase}

Devuelve el nombre de la empresa del propietario todo en mayúsculas.

Compuesto

La opción de formato compuesto permite combinar dos formatos adicionales.

{variable | format1 | format2}

Donde variable es una de las variables, y format1 y format2 representan dos opciones de formato diferentes de las indicadas anteriormente. Por ejemplo:

{rco.approved | written | uppercase}

Orden

Cuando se dispone de una lista o colección de datos, se puede ordenar en orden ascendente (asc) o descendente (desc) por número.

Utilice el siguiente formato:

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

Por ejemplo:

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

Recortar

Puede eliminar la extensión de archivo de los documentos generados. Por ejemplo, si utiliza la variable {{{-w contract.exhibits}{targetName}{/contract.exhibits}}}, puede incluir la extensión de nombre de archivo .docx o .pdf en el documento generado.

Si todos los archivos están en formato .docx, puede eliminar la extensión mediante la función trimEnd:

{targetName | trimEnd:'.docx'}

Si tiene archivos .docx y .pdf y desea eliminar ambas extensiones, puede encadenar la función trimEnd de la siguiente manera:

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

Dividir

La función split permite separar una cadena en distintas partes en función de un carácter o conjunto de caracteres específico, conocido como delimitador.

Este es un ejemplo:

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

Este comando dividirá la cadena almacenada en la variable number en cada -. A continuación, obtendrá la segunda parte de la cadena dividida, ya que el recuento comienza en 0.

Supongamos que la variable number contiene la cadena "1.1-001-ABC 01-CD EF 00FF-1.9G". A continuación se indica lo que devolverá cada comando get:

Como alternativa, puede utilizar la función slice o el comando last para extraer partes de la cadena: