Sidst opdateret: 06-06-2023
Denne guide beskriver hvordan Cicero tilsluttes til "Næste generation Digital Post" (NgDP) samt hvilke ændringer der skal foretages i Cicero efterfølgende.
- Cicero skal være sat op som afsendersystem i NgDP. Dette skal gøres inden næste skridt.
- I Cicero LMS skal NgDP være opsat i F7->Serveropsætning.
- Skabelon til saldoopgørelse (samt evt. andre notifikationer, der anvender Digital Post) skal være tilrettede, så de overholder den nye validering.
Nedenstående tekst forklarer, hvordan dette gøres.
1. Opsætning af Cicero som afsendersystem i NgDP
Inden I kan sætte Cicero op i NgDP skal jeres kommune/institution have lavet den grundlæggende opsætning i NgDP's administrative system. Dernæst følges nedenstående instruktion.
Hvis der er spørgsmål til NgDP's brugergrænseflade henvises til den officielle dokumentation.
Start i https://admin.digitalpost.dk/
Foretag login
Fra oversigten vælges "Systemtilslutning"
1. System
Klik på "Opret system". "Gå videre" og vælg "Opsæt systemet fra bunden".
Udfyld med navn på system og evt. leverandør, og marker systemet som "Afsendersystem".
Klik "Næste".
2. Tilslutning
Her vælges "REST PUSH". Udfyld med IP adresse(r) og URL for dit Cicero-miljø (FBS eller CIC), samt Systematics CVR nummer, som er 78834412.
IP-adresse for KOMBIT kunder: 87.49.228.101
URL for KOMBIT kunder: https://cicero-fbs.com/rest/digitalpost/memo/receipt/v1
IP-adresse for andre kunder: 87.49.230.130
URL for andre kunder: https://cicero-lms.com/rest/digitalpost/memo/receipt/v1
Husk at klikke på "Tilføj" ved IP adresse for at tilføje den til listen, så det ser ud som herunder.
De sidste to felter i formularen - "Vælg et ældre kvitteringsformat (Valgfrit)" og "StandardmaterialeID (Valgfrit)" - skal ikke udfyldes. Klik "Næste".
3. Aktivering
Klik på "Aktiver systemet nu". Klik på "Næste".
4. Kontakt
Angiv kontaktoplysninger. Klik på "Næste".
5. Opsummering
Kontroller om oplysningerne er korrekte. Klik på "Tilslut".
6. Kvittering
Som kvittering vises 2 oplysninger, som skal indsættes i opsætningen i Cicero: ID og API-key.
Klik på "Download systemindstillinger" - disse skal indsættes i Cicero, som beskrevet herunder.
2. Konfiguration af NgDP i Cicero
Gå ind i Cicero og gå til F7->Serveropsætning. De relevante konfigurationer findes under kategorien Notifikation.
Find konfigurationsparametrene for NgDP for henholdsvis ID af afsendersystem i NgDP og for API-nøgle til afsendersystem i NgDP og indsæt værdierne som du har downloadet fra NgDP således:
ID indsættes i "ID af afsendersystem i NgDP".
API-key indsættes i "API-nøgle til afsendersystem i NgDP".
Bemærk: "Basic" og det efterfølgende mellemrum skal være med, når du angiver API-key. Kontroller også at API-key ikke indsættes med et linjeskift eller mellemrum, på den position hvor der er linjeskift i PDF-dokumentet.
Digital post afsender CVR nummer udfyldes med bibliotekets CVR nummer.
Digital post afsender fulde navn udfyldes med bibliotekets navn.
Digital post-service her vælges Digital Post (Danmark).
3. Skabelon for saldoopgørelse
I forbindelse med afsendelse af breve via NgDP bliver HTML’en, som brevene indeholder, valideret mere striks end tidligere. Eksempelvis betyder det at skabelonerne ikke må indeholde tags som <pre> og <hr>. Det kan derfor være nødvendigt at opdatere de skabeloner, som forventes at skulle sendes via digital post, da afsendelsen ellers vil fejle.
Reglerne for validering er beskrevet i NgDP’s dokumentation - søg efter ”HTML whitelist for document validation”: https://www.digitaliser.dk/resource/5765802
Samtidig skal skabelonen have den korrekte encoding, dvs. at skabelonen skal indeholde en linje, der ser således ud:<meta http-equiv="content-type" content="text/html;charset=UTF-8"/>
Hvis der i denne linje står charset=ISO-8859-1 skal det rettes til ovenstående, ellers vil afsendelsen fejle.
Det er op til det enkelte bibliotek at sørge for at alle digital post-skabeloner overholder de nye retningslinjer.
Systematic har udarbejdet en revideret standardskabelon til saldoopgørelsen, samt tilrettet de eksempler som findes på Cicero Connect. Du kan hente standardskabelonen frem i Cicero i F7->Serveropsætning ved at klikke på "Gendan til standardværdi" i "Digital Post- og printskabelon" for notifikationen "Saldoopgørelse".
OBS! Husk at tage en kopi af jeres nuværende skabelon først, så I kan kopiere evt. lokalt tilrettede tekster og andet.
Skabeloner til saldoopgørelse kan også findes på Cicero Connect under Manualer->Skabeloner.
Hvis I udsender andre typer af notifikationer via Digital Post er det jeres eget ansvar at sikre at skabelonerne overholder de regler som er beskrevet af NgDP.
SSE/14789/USM/0066