Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning

DS-1450 - Getting issue details... STATUS

JOB-404 - Getting issue details... STATUS

BI-347 - Getting issue details... STATUS

Indholdsfortegnelse

Afgrænsning af epic

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne (links i listen virker kun med STAR Jira konto):

Jobnets håndtering af interne snitflader

Nr. 2 undersøges af  JOB-537 - Getting issue details... STATUS . Resultat: Jobnet får værdi fra service men har ikke mappet den igennem. JN er således ikke påvirket af DFDG's udfasning af fejlkode 4374. 

Automatisk oversigt (vi arbejder på løsning på at gøre den synlig)

Beskrivelse af epic

I øjeblikket benytter STAR sig af sin egen SMSgateway ved udsendelse af SMSer.

Antal SMSer

Antallet af SMSer der ca. bliver sendt på en måned er:

254.630 stk (seneste 30 dage ved kørsel d. 23-09-2019)

Ovenstående antal er fratrukket SMSer vedr. TJOB og kvitterings frist for MinPlan som udgår ved release af 2019-4

Telefonnumre

Antallet af borger verificerede mobiltelefon numre samt borger mobiltelefon numre som er blevet oprettet af sagsbehandlere er:

Tal fundet ved eksekvering af scripts d. 23-09-2019 (Manuscript 157147)

Ovenstående skal benyttes i samtale / mail med DigitalPost (e-Boks) til begrundelse til, hvorfor STAR skal have mulighed for at tilmelde borger via Jobnet.

Efter samtale med Digital Post er det besluttet at Jobnet implementere et link til Digital Post i stedet for muligheden for tilmelding direkte i Jobnet, dette grundet at der ved tilmelding af NemSMS skal indtastes beskæftigelses kode på Digital Post.

Maksimalt indhold af en NemSMS er 160 karakterer

NemSMS

Dokumentation findes på digitaliseringensstyrelsens hjemmeside:

https://digst.dk/it-loesninger/digital-post/vejledninger/

NemSMS’er

NemSMS’er, der er korte meddelelser fra myndighed til slutbruger, kan afsendes via REST,
S/MIME og masseforsendelse snitfladerne. Da NemSMS-brugeren skal kunne modtage
beskeden som SMS, sætter dette nogle begrænsninger på indholdet. En NemSMS kan
maksimalt indeholde 160 karakterer og kan ikke sammenkædes. Se afsnittet ’Tegnsæt’ mht.
encoding.
Tidsrummet for udsendelse af NemSMS er afgrænset til kl. 8.00 – 22.00. Hvis
afsendelsestidspunktet for en NemSMS er uden for dette tidsrum korrigeres dette automatisk.
Bemærk at der kan gå op til en time før NemSMS’en forsøges sendt.
Filformatet skal altid sættes til ’TXT’ for NemSMS’er.

Tegnsæt

Alle XML dokumenter der afleveres skal være encoded i UTF8. Alle tekster må uanset hvilken
encoding der er anvendt kun indeholde karakterer, som er indeholdt i ISO 8859-1 (Latin-1,
Western European).
For samtlige snitflader forudsættes at indholdet af meddelelser, dokumenter og vedhæftninger,
hvor filtypen (FilFormatNavn) er ’TXT’ og ’HTM’, er encoded i ISO 8859-1.
Når en slutbruger oploader en fil som vedhæftes en forsendelse til en myndighed forudsættes,
at myndigheden er i stand til at håndtere filen i det format slutbrugeren har anvendt.
NemSMS’er afleveres encoded i ISO 8859-1 formatet, men karaktererne er her yderligere
begrænset til standard SMS 7-bit karaktersættet, som defineret i GSM 03.38 standarden for
’Alphabets and language-specific information (se vedhæftning)

Ud fra ovenstående er det testet at følgende karakterer kan sendes med NemSMS:

!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_abcdefghijklmnopqrstuvwxyz{|}~¡£¤¥§¿ÄÅÆÇÉÑÖØÜßàäåæçèéìñòöøùü

Tiltænkt flow

Før afsendelse tjekkes om borger er tilmeldt materialet (NemSMSen), i digital post er det alt eller intet, borger kan derfor enten være tilmeldt eller ikke tilmeldt NemSMSer.

Er borger tilmeldt sendes NemSMS via enkeltforsendelse til borger.

Er borger ikke tilmeldt sendes der ikke SMSer, på Jobnet vises et link til Digital Post.

Info: Muligheden for tilmelding direkte i Jobnet bliver derved ikke implementeret, dette grundet at der ved tilmelding af NemSMS skal indtastes beskæftigelses kode på Digital Post.

Af Digital post snitflader 7.0 (Afsnit 4.1 C.)

Afgør via online REST kald til afsendersystemet.

Via nedenstående REST kald kan det afgøres online, hvorvidt en specifik slutbruger er tilmeldt en given indholdstype (se Bilag A1 - REST - Afsendersystem).

Kaldet må kun anvendes ved enkeltforsendelser (dvs. ikke masseforsendelse).

Forespørg om en slutbruger ønsker en specifik indholdstype

GET /afsendersystem/{sysid}/Tilmeldinger/{indholdstypeid}

Enkeltforsendelse / opdater afsendelse

PUT /afsendersystem/{sysid}/afsendelser/{meddelelsesid}

Anvendes til at oprette en afsendelse og opdatere en planlagt afsendelse. En afsendelse bliver til en meddelelse når den er afsendt. Afsendelsen kan indeholde både XML og binære data, når den oprettes. Det binære data er indkodet i Base64 formatet. Afsendelsen indeholder afsendelsens informationer inklusiv metadata, selve indholdet, og evt. vedhæftninger. Når en afsendelse er oprettet er den eneste ændring der kan foretages annullering eller ændring af afsendelsestidspunkt. En afsendelse bliver først afsendt, når den har status planlagt og det angivne afsendelsestidspunkt er nået. Indtil da er den planlagt eller afventer. Parameteren meddelelsesid bestemmes af afsendersystemet. Det er afsendersystemets ansvar at sikre at de anvendte id’er er unikke indenfor det pågældende afsendersystem.

Konfiguration

Demo

Base endpoint: https://demo-rest.e-boks.dk/V1.svc

CertifikatSN: CVR:30808460-UID:25351738

SysID: 4290

IndholdsTypeId: 181292

Prod

Base endpoint: https://rest.e-boks.dk/V1.svc

CertifikatSN: CVR:30808460-UID:25351738

SysID: 42764 

IndholdsTypeId: 181482

Acc.kr 975.1.1 DFDG sender huskeservice SMS'er via NemSMS

Opgaver

Nedenstående huskeliste, hvad der skal gennemgås.

• Ny servicemetode i DFDG som udstiller, metode til brug for at bestemme, hvorvidt borger er tilmeldt NemSMS eller ej.
  • DS-1855 - Getting issue details... STATUS
• Send til NemSMS i stedet for GateWay (Skema validering før afsendelse gøres konfigurerbar så man har mulighed for at slå dette fra efter de er kørt i ca. 3 måneder)
  • Ink Fejlhåndtering
  • DS-1863 - Getting issue details... STATUS
• Hvorvidt beskeder er sendt/ikke sendt i LSS
  • DS-1872 - Getting issue details... STATUS
• Oprydning
  • Gateway
    • DS-1870 - Getting issue details... STATUS
  • SMSStatusService (hel service)
    • DS-1782 - Getting issue details... STATUS
  • Verifikations logik /enqueue logik
  • Validering på hvad man er tilmeldt
  • Fjern validering på eksisterende telefon nummer
    
    • DS-1783 - Getting issue details... STATUS
• Tekster tilpasses 160 tegn.
  • DS-1784 - Getting issue details... STATUS
• Validering på CitizenMessageService.CreateMessage
  • 160 Tegn
  • Eksterne ikke kan sende på denne beskedtype
    • DS-1785 - Getting issue details... STATUS
• Service ReminderService skal flyttes til NemSMS
  • Tages i afsnittet test, skulle virke out of the box.
• Whitelist/sortlist i TMiljøerne.
  • DS-1876 - Getting issue details... STATUS
• Udsendelse af beskeder via borgers beskedbakke, hvor borger ikke kunne modtage via SMS.
  • DS-1875 - Getting issue details... STATUS
• DASR tekster opdateres maksimalt 160 tegn
  • DS-1784 - Getting issue details... STATUS

Verifikations, enqueue og validerings logik

CitizenMessageService.CreateMessage

Der ændres på validerings logik ved kanaltype SMS, CitizenMessageChannelTypeIdentifier 1, fremadrettet vil beskedlængde maksimalt kunne være 160 tegn, ydermere fjernes alle andre end STARs egne systemer som benytter af kanaltypen SMS.

Fjernelse af service SMSStatusService

Da STAR overgår til NemSMS vil denne service ikke længere blive benyttet, service er lavet til at den eksisterende SMS gateway kunne kalde for at status, hvorvidt SMS blev sendt til borger eller ej kunne opsamles.

Fjernelse af borgers mulighed for at verificere sit mobiltelefon nummer

Da eksisterende SMS gateway fjernes, fjernes samtidigt borgers mulighed for at verificere mobiltelefonnummer.

Dette gøres blandt andet grundet indtastningen af mobiltelefonnummer på Jobnet, fremadrettet ikke behøver at være det samme mobiltelefon nummer som borger har angivet som sit NemSMS mobil telefon nummer, samt at borger i forbindelse med tilmelding til NemSMS skal bekræfte mobil telefon nummer.

JobnetPersonNotificationReminderService.(v1).SavePersonContactData vil derfor ikke længere generere en bekræftelseskode til borger i from af SMS ved benyttelse af PersonContactDataTypeIdentifier ID 1 (Mobiltelefon), ligeledes vil borger ikke længere kunne verificere sit mobiltelefon nummer ved kald til JobnetPersonNotificationReminderService.(v1).VerifyPersonContactData ved benyttelse af PersonContactDataTypeIdentifier ID 1 (Mobiltelefon).

Error

Nedenstående fejlkode vil ikke længere kunne kastes af DFDG, da borger ikke længere har behov for at verificere det mobiltelefon nummer som vedkommende har indtastet på Jobnet.

Nedenstående services havde tidligere mulighed for at kaste denne fejlkode.

• JobnetPersonNotificationReminderService v1

• PersonNotificationReminderService v1

• JobnetVacationService v6

• UnemploymentEnrollmentService v6 + 7

PersonCommunicationStatusService.(v1).GetPersonNemSMSSubscription udstiller, hvorvidt borger er tilmeldt NemSMS eller ej, metoden er sat op til kun at kunne blive kaldt af STAR.

Se snitflade beskrivelse her: PersonCommunicationStatusService (Version [UDV], 2020-1)

Man skal som kalder i TMiljøerne være opmærksom på, at der skal benyttes fiktive CPR-numre, ved kald af servicemetode, liste af fiktive CPR-numre kan findes via nedenstående link:

/wiki/spaces/CITY/pages/1422721068

Ved kald i TMiljøerne med "rigtige" CPR-numre vil resultere i at false vil blive returneret, dette er grundet at der i TMiljøerne er implementeret sortlistning/whitelistning af CPR-numre, da Digital Post frabeder sig kald med rigtige CPR-numre.

Udsendelse af beskeder via borgers beskedbakke, hvor borger ikke kunne modtage via SMS

I afsendelses øjeblikket, vil der fremadrettet blive valideret for følgende, før udsendelse af NemSMS foretages

• Borger er ikke ment at få SMS grundet whitelistning / sortlistning
  • Se nedenstående afsnit
• Borger er tilmeldt NemSMS
• Valideres ved brug af samme logik som udstilles i afsnittet
• Ny servicemetode i DFDG som udstiller, metode til brug for at bestemme, hvorvidt borger er tilmeldt NemSMS eller ej

Hvis borger ikke modtager SMS enten grundet whitelist/sortlistning, eller grundet borger ikke er tilmeldt NemSMS, sendes samme besked som borger ellers ville have modtaget via NemSMS, via borgers beskedbakke.

Følgende foranstillede besked før besked tekst i SMSen

Beskeder til Beskedbakken

Titler og foranstillede tekster til Jobnet beskedbakke i beskeder ved 1) sortlistet eller 2) manglende tilmelding ifm. NemSMS (jf. FB 164930):

1)
Titel: "Beskedservice"
Tekst: "Du modtager nedenstående besked her på Jobnet, da det ikke var muligt at sende den via NemSMS, da der pt. ikke må sendes beskeder til dig." + 2 linjeskift og den oprindelige besked.

2)
Titel: "Beskedservice"
Tekst "Du modtager nedenstående besked her på Jobnet, da du ikke er tilmeldt NemSMS. Tilmeld dig NemSMS hos Digital Post for at modtage beskeder fra Jobnet som SMS.

Hvis du ikke tilmelder dig NemSMS og ikke ønsker disse beskeder, kan du fjerne markeringen for at modtage NemSMS via menuen Brugerprofil og menupunktet Få besked på SMS og/eller e-mail.
+ 2 linjeskift og den oprindelige besked.

Whitelist / sortlistning i TMiljøerne

Sortlistning / whitelistning i TMiljøer er bygget op så det sikres, at der ikke på noget tidspunkt, kan sendes SMSer til slutbruger uden at slutbruger er på whitelisten.

Tidligere var det således, at det var telefonnumre som var whitelistet, det var således en konfigurationsændring at få sit telefonnummer på whitelisten, dette ændres i forbindelse med implementeringen af NemSMS, grundet registeret med telefonnummere til brug for SMSer ikke længere er placeret hos STAR.

Ved afsendelse af NemSMS kender STAR, således ikke det telefonnummer SMSen vil blive sendt til hvorfor sortlistning / whitelistning i stedet vil virke på CPR-nummer.

Ved færdig implmentering er det følgende liste af fiktive CPR-numre der kan benyttes:

/wiki/spaces/CITY/pages/1422721068

Acc.kr 975.1.2 Passende tekst- og funktionsændringer på Jobnet ift. brugen af NemSMS

PersonCommunicationStatusService og SMS abonnementer på Jobnet

For at Jobnet fremadrettet kan se om en borger er tilmeldt NemSMS, implementeres PersonCommunicationStatusService V.1. Servicen implementeres i /wiki/spaces/ISB/pages/1426162790.

PersonCommunicationStatusService kaldes, når borger på Jobnet klikker på menupunktet "Få besked på SMS og/eller Email". Er borger ikke tilmeldt vil fremgå nedennævnte besked, der opfordrer borger til at melde sig til.

Er borger meldt til fremgår i stedet følgende besked af feltet SMS: "Nummeret du har registreret ved NemSMS".
Jobnet kender ikke dette nummer og det kan i praksis kan være et andet end borgers mobilnummer.

Returnerer PersonCommunicationStatusService en fejl, således at Jobnet ikke ved om borger er tilmeldt NemSMS eller ej, så vises følgende:

I sektionen hvor borger vælger sine abonnementer rettes teksten ud for tjekboksen, som før hed "SMS" (hvis borger altså havde oplyst mobilnummer) alternativt "SMS nummer ikke oplyst" (hvis nummer ikke var oplyst), til i alle situationer at hedde "NemSMS".
Logikken, der før var, som gjorde denne boks klikbar/ikke klikbar, beroede på om mobilnummer var oplyst eller ej. Denne logik er tillige fjernet og feltet er altid klikbart, for reelt kan borger være tilmeldt NemSMS uden at have oplyst nummer på Jobnet. Eller beslutte sig for at abonnere på SMS'er på jobnet i den aktuelle session, uden borger endnu har tilmeldt sig NemSMS. Eller have meldt sig til i et andet vindue på NemSMS inden abonnementer gemmes. Det er altså fravalgt at lave hårde bindinger imellem systemer hvor der ikke bør være det. Og borger kan frit sætte et abonnement via NemSMS uden at være tilmeldt. I det tilfælde, vil SMS ikke udsendes, men der vil sendes en besked til borgers beskedbakke (Af DFDG).

Vælger borger "NemSMS"-abonnementer, så foretages atter et kald mod PersonCommunicationStatusService ved borgers klik på "Gem ændringer". Er borger på det tidspunkt ikke oprettet hos NemSMS får borger feed back herom i en call out i toppen af siden.



Er borger tilmeldt gives blot feedback på, at valg er gemt (herunder vist i responsiv tilpasning).



Arbejdet udføres i /wiki/spaces/ISB/pages/1432126357 hvor yderligere detaljer forefindes.

Mobilnummer skal ikke længere bekræftes

Ved ændringer af mobilnummer på Jobnet har det været vigtigt, at mobilnummeret blev verificeret. Dette fordi det koster penge at sende erhvervsSMS'er ud og man derfor har ville sikre sig, at SMS modtages. Ved overgang til NemSMS er der dog ikke længere et behov for denne validering og i praksis lader den sig heller ikke gøre, da STAR ikke længere har en SMSgateway at sende verifikationskoden ud via. NemSMS kan ikke bruges. Dels er der ingen garanti for at borger er tilmeldt og hvis borger er tilmeldt, kan det reelt være på et andet nummer end dét, der oprettes/ændres på Jobnet.  Og så ville det være upassende at sende en verifikationskode ud. Hele ideen i verifikationen er jo, at den der har ændret nummeret i Jobnet har adgang til det telefonnummer der opdateres. Og det kan ikke garanteres mere.

Verifikation af mobilnummer, på forsiden og under "Personlige oplysninger", via notifikationer og popups (dvs. den alenestående popup omhandlende rettelse af mobilnummer og den sammensatte popup, omhandlende ændring af mobilnummer og emailadresse på én gang) er derfor slettet.

Verifikation sker dog fortsat af borgers ændrede emailadresse. Her er ingen ændringer sket og løsning er verificeret at virke.

Arbejdet er udført i /wiki/spaces/ISB/pages/1432355264

Reklamebanner for NemSMS

I 2019-4 R02 er etableret et "reklamebanner" for NemSMS på borgers forside. Banneret er valgt frem for dialogmodul, fordi STAR vil sikre sig, at borgere der melder sig ledige i sidste øjeblik inden SMSgateway fases ud og NemSMS tager over, er informeret om nødvendigheden af tilmelding til NemSMS.

Banneret vil være aktivt resten af 2019-4 og er ike merget til 2020-1, hvorfor det automatisk forsvinder. Banneret er lavet som et genbrugeligt element og er lagt i jobnets FrontendGuide for let genanvendelse ved andre budskaber.

Arbejdet er udført i /wiki/spaces/ISB/pages/1432224470

Acc.kr 975.1.3 Import af fiktive test CPR numre, hvor der er mulighed for NemSMS afsendelse

Af NemSMS digitalpost afsendersystem i demo er der listet en lsite fiktive CPR numre som vi kan sende ud på, disse CPR numre ønskes importeret som i epic 917.1 via BI.

Listen af fiktive CPR numre er:

• 0101600354
• 0101610354
• 0101620354
• 0101630354
• 0101640354
• 0101650354
• 0101660354
• 0101670354
• 0101680354
• 0101690354

Acc. kr. 975.1.4 STAR tilpasser antal tegn i SMS'er (max 160 tegn pr. sms)

Tekster er opdateret på siden:

Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:

• DFDG
  • Services
  • WSRMer
  • Kodelister
  • PersonStatusService (PSS)
  • PersonHistoryService (PHS)
  • LSS (Landssupportsystem) og herunder Registerudtræk (hvis STAR har dataejerskab og der er lavet PHS på domænet)
• Jobnet
• VITAS
• JobKon
• JobAG
• BI integrationsplatform
• Alle områder
  • Nye batchjobs
    • Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon) 
  • Dataløft
    • Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.
• Kommunalt sagsbehandlingssystem
• A-kasse sagsbehandlingssystem
• Kommunalt bookingsystem
  • JobcenterPlanner (JCP)
  • WorkForcePlanner (WFP)
• Kommunalt ydelsessystem

Særlige krav til test

I TMiljøerne er det følgende liste af Fiktive CPR-numre der skal benyttes, da Digital Post har frabedt sig kald med "rigtige" CPR-numre på deres demo miljø.

• /wiki/spaces/CITY/pages/1422721068

Vejledning af brug af de fiktive Test-CPR-numre kan findes her

• /wiki/spaces/CITY/pages/1422688266

NB: Vær opmærksom på ved test mod Digital Post i deres Demo miljø, kan det tage op til et par minutter for at NemSMSen når frem.

* Batchjobs

• bør testes både med delta og fuldt load,
• bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden
• bør testes i samarbejde med teams som har afhængigheder
• kørselstid, særligt hvis det er en del af NightlyBatch

Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse:

• Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres
• Skal der køres konvertering
• Skal der køres databasescripts for opdatering af tabeller i databasen

Efter idriftsættelse:

Arkitektur- og implementeringsnoter 

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

• Nye dataområder: Nej
• Nye snitflader: Ja, NemSMS
• Nye komponenter: ?
• Nye miljøer: ?
• Nye teknologier: ?
• Nye aftagertyper: Nej
• Eller afvigelser fra principperne: Nej
• Eventuelle behov for reduktion af teknisk gæld skal afdækkes: ?

Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.