666.2 Optimering af PHS - fase 2
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 17/12-2015)
Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
3.1 Fogbugzsager som løses
4 Beskrivelse af epic
4.1 666.2.1 Som Landssupport og kommunal sagsbehandler vil jeg gerne have adgang til historik på frister, bookninger og samtaler
4.2 666.2.2 Som del af beskæftigelsessamarbejdet vil jeg gerne have serviceunderstøttelse for data som i dag tilgås i AMPortal
4.3 Overblik over PHS collection-brug i LSS
4.3.1 PersonHistoryService GetPersonHistory
4.4 Generelle DFDG ændringer for understøttelse af historikken
4.4.1 Ændret registreringspraksis i DFDG for understøttelse af metadata
4.4.2 Funktionsbeskrivelse for understøttelse af historikudtræk
4.4.3 Initialisering
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
Ændringslog
Dato |
Version |
Forfatter |
Berørte afsnit |
23.11.2016 |
0.01 |
Jesper Brunholm |
Grundlagt epic med oplæg til acceptkriterier 666.2.1 og 666.2.2 |
25.11.2016 |
0.01 |
Jesper Brunholm |
Tilføjet afsnit 4.3 med overblik over nuværende PHS-brug i LSS. |
16.12.2016 |
0.1 |
Jesper Brunholm |
Resterne fra 666.1 flyttet til denne. Løftet til version 0.1 |
13.01.2016 |
0.1 |
Jesper Brunholm |
Foreløbig oprydning i usikkert indhold |
08.02.2017 |
0.5 |
Jesper Brunholm |
Løftet til 0.5. Snitflader justeret: der kommer ikke en serviceversion, så alt tilsagn er til orientering om den valgte arkitektur. |
22.03.2017 |
1.0 |
Jesper Brunholm |
Løftet til 1.0 |
Afgrænsning af epic
Afgrænsning |
|
|
|
Som sagsbehandler i Landssupporten, KS Systemer eller A-kasser vil jeg have en opdateret historikservice med historik på centrale datadomæner på beskæftigelsesområdet.For at have et fuldt grundlag at lave sagsbehandling på. |
|
|
|
Acceptkriterier |
|
|
|
Nr. |
Beskrivelse |
Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie |
|
666.2.1 |
Som Landssupport og kommunal sagsbehandler vil jeg gerne have adgang til historik på frister, bookninger og samtaler |
DFDG, LSS |
|
666.2.2 |
Som del af beskæftigelsessamarbejdet vil jeg gerne have serviceunderstøttelse for data som i dag tilgås i AMPortal |
DFDG, LSS |
|
666.2.3 |
Som supporter i landssupporten vil jeg i LSS gerne kunne se en historik for borgerens historiske adresser, for at jeg kan genskabe forløb ifm. sagsudredningerOBS husk historik på borgere, der har flyttet jobcenter |
DFDG |
|
666.2.4 |
Som supporter i landssupporten vil jeg i LSS gerne kunne se
|
DFDG, LSS |
|
666.2.5 |
Som supporter i landssupporten vil jeg i LSS gerne kunne se historik på mødedeltagerfravalg i LSS, for at jeg kan udrede sager hvor en part (borger eller a-kasse) tidligere har fravalgt deltagelse |
DFDG |
|
666.2.6 |
Som i landssupporten vil jeg i LSS gerne kunne se historik på aftalefeltet for afholdte samtaler |
DFDG |
|
|
|
|
|
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader |
Berørte acceptkriterier |
|
|
|
|
|
|
Bemærkninger |
|
|
|
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Oversigt over berørte web services
Snitflade |
Serviceaftager der er berørt |
|
|
|
|
|
|
|
Bemærkninger |
|
|
|
DFDG |
Jobnet |
Plannersystemer |
KSS |
A-kasse |
Ydelsessystem |
JobKon |
Andet |
|
|
|
PersonHistoryService (Version 4) |
X |
|
|
t.o. |
t.o. |
|
|
|
|
Der kommer ikke en serviceversion ud i 2017-2 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Fogbugzsager som løses
LJU: Vi har en række Fogbugz, vi gerne vil have løst som en del af denne epic
Nedenstående liste er fra en gl. LB 413 (med LSS ønsker) som vi aldrig er nået til:
FB |
Titel |
Prio |
Note |
Status 21.09.2016 |
---|---|---|---|---|
Historik på opholdsadresse |
2 |
Historik findes i DFDG, men det skal udstilles over en web service |
Pia har 24.02.2016 oplyst at ønsket fortsat er aktuelt |
|
Sluthistorik på bevillinger |
3 |
Historik findes i DFDG, men det skal udstilles over en web service |
Fortsat relevant 19/9 2016, Pia Poulsen |
|
Historik på fremtidige afmeldinger og bekræftelse af tilmelding i LSS |
2 |
2 story points |
Med i epic 666.1 (PHS optimering). |
Beskrivelse af epic
Denne epic til denne ISB: 666 ISB Optimering af PHS PersonHistoryService
Der laves en ny version af PersonHistoryService, version 4. Denne laves fra grunden, med nye collections og ny datastruktur. For et givent objekt vil alle objektets "tilstands-snapshots" som de på et tidspunkt undervejs har kunnet ses i PersonStatusService være udstillet i en fortløbende række med metadata.
Det kan illustreres som følger:
Blokkene til venstre er objekter i en collection, hvor A, B og C er hver sit objekt med repræsentationer for forskellige tidspunkter. Det nederste objekt er "sluttilstanden" som vil være synlig i PersonStatus-Service – med undtagelse af B objektet som er blevet slettet.
Hver blok repræsenterer således et snapshot for hvilket, der i PHS vil være et objekt med tilhørende metadata om, hvem der har lavet ændringen hvornår m.v.
De nye collections vil blive baseret på PersonStatusService collections.
Strukturen med snapshots gør det billigere at vedligeholde og udvikle servicen.
Der har været drøftet en servicemodel hvor man GUID-baseret kan hente historik for et objekt. Dette er uhensigtsmæssigt ift. flere aftagere af servicen, og fordyrende for udviklingen, og skrinlægges derfor.
Der laves af hensyn til brugsperformance en begrænsning så man som ekstern aftager kun kan hente 1 collection ad gangen.
A-kasser har kun adgang til servicens collections i samme omfang som de har til de tilsvarende collections med eventuelle filtreringer som de har adgang til i PSS (jf. bl.a. epic 738.1).
Servicen må kun kaldes af jobcentre (og AA som jobcenter), kommuner, a-kasser og STAR.
666.2.1 Som Landssupport og kommunal sagsbehandler vil jeg gerne have adgang til historik på frister, bookninger og samtaler
666.2.2 Som del af beskæftigelsessamarbejdet vil jeg gerne have serviceunderstøttelse for data som i dag tilgås i AMPortal
Dette for at understøtte nedlukning af AMPortalen
Overblik over PHS collection-brug i LSS
Bruttoliste over PHS input parametre ift. collections |
Anvendes i LSS |
JobcenterHistory |
X |
UnemploymentFundHistory |
X |
EnrollmentHistory |
X |
ConfirmActiveJobSeekingHistory |
X |
ConfirmActiveJobSeekingWarningHistory |
X |
CvStatusHistory |
X |
SocialAidHistory |
X |
IllnessBenefitHistory |
|
ContactGroupHistory |
X |
AbsenceHistory |
X |
HealthLimitationHistory |
X |
PersonGroupMarkingHistory |
X |
RunHistory |
X |
BookingHistory |
X |
PersonInterviewHistory |
|
ActivitySupplementHistory |
X |
CvInterviewHistory |
|
CivicConsentHistory |
X |
CommentHistory |
X |
PersonHistoryService GetPersonHistory
En "TASS" gruppe: Enrollment, SocialAid, Absence, ContactGroup og PersonComment
En samling af PHS collectioner som lægger sig op ad PSS-collectionen "TASS": EnrollmentCollection, SocialAidCollection, AbsenceCollection, ContactGroupCollection, PersonCommentCollection.
Dertil: en længe ventet opdatering af historik på a-kassemedlemsskab.
Der medtages alle objekter i collectionerne (også de som ikke endnu kategoriseres som historiske).
PersonHistoryService (Version 4) GetPersonHistoryRequest
Navn |
Type |
Detaljer |
PersonCivilRegistrationIdentifier |
Borgers personnummer. Forekomst: 1 |
|
RequestHistory |
RequestHistoryType |
Liste af variable, der benyttes til at styre, hvilken personhistorik der ønskes |
RequestHistoryType
Navn |
Type |
Detaljer |
AbsenceHistory |
boolean |
Hent fraværshistorik Forekomst: 0-1 |
ContactGroupHistory |
boolean |
kontaktgruppehistorik Forekomst: 0-1 |
EnrollmentHistory |
boolean |
Hent tilmeldehistorik Forekomst: 0-1 |
PersonCommentHistory |
boolean |
Hent kommentarhistorik Forekomst: 0-1 |
SocialAidHistory |
boolean |
Hent kontanthjælps bevillingshistorik Forekomst: 0-1 |
UnemploymentFundHistory |
boolean |
Hent historik for a-kassemedlemsskab |
|
|
|
Bemærk at af hensyn til dokumentationens overskuelighed skal collections sorteres alfabetisk i WSDL. Collections som ikke er til rådighed i output vil enten have forekomst 0 eller ikke være medtaget i WSDL'en (de er lagt i WSDL i et tidligt stadie af udviklingen hvor man forventede at kunne tage mere med i release 2017-1)
PersonHistoryService GetPersonHistoryResponse
Navn |
Type |
Detaljer |
PersonCivilRegistrationIdentifier |
PersonCivilRegistrationIdentifierType |
Borgers personnummer. Forekomst: 1 |
AbsenceHistory |
AbsenceHistoryCollection |
Fraværshistorik Forekomst: 0-1 |
ContactGroupHistory |
¤¤ |
Kontaktgruppehistorik Forekomst: 0-1 |
EnrollmentHistoryCollection |
¤¤ |
Tilmeldehistorik Forekomst: 0-1 |
PersonCommentHistory |
¤¤ |
Kommentarhistorik Forekomst: 0-1 |
SocialAidHistoryCollection |
|
Kontanthjælps bevillingshistorik Forekomst: 0-1 |
UnemploymentFundHistory |
|
A-kassemedlemsskab |
|
|
|
|
|
|
|
|
|
Rækker med gråt forventes medtaget i release 2017-2. Bemærk at af hensyn til dokumentationens overskuelighed skal collections sorteres alfabetisk i WSDL.
AbsenceHistoryCollection
Navn |
Type |
Detaljer |
Forekomst |
Beskrivelse |
AbsenceHistoryCollection |
AbsenceHistoryCollection |
|
1 |
Collection med alle absenceobjekter |
AbsenceIdentifier |
GUID |
|
1 |
|
- AbsenceEntryCollection |
AbsenceEntryCollectionType |
|
|
|
StartDateTime |
dateTime |
|
1 |
|
EndDateTime |
dateTime |
|
0 - 1 |
|
AbsenceTypeIdentifier |
MaxInclusive: 10000000 |
1 |
|
|
AbsenceComment |
AbsenceCommentType Base: string |
Length: 0 - 1500 |
0 - 1 |
|
NotificationDateTime |
dateTime |
|
1 |
|
IsActiveAbsence |
boolean |
|
1 |
|
AbsenceCauseTypeIdentifier |
MaxInclusive: 10000000 |
0 - 1 |
|
|
- - CorrectionComment |
CorrectionCommentType Base: string |
Length: 0 - 1500 |
0 - 1 |
|
NemRefusionIdentifier |
guid Base: string |
|
0 - 1 |
Identifikation af om der er abonnement på sygemelding fra ydelse. |
CurrentUnemploymentStatusTypeIdentifier |
MaxInclusive: 10000 |
0 - 1 |
|
|
CompanyIdentifier |
CompanyIdentifierType |
|
0 - 1 |
|
- ProductionUnitIdentifier |
ProductionUnitIdentifierType Base: string |
|
0 - 1 |
|
- CVRnumberIdentifier |
CVRnumberIdentifierType Base: string |
|
1 |
|
- AdditionalInformationOnAbsenceTypeCollection |
AdditionalInformationOnAbsenceTypeCollectionType |
|
0 - 1 |
|
- AdditionalInformationOnAbsence |
AdditionalInformationOnAbsenceType |
|
0 - * |
|
- MessageIdentifier |
guid Base: string |
Pattern: [0-9a-fA-F]{8}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{4}[0-9a-fA-F]{12} |
1 |
|
- AdditionalInformationOnAbsenceTypeIdentifier |
MaxInclusive: 10000 |
1 |
|
|
- StartDateTime |
dateTime |
|
1 |
|
EndDateTime |
dateTime |
|
0 - 1 |
|
RegistrationDate |
dateTime |
|
1 |
|
CorrectionComment |
CorrectionCommentType Base: string |
Length: 0 - 1500 |
0 - 1 |
|
RegistrationMetadata |
RegistrationMetadataType |
|
1 |
|
UnemploymentFundHistory
Skal bl.a. understøtte visning af tilbagekaldt A-kassemedlemskab på LSS.
Collectionen der returneres fra PHS skal udvides med boolean feltet "IsRecalled"
Navn |
Type |
Detaljer |
Forekomst |
Beskrivelse |
UnemploymentFundCollection |
UnemploymentFundCollection |
|
1 |
Collection med alle absenceobjekter |
UnemploymentFund |
UnemploymentFund |
|
0-* |
|
UnemploymentFundCode |
Integer, 0-99 |
|
1 |
Kode for A-kasse |
UnemploymentFundName |
String |
|
1 |
Navn på A-kasse |
UnemploymentFundBranchCode |
Integer, 0-999999 |
|
1 |
Kode for afdeling, inkl. A-kasse kode |
UnemploymentFundBranchName |
string |
|
1 |
Navn på afdeling |
UnemploymentInsuranceCategoryTypeIdentifier |
|
1 |
Ledighedsgrad |
|
UnemploymentFundMembershipRegistrationDate |
DateTime |
|
1 |
Dato og tid for start af medlemskab |
UnemploymentFundMembershipCancellationDate |
DateTime |
|
0-1 |
Dato og tid for afmelding |
UnemploymentFundMembershipCancellationCodeTypeIdentifier |
|
0-1 |
Afmeldingsårsag |
|
IsRecalled |
Boolean |
|
1 |
Er medlemskab tilbagekaldt |
Yderligere skal feltet "IsRecalled" inkluderes i fra tabellen "tblUnemploymentFundMembershipArchive" i changeloggen.
RegistrationMetadataType
IsDeleted og samme indhold som RequestUserMetadataType
Navn |
Type |
Detaljer |
Forekomst |
Beskrivelse |
IsDeleted |
Boolean |
|
1 |
Angiver om registreringen er sletning |
RequestUserStructure |
RequestUserStructureType |
|
1 |
Struktur der indeholder beskrivelse af brugeren |
UserFullName |
UserFullNameType |
Length: 1-140 |
1 |
Brugers fulde navn, ved systemkald angives systemets og jobbets navn her. |
RequestUserTypeIdentifier |
RequestUserTypeIdentifierType |
|
1 |
Kodeliste med brugertyperne:
|
UserIdentifier |
UserIdentifierType |
Length: 1-255 |
1 |
Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l.
|
UserEmail |
EmailAddressIdentifierType |
Length: 2-256 |
0-1 |
Brugerens e-mail adresse |
RequestOrganisationStructure |
RequestOrganisationStructureType |
|
1 |
Information om den organisation som kaldet foretages på vegne af. |
OrganisationTypeIdentifier |
OrganisationTypeIdentifierType |
|
1 |
Kodeliste. Identificerer den type af organisations som brugeren hører til. Dette er en kodeliste, dog som integer af historiske årsager. |
OrganisationCode |
String |
|
1 |
Koden som identificerer organisationen. Det kan være et Jobcenternummer, CVR nummer, en a-kassekode eller en kommunekode. |
RegistrationDateTime |
DateTime |
|
1 |
Registreringstidspunkt i kaldende system |
MeetingParticipationHistoryCollection
Denne collection indeholder en historik for indberetninger af deltagelsvalg. Eftersom man ikke kan rette i en eksisterende indberetning, men kun lave en ny indberetning er der ikke brug for en changelog for denne slags indberetninger.
Navn |
Type |
Detaljer |
Forekomst |
Beskrivelse |
MeetingParticipationHistoryCollection |
MeetingParticipationHistoryCollection |
|
1 |
Collection med alle meeting particitipation objekter |
|
MeetingPartticipation |
|
0-* |
|
|
GUID |
|
1 |
Guid for the entry |
|
CVRnumberIdentifierTypeBase: string |
|
1 |
|
|
Integer |
|
1 |
AuthorityType for hvem samtalen er med |
|
Integer |
|
1 |
AuthorityCode for hvem samtalen er med |
|
MeetingParticipationChoiceTypeIdentifier Base: Integer |
|
1 |
Borgers eller A-kasses valg |
|
Boolean |
|
1 |
Deltager eller ej |
|
DateTime |
|
1 |
Tidspunkt hvor valget gælder fra |
|
Integer |
|
1 |
Authoritytypeid for indberetningen |
|
Integer |
|
1 |
Authoritytypecode for indberetningen |
|
DateTime |
|
1 |
Timestamp for indberetningen |
Generelle DFDG ændringer for understøttelse af historikken
Ændret registreringspraksis i DFDG for understøttelse af metadata
På datadomæner hvor der ikke er skiftet til brug af DFDGUser i forbindelse med overgang til ny sikkerhedsmodel skiftes der til at bruge DFDGUser på det primære registreringsflow (fx den direkte registreringsservice). Batchjobs og øvrige services som benytter sig af de services hvor der rettes (indirekte brug) vil ikke blive rettede til at bruge DFDGUser (da vi så hurtigt når til at skulle rette i hele DFDG), men vil i stedet kalde med en inkomplet DFDGUser baseret på den CaseWorker der er til rådighed.
Forskellen på CaseWorker og DFDGUser:
¤¤¤
Funktionsbeskrivelse for understøttelse af historikudtræk
Ved opdatering af en entry til et givet dataområde (dvs. der foreligger en entry med samme GUID) føres det nuværende indhold til historiktabel incl. RequestUserMetadata.
Hvis opdateringen er en sletning føres både den eksisterende række og den nye række i historiktabel, idet der sættes IsDeleted markering på opdateringen som sletter.
Ved udtræk af historik trækkes der både fra aktuel tabel og fra historisk, så man har et komplet billede af en given GUIDs forløb.
Initialisering
En del collections har i dag slettemarkering liggende på den seneste opdaterede række. Her skal der – for at sikre mulighed for ensartet udtræk – flyttes data til at der oprettes en ny række med metadata fra agerende user for sletningen.
Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:
- DFDG
- Services
- WSRMer
- Kodelister
- Jobnet
- VITAS
- JobKon
- JobAG
- BI integrationsplatform
- Kommunalt sagsbehandlingssystem
- A-kasse sagsbehandlingssystem
- Kommunalt bookingsystem
- Planner
- Kommunalt ydelsessystem
- LSS (Landssupportsystem)
Særlige krav til test
Testscenarie |
Berørte systemområder |
Identificeret af |
|
|
|
|
|
|
Kendte udeståender fra udviklingsfasen
Link til søgeresultat fra FogBugz på epic-nummer:
User stories
User stories er kun til interne brug for STAR's leverandører.