# Variabelliste: underkategorier og spørsmålstegn

### **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:

1. **En forklaring av hva variabelen består av:** 

   Variabelen er en gruppering (et objekt) med flere underfelter
2. **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:

<details>

<summary>Spørsmålstegn som viser underkategorier i variabellisten (gruppering)</summary>

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.&#x20;

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2F6jNk4lRPd6PWf1vhXJ4e%2Fimage.png?alt=media&#x26;token=929e2706-7793-4b05-902e-72356fcec2ee" alt="" width="375"><figcaption></figcaption></figure></div>

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[^1] for å hente ut spesifikke verdier fra gruppen, for eksempel kundenavn, organisasjonsnummer eller adresseinformasjon.

* #### **Velge underkategorier direkte fra listen**

Når du klikker på selve Kunde-variabelen i listen, åpnes en oversikt over tilgjengelige underkategorier:

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2F4YmT0PnRrQsIJOladE4C%2Fimage.png?alt=media&#x26;token=ba3dc8d3-1fc1-4708-95ac-6c46dea6867a" alt="" width="313"><figcaption></figcaption></figure></div>

Disse variablene kan kopieres direkte og brukes i Word-malen uten ytterligere valg.<br>

* #### **Flere nivåer med gruppering**

Noen underkategorier kan selv være grupperinger.\
I kunde-eksempelet gjelder dette for adresse:

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2FjTFhfb32mHPEqA7DoyYO%2Fimage.png?alt=media&#x26;token=e057f341-f551-4bcb-ae4d-23316eed9540" alt="" width="315"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2FOiQFexzdeYcsrxtbOqQ1%2Fimage.png?alt=media&#x26;token=966e30e3-ca82-48c5-a263-970b573b0efb" alt="" width="339"><figcaption></figcaption></figure></div>

Disse fungerer på samme måte som de andre nevnte variablene og kan kopieres direkte og brukes i Word-malen.

</details>

<details>

<summary>Spørsmålstegn som åpner valg (String, Number, File, Date)</summary>

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.

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2F0n7gLYy6Qe0LkaWeaY3v%2Fimage.png?alt=media&#x26;token=641897ca-bc98-4ead-8a88-16ad16d0990f" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://3216209513-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6aWzMnk8Uk6WDJJWUE46%2Fuploads%2FkT1FPMrNjy7IV8AakLvV%2Fimage.png?alt=media&#x26;token=f9286342-5ce9-47b7-b182-c8b958a9fb2c" alt="" width="316"><figcaption></figcaption></figure></div>

Etter du har kopiert ønsket variabel, er variabelen klar for å brukes i Word-malen.&#x20;

</details>

***

### **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:

<details>

<summary><strong>String</strong></summary>

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}`

</details>

<details>

<summary>Number</summary>

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}`

</details>

<details>

<summary><strong>File</strong></summary>

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}`

</details>

<details>

<summary><strong>Date</strong></summary>

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<br>

</details>

[^1]: Betyr at du velger et bestemt felt i en variabel ved å bruke punktum&#x20;

    eks: {billing.customer.companyName}