1005.17.29 Midlertidig adresse (Temporær adresse)
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
|---|---|---|---|---|---|---|
@Knud de Place (STAR) @Jens Andersen | @Jan Nyman (@Carsten Olsen) | 2024-3 | 2024-4 | 2025-1 | 1.0 | A-kasse, KSS, Converter |
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? |
|---|---|---|---|
14-10-2022 | 0.1 | Carsten Olsen | Oprettelse |
12-02-2022 | 0.1 | Carsten Olsen | Release flyttet til 2024-3 |
30.05.2024 | 0.3 | Knud de Place | Foranlediget af spg fra KMD under tilsagnsproces: “Borgerkommunikation.MidlertidigAdresseService (Version 1).GetMidlertidigAdresse” tilføjet til afsnit om berørte services. I tabel (under AC-2) med beskrivelse af valideringer er tilføjet id’er på de cpr-statusser, der er tale om. |
31.05.2024 | 0.3 | Knud de Place | I tabel (under AC-2) med beskrivelse af valideringer er tilføjet navn på nye fejlkode 600xx. |
10.06.2024 | 0.3 | Jan og Carsten | Konverteringsregler opdateret |
29.07.2024 | 0.3 | Carsten Olsen | STAR Release start ibrugtagning var ved en tastefejl sat allerde til 2024-3 det er 2024-4 således den følger vores normale mønster |
06.08.2024 | 0.5 | Knud de Place | I 2024-4 kodespor udestår at lave SOAP-REST converter og intern LSS understøttelse |
12.09.2024 | 0.5 | Knud | Interne links (til STAR) opdateret |
03.10.2024 | 1.0 | Knud de Place | v1.0 - ikke andre ændringer |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-12142
https://starwiki.atlassian.net/browse/BI-2490
Rigtige link indsættes
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 3 Afgrænsning af epic
- 4 Oversigt over berørte webservices
- 5 Beskrivelse af epic
- 5.1 Baggrund
- 5.2 Regler
- 5.3 Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
- 5.4 1005.17.29.1 - Som STAR vil jeg have flyttet forretningsområde temporær adresse til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper der er fastsat
- 5.5 1005.17.29.2 - Som serviceaftager og STAR vil jeg have udstillet temporær adresse via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service nu med tilføjelse af en ny metode
- 5.5.1.1 Løsningsmodel
- 5.5.2 Borgerkommunikation.MidlertidigAdresseService
- 5.5.2.1 Forretningsmæssige valideringer
- 5.5.2.2 Ny metode:
- 5.5.3 BorgerkommunikationStatusService
- 5.6 1005.17.29.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
- 5.6.1.1 Løsningsmodel
- 5.6.2 PersonTemporaryAddressService (Version 1)
- 5.7 1005.17.29.4 - Som STAR vil jeg have Initial load i forhold til nye forretningsdomæne (silo)
- 5.8 1005.17.29.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.9 1005.17.29.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.10 1005.17.29.7 - Borgerkommunikation udstiller kodelisterne for MidlertidigAdresse
- 5.10.1 Løsningsmodel
- 5.11 1005.17.29.8 - PersonStatusService (version 20) udstiller ikke mere oplysninger om midlertidig adresse stedet returneres en tom liste
- 5.11.1 PersonStatusService (Version 20)
- 5.11.1.1 GetVariablePersonStatus
- 5.11.1 PersonStatusService (Version 20)
- 5.12 1005.17.29.9 Borgerkommunikation modtager persondata ved håndtering af BorgerstamdataOpdateretEvent.
- 5.13 1005.17.29.10 - Død kode i DFDG, i forbindelse med forsørgelseshistorik, fjernes
- 5.14 1005.17.29.11 - Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i , i stedet for
- 5.15 1005.17.29.12 - WSRM og WSB på temporær adresse udsendes
- 5.16 Tjekliste modernisering DFDG:
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
Afgrænsning af epic
Afgrænsning | |||
|---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for MidlertidigAdresse (SavePersonTemporaryAddress) til REST som en del af STAR's moderniseringsprogram for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.17.29.1 | Som STAR vil jeg have flyttet forretningsområdet MidlertidigAdresse (TemporaryAddress) til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper, der er fastsat | PLAN, BI | |
1005.17.29.2 | Som serviceaftager og STAR vil jeg have udstillet MidlertidigAdresse via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service, med en ny metode, der er frivillig om man vil bruge. | PLAN, Jobnet classic | |
1005.17.29.3 | Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode indtil 2025-1 for at sikre en fleksibel overgang til ny snitflade | PLAN, Jobnet classic | |
1005.17.29.4 | Som STAR vil jeg have Initial load i forhold til nye forretningsdomæne (silo) | BI | |
1005.17.29.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | PLAN | |
1005.17.29.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | PLAN, SF | |
1005.17.29.7 | Borgerkommunikation udstiller kodelisterne for MidlertidigAdresse | PLAN |
|
1005.17.29.8 | PersonStatusService (version 20) udstiller fra 2025-1 ikke mere TemporaryResidence. I stedet returneres en tom liste | PLAN | |
1005.17.29.9 | Borgerkommunikation modtager persondata ved håndtering af BorgerstamdataOpdateretEvent. | PLAN | Ingen |
1005.17.29.10 | Død kode i DFDG, i forbindelse med MidlertidigAdresse, fjernes | PLAN | |
1005.17.29.11 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Borgerkommunikation, i stedet for TemporærAdresse servicen fra DFDG (classic) | PLAN | |
1005.17.29.12 | WSRM og WSB på temporær adresse udsendes | PLAN Jobnet classic |
|
Pakke TEMPADR-1 i DFDG Roadmap
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||
|---|---|---|---|---|
1005.17.29.2 | 1005.17.29.3 | 1005.17.29.12 | ||
Som KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | ||
Som bruger af PersonStatusService skal jeg senest i 2025-1 skifte til REST snitflade og kald til https://starwiki.atlassian.net/wiki/spaces/GI/pages/4172283905 for at hente Temporær addresse. |
| |||
KSS og a-kasse kan håndtere, at pegepinden til data om borger flyttes fra borgers gamle til borgers nye cpr nr. ved cpr.skift | X | X | A-kasser og jobcentre kan abonnere på (for tiden WSRM-beskeden) GetCprChanged, hvis der er behov for, at vide, hvornår DFDG flytter pegepinden til data om borger fra gammelt til nyt cpr nr. | |
KSS og a-kasse kan håndtere ny WSB. |
|
| X |
|
Oversigt over berørte webservices
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)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
Ny | Metoden udvides med en kollection for temporaryAddresser. Og ændring til udstilling af borgers kommune tilhørsforhold. | A-kasse, KSS | N/A | Plan | |
Udgået | Metoden udgår til fordel for version 3 | A-kasse, KSS | N/A | Plan | |
Borgerkommunikation.MidlertidigAdresseService (Version 1).GetMidlertidigAdresse | Ny | Ny metode til læsning af midlertidig adresse | A-kasse, KSS | Kontaktforløb | Plan |
Borgerkommunikation.MidlertidigAdresseService (Version 1).CreateMidlertidigAdresse | Ny | Ny metode til midlertidig adresse, som erstatter "SavePersonTemporaryAddress" | A-kasse, KSS | Kontaktforløb | Plan |
Ny | Ny WSB om borgers midlertidige adresse. Erstatter WSRM'en GetPersonTemporaryContactDataVersion1 | A-kasse, KSS | SF | Plan | |
Ændret | Elementet TemporaryResidence udgår i 2025-1 og vil herefter returnere tom altid | A-kasse, KSS | jobnet | Plan | |
PersonTemporaryAddressService (Version 1).SavePersonTemporaryAddress | Udgået | Metoden lukkes og erstattes af ny REST service "CreateMidlertidigAdresse". Bemærk gammel soap metode bevares i en overgangsperiode indtil 2025-1. | KSS | Kontaktforløb | Plan |
PersonTemporaryAddressService (Version 1, 2020-3).SavePersonTemporaryAddressCV | Udgået | Metoden lukkes og erstattes af ny REST service "CreateMidlertidigAdresse". Bemærk gammel soap metode bevares i en overgangsperiode. | N/A | Kontaktforløb, jobnet | Plan |
WsrmMessageService (version 10).GetPersonTemporaryContactDataVersion1 | Udgået | Udgår til fordel for ny WSB. WSRM'en kan anvendes i en overgangsperiode. | A-kasse, KSS | SF | Plan |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Beskrivelse af epic
Baggrund
Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.
Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til temporær adresse følgende:
I DFDG et skift til REST snitflade - og i denne epic med mindre forretningsmæssige ændringer i forhold til varighedsregler for max varighed på temporær adresse (indenlandsk og udenlandsk) på baggrund af ÆØ modtaget fra kommuner via KSS (S2405-624)
I Jobnet en overgang til ny REST snitflade samt ny frontend arkitektur (denne opgave er ikke en del af denne epic, men vil blive specificeret i en efterfølgende epic)
Ny mulighed for at hente historiske temporære adresser, men denne mulighed er frivillig for KSS og a-kasse.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Det er ingen nye indberetningsregler i denne epic.
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.
Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 2024-4) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.
Perioden kan dog ændres, hvis der efterfølgende kommer forretningsændringer til servicen. En sådan efterfølgende ændring af perioden, vil fremgå i epic med de nye forretningsændringer.
Den nye mulighed for at hente historiske temporære adresser er frivillig for KSS og a-kasse og der er i den forbindelse ikke påvirkning af de angivne release (2024-3 og 2024-4).
1005.17.29.1 - Som STAR vil jeg have flyttet forretningsområde temporær adresse til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i Borgerkommunikation
Excel ark med konverteringsregler til BI
Alt hvad der er i historik tabeller og fakt, skal merges til den nye fakt tabel
Den seneste indsatte række skal have isLatest = true, alle andre skal have false
Danske og udenlandske adresser skal samles i 1 tabel
Kontakt til BI på de kan gå igang med deres konvertering/ tjek deres US er klar
1005.17.29.2 - Som serviceaftager og STAR vil jeg have udstillet temporær adresse via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service nu med tilføjelse af en ny metode
Løsningsmodel
Ny REST service og getmetode i https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4249354244
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder
Service erstatter: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4098622516/PersonTemporaryAddressService+Version+1+2020-3#SavePersonTemporaryAddress
Ny metode: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4249387012#CreateMidlertidigAdresse-(POST-/v1/CreateMidlertidigAdresse)
Metode erstatter: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4098622516/PersonTemporaryAddressService+Version+1+2020-3#SavePersonTemporaryAddress
Denne metode benyttes til at gemme og opdatere midlertidig adresse på en borger.
Forretningsmæssige valideringer
Der er modtaget ønske om ændringer ift. varighedsbegrænsninger på midlertidig adresser. Det giver anledning til følgende ændringer:
Nuværende validering | Ændres til |
|---|---|
| [det valideres der vist ikke i praksis på] |
| uændret |
| uændret |
| uændret |
| uændret |
| uændret |
| uændret |
| uændret |
| uændret |
| uændret |
|
|
|