Algunas variables presentan opciones de formato que permiten especificar el formato de salida.
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 indicadas anteriormente y format especifica el formato de la fecha. Por ejemplo:
{rfq.createdAt | date:'MM DD, YYYY'}Consulte Moment.js para obtener formatos de fecha adicionales.
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: “☒”:”☐”}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 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.
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'} | Devuelve la cantidad total hasta la fecha de la solicitud de pago |
| {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 |
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:
uppercaselowercasecapitalizetitlecasePor ejemplo:
{owner.name | uppercase}Devuelve el nombre de la empresa del propietario todo en mayúsculas.
Para extraer el formato de texto enriquecido (por ejemplo, negrita, cursiva) en una plantilla de documento de Word, debe añadir el símbolo "@" a la variable personalizada.
Por ejemplo:
Si tiene una variable de nota {rco.note}, este es el aspecto al añadir el símbolo "@": {@rco.note}. Este cambio garantizará que se incluya el formato de texto enriquecido de las notas de la orden de cambio.
Puede eliminar las extensiones 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'}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}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:
get:'0': 1.1get:'1': 001get:'2': ABC 01get:'3': CD EF 00FFget:'4': 1.9GComo alternativa, puede utilizar la función slice o el comando last para extraer partes de la cadena:
{sco.number | slice':-3'}.{sco.number | split:'-' | last} para obtener la última parte de la cadena dividida.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'}