...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

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

...

...

Rolf Marcher Arndt

Rigmor Gold (Unlicensed)

...

2023-1 (STAR udv.)

2023-2 (STAR udv.)

2023-3 (ekstern ibrugtagning)

...

JobAD aftagere

KSS

A-kasse

Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

...

Dato

...

Version

...

Hvem

...

Hvad er ændret?

...

2022-11-01

...

0.1

...

Rolf Marcher Arndt

...

Udkast

...

2022-11-07

...

0.1

...

Rolf Marcher Arndt

...

Fjernet del 1 af 2 fra titel, da det kan være den skal være over flere releases.

...

Tilføjet highlevel acc.krs, varslingstasks herunder interne og eksterne snitflader og yderligere klargøring af epic for at komme til en nærmere tilstand, hvor der kan udføres internt review.

...

Status sættes i 0.3 efter aftale med STAR, epic er med i tilsagnsbølge 3 til release 2023-1.

Epic åbnes for eksterne aftagere.

...

Interne links (indhold i links ikke relevant for eksterne)

Indholdsfortegnelse

Afgrænsning af epic

...

Som STAR ønsker jeg, at eksterne og interne serviceaftagere af JobAD service fra release 2023-3 kun tilgår data vedr. jobannoncer via forretningsområdet Virksomhedsindsats

...

Jobnet (Herunder JobAd, Ankiro, JGM),

JobAG,

Vitas,

EURES,

BVL,

D&S,

SF

...

JobAG,

Vitas,

EURES,

BVL,

D&S (herunder LSS),

SF

...

Ibrugtagning i 2023-3

...

Oversigt over berørte webservices 

Omfanget afdækkes som en del af designarbejdet (fase 2)

Manuel oversigt som er synlig for eksterne

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

(TABEL GENINDSÆTTES HER)

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

Beskrivelse af epic

Baggrund

JobAD er en SOAP webservice, som giver interne applikationer (Jobnet og JobAG) og eksterne (ca. 60-70) eksterne aftagere adgang til at indberette og modtage jobannoncer. JobAD indeholder en række metoder, som understøtter følgende:

• Indberetning af jobannoncer, som skal publiceres på jobnet.dk i ét webservicekald

• Interaktiv indberetning af jobannoncer (opret kladde, opdater løbende, send til godkendelse og publicering)

• Fremsøg jobannoncer

• Hent jobannonce

En JobAD-jobannonce kan have en række forskellige tilstande, se: JobAd Annoncer - STAR City - Internt område - Confluence (atlassian.net) (internt link - eksterne kan kan se indhold her). Desuden har JobAD en lang række snitflader og afhængigheder til de forskellige interne og eksterne applikationer, herunder brugen af Ankiro-søgemotoren. I forbindelse med modernisering af Jobnet skal JobAD "afkobles" og flyttes til et selvstændigt forretningsområde (silo): Virksomhedsindsats.

Ud fra foranalysen foretaget i (internt link) /wiki/spaces/ISB/pages/3861709044.

Grundet de mange aftagere, er der ud over epic, oprettet følgende ekstern side til kommunikation.

Kommunikations side til moderniseringen af jobannoncer (JobAd) (også synligt eksternt)

Faseopdeling

Modernisering af JobAD opdeles i en række faser, hvoraf nærværende Epic kun dækker fase 1. Arbejdet i fase 2+ påvirker ikke JobannonceService snitfladen og de eksterne aftagere.

Fase 1: Oprettelse af JobannonceService i forretningsområdet

1. Udstilling af JobannonceService (REST) med tilhørende servicemetoder fra forretningsområdet

Fase 2+: Internt lægges der om så al funktionalitet løbende omlægges til at ligge i forretningsområdet

1. Eventuelt overløb fra fase 1.
2. Konvertering til endelig fysisk datamodel
3. Omlægning til brug af interne nye services i stedet for black box legacy applikationer
4. Support af eksterne
5. Fjern teknisk gæld

Løsningens omfang

"As-Is"

Image Removed

"To-be" (når alle faser er gennemførte)

Image Removed

Se: (internt link )Modernisering af jobannoncer inkl. JobAD - STAR City - Internt område - Confluence (atlassian.net)

Personer

...

...

...

...

...

...

...

...

...

...

1005.17.40.1 Som eksterne og interne serviceaftagere af eksisterende JobAd service, ønsker jeg at kunne hente data fra forretningsområdets nye service JobAnnonceService

For at det for eksisterende aftagere gøres så smidigt som muligt at komme over på den nye snitfladeudstilling fra forretningsdomænet Virksomhedsindsats, ændres der så vidt muligt ikke ved selve udstillingen.

Det der bliver udført i forbindelse med implementeringen af servicen JobannonceService (tidligere JobAD Service) på Virksomhedsindsats forretningsområdet er følgende:

• Navnet på servicen ændres fra JobADService til i stedet at hedde JobannonceService.
• Udstilling af denne service vil blive udstillet af Virksomhedsindsats forretningsområdet
• Fra tidligere at benytte brugernavn og adgangskode til at få tilgang til servicen skal man fremover benytte funktions certifikat som det ligeledes gør sig gældende, for alle de andre DFDG udstillede services.
• Navngivning i snitflader rettes til dansk, herunder metodenavne, indhold i hhv. request og response, kodelister, beskrivelse af felter mv.
• Servicemetoderne CloseJobAsUser og DeleteJobAsUser på JobADService genimplementeres ikke, da man i forbindelse med skift til sikkerhed med funktions certifikat fra tidligere brugernavn og adgangskode vil få informationerne fra certifikatet.
• Kodelisten DriversLicence videreføres ikke man skal som aftager i stedet benytte kodelisten JobSearch.DriverLicenseTypeCodeList.

Der udestår enkelte forretningsmæssige afklaringer i nedenstående linkede snitflade beskrivelse markeret med orange

...

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

...

Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

Interne links (indhold i links ikke relevant for eksterne)

Indholdsfortegnelse

...

Afgrænsning af epic

Oversigt over berørte webservices 

Omfanget afdækkes som en del af designarbejdet (fase 2)

Manuel oversigt 

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

Enumerationslister bliver til kodelister med nye værdisæt: Læs mere nedenfor

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

Beskrivelse af epic

Baggrund

JobAD er en SOAP webservice, som giver interne applikationer (Jobnet og JobAG) og eksterne (ca. 60-70) eksterne aftagere adgang til at indberette og modtage jobannoncer. JobAD indeholder en række metoder, som understøtter følgende:

• Indberetning af jobannoncer, som skal publiceres på jobnet.dk i ét webservicekald

• Interaktiv indberetning af jobannoncer (opret kladde, opdater løbende, send til godkendelse og publicering)

• Fremsøg jobannoncer

• Hent jobannonce

En JobAD-jobannonce kan have en række forskellige tilstande, se: /wiki/spaces/CITY/pages/67567825 (internt link - eksterne kan kan se indhold her). Desuden har JobAD en lang række snitflader og afhængigheder til de forskellige interne og eksterne applikationer, herunder brugen af Ankiro-søgemotoren. I forbindelse med modernisering af Jobnet skal JobAD "afkobles" og flyttes til et selvstændigt forretningsområde (silo): "Virksomhedsindsats".

Der er lavet en foranalysen (internt link) /wiki/spaces/ISB/pages/3861709044, som denne epic er baseret på.

Grundet de mange aftagere, er der ud over epic, oprettet følgende ekstern side til kommunikation.

Kommunikationsside til moderniseringen af jobannoncer (JobAd) (synlig for eksterne).

Faseopdeling

Modernisering af JobAD opdeles i en række faser, hvoraf nærværende Epic kun dækker fase 1 (som har betydning for den forretningsmæssige del).

Arbejdet i fase 2, 3, 4, 5 og 6 påvirker ikke JobannonceService snitfladen og de eksterne aftagere, men er "oprydning ifm. teknisk gæld".

Fase 1: Oprettelse af JobannonceService i forretningsområdet

1. Udstilling af JobannonceService (REST) med tilhørende servicemetoder fra forretningsområdet

Fase 2+: Internt lægges der om så al funktionalitet løbende omlægges til at ligge i forretningsområdet

1. Eventuelt overløb fra fase 1.

2. Konvertering til endelig fysisk datamodel

3. Omlægning til brug af interne nye services i stedet for black box legacy applikationer

4. Support af eksterne

5. Fjern teknisk gæld

Løsningens omfang

"As-Is"

Fase 1

Fase 2

Fase 3

Fase 4

Fase 5

Fase 6

Fase 6 (Done)

Personer

1005.17.40.1 Som eksterne og interne serviceaftagere af eksisterende JobAd service, ønsker jeg at kunne hente data fra forretningsområdets nye service JobAnnonceService

For at det - for eksisterende aftagere - gøres så smidigt som muligt at komme over på den nye snitfladeudstilling fra forretningsdomænet Virksomhedsindsats, ændres der så vidt muligt ikke ved selve udstillingen.

Det der bliver udført i forbindelse med implementeringen af servicen JobannonceService (tidligere JobAD Service) på Virksomhedsindsats forretningsområdet er følgende:

• Navnet på servicen ændres fra JobADService til i stedet at hedde JobannonceService.

• Udstilling af denne service vil blive udstillet af Virksomhedsindsats forretningsområdet

• Fra tidligere at benytte brugernavn og adgangskode til at få tilgang til servicen skal man fremover benytte funktions certifikat som det ligeledes gør sig gældende, for alle de andre DFDG udstillede services.

• Navngivning i snitflader rettes til dansk, herunder metodenavne, indhold i hhv. request og response, kodelister, beskrivelse af felter mv.

• Servicemetoderne CloseJobAsUser og DeleteJobAsUser på JobADService genimplementeres ikke, da man i forbindelse med skift til sikkerhed med funktions certifikat fra tidligere brugernavn og adgangskode vil få informationerne fra certifikatet.

• Kodelisten DriversLicence videreføres ikke man skal som aftager i stedet benytte kodelisten JobSearch.DriverLicenseTypeCodeList.

• Kodelisten WeeklyWorkTimeTypes videreføres ikke man skal som aftager i stedet benytte kodelisten Virksomhedsindsats.UgentligArbejdstidTypeCodeList

• Ny kodeliste tilføjet til jobannonce JobannonceEgenskabTypeCodeList 

• Aftagere af organisationstypen virksomhed, vil ved release ikke længere have lov til at kalde denne servicemetode GetTicket

• Det vil være muligt at angive om Jobannoncen vedrører en ansættelse i Staten, Region, Kommune 

Snitfladen er tilgængelig i en specifikationsudgave på /wiki/spaces/ISB/pages/3911549099. Så snart vi har udviklede snitflader er disse tilgængelige på /wiki/spaces/GI/pages/4011820143. Disse anbefales.

Enumerationslister bliver til kodelister med nye værdisæt

Enumerationslisterne fra JobAdService omlægges til at være kodelister i JobannonceService, med nye værdisæt.

Servicens kodelister er i udviklingsudgaven tilgængelige på servicedokumentationen:  /wiki/spaces/ISB/pages/3911549099. Så snart kodelisterne er udviklede, vil de være tilgængelige på Virksomhedsindsats.CodeLists. 

Eksempelvis fandtes enumerationen med arbejdstid, med nummer 16 - PartTime, som er blevet til kodelisten UgentligarbejdstidTypeCodeList med Id 2 - Deltid.

1005.17.40.2 Som STAR ønsker jeg at aftagere fremadrettet skal benytte certifikat ved kald den nye JobannonceService

...

for at øge sikkerheden

...

samt standardisere måden webservices bliver kaldt på

Sikkerhedsmodellen vil være den samme som for DFDGs øvrige services, se eventuelt yderligere om denne på STARs sikkerhedsmodel

Regler

Her udfylder PO oplysninger om eksisterende eller forventede

...

regler om registrering og indberetning.

Ingen ændring i forhold til eksisterende regler.

Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer

Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne.

...

 Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

De eksterne aftagere skal benytte funktionscertifikat (på samme vis som andre DFDG udstillede services) samt overgå til REST udstillet webservice fra Virksomhedsindsats fremfor eksisterende SOAP webservice.

Logiske modeller

Annoncer og formidling på annonce - model

Særlige krav til test

I tilfældet af at ekstern aftager af JobannonceService udbyder sit system/applikation/funktionalitet til flere kunder, er der forskellige kaldemønstre der skal overholdes i forhold til, hvorvidt aftager har certifikat til adgang for hver kunde af system/applikation/funktionalitet, eller et enkelt for systemet/applikationen/funktionaliteten som flere kunder benytter.

...

* 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: 

  • Ved den endelige implementering vil der skulle ske en data konvertering

...

• • af eksisterende data til det nye forretningsområde: Virksomhedsindsats.

...

• • STAR skal  forud for denne overveje påvirkning, kørselstider mv.

    • Herunder tiltag som kan mindske påvirkning, hvis det besluttes at det skal sammenfalde med en af de 4 årlige releases.

• 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:  

• Nye snitflader:  

• Nye komponenter:  

• Nye miljøer:  

• Nye teknologier:  

• Nye aftagertyper:  

• Eller afvigelser fra principperne:  

• 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.

Husk GDPR stillingtagen

Ingen personfølsomme data i epics

Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.

•   Ja, det er tjekket, at epic ikke indeholder dette.

• Angiv hvem der har foretaget dette tjek:  

...

• Tanvir Ahmed

• Angiv dato for tjek:

...

• 23 Mar 2023 

Opbevaring af oplysninger i STARs it-systemer

Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.

Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.

Hvem må tilgå oplysningerne?

Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.

Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.  

Korrekte sikkerhedsattributter på services

PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.

Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )

A-kasse filtrering

Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin

Sagsbehandlerlogin på Jobnet - tag stilling til adgang!

En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.

En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.

Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.

Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin