Denne vejledning beskriver, hvordan du udarbejder og afleverer en brevskabelon, der kan sendes til borgere via Sundhedsdatastyrelsens Digital Post Adapter (DPA). PDF-skabeloner publiceres i Digital Post Komponent (DPK).
Indholdsfortegnelse
Ved anvendelse af Digital Post Adapter (DPA) Digital Post Adapter (DPA) - Leverancebeskrivelse til afsendelse af breve til borgere, skal der være udarbejdet brevskabeloner, der kan leveres enten digitalt eller fysisk via Strålfors. Da borgere i Danmark har ret til at fravælge Digital Post, skal der derfor foreligge to separate brevskabeloner – én til hver leveringsform. Skabelonerne publiceres på Digital Post Komponent (DPK), som også omtales som Digital Post Serviceprovider. Denne komponent leveres af Trifork.
I forbindelse med afsendelse af et nyt digitalt brev til en borger som led i et projekt eller via en komponent, er der en række opgaver omkring brevets udformning. Opgaverne følger denne ansvarsfordeling.
Ansvarsfordeling:
Ved udformning af brevet, er der flere forhold, der skal afklares, før det endelige brev kan leveres i PDF-format.
Afsender og papirlinje
Skrifttyper
Der er begrænsninger på, hvilke skrifttyper der som udgangspunkt kan benyttes.
iText-biblioteket, som benyttes til at generere PDF-filer, leveres med et foruddefineret sæt skrifttyper. Følgende skrifttyper er inkluderet i iText:
Der er blevet tilføjet to yderligere skrifttyper for at understøtte de skrifttyper:
Brug af skrifttyper, som ikke er nævnt ovenfor, kræver ekstra konfiguration i forhold til skabeloner, sammenlignet med brug af skrifttyper, der allerede er registreret. Dette vil afspejle sig i det antal timer, der bruges på at konfigurere nye skabeloner.
Kilde: godkendte skrifttyper hos Trifork Fonts
Særligt krav til fysiske breve
For fysiske breve gælder, at hvis der er indsat links, skal de linkede sider vedlægges brevet og sendes til borgere, der har fravalgt Digital Post. Da dette kan medføre et stort antal ekstra sider, bør brugen af links undgås, hvis det er muligt.
Digital Post anvender Strålfors til at producere de fysiske breve. For at brevets forside passer med adressefeltet i en kuvert etc er der flere krav til brevformatet. For at verificere skabelonens layout, kan PDF-filer uploades til Connect Brevtester (https://brevtest.sconnect.dk/). Eksempelvis er det vigtigt at holde det øverste venstre hjørne af på forsiden af et fysisk brev fri for tekst, da denne tekst ellers ikke vil fremgå af det fysiske brev ved udskrivning. Se illustrationen nedenfor.
Brevskabelonen vil indeholde enten få eller mange variable felter - altså parametre som tilpasses det enkelte brev så som navn, dato, cpr, adresse eller andet indholdsmæssigt.
Er der behov for mange dynamiske felter, er det en god ide at udarbejde et særligt dokument med en tabel indeholdende alle felter, så det sikres, at alle felter udfyldes korrekt i skabelonen.
En beskrivelse af (generiske) valgfrie værdier:
dato: Dette vil tilsidesætte den dato, der er angivet øverst til venstre i brevet. Hvis der ikke angives nogen dato, anvender PDF-tjenesten den aktuelle dato på tidspunktet for PDF-genereringen.
Eksempel:
{ModtagerNavn} – string
{CPR} – format: ddMMyy-xxxx
{dato} – format: dd. mmm yyyy
{Fritekst} – multiline, max 5 linjer
|
Eksempel:
{code}
{ModtagerNavn} – string
{CPR} – format: ddMMyy-xxxx
{dato} – format: dd. mmm yyyy
{Fritekst} – multiline, max 5 linjer
{code}
Udkast til skabelon-dokumenter overdrages til Trifork:
{code}
pdf.nspop.dk/PROJEKT/ÅÅÅÅMMDD/digital|physical/BREVTYPE
{code}
Eksempler:
Graviditet: _pdf.nspop.dk/GM2/20250909/digital/SvangreStart/_
Fravalg: _pdf.nspop.dk/fgvhr/20241001/digital/BekraeftelseRegistreringFravalg/_
En skabelon er unikt identificeret af en strengidentifikator, som bruges i HTTP POST-anmodninger til at angive de nøjagtige skabeloner for fysiske og digitale breve, angivet med nøglerne template_digital og template_physical.
Nøglen template_digital må ikke være tom, mens template_physical kan udelades, hvis fysisk post ikke ønskes.
Når skabelonen er klar i DPK og beskrevet her: https://github.com/trifork/dpk-docs/wiki/Templates, så skal DPA konfigureres til at kunne kalde den.
Projektet sørger for at bestille hos NSP Support, at de nye skabeloner konfigureres i DPA og orienterer NSP PO.
Skabelonerne Følgende oplysninger skal angives:
+------------------------------------------------+----------------+------------------------------------------------+
| persistent_unique_key | it_system_name | template_id |
+------------------------------------------------+----------------+------------------------------------------------+
| systemcertifikat | DRG | fgvhr/20241218/BekraeftelseRegistreringFravalg |
+------------------------------------------------+----------------+------------------------------------------------+
Det er muligt at opdatere en eksisterende skabelon (udover at oprette en ny, med en ny identifikator). Det kan tage op til 30 minutter, før den opdaterede version kan anvendes.
Skabelon-eksempler til Digital Post