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

Interne links (indhold ikke relevant for eksterne)

BI-967 - Getting issue details... STATUS

DS-3553 - Getting issue details... STATUS

JOB-2160 - Getting issue details... STATUS

VIR-1594 - Getting issue details... STATUS

Indholdsfortegnelse

Afgrænsning af epic

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.

Automatisk oversigt

Ikke synlig for eksterne. Indhold er kopieret til den manuelle oversigt ovenfor.

Beskrivelse af epic

Beskrivelse til KSS og a-kasser

Stillingsbetegnelser fra ESCO STAR information til KSS, A-kasser og andre interessenter

Stillingsbetegnelser fra ESCO STAR information til KSS og a-kasser og andre interessenter

Som en del af denne epic og grundlaget for de nye ESCO STAR stillingsbetengelser anvendes servicen og metoder der udstilller selve taxonomien for ESCO STAR.

For en mere detaljeret oversigt over disse service og metoder henvises til:

Taxonomy.EscoStarService (2021-1)

Der indeholder ESCO STAR stilllingsbetegnelser og alias på metoderne:

• GetOccupation (GET /v1/EscoStar/occupations/{conceptUri})

• GetOccupations (GET /v1/EscoStar/occupations)

Der indeholder mapningen fra de gamle DiscoAMS stillingsbetegnelser  til de nye ESCO STAR stillingsbetegnelser i metoderne:

• GetDiscoAms08ConceptUriMapping (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings/{discoAms08Id})

• GetDiscoAms08ConceptUriMappings (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings)

Stillingstagen for, hvorvidt stillingsbetegnelsen kan benyttes

• Hvis stillingsbetegnelse har en IscoGroup defineret er det en stillingsbetegnelse.

  • Til information: Stillingsbetegnelser i hierarkiet er i niveau fem eller under.

• Hvis stillingsbetegnelse er Aktiv og validFrom og validTo, er indenfor tidspunktet registreringen omhandler, kan denne benyttes.

Taxonomy.CodeListsService

De kodelister og deres værdi der anvendes i forbindelse med ESCO STAR kan findes under Taxonomy.CodeListsService

Det skal bemærkes at der i forbindelse med releasen til 2021-2 sker en forretningsmæssig opdatering og:

• Taksonomien tilrettes uden ændringer af grænseflader.

• Nye, fravalgte og ændrede stillingsbetegnelser.

• Nye, fravalgte og ændrede aliaser.  

976.14.1 Min Plan data (Jeg skal søge job som, flaskehals, stilling på virksomhedsrettet aktivitet, jobmål, mål på aktiviteter) er konverterede fra DISCOAMS til ESCO-STAR med konverteringstabel

DiscoAMS stillingsbetegnelser konverteres i DFDG forhold data i aktiviteter og plan. Bemærk i DFDG indeholder Min plan ikke DiscoAMS data i de fysiske tabeller. Min plan sniffladen udstiller dog fra aktiviteter og plan, men de konverteres i aktiviteter og plan.

Hvis en ekstern serviceaftager (KSS eller a-kasse) har lokale data omkring aktiviteter og plan, er det serviceaftager, der selv skal foretage konvertering af egne data. Konvertering skal benytte metoden GetDiscoAms08ConceptUriMapping (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings/{discoAms08Id}).

Konvertering af eksisterende data i Min plan

Aktiviteter 

Her sker en konvertering direkte fra DiscoAMS til ESCOSTAR.

Mål på plan

Mål i planen ligger som en collection derfor udvides denne collection til også at indeholde mål af ESCO typen, dette sker via en ny værdi 5 i GoalCodeTypeIdentifier. Konverteringsmæssigt betyder det, at der laves en ny række, der indeholder ESCOSTAR ud fra den eksisterende DiscoAMS og begge rækker vil forfindes i data.

976.14.2 - Webservices (Jeg skal søge job som, flaskehals, stilling på virksomhedsrettet aktivitet, jobmål, mål på aktiviteter) understøtter ESCOSTAR inkl. alias i stedet for DISCOAMS

Løsningsmodel

De eksisterende DiscoAMS kode erstattes med ESCOSTAR koder og eksisterende koder konverteres. I det omfang KSS eller a-kasser har aktiviteter eller Min plan data replikleret i deres lokalt fagsystemer, fortager KSS og a-kasse en konvertering lokalt i fagsystemet  

De oprindelige DiscoAMS koder bevares i DFDG's historik af hensyn til revision og datahistorik. De oprindelige DiscoAMS koder vil dog ikke være tilgængelige i snitflader m.v.

se Løsningsmodel for at tilføje ESCO STAR til DFDG database model og snitflader

Note omkring alias 

Vigtigt for KSS og a-kasser

I forbindelse med at borger i dag kan anvende DiscoAMS synonymer (alias) i "Jeg søger job som" på Jobnet og dette videreføres i forhold til ESCOSTAR, hvor der også kan vælge alias. Det nye er nu, at DFDG udstiller borgers valg inkl. alias og også andre stedet tillader sagsbehandler at anvende alias og præsenterer dette valg på Jobnet. For KSS og a-kasser er alias derfor nyt både som begreb og i de fysiske snitflader.

Det generelle forhold med en ESCOSTAR stillingsbetegnelser og alias er at aliaset er et synonym for en stillingsbetegnelse og det vil altid være optionelt at angive et alias.

I forbindelse med Min plan udvides Min plan jobmål også med alias, således at borger på Jobnet vil kunne genkende strukturen fra det borger har angivet i "Jeg søger job som". Ligeledes udvides krav til jobsøgning, så sagsbehandler også her vil kunne anvende alias. Hermed sikres at der bliver sammenhæng mellem hvordan "Jeg søger job som", Min plan jobmål og krav til jobsøgning præsenteres for borger og sagsbehandler.

I forhold til aktiviteter, vil mål på den enkelte aktivitet arve mål for Min plans jobmål og derfor er det mulig også her at angive alias.

Da et alias forretningsmæssigt altid er optionelt, vil der ikke være et krav om at sagsbehandler anvender alias i forhold til Min plan jobmål, mål på aktiviteter og i krav til jobsøgning, men det vil være en fordel for borger, at der er en sammenhæng.

Skulle en a-kasse eller KSS fravælge at anvende alias f.eks. i regi af Min plan, skal a-kassen eller KSS håndterer, at de får borger fra et andet system - f.eks. i forbindelse med flytning - der kan indeholde alias. Denne håndtering kan godt foregå ved, at man ikke viderefør et alias og dermed fjerner dette ved opdatering. 

ActivityService (Version 3)

Udgår i 2021-3 til fordel for ny version 6. Det er ikke muligt at blive på version 3 efter 2021-3.

ActivityService (Version 4)

Udgår i 2021-3 til fordel for ny version 6. Det er ikke muligt at blive på version 4 efter 2021-3.

ActivityService (Version 5)

Udgår i 2021-3 til fordel for ny version 6. Det er ikke muligt at blive på version 5 efter 2021-3.

ActivityService (Version 6)

Version 6 afløser alle tidligere versioner. 

Version 6 må først anvendes i produktion fra release 2021-3 - og må kun anvendes i testmiljøer indtil da.

For ændringer til snitflade se ActivityService (Version 6). Ændringer er farvemarkeret med lysegrøn og lyserød.

CreateActivity, UpdateActivity og GetActivity

• Flaskehalsangivelse (BottleneckSector): Udgår og feltet fjernes.
  De eksisterende Discokoder for flaskehals bliver i database som DiscoAMS koder af hensyn til historik. Data vil dog ikke kunne tilgås via webservicesnitflader.
• ActivationTypeIdentifier: Udgår og feltet fjernes.
  Databasefelt beholdes af hensyn til historik. Data vil dog ikke kunne tilgås via webservicesnitflader.
• Beskæftigelsesmål i forbindelse med virksomhedsrettet aktivitet skiftes fra DiscoAMS (gammelt felt DiscoWeb) til ESCO STAR (nyt felt EmploymentGoalConceptUriDa) og der indføres alias (nyt optiomelt felt EmploymentGoalAliasIdentifier)
• Fejlkode-tekster opdateres (bl.a. 9145, 9356)

GetActivities og GetSubsidyJob

• De mål, der er knyttet til en aktivitet (GoalCode), kan fremadrettet være ESCOSTAR, AMU, DUN eller fritekst. Dvs. ESCOSTAR kode erstatter de oprindelige DiscoAMS koder. 
• Det er kodelisten GoalCodeTypeIdentifierType, der bestemmer typen af mål, rettes til således, at Id 1 fremadrettet repræsenterer ESCOSTAR stillingsbetegnelser i stedet for DiscoAMS stillingesbetegnelser.
• Der laves en ny kodelisteværdi, selvom begge dele er stillingsbetegnelser (forretningsmæssigt genbruges kodelisteværdien ikke). 
• Som en del af det mål, der er knyttet til aktiviteten (GoalCode), kan der (optionelt) fremadrettet også sættes et alias (AliasIdentifier), hvis typen er ESCOSTAR.

GetCompanyActivitySummaries

• Beskæftigelsesmål i forbindelse med virksomhedsrettet aktivitet skiftes fra DiscoAMS (gammelt felt DiscoAms08) til ESCOSTAR (nyt felt EmploymentGoalConceptUriDa) og et alias-felt (EmploymentGoalAliasIdentifier).

PlanService (Version 4)

Udgår i 2021-3 til fordel for ny version 5. Det er ikke muligt at blive på version 4 efter 2021-3.

PlanService (Version 5)

For oversigt over hvilke niveauer af stillingsbetegnelser, der må anvendes i forhold til jobmål på Min plan: Se Kontaktgrupper og mål i forhold til plantyper.

CreateDraftPlan, GetActivePlan, GetDraftPlan, GetPlan, SavePlanObjective

• Mht. jobmål/uddannelses mål i borgers Min plan (i GoalCollection i PlanService) skiftes fra DiscoAMS (i feltet GoalCode) til ESCO STAR (stadig i felt GoalCode)
• Det er kodelisten GoalCodeTypeIdentifierType, der bestemmer hvilken type af mål rettes til således, at Id 5 fremadrette repræsenterer ESCO STAR stillingsbetegnelser i stedet for DiscoAMS stillingesbetegnelser.
• Som en del af det mål, der er knyttet til aktiviteten (GoalCode), kan der fremadrettet også sættes et alias (AliasIdentifier) hvis typen er ESCO STAR.
• Mht. jobmål/uddannelsesmål i borgers Min plan (i GoalCollection i PlanService) indføres alias således, at der kan være en ensartet sammenhæng mellem "Jeg søger job som",  Jobmål i Min plan og Krav til jobsøgning.
• Tekst på fejlkoder opdateres (bl.a. 8061, 9368, 9369, 9371, 9372)

PublishPlan

• Enkelt validering rettes, således der valideres for at i en jobplan er de mål der angives ESCO STAR stillingsbetegnelser (Den eksisterende validering er mod DiscoAMS stillingsbetegnelser)
• Tekst på fejlkoder opdateres (bl.a. 8061)

MyPlanService (Version 4) 

Udgår i 2021-3 til fordel for ny version 6. Det er ikke muligt at blive på version 4 efter 2021-3.

MyPlanService (Version 5)

Udgår i 2021-3 til fordel for ny version 6. Det er ikke muligt at blive på version 5 efter 2021-3.

MyPlanService (Version 6)

Skal anvendes i produktion fra release 2021-3. Må indtil da alene anvendes i testmiljøer.

GetCitizenDraftMyPlan, GetLegalMyPlan, GetMyPlan

• Jobmål (GoalCollection.GoalType) vil indeholde ESCOSTAR i stedet for DiscoAMS.
  • Som en del af det mål,der er knyttet til aktiviteten (GoalCode), kan der fremadrettet også være sat et alias (AliasIdentifier), hvis typen er ESCOSTAR.
• Mål i forbindelse med aktivitet (GoalCode og GoalCodeTypeIdentifier) vil indeholde ESCOSTAR i stedet for DiscoAMS.
  • Som en del af det mål, der er knyttet til aktiviteten (GoalCode), kan der fremadrettet også være sat et alias (AliasIdentifier), hvis typen er ESCOSTAR.
• Krav til jobsøgning (TradeForJobSearch) vil indeholde ESCOSTAR i stedet for DiscoAMS, DiscoAMS08Collection udgår og i stedet kommer TradeForJobSearchCollection.
• OtherExpectationsForJobSearch længde øges til 5000 tegn.

GetLegalMyPlanWithDetails

• Jobmål (GoalCollection.GoalType) vil indeholde ESCOSTAR i stedet for DiscoAMS.
  • Som en del af det mål, der er knyttet til aktiviteten (GoalCode), kan der fremadrettet også være sat et alias (AliasIdentifier), hvis typen er ESCOSTAR.
• Mål i forbindelse med aktivitet (GoalCode og GoalCodeTypeIdentifier) vil indeholde ESCOSTAR i stedet for DiscoAMS.
  • Som en del af det mål, der er knyttet til aktiviteten (GoalCode), kan der fremadrettet også være sat et alias (AliasIdentifier), hvis typen er ESCOSTAR.
• Krav til jobsøgning (TradeForJobSearch) vil indeholde ESCOSTAR i stedet for DiscoAMS, DiscoAMS08Collection udgår og istedet kommer TradeForJobSearchCollection.
• Flaskehalsangivelse (BottleneckSector) udgår - og feltet fjernes (fra ActivityCoreItem).
• For virksomhedsrettet aktiviteter ændres stillingsbetegnelsen til ESCOSTAR.
• For CompanyActivity erstattes DiscoWeb med EmploymentGoalConceptUriDa og der kan være sat et alias (EmploymentGoalAliasIdentifier)

WsrmMessageService (Version 10)

GetActivityGenerelEventVersion1 og GetActivitySpecialEventVersion1

Disse besked-versioner udgår i 2021-3 til fordel for ny version3 af beskederne på WsrmMessageService (version 11). 

WsrmMessageService (Version 11)

GetActivityGenerelEventVersion2 og GetActivitySpecialEventVersion2

Disse besked-versioner udgår i 2021-3 til fordel for ny version3 af beskederne på WsrmMessageService (version 11). 

GetActivityGeneralEventVersion3 og GetActivitySpecialEventVersion3

Ændringer fremgår på siden GetActivitySpecielEventVersion3 [udv] og GetActivityGeneralEventVersion3 [udv]

GetActivityGeneralEventVersion3

Ændringer i forhold til versionen GetActivityGenerelEventVersion2 af beskeden:

• BottleneckSector udgår af ActivityCoreItem.
• ActivationTypeIdentifier udgår af ActivityCoreItem.
• MinisterialDepartmentTypeIdentifier i CompanyActivity udgår.
• DiscoWeb i CompanyActivity udgår og der tilføjes i stedet EmploymentGoalConceptUriDa og der kan også være sat et alias (EmploymentGoalAliasIdentifier).
• "JobTypeIdentifier"  i CompanyActivity ændres til "JobOrderTypeIdentifier" således, at navngivningen svarer til indholdet i feltet.

GetActivitySpecialEventVersion3

Ændringer i forhold til version 2 af beskeden:

• BottleneckSector udgår af ActivityCoreItem.
• ActivationTypeIdentifier udgår af ActivityCoreItem.
• MinisterialDepartmentTypeIdentifier i CompanyActivity udgår.
• DiscoWeb i CompanyActivity udgår og der tilføjes i stedet EmploymentGoalConceptUriDa og der kan også være sat et alias (EmploymentGoalAliasIdentifier).
• "JobTypeIdentifier"  i CompanyActivity ændres til "JobOrderTypeIdentifier" således, at navngivningen svarer til indholdet i feltet.

Codelists (Version 5)

GoalCodeTypeIdentifier

Ny kodelisteværdi for ESCO STAR.

976.14.5 Som a-kasse vil jeg kunne sende udkast til Min plan med ESCOSTAR stillingsbetegnelser i stedet for DiscoAMS

I forbindelse med at a-kassen sender "Udkast til Min plan" til jobcentret via CitizenMessageService opdateres XML-filen, der anvendes til at indeholde ESCOSTAR stillingsbetegnelser til Jobmål i stedet for DiscoAMS.

Det er STAR, der udarbejder den nye version af XML'en og publicerer denne på wiki.

Link til XML fil (kommer senere XXX)

976.14.8 Vitas ansøgningsdata er konverterede fra DISCOAMS til ESCOSTAR med konverteringstabel

Internt acceptkriterie i VITAS.

Alle VITAS databasetabeller, som indeholder DISCO-AMS koder (FkDiscoCode) får tilføjet en kolonne med ESCO-STAR kode (conceptUriDa). VITAS omlægges efter en-til-en modellen, dvs. alias lagres ikke i VITAS. DISCO-AMS koder er ikke længere obligatorisk., mens ESCO-STAR koder er obligatoriske, hvor DISCO-AMS koder hidtil har været det.

Eksisterende ansøgninger, bevillinger mv. i VITAS konverteres fra DISCOAMS til ESCO-STAR med konverteringstabel. Det betyder, at eksisterende ansøgninger, bevillinger mv. kan og ofte vil ændre titel på stillingsbetegnelserne til nye, tilsvarende stillingsbetegnelser i ESCO-STAR klassifikationen. Virksomheder og jobcentre vil opleve, at ansøgninger, bevillinger mv., bevillinger mv.ændres uden at virksomhederne eller jobcentre aktivt har redigeret ansøgninger, bevillinger mv..

De eksisterende DISCOAMS koder beholdes på eksisterende ansøgninger, bevillinger mv. af hensyn til historik, men udstilles ikke længere i VITAS' brugergrænseflade, webservices eller WSRM'er. Dvs. virksomheder, jobcentre mv. kan ikke se de oprindelige stillingsbetegnelser.

Bjarne Hansen (Edora)

976.14.9 Vitas brugergrænseflade er tilpasset til at vælge ESCOSTAR stillingsbetegnelser. Alias anvendes kun til at fremsøge stillingsbetegnelse

Internt acceptkriterie i VITAS.

Alle inputfelter og visningsfelter i VITAS, som bruges til at vælge eller vise stillingsbetegnelser er omlagt fra DISCO-AMS til ESCO-STAR. Brugerne kan indtaste stillingsbetegnelse med type-ahead med stillingsbetegnelser og alias fra ESCO-STAR. Type-ahead viser matchende stillingsbetegnelser og alias i følgende format: <stillingsbetegnelse> (<alias>). Dvs. samme princip, som allerede er implementeret i JobAG. VITAS anvender kun alias til at hjælpe brugerne med at finde stillingsbetegnelse, men lagrer ikke alias og viser dermed heller ikke alias, når ansøgning, bevilling mv. indlæses.

Bjarne Hansen (Edora)

976.14.10 Vitas Servicesnitflader er tilpasset til at udstille ESCOSTAR stillingsbetegnelser

De nuværende versioner af VITAS' webservices, som har DISCOAMS koder, udgår og erstattes af nye versioner, som udstiller ESCOSTAR koder (conceptUriDa) i stedet for DISCOAMS koder (DiscoWeb):

• Vitas.FlexjobService (Version 1, 2020-2) udgår og erstattes af Vitas.FlexjobService (Version 2, 2021-3)
• Vitas.JobRotationService (Version 1, 2020-2) udgår og erstattes af Vitas.JobRotationService (Version 2, 2021-3).

Bemærk: Vitas.MentorService, Vitas.PersonalAssistanceService, Vitas.AidService og Vitas.PdfServiceVitas.PdfService er ikke berørte.

Bemærk: VITAS udstiller ikke alias fra ESCO-STAR på webservices og WSRM'er.

Bjarne Hansen (Edora)

976.14.11 Afsendelse af WSRM fra Vitas via DFDG  er tilpasset til at udstille ESCO-STAR stillingsbetegnelser

WSRM besked ændres således at stillingsbetegnelse fremadrettet er angivet som ESCO STAR kode. 

Bemærk: VITAS udstiller ikke alias fra ESCOSTAR på webservices og WSRM'er.

VitasNotificationService (Version 6, 2019-1)

Intern snitflade, hvor VITAS kalder DFDG for at få sendt WSRM ud.

Udgår til fordel for version 7.

VitasNotificationService (Version 7, [UDV] 2021-3)

Intern snitflade, hvor VITAS kalder DFDG for at få sendt WSRM ud.

SendJobOfferStatusNotification, SendJobAllocationStatusNotification, og SendIguAgreementStatusNotification

• Stillingsbetegnelse: Den eksisterende DiscoWeb attribut erstattes med ConceptUriDa. 

WsrmMessageService (Version 11)

GetJobOfferStatusNotificationVersion6

Udgår til fordel for version 7.

GetJobAllocationStatusNotificationVersion6

Udgår til fordel for version 7.

GetIguAgreementStatusNotificationVersion3

Udgår til fordel for version 4.

GetJobAllocationAddOnsStatusNotificationVersion4

Ingen ændringer til denne Vitas WSRM.

WsrmMessageService (Version 11, [UDV] - ESCO og VITAS GetJobOfferStatusNotificationVersion, GetJobAllocationStatusNotificationVersion, GetIguAgreementStatusNotificationVersion)

GetJobOfferStatusNotificationVersion7, GetJobAllocationStatusNotificationVersion7 og GetIguAgreementStatusNotificationVersion4

• Stillingsbetegnelse den eksisterende DiscoWeb attribut erstattes med ConceptUriDa. 

ANDRE ÆNDRINGER INTERN NOTE

JobDescription længde i Activityservice øges fra 500 til 4000

JobOfferInformation fra Vitas??? tænker ikke anvendt

976.17.12 Der kan igen oprettes jobannoncer ifm. Løntilskud i VITAS

VITAS har af tekniske årsager ikke kunnet oprette jobannoncer i 2021-2. Funktionen genetableres i 2021-3.

Særlige krav til test

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