1005.17.29 Midlertidig adresse (Temporær adresse)

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
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

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?

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)

key po fa ux sme eksterne snitflader interne snitflader status labels
Loading...
Refresh

https://starwiki.atlassian.net/browse/DS-12142

https://starwiki.atlassian.net/browse/BI-2490

Rigtige link indsættes

Indholdsfortegnelse






Afgrænsning af epic

Afgrænsning

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

https://starwiki.atlassian.net/browse/KON-1429

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

https://starwiki.atlassian.net/browse/PLAN-3474

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


Ingen

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

https://starwiki.atlassian.net/browse/PLAN-4187

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

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.


X







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.
WSRM bevares i en overgangsperiode

 

 

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

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

Borgerkommunikation.BorgerkommunikationStatusService (Version 3).GetPersonKommunikationStatus (GET /v3/BorgerkommunikationStatus)

Ny

Metoden udvides med en kollection for temporaryAddresser. Og ændring til udstilling af borgers kommune tilhørsforhold.

A-kasse, KSS

N/A

Plan

Borgerkommunikation.BorgerkommunikationStatusService (Version 2).GetPersonKommunikationStatus (GET /v2/BorgerkommunikationStatus)

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

MidlertidigAdresse.WSB

Ny

Ny WSB om borgers midlertidige adresse. Erstatter WSRM'en GetPersonTemporaryContactDataVersion1

A-kasse, KSS

SF

Plan

PersonStatusService (Version 20).GetVariablePersonStatus

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

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Loading...
Refresh

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

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

Nuværende validering

Ændres til

  • Startdato må ikke være historisk.

[det valideres der vist ikke i praksis på]

  • Midlertidig adresse fjernes ved at sætte slutdato, dette gælder også ved fremtidige midlertidige adresser hvor slutdato skal sættes lig startdato.

uændret

  • Der kan kun findes en aktiv midlertidig adresse på en borger (uanset om den er dansk eller udenlandsk).

uændret

  • Hvis adressen er DK, skal “SlutDato” være angivet.

uændret

  • Hvis adressen ikke er DK, skal “LandeKode” være angivet.

uændret

  • Hvis adressen er DK, skal “PostNummer” bruge regex “[0-9]{4}”.

uændret

  • Hvis der er en eksisterende adresse med samme startdato skal den gamle forekomst slettes og en ny dannes.

uændret

  • Slutdato skal ligge efter startdato - fejlkode 4401 'The end date has to be greater than start date for a temporary address'

uændret

  • Slutdato skal være efter d.d. -  fejlkode 4402 ’The end date has to be greater than today for a temporary address

uændret

  • Start- og slutdato skal registreres -  fejlkode 4403 ’The start date and the end date has to be set for temporary address’

uændret

  • Max varighed 90 dage -  fejlkode 4376 ’The maximum duration of a temporary address is 90 days’

  • Ændres til max 180 dage - og afledt af dette en ny fejlkode

    • 600xx - ‘Maksimal varighed for midlertidig adresse er 180 dage’

  • Midlertidig udenlandsk adresse kan ikke registreres for borgere på kontanthjælpsområdet - fejlkode 4378 'Temporary foreign address can not be registered for persons with ClientCategory 2, 4, 6, 7, 8 and 9 (Kontanthælpsansøgere/modtagere, herunder efter integrationsprogram, and uddannelseshjælpsansøgere/modtagere'