Brevmaler — rediger og forhåndsvis¶
Brevmal-administrasjonen (Innstillinger → Masterordre → Brevmaler,
/settings/portal-setting/masterorder-letter-templates) er redigeringsflaten for de lagrede
brevmalene som brukes når systemet sender tilbud, purringer og ordreforslag.
Hver mal har en emnetekst og en brødtekst med flettefelt, og det finnes én aktiv mal per
brevtype. Brødteksten redigeres i en rik tekst-editor og sendes som HTML — se avsnittet
«Formatering i brødteksten» under.
Denne siden dekker også Dokumentmaler (Innstillinger → Masterordre → Dokumentmaler,
/settings/portal-setting/masterorder-document-templates) — se avsnittet «Dokumentmaler» lenger
ned på denne siden. De to sidene styrer beslektet, men separat innhold: brevmaler er
e-postteksten som sendes, dokumentmaler er PDF-dokumentene (tilbuds-forside, ordreforslag m.m.) som
kan legges ved.
Tilgang¶
| Rettighet | Gir | Datatilgang (ObjectType) |
|---|---|---|
| Se maler + forhåndsvise | Åpne siden, lese malene, kjøre forhåndsvisning | Subscription.LetterTemplate — Se |
| Opprette / endre / aktivere | Ny mal, lagre endringer, sette en mal aktiv | Subscription.LetterTemplate — Endre |
Tilgangen styres i Innstillinger → Datatilgang på objekttypen «Brevmaler (abonnement)». Siden er fail-closed: uten lesetilgang vises en forklaring i stedet for innhold, og selve API-et håndhever den samme tilgangen på hvert kall.
Brevtyper¶
- Proposal — ordreforslag.
- SingleOffer — første utsending av et tilbud.
- Reminder — purring på et utsendt tilbud.
- SupportLetter — ordreforslag.
Brevtypen settes når malen opprettes og kan ikke endres etterpå. En mal tilhører alltid én fast brevtype.
Slik gjør du¶
- Velg en mal i listen til venstre, eller klikk Ny mal og velg brevtype for å starte en ny. Listen kan filtreres på brevtype, og den aktive malen for hver type vises med et grønt «Aktiv»-merke.
- Rediger Navn, Emne og Brødtekst. Brødteksten redigeres i en rik tekst-editor (overskrifter, fet, kursiv, understreking, punkt- og nummerlister, samt tabeller og innebygde stiler — se «Formatering i brødteksten» under).
- Sett inn flettefelt ved å plassere markøren der feltet skal stå og velge det fra
Flettefelt-menyen i verktøylinjen over brødteksten. Feltene er gruppert (Kunde, Tilbud,
Levering, Sum) og settes inn nøyaktig der markøren står. For Emne-feltet — som ikke har
rik tekst — velges flettefelt fra en tilsvarende gruppert nedtrekksliste ved siden av feltet.
Et flettefelt settes inn som
{{Felt}}(dobbel krøllparentes), for eksempel{{OfferNo}}eller{{CustomerName}}. - Klikk Forhåndsvis for å se emne og brødtekst gjengitt med eksempeldata. Oppgi eventuelt et tilbudsnummer for å gjengi mot et ekte tilbud i stedet for eksempeldata.
- Klikk Lagre. Lagre-knappen er utilgjengelig til navn, emne og brødtekst er fylt ut.
- For en lagret mal som ikke er aktiv: klikk Sett aktiv for å gjøre den til den aktive malen for sin brevtype (de andre malene av samme type blir da inaktive).
Flettefelt¶
Flettefelt er plassholdere som fylles med data når brevet gjengis. Katalogen omfatter blant annet
OfferNo, CustomerName, CustomerNo, AcceptLink, ExpiresAt, ProposedDeliveryDate,
MasterOrderNo, VesselName, ManagementName, OrderLines, TotalAmount, Currency og
leveringsadressefeltene (DeliveryName, DeliveryAddressLine1 med flere). I Flettefelt-menyen
er de gruppert som Kunde, Tilbud, Levering og Sum.
Forhåndsvisningen validerer teksten mot katalogen:
- Ukjente flettefelt (rødt) — en plassholder som ikke finnes i katalogen. Dette blokkerer lagring og må rettes.
- Tomme flettefelt (gult) — et kjent felt som ikke har verdi for det valgte tilbudet (eller eksempelkonteksten). Dette er kun en advarsel; brevet kan lagres.
Formatering i brødteksten¶
Brødteksten redigeres i en rik tekst-editor og lagres som HTML, og sendes med
IsBodyHtml = true — mottakeren ser altså den formaterte teksten i sin e-postklient, ikke rå HTML.
Verktøylinjen støtter overskrifter, fet, kursiv, understreking og punkt-/nummerlister.
Brevmal-editoren tillater i tillegg tabeller og innebygde stiler (den er mer permissiv enn
dokumentmal-editoren beskrevet under, siden et brev er e-post og ikke skal gjennom PDF-rendring).
Eldre maler og formatering av linjeskift: en del eksisterende brevmaler ble opprinnelig lagret
som ren tekst med vanlige linjeskift, mens systemet alltid har sendt brev som HTML — linjeskiftene
har derfor kollapset til én sammenhengende avsnitt hos mottakeren. Første gang en slik mal åpnes i
editoren, konverteres den automatisk: doble linjeskift blir til avsnitt og enkle linjeskift blir til
linjeskift i teksten (<br>), slik at forhåndsvisningen igjen viser malen slik den var tenkt. En mal
som allerede inneholder HTML-markup røres ikke. Konverteringen skjer kun i redigeringsvinduet — den
lagrede malen endres ikke før du selv klikker Lagre, og deretter er den nye HTML-versjonen det
som brukes videre.
Vanlige problemer¶
| Problem | Årsak | Løsning |
|---|---|---|
| «Sett aktiv» vises ikke | Malen er allerede aktiv, eller er ikke lagret ennå | Lagre malen først; en aktiv mal har ikke knappen |
| Lagring feiler med ukjente flettefelt | Brødteksten inneholder en plassholder utenfor katalogen | Rett eller fjern plassholderen (se rødt varsel i forhåndsvisningen) |
| Forhåndsvisning bruker eksempeldata selv med tilbudsnummer | Tilbudet ble ikke funnet | Kontroller tilbudsnummeret; et grått varsel bekrefter at eksempeldata ble brukt |
| En gammel mal vises som ett sammenhengende avsnitt | Malen er ikke åpnet i den nye editoren ennå, eller er ikke lagret på nytt etter formateringen ble innført | Åpne malen, kontroller at avsnittene ser riktige ut i forhåndsvisningen, og lagre — konverteringen skjer automatisk ved åpning, men trer i kraft først når malen lagres på nytt |
Dokumentmaler — rik tekst, skriftstørrelse og logo¶
Det finnes ennå ingen egen håndbokside for dokumentmal-komponisten. Innholdet er lagt her fordi siden er nært beslektet med brevmaler (begge er innhold som gjengis mot et tilbud), og fordi Innstillinger-menyen plasserer dem rett under hverandre. Flytt til en egen side når komponisten får nok innhold til å stå alene.
Dokumentmal-administrasjonen (Innstillinger → Masterordre → Dokumentmaler,
/settings/portal-setting/masterorder-document-templates) er redigeringsflaten for de
PDF-dokumentene systemet kan generere og sende med tilbud og masterordrer — for eksempel
tilbuds-forsiden, en masterordre-oversikt eller et ordreforslag-vedlegg. En mal settes sammen av
navngitte seksjoner i valgt rekkefølge, og forhåndsvisningen bruker den samme
server-rendringen (QuestPDF) som produksjon, slik at det du ser i forhåndsvisningen er nøyaktig
det som blir generert.
Tilgang¶
| Rettighet | Gir | Datatilgang (ObjectType) |
|---|---|---|
| Se maler + forhåndsvise / validere | Åpne siden, lese malene, kjøre forhåndsvisning | Subscription.DocumentTemplate — Se |
| Opprette ny mal / kopiere | Ny mal, kopiere en eksisterende mal | Subscription.DocumentTemplate — Opprette |
| Endre / aktivere | Lagre endringer, sette en mal aktiv | Subscription.DocumentTemplate — Endre |
Det finnes ingen slette-funksjon for dokumentmaler — rader kan kun redigeres, kopieres og aktiveres/deaktiveres, tilsvarende brevmaler.
Dokumenttyper og seksjoner¶
Hver mal tilhører én av dokumenttypene Tilbud, Masterordre eller Ordreforslag, og består av en ordnet liste seksjoner:
- Toppfelt — dokumenttittel, logo og firmablokk (se «Dokumenttittel» og «Logo i dokumenter» under).
- Nøkkel/verdi-boks — en rute med korte etikett/verdi-par (f.eks. tilbudsnr., dato).
- Fritekst — fri, formatert tekst (se «Rik tekst i seksjonene» under).
- Linjetabell — tilbuds- eller ordrelinjene som en tabell.
- Infoboks — en fremhevet tekstboks, med samme rike tekst-støtte som Fritekst.
- Sum — totalsum-oppsummering.
- Bunntekst — gjentas nederst på hver side (se «Bunntekst» under).
Et eget stilpanel styrer språk (norsk/engelsk), tetthet (kompakt/normal/romslig), topptekststil og aksentfarge — aksentfargen brukes blant annet på H1/H2-overskrifter, se under.
Rik tekst i seksjonene¶
Fritekst- og Infoboks-seksjoner redigeres i en TinyMCE-editor med overskrifter (H1–H6), fet, kursiv, understreking og punkt-/nummerlister. I motsetning til brevmal-editoren er denne bevisst begrenset til nøyaktig det elementsettet PDF-rendringen forstår — HTML utenfor dette settet (f.eks. tabeller, innebygde stiler) blir fjernet når seksjonen åpnes i editoren, fordi PDF-motoren ellers ville ha forkastet det stille ved generering uansett.
Overskriftene skaleres relativt til seksjonens skriftstørrelse: H1 og H2 er de mest fremtredende (og bruker i tillegg malens aksentfarge), mens H5 og H6 bevisst ikke er større enn brødteksten — de fungerer som semantiske løpende etiketter, ikke visuelt store overskrifter. Nummererte og punktlister kan nøstes; hvert nivå gir ett innrykkstrinn, opp til 4 nivåer dypt.
Hver Fritekst- og Infoboks-seksjon har i tillegg et eget skriftstørrelse-valg (7–18 pt), med et eget alternativ «Arv fra mal» som betyr at seksjonen følger malens generelle skriftstørrelse i stedet for en fast verdi.
Flettefelt¶
Flettefelt settes inn fra Flettefelt-menyen i verktøylinjen, gruppert som Firma, Kunde, Levering, Tilbud, Sum, Masterordre og Andre (felt som ikke sorterer naturlig under de øvrige gruppene). Feltet settes inn nøyaktig der markøren står i teksten.
Språk og dokumenttype¶
Språk kan endres på en eksisterende mal. Det kan bare finnes én aktiv mal per dokumenttype og språk — flytter du en aktiv mal til et språk som allerede har en aktiv mal av samme dokumenttype, avvises lagringen med en melding om at du må deaktivere den andre først eller velge et annet språk. En mal som ikke er aktiv kan alltid flyttes.
Dokumenttype er låst etter opprettelse: seksjonenes felt- og kolonnevalg er validert mot dokumenttypens flettefelt-katalog, så et bytte ville gjort dem ugyldige. Trenger du samme oppsett for en annen dokumenttype, bruk Kopier og velg type på kopien.
Dokumenttittel¶
Toppfelt-seksjonen har feltet Dokumenttittel og valget Tittelplassering.
| Felt | Betydning |
|---|---|
| Dokumenttittel | Overskriften øverst i dokumentet. Kan inneholde flettefelt, f.eks. Ordrebekreftelse {{MasterOrderNo}}. Bruk «Flettefelt»-knappen ved siden av feltet for å sette inn et felt — det legges til på slutten av teksten, og du flytter det dit du vil. |
| Tittelplassering | Venstre (standard) eller Høyre. Uavhengig av logoplasseringen, så en logo til venstre med tittel til høyre er en gyldig kombinasjon. |
Lar du feltet stå tomt, brukes standardtittelen for dokumenttypen — «Tilbud», «Masterordre» eller «Ordreforslag». Samme standardtittel brukes både i forhåndsvisningen i editoren og i det ferdig genererte dokumentet.
Bunntekst¶
Bunntekst-seksjonen gjentas nederst på hver side i det genererte dokumentet. En mal kan ha én bunntekst, og den ligger alltid nederst i seksjonslisten — plasseringen påvirker ikke resultatet, siden bunnteksten uansett rendres som sidefot.
| Felt | Betydning |
|---|---|
| Oppsett | Én kolonne (full bredde, venstrejustert) eller Tre kolonner (venstre, midtstilt, høyre). Bytter du fra tre til én, beholdes kolonne 1 og de to andre forkastes. |
| Kolonneinnhold | Rik tekst, samme editor som Fritekst — fet, kursiv, understreking og lister. Flettefelt kan brukes. |
| Logo | Hvilken kolonne som viser virksomhetens logo over teksten sin, eller «Ingen logo». |
| Høyde (pt) | Logohøyde, 12–48 pt. Vises kun når en logokolonne er valgt. |
| Skriftstørrelse | Egen størrelse for bunnteksten, eller «Arv fra mal» (dokumentets grunnstørrelse minus én). |
Sidetall settes inn som flettefeltene {{PageNumber}} (gjeldende side) og {{TotalPages}}
(antall sider) — bruk Sidetall-knappen under kolonnen. De to feltene virker kun i
bunnteksten; brukes de i en Fritekst- eller Infoboks-seksjon, avvises malen ved lagring, fordi
sidetallet først er kjent når siden settes opp.
Sidetallet er ikke lenger automatisk
Tidligere fikk alle genererte dokumenter et sentrert «1 / 1» nederst. Nå styres det av malen.
En mal uten bunntekst får ingen sidetall — det gjelder også standardmalene og maler som
allerede er lagret. Legg til en bunntekst med {{PageNumber}} / {{TotalPages}} for å få
sidetallet tilbake.
Logo i dokumenter¶
Toppfelt-seksjonen har et valg for logoplassering: Venstre, Høyre eller Ingen logo. Når en plassering (ikke «Ingen logo») er valgt, henter systemet virksomhetens logo — samme logo som vises i andre PDF-rapporter i systemet (f.eks. bankavstemming) — og setter den inn i både forhåndsvisningen og den genererte PDF-en.
Logoen krever at innstillingen Offentlig base-URL (Subscription.PublicBaseUrl, se
Pipeline-konfigurasjon) er satt for kunden, fordi dokumentmotoren
kjører på serveren og må hente logobildet over HTTP i stedet for å lese den lokale UI-filen
direkte. Er innstillingen tom, genereres dokumentet som før — helt uten logo og uten noen
feilmelding. Det samme gjelder hvis logoen ikke lar seg hente (f.eks. feil URL eller nettverksfeil):
dokumentet genereres likevel, bare uten logo.
Vanlige problemer (dokumentmaler)¶
| Problem | Årsak | Løsning |
|---|---|---|
| Formatering forsvinner når en seksjon åpnes på nytt | Den lagrede teksten inneholder HTML utenfor det editoren/PDF-motoren støtter (f.eks. fra en eldre mal eller innliming fra et annet program) | Bygg formateringen på nytt med verktøylinjens knapper i stedet for å lime inn ferdig HTML |
| Logoen vises ikke i dokumentet | «Offentlig base-URL» er ikke satt, eller Toppfelt-seksjonens logoplassering står på «Ingen logo» | Sett Subscription.PublicBaseUrl under Pipeline-konfigurasjon, og velg Venstre/Høyre-plassering i Toppfelt-seksjonen |
| Overskrifter ser like store ut som brødteksten | H5/H6 er valgt — disse er bevisst ikke forstørret, de er tenkt som løpende etiketter | Bruk H1–H4 hvis en tydelig visuell overskrift er ønsket |