Referenstaggar¶
På flera ställen i DF RESPONS, till exempel dokumentmallar, kommunikationsfältet och e-postmallar, kan du använda så kallad referenstaggar. Referenstaggar gör det möjligt att visa dynamiskt innehåll från olika källor, såsom ärendedata, användarinformation, datum- och tidsvärden samt system- och ärendeegenskaper. Genom att använda referenstaggar kan du säkerställa att dina mallar och texter är korrekta och automatiskt återspeglar den senaste informationen.
Alla referenstaggar finns tillgängliga i systemet på de ställen där de kan användas, det visas genom en knapp där det står Visa hjälp för mallar eller en symbol i form av ett frågetecken.
Olika typer av referenstaggar¶
När man öppnar hjälpen för mallar så är den uppdelad i olika avsnitt.
För att se referenstaggarna under ett visst avsnitt klickar du på den raden. Som standard är avsnittet Fält utfällt då det är den vanligast använda.
| Avsnitt | Visar taggar för: |
|---|---|
| Fält | Alla fält som finns i modulen. |
| Ärende | Ärendegenskaper. |
| Handling | Handlingar. |
| Ärendetyp | Information om ärendetypen/modulen. |
| Meddelande/kommentar | Information om meddelande om kommentarer. |
| Tid | Aktuellt datum och tid. |
| Användare | Inloggad användare. |
| System | Systemegenskaper. |
| Tips & Tricks | Villkor och modifikatorer för taggar. |
| NOS | NOS-del Resultat: Kommunikationsfält – Vidarebefordra händelser (SYS). |
Referenstagg för fält i handlingar¶
För vissa fälttyper finns det många olika taggar att använda för att visa värden från fältet. Vissa av dessa taggar är bättre lämpade än andra att använda när man ska skapa en handling där fälten ingår.
Rekommenderade referenstaggar
| Fält/egenskap | Referenstagg: |
|---|---|
| Anteckningsfältet | ##FIELD_123_NOTE_SIMPLE_LIST##. Visar anteckningar med ev. rubriker. |
| Fillista | ##FIELD_123_LIST_SIMPLE. Visar alla uppladdade filer (titel, filnamn och filstorlek) i textform, där varje fil separeras med semikolon. |
| Användarfält | ##FIELD_123_NAME##. Visar användarens namn. |
| Registreringsdatum | ##MATTER_CREATED_AT_SHORT##. Visar datum i siffror då ärendet skapades i svenskt format. T.ex. 2025-10-09 |
Villkor och evaluering¶
Villkorsstyrd text gör det möjligt att skapa dynamiska mallar som anpassar innehållet beroende på data i systemet. Detta är särskilt användbart för:
-
Personalisering: Visa olika meddelanden beroende på status eller värde. T.ex. infotext som visas på "Tack-sidan" när ett ärende registrerats externt.
-
Effektivitet: Slipp skapa flera separata mallar – använd ett enda dokument med villkor.
-
Flexibilitet: Anpassa kommunikationen för olika scenarier (t.ex. avslutade ärenden, specifika fältvärden).
Boolesk evaluering¶
En boolesk evaluering innebär att taggens värde tolkas som sant eller falskt (true/false). Det kan användas när taggen representerar en status eller ett tillstånd (t.ex. om något är aktivt, avslutat, godkänt).
Syntax¶
##If--{TAG}##
Text som visas om taggens värde är sant.
##Else--{TAG}##
Text som visas om taggens värde är falskt.
##EndIf--{TAG}##
Exempel¶
Om ett ärende är avslutat ska en särskild text visas för användaren.
##If--MATTER_IS_CLOSED##
Denna text visas endast om ärendet är avslutat.
##Else--MATTER_IS_CLOSED##
Denna text visas endast om ärendet inte är avslutat.
##EndIf--MATTER_IS_CLOSED##
Jämförelse mot värde¶
Används när du behöver kontrollera om ett fält har ett specifikt värde (t.ex. ett alternativ är valt, ett namn eller en kategori).
Syntax¶
##If--{TAG}='VALUE'##
Text som visas om taggens strängrepresentation matchar värdet.
##Else--{TAG}='VALUE'##
Text som visas om ovanstående inte är sant.
##EndIf--{TAG}='VALUE'##
Exempel¶
Om alternativ 1 är valt på ett flervalsfält ska en viss text visas för användaren. Så villkoret nedan hänvisar till alternativ med id 1 på fält med id 100 är markerat, dvs. har värde '1' vlket innebär att det är markerat.
##If--FIELD_100_1='1'##
Denna text visas endast om alternativ 1 är valt på fältet.
##EndIf--FIELD_100_1='1'##
Modifikatorer¶
Modifikatorer kan användas i kombination med referenstaggarna och låter dig justera hur ett värde visas. Du kan till exempel:
-
Ändra textformat - göra texten till versaler eller gemener.
-
Ta bort HTML – rensa bort HTML-taggar.
-
Formatera tal eller datum – visa siffror eller datum i önskat format.
Du kan kombinera flera modifikatorer i samma uttryck.
Exempel:
##FIELD_123:STRIPHTML:REMOVEFROMEND(5)## = Först tas alla HTML-taggar bort, sedan tas de fem sista tecknen bort.
| Modifikator | Beskrivning |
|---|---|
| ##FIELD_X:DEFAULT(standardvärde)## | Infogar standardvärde om fältet är tomt. |
| ##FIELD_X:REPLACE(x, y)## | Ersätter text x med y. |
| ##FIELD_X:HASVALUE## | Visar true om fältet har värde, false om det inte finns. Kan användas i kombination med villkorstaggar. |
| ##FIELD_X:CONTAINS(x)## | Visar true om värdet innehåller x. |
| ##FIELD_X:CONTAINS(x, CI)## | Visar true om värdet innehåller x och ignorerar versaler/gemener. |
| ##FIELD_X:UPPER## | Gör alla tecken till versaler. |
| ##FIELD_X:LOWER## | Gör alla tecken till gemener. |
| ##FIELD_X:TRIM## | Tar bort blanksteg i början och slutet av värdet. |
| ##FIELD_X:TRIMSTART## | Tar bort blanksteg i början av värdet. |
| ##FIELD_X:TRIMEND## | Tar bort blanksteg i slutet av värdet. |
| ##FIELD_X:GETLINES(x)## | Visar X rader av värdet. |
| ##FIELD_X:REMOVELINES(x)## | Tar bort X antal rader från början av värdet. |
| ##FIELD_X:REMOVEFROMSTART(x)## | Tar bort x antal tecken från början av värdet. |
| ##FIELD_X:REMOVEFROMEND(x)## | Tar bort x antal tecken från slutet av värdet. |
| ##FIELD_X:REMOVEALLFROM(x)## Tar bort allt innehåll fram till första förekomsten av värde X. | |
| ##FIELD_X:REMOVEALLBETWEEN(x)## | Tar bort allt innehåll från första förekomsten av värde X fram till andra förekomsten av värde X. |
| ##FIELD_X:SUBSTR(start, längd)## | Hämtar del av text beräknat på antal tecken, t.ex. ##MESSAGE:SUBSTR(0, 10)## hämtar 10 tecken från det första tecknet. |
| ##FIELD_X:NL2BR## | Ersätter radbryt med <br />. Används om text från ett textfält ska visas i utskriftsmall. |
| ##FIELD_X:BR2NL## | Ersätter med radbrytning. |
| ##FIELD_X:STRIPTHML## | Tar bort alla HTML-taggar. |
| ##FIELD_X:SHA256## | Omvandlar värdet till en unik längd tecken (en så kallad hash), värdet går inte att ändra tillbaka. |
| ##FIELD_X:URLENCODE## | Gör texten säker att använda i en webbadress (URL) genom att ersätta specialtecken med kodade versioner. |
| ##FIELD_X:HTMLENCODE## | Gör texten säker att visa i HTML genom att ersätta vissa tecken med kodade version. |
| ##FIELD_X:BASE64ENCODE## | Omvandlar text till ett Base64-format, vilket är ett sätt att representera data med tecken som är säkra att använda i olika system. Använder teckenstandard UTF8. |
| ##FIELD_X:BASE64DECODE## | Avkodar Base64-text tillbaka till originaltexten. Använder teckenstandard UTF8. Om avkodningen misslyckas returneras det kodade värdet oförändrat. |
Formatera nummer¶
| Modifikator | Beskrivning |
|---|---|
| ##FIELD_123:FORMATNUMBER(HASH)## | Formaterar ett nummer. Formatet är likt Excels formatmallar. |
| ##FIELD_123:FORMATNUMBER(HASH, sv-SE)## | Första parametern är formatet. Eftersom många tecken är reserverade behöver de skrivas med godkända specialtaggar. # blir HASH . blir DOT , blir DECIMAL. |
| ##FIELD_123:FORMATNUMBER(HASH, sv-SE, COMMA, DOT)## | Exempel: ##FIELD_123:FORMATNUMBER( **HASH****COMMA****HASH****HASH**0**DOT**00)## med värde 12345678 blir resultatet 12,345,678.00. |
Operatorer¶
Operatorer används för att utföra beräkningar i uttryck.
Tänk på att
Om flera operatorer används i samma uttryck sker beräkningen från vänster till höger, oavsett vilken operator det är.
Syntax¶
Ett uttryck byggs upp med operander (värden eller taggar) och operatorer (t.ex. +, -, x, /).
Exempel: ##OPERAND1|+|OPERAND2|+|OPERANDi##
Addition¶
Adderar två eller flera värden:
##OPERAND1|+|OPERAND2|+|OPERANDi##
OPERANDx kan vara:
- Ett numeriskt värde (t.ex. 10)
- En tagg som returnerar ett numeriskt värde (t.ex. FIELD_11_N)
Om ett eller flera värden inte är numeriska sammanfogas de till en sträng. Exempel: Hello+World = HelloWorld
Addition med datum¶
Här adderas ett datum med ett tidsintervall.
##OPERAND1[date]|+|OPERAND2[-days]##
Tidsenheter anges med ett minustecken inom hakparenteser, t.ex. [-days].
Subtraktion¶
Subtraherar två eller flera värden:
##OPERAND1|-|OPERAND2|-|OPERANDi##
Subtraktion med datum:¶
Här subtraheras ett datum med ett tidsintervall.
##OPERAND1[date]|-|OPERAND2[-hours]##
Multiplikation¶
Multiplicerar två eller flera värden:
##OPERAND1|x|OPERAND2|x|OPERANDi##
Division¶
Dividerar två eller flera värden:
##OPERAND1|/|OPERAND2|/|OPERANDi##
Datatyper¶
Du kan ange typ för en operand med hakparenteser:
- Sträng: [s], [str], [string]
- Boolesk: [b], [bool]
- Heltal: [i], [int]
- Stort heltal: [l], [long]
- Decimal: [f], [float], [d], [double]
- Exakt decimal (t.ex. valuta): [m], [dec], [decimal]
- Datum: [dt], [date], [datetime]
Om typ inte anges antas ett numeriskt värde.
Ytterligare argument kan anges med formatet: [typ-arg1,arg2,argi]
Tidsenheter för datum¶
Vid beräkning med datum kan följande enheter användas:
- years
- months
- days
- hours
- minutes
- seconds
Exempel: ##DATE_FIELD[dt]|+|1[-days]##
Tips för felsökning¶
-
Kontrollera att alla hakparenteser är korrekt placerade.
-
Använd alltid citattecken runt strängvärden.
-
Om beräkningen ger oväntat resultat, kontrollera datatypen för varje operand.