...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
| Page Properties | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
|
...
|
...
|
...
Indgik i tilsagn:
|
...
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 | Udkast | |
2022-11-07 | 0.1 | Fjernet del 1 af 2 fra titel, da det kan være den skal være over flere releases. | |
2022-11-15 | 0.1 | 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. | |
2022-11-21 | 0.1 | Ibrugtagningsrelease 2023-3 fastlagt, af møde 20221117 | |
2022-11-28 | 0.1 | Tilføjet Acc. 1005.17.40.7 og 1005.17.40.8 + indsat link til ekstern kommunikations side. | |
2022-12-02 | 0.3 | 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. | |
2023-01-27 | 0.3 | Klargøring til gentilsagn, inkluderet sniflade beskrivelse, særlige krav til test mv. | |
2023-03-22 | 0.1 | Tanvir og Jesper | Sat ned til version 0.1, gennemskrives med henblik på nyt tilsagn |
2023-04-14 | 0.3 | Tanvir og Jesper | Løft til 0.3 mhp. tilsagn. Tilføjet at enumerationslister omlægges til kodelister med værdisætændringer |
2023-09-08 | 1.0 | Epic løftet til status 1.0 |
Interne links (indhold i links ikke relevant for eksterne)
| Jira Legacy | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Jira Legacy | ||
|---|---|---|
|
...
|
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
...
|
| Jira Legacy | ||
|---|---|---|
|
...
...
|
...
|
...
| Jira Legacy | ||
|---|---|---|
|
...
|
...
| Jira Legacy | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Jira Legacy | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
|
| Jira Legacy | |||||
|---|---|---|---|---|---|
|
...
|
...
|
| Jira Legacy | ||
|---|---|---|
|
...
...
|
...
|
...
| Jira Legacy | ||
|---|---|---|
|
...
|
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
Indholdsfortegnelse
| Table of Contents | ||
|---|---|---|
|
...
Afgrænsning af epic
Afgrænsning | ||
|---|---|---|
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 | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for |
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 | Jobnet (Herunder JobAd, Ankiro, JGM), JobAG, Vitas, EURES, BVL, D&S, SF |
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å. | JobAG, Vitas, EURES, BVL, D&S (herunder LSS), SF |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||||||
|---|---|---|---|---|---|---|---|---|---|
1005.17.40.1 | 1005.17.40.2 | 1005.17.40.3 | 1005.17.40.4 | 1005.17.40.5 | 1005.17.40.6 | 1005.17.40.7 | 1005.17.40.8 | ||
Som KSS, A-kasse og andre aftagere/ system/applikation der gør brug af eksisterende JobAdService skal jeg være bekendt med, at jeg skal overgå til at kalde service fra et andet forretningsområde fra en senere release. | X | Ibrugtagning i 2023-3 | |||||||
Som aftager af JobannonceService er jeg bekendt med at STAR i forbindelse med skiftet til forretningsområdet, ændrer på måden aftagere skal tilgå webservicen, der skal fremadrettet benyttes certifikat for at tilgå webservicen samt dets webservicemetoder. | X | Skiftet til certifikat gøres for at standardisere, hvordan webservices bliver kaldt samt højne sikkerheden, hvori aftagere tilgår og ændre data. | |||||||
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)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
Ændret | Eksterne og interne serviceaftagere af JobannonceService skal være opmærksomme på at servicen skal kaldes med certifikatbaseret sikkerhedsmodel | A-kasse(t.o.), Andre, BI, DSDW(VOA)(t.o), JobAD, KSS(t.o.), MOD, SF | BI, DFDG, EURES, JobAG, Jobnet, MOD, SF, VITAS | Modernisering | |
Udgået | JobAdService udgår, aftagere skal i stedet bruge ny service virksomhedsindsats.JobannonceService | A-kasse(t.o.), Andre, BI-(t.o.), DSDW(VOA)(t.o), JobAD, KSS(t.o.), SF, VITAS | BI, DFDG, EURES, JobAG, Jobnet, MOD, SF, VITAS | Modernisering | |
JobannonceService (tidl. JobAdService) enumerationslister bliver til kodelister | Ny | JobAdService enumerationslister lægges ved skiftet til Jobannonceservice om til kodelister på Virksomhedsindsats.CodeLists med nye værdisæt | A-kasse(t.o.), Andre, BI-(t.o.), DSDW(VOA)(t.o), JobAD, KSS(t.o.), SF, VITAS | DFDG, EURES, JobAG, Jobnet, MOD, SF, VITAS | Modernisering |
Ny | Ny service som overtager alle opgaver efter JobAdService | A-kasse(t.o.), Andre, BI, DSDW(VOA)(t.o), JobAD, KSS(t.o.), MOD, SF | BI, DFDG, EURES, JobAG, Jobnet, MOD, SF, VITAS | Modernisering | |
Ændret | Aftagere af organisationstypen virksomhed, vil ved release ikke længere have lov til at kalde denne servicemetode | A-kasse(t.o.), Andre, BI, DSDW(VOA)(t.o), JobAD, KSS(t.o.), MOD, SF | BI, DFDG, EURES, JobAG, Jobnet, MOD, SF, VITAS | Modernisering |
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.
| Jira Legacy | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
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
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
Eventuelt overløb fra fase 1.
Konvertering til endelig fysisk datamodel
Omlægning til brug af interne nye services i stedet for black box legacy applikationer
Support af eksterne
Fjern teknisk gæld
Løsningens omfang
"As-Is"
| Include Page | ||||
|---|---|---|---|---|
|
Fase 1
| Include Page | ||||
|---|---|---|---|---|
|
Fase 2
| Include Page | ||||
|---|---|---|---|---|
|
Fase 3
| Include Page | ||||
|---|---|---|---|---|
|
Fase 4
| Include Page | ||||
|---|---|---|---|---|
|
Fase 5
| Include Page | ||||
|---|---|---|---|---|
|
Fase 6
| Include Page | ||||
|---|---|---|---|---|
|
Fase 6 (Done)
| Include Page | ||||
|---|---|---|---|---|
|
Personer
Navn | Område | Beskrivelse |
|---|---|---|
Krav | GoTo person i forhold til kravsafdækning | |
Løsningsbeskrivelse | GoTo person i forhold til løsningsbeskrivelser | |
Epic, userstories, indhold | GoTo person i forhold til epic, userstories, kvalitetssikring, fremgangsmåde | |
APOC2? | STAR (Fagkontor) | Fagkontor som kan kvalitets sikre logiske modeller, krav? |
STAR | SPOC til interessenter der benytter JobAD | |
STAR | SPOC til interessenter der benytter JobAD | |
STAR | SPOC i rollen som CPO, Jobnet, JGM | |
STAR | SPOC i rollen som CPO, DFDG | |
Reviewer | Kvalitetssikring, review | |
STAR | STAR PL GoTo person vedr. JobAD i STAR regi | |
STAR | STAR PL moderniseringen DFDG |
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
| Include Page | ||||
|---|---|---|---|---|
|
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.
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
|---|---|---|
Ved system/applikation/funktionalitet der benytter JobannonceService med samme certifikat i regi af flere kunder, skal det sikres at system/applikation/funktionalitet der kalder ind, kalder med den korrekte metadata. Det er i certifikatet og i metadata det sikres, at forskellige kunder ikke får adgang til hinandens jobannoncer. | Virksomhedsindsats (JobannonceService) | |
Ved system/applikation/funktionalitet der benytter JobannonceService i regi af flere kunder, hvor kunderne har et separat certifikat pr. kunde , skal det sikres at system/applikation/funktionalitet der kalder ind, kalder med den korrekte certifikat og metadata for den pågældende kunde. Dette da det er i certifikat + metadata det sikres, at forskellige kunder ikke får adgang til hinandens jobannoncer. | Virksomhedsindsats (JobannonceService) |
* 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:
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 )
Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | |
|---|---|---|---|---|---|---|
A-kasse | X | |||||
JobCenter | X | |||||
Kommune | ||||||
STAR | X | |||||
AUB | ||||||
UDK | ||||||
STIL | ||||||
Virksomheder | X |
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