Variabelformatering

Nogle variabler indeholder formateringsindstillinger, som giver mulighed for at angive outputtets format.

Date

Med datoformatindstillingen kan du angive, hvilket format datoerne angives i.

{variable | date:'format'}

Hvor variable er en af variablerne, og format angiver datoens format. For eksempel:

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

Der henvises til Moment.js, hvor der findes flere datoformater.

Boolesk

Med formatindstillingen for boolesk kan du bruge en boolesk operator på tilpasset tekst.

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

Hvor variable er en af variablerne. For eksempel:

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

Opret et afkrydsningsfelt for brugerdefinerede attributter, f.eks.:

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

Nummer

Med talformatindstillingen kan du angive formatet på numeriske output.

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

Hvor variable er en af variablerne, angiver decimal points antallet af decimaltal efter brøkseparatoren, group separator angiver det symbol, der skal bruges til gruppeseparatoren, fraction separator angiver det symbol, der skal bruges til brøkseparatoren, f.eks.

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

vil returnere et tal som 10,050.89.

Du kan tilføje en skrevet valuta til talformatvariablerne ved at bruge formatet writtenCurrency:'USD'. For eksempel:

{contract.awarded | writtenCurrency:'USD'}

hvor du kan erstatte USD med den faktiske valuta i den tildelte kontrakt.

Matematiske funktioner

Matematiske funktioner og afrunding kan anvendes på variabler i dokumenter. Adder, subtraher, multiplicer og divider understøttes alle.

Eksempler:

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

Matematik- og afrundingseksempel:

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

Du kan også oprette mere avancerede matematiske variabler, som kan være nyttige, når du arbejder med dokumentskabeloner til betalingsanmodninger. For eksempel:

Variabler Beskrivelse
{ previousQuantity | add: quantity | rounding: '0.01': 'half-up' } Returnerer samlet mængde til dato for betalingsanmodningen
{ previousAmount | add: amount | rounding: '0.01': 'half-up' } Returnerer det samlede beløb til dato for betalingsanmodningen
{ payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up’ } Returnerer hovedtotal for betalingsanmodningen

Tekst

Med tekstformatindstillingerne kan du styre brugen af store og små bogstaver i outputtet med variablen.

{variable | case}

Hvor variable er en af variablerne, og case repræsenterer en af følgende:

For eksempel:

{owner.name | uppercase}

Returnerer ejervirksomhedens navn med store bogstaver.

Komposit

Med kompositformatindstillingen kan du kombinere to andre formater.

{variable | format1 | format2}

Hvor variable er en af variablerne, og format1 og format2 repræsenterer to forskellige formatindstillinger fra herover. For eksempel:

{rco.approved | written | uppercase}

Sortering

Når du har en liste eller samling af data, kan du sortere den efter nummer i enten stigende (asc) eller faldende (desc) rækkefølge.

Brug følgende format:

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

For eksempel:

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

Trim

Du kan fjerne filtypenavnet fra genererede dokumenter. Hvis du f.eks. bruger variablen {{{-w contract.exhibits}{targetName}{/contract.exhibits}}}, kan den indeholde filtypenavnet .docx eller .pdf i det genererede dokument.

Hvis alle dine filer er i .docx-format, kan du fjerne filtypenavnet ved at bruge funktionen trimEnd:

{targetName | trimEnd:'.docx'}

Hvis du både har .docx- og .pdf-filer og vil fjerne begge filtypenavne, kan du kæde funktionen trimEnd sammen på denne måde:

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

Opdel

Funktionen split giver dig mulighed for at adskille en streng i forskellige dele baseret på et bestemt tegn eller tegnsæt, også kaldet afgrænser.

Her er et eksempel:

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

Denne kommando opdeler den streng, der er gemt i variablen number, ved hver - og henter derefter den anden del af den opdelte streng (da optællingen starter fra 0).

Lad os sige, at variablen number indeholder strengen "1.1-001-ABC 01-CD EF 00FF-1.9G". Her vises det, hver get-kommando returnerer:

Du kan også bruge funktionen slice eller kommandoen last til at udtrække dele af strengen: