Variabelliste: underkategorier og spørsmålstegn
Spørsmålstegn i variabellisten med underkategorier og formateringsvalg.
Hva betyr spørsmålstegn i variabellisten?
Variabellisten i Dibbel inneholder flere standardvariabler som kan kopieres direkte inn i Word-maler. Noen variabler har imidlertid underkategorier, og disse vises med et spørsmålstegn i listen.
Når du klikker på spørsmålstegnet, får du enten:
En forklaring av hva variabelen består av:
Variabelen er en gruppering (et objekt) med flere underfelter
Et valg mellom ulike alternativer for samme variabel For eksempel om verdien skal formateres som valuta, eller avrundes til to desimaler
I begge tilfeller må du velge ett av alternativene eller ett av underfeltene for at variabelen skal fungere riktig i Word-malen.
To måter spørsmålstegnet brukes på
Et spørsmålstegn betyr at det finnes mer informasjon eller flere valg knyttet til variabelen. Dette kan være:
Spørsmålstegn som viser underkategorier i variabellisten (gruppering)
I noen tilfeller brukes spørsmålstegnet kun for å vise at en variabel er en gruppering av flere felt. Variabelen kan da ikke brukes direkte, men fungerer som et objekt som inneholder underkategorier.
Et eksempel på dette er kunde-variabelen.
Når du klikker på spørsmålstegnet ved siden av "Kunde", får du en forklaring som viser at variabelen består av flere underfelter og fungerer som en gruppering av data.

Dette betyr at kunde ikke er én enkelt verdi, men et objekt som inneholder flere relaterte felter.
Forklaringen viser også at du må bruke punktnotation for å hente ut spesifikke verdier fra gruppen, for eksempel kundenavn, organisasjonsnummer eller adresseinformasjon.
Når du klikker på selve Kunde-variabelen i listen, åpnes en oversikt over tilgjengelige underkategorier:

Disse variablene kan kopieres direkte og brukes i Word-malen uten ytterligere valg.
Noen underkategorier kan selv være grupperinger. I kunde-eksempelet gjelder dette for adresse:

Klikker du på "Kundens adresse", får du opp nye underfelter:

Disse fungerer på samme måte som de andre nevnte variablene og kan kopieres direkte og brukes i Word-malen.
Spørsmålstegn som åpner valg (String, Number, File, Date)
I andre tilfeller brukes spørsmålstegnet for å gi deg valg for hvordan en variabel skal behandles og vises i dokumentet. Når du klikker på spørsmålstegnet, får du opp valg for hvilken variant av variabelen som skal brukes, avhengig av hvordan verdien skal presenteres i dokumentet.

Her må du velge riktig variant fra valgene som vises når du klikker på spørsmålstegnet:

Etter du har kopiert ønsket variabel, er variabelen klar for å brukes i Word-malen.
Typer av valg i informasjonsboksen (String, Number, File og Date)
Når du klikker på et spørsmålstegn som åpner formateringsvalg, får du mulighet til å velge hvordan variabelens verdi skal behandles og vises i dokumentet.
Hvilke valg som vises, avhenger av hvilken type data variabelen representerer. Disse valgene er vanligvis knyttet til én av følgende typer:
String
Brukes for tekstverdier som kan formateres eller tilpasses før visning.
Eksempler på valg:
Store bokstaver (
uppercase) Viser teksten i versaler{billing.order.reference | uppercase}Små bokstaver (
lowercase) Viser teksten i små bokstaver{billing.order.reference | lowercase}Forkorting (
truncate) Forkorter teksten til ønsket lengde{billing.order.reference | truncate:10}
Number
Brukes for tallverdier som kan beregnes og formateres.
Eksempler på valg:
Formatere som valuta (
currency) Viser tallet som valuta{billing.billingLines.total.sum | currency}Formatere som Dibbel-valuta (
dibbel_currency) Tar utgangspunkt i at verdien er lagret i øre og viser korrekt valutabeløp. Denne formateringen bør brukes for alle pengebeløp som hentes direkte fra Dibbel.{billing.billingLines.total.sum | dibbel_currency}Avrunding (
round) Avrunder tallet til et bestemt antall desimaler{billing.billingLines.total.sum | round:2}
File
Brukes for filer, typisk bilder som skal vises i dokumentet.
Eksempler på valg:
Sett størrelse (
size) Angir fast størrelse på bildet{photo | size:100x200}Maks størrelse (
maxSize) Angir maksimal størrelse{photo | maxSize:300x400}
Date
Brukes for datofelt, som forfallsdato, gyldighetsdato eller opprettelsesdato.
Datovariabler kan formateres for å styre hvordan dato og eventuelt klokkeslett vises i dokumentet.
Eksempler på valg:
Formatere dato (
format) Viser dato i ønsket format{billing.dueAt | format:'dd.MM.yyyy'}Formatere dato med tid (
format) Viser dato og klokkeslett{billing.dueAt | format:'dd.MM.yyyy – kk:mm:ss'}
Se https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table for mer info om datoformatering
Sist oppdatert

