Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | ||
---|---|---|
Som en bruger af Virksomheders ordinære jobordrer på JobAG og i DFDG vil jeg skifte fra DISCOAMS koder til ESCO-STAR koder for at understøtte ESCO-STAR | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for |
976.16.1 | Data er konverterede fra DISCOAMS til ESCO-STAR med konverteringstabel | BI (DFDG, JobAG) |
976.16.2 | Webservices understøtter ESCO-STAR inkl. alias i stedet for DISCOAMS | DFDG, JobAG |
976.16.3 | Brugergrænseflader understøtter ESCO-STAR inkl. alias i stedet for DISCOAMS | JobAG |
976.16.4 | Som STAR vil jeg have dataleverencen fra BI tilrettet til ESCO STAR i forhold til aftagere - f.eks. VOA | BI (DFDG) |
976.16.5 | Som STAR/SF/landssupport vil jeg have løftet datakanon til ny version af service og dermed også anvende ESCO STAR dér | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
976.16.1 | 976.16.2 | ||||
Hvis jeg som sagsbehandler/jobkonsulent i jobcenter (a-kasse) har egne jobordrer liggende i mit system vil jeg have disse konverteret til ESCO STAR stillingsbetegnelser | X | Har KSS egne data eller replikeret data er det KSS selv, der foretage konvertering i egne data. Konvertering kan sker vis den udstillede mapningsservice. Det antages at a-kasserne ikke har replikeret disse data. Skulle denne antagelse ikke være korrekt er det vigtigt, at a-kassen vender tilbage til STAR (PO) omkring dette. | |||
Som sagsbehandler/jobkonsulent i jobcenter, a-kasse eller anden aftager, der anvender formidling af ordinære job, vil jeg have, at mit fagsystem overgår til ESCO STAR | X | Se berørte services nedenfor |
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.
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
---|---|---|---|---|---|
CompanyRecruitmentService (Version 3).Alle | Udgået | Dette sker først i 2021-2 Bemærk: Det vil ikke være muligt at forblive på version 3, da det ikke er mulig at etablere, at service er bagud kompatible. | A-kasse(f), Andre, KSS | JobAG | D+S |
CompanyRecruitmentService (Version 4).CreateCompanyRecruitment | Ændret | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), KSS | JobAG | D+S |
CompanyRecruitmentService (Version 4).GetCompanyRecruitments | Ændret | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), Andre, KSS | JobAG | D+S |
CompanyRecruitmentService (Version 4).GetCompanyRecruitmentsOnCompany | Ændret | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), Andre, KSS | JobAG | D+S |
CompanyRecruitmentService (Version 4).GetCompanyRecruitment | Ændret | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), KSS | JobAG | D+S |
CompanyRecruitmentService (Version 4).UpdateCompanyRecruitment | Ændret | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), Andre, KSS | JobAG | D+S |
WsrmMessageService (Version 11).GetCompanyRecruitmentVersion4 | Ny | Skift af stillingsbetegnelse til ESCO STAR | A-kasse(f), KSS | SF | D+S |
WsrmMessageService (Version 11).GetCompanyRecruitmentVersion3 | Udgået | Udgår til fordel for version 4. Version 3 vil ikke mere kunne anvendes | A-kasse(f), KSS | SF | D+S |
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 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.16.1 Data er konverterede fra DISCOAMS til ESCO-STAR med konverteringstabel
Konvertering fra DISCOAMS til ESCO-STAR fortages i DFDG.
Konvertering laves af BI og denne foretages alene i DFDG. Der sendes ikke WSRM (GetCompanyRecruitmentVersion4) i forbindelse med denne konvertering.
Data som KSS har i eget system, konverteres af KSS selv.
976.16.2 Webservices understøtter ESCO-STAR inkl. aliase i stedet for DISCOAMS
Løsningsmodel
- Skift til ESCO STAR i selve den ordinære jobordre.
- Ny version af service
CompanyRecruitmentService (Version 3)
Udfases til fordel for version 4.
Bemærk: Dette sker først i 2021-2
Bemærk: Det vil ikke være muligt at forblive på version 3, da det ikke er muligt at etablere, at service er bagud kompatible.
CompanyRecruitmentService (Version 4, [UDV] 2021-2)
CreateCompanyRecruitment, GetCompanyRecruitment, UpdateCompanyRecruitment, GetCompanyRecruitmentsOnCompany, GetCompanyRecruitments
For disse metoder gælder at:
- Eksisterende attribut med DiscoAMS stillingsbetegnelse (OccupationId) fjernes fra snitflade
Bemærk DiscoAMS stillingsbetegnelse fjernes ikke fra fysisk tabel af hensyn til historik/revisionsspor, den gamle DiscoAMS stillingsbetegnelse vil ikke kunne hentes via nogle snitflader eksternt fra. - Der kommer to nye attributter for ESCO STAR stillingsbetegnelse (ConceptUriDa og AliasIdentifier).
- Der rettes og opdateres fejlkoder i forbindelse med angivelse af stillingsbetegnelse
se CompanyRecruitmentService (Version 4, [UDV] 2021-2) for de konkrete attributter, der berøres, samt de ændrede og nye fejlkoder. Begge dele markeret med rød eller grøn farve.
CreateCompanyRecruitmentEvent, SetCompanyRecruitmentStatus, GetCompanyJobcenterAffiliation, UpdateCandidateOnCompanyRecruitmentEvent
Disse metoder ændres ikke i forbindelse med denne epic.
PersonStatusService Version 20
Da CompanyRecruitmentInfo i PSS ikke indeholder referencer til stillingsbetegnelser er der ingen ændringer i PSS i den forbindelse.
WsrmMessageService (Version 11, 2021-1)
GetCompanyRecruitmentVersion3
Udgår til fordel for GetCompanyRecruitmentVersion4.
Bemærk: Dette sker først i 2021-2
Bemærk: Det vil ikke være muligt at forblive på version 3 af WSRM- beskeden, da det ikke er mulig at etablere, at service er bagud kompatible.
GetCompanyRecruitmentVersion4
Beskeden sendes efter samme regler som hidtid. Der er alene tale om en indholdsmæssig ændring vedr. stillingsbetegnelse. Se rød og grøn baggrund.
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetCompanyRecruitmentVersion4Request | WsrmRequestType | 1 |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetCompanyRecruitmentVersion4Response | GetCompanyRecruitmentTypeCollection | 1 | ||
- GetCompanyRecruitmentType | GetCompanyRecruitmentType Base: WSRMMetadataBaseType | 0 - * | ||
- - BaseType | WSRMMetadataBaseType | 1 | ||
- - - WSRMMetadata | WSRMMetadataType | 0 - 1 | ||
- - - - MessageIdentifier | guid Base: string | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 | |
- - - - ClientSystemTypeIdentifier | ClientSystemTypeIdentifierType | 0 - 1 | ||
- - - - RegisteringAuthority | ActiveOrganisationHeaderType | 0 - 1 | ||
- - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType Base: int | MinInclusive: 1 MaxInclusive: 100 | 1 | Kodeliste med organisationstype / myndighedstype |
- - - - - OrganisationCode | OrganisationCodeType Base: string | Length: 1-20 | 1 | Identifikation af organisation / myndighed |
- - - - RegisteringUser | RequestUserMetadataType | 0 - 1 | ||
- - - - - RequestUserStructure | RequestUserStructureType | 1 | Information om den kaldende bruger. | |
- - - - - - UserFullName | UserFullNameType Base: string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
- - - - - - RequestUserTypeIdentifier | RequestUserTypeIdentifierType | 1 | Brugertype | |
- - - - - - UserIdentifier | UserIdentifierType Base: string | 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 Base: string | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
- - - - - RequestOrganisationStructure | RequestOrganisationStructureType | 1 | Den organisation som registrerende bruger tilhører. | |
- - - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType | 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
- - - - - - OrganisationCode | OrganisationCodeType Base: string | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
- - - - - RegistrationDateTime | dateTime | 1 | Kaldende systems registreringstidspunkt. | |
- - - - EnqueueDateTime | dateTime | 0 - 1 | ||
- - - - SortKey | unsignedLong | 0 - 1 | ||
- - RegistrationType | RegistrationTypeType Base: string | Enumeration:
| 1 | Beskriver om der er tale om en Create eller Update WSRM. |
- - ResponsibleJobCenterCode | string | Pattern: ^[0-9]{5}$ | 1 | Ansvarligt jobcenter. |
- - CorrectionComment | string | Length: 1-1500 | 0 - 1 | Årsag til ændring. |
- - CompanyRecruitment | CompanyRecruitmentType | 0 - 1 | Joborder. | |
- - - CompanyRecruitmentIdentifier | guid Base: string | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 | Entydig identifikation af jobordre |
- - - CompanyRecruitmentTitle | string | Length: 1-100 | 0 - 1 | Titel på den henvendelse eller ordinær joborder der ønskes besat. |
- - - ConceptUriDa | 0 - 1 | Unik ESCO STAR identifikation på stillingsbetegnelse. Er koblet til titel og findes kun, hvis titel er en valideret stillingsbetegnelse i forhold til ESCO STAR. | ||
- - - AliasIdentifier | 0 - 1 | Unik ESCO STAR identifikation på alias. Er koblet til titel og findes kun, hvis titel er en valideret stillingsbetegnelse i forhold til ESCO STAR. | ||
- - - CompanyRecruitmentJobDescription | string | Length: 1-5000 | 1 | Beskrivelse af det job henvendelse eller ordinær joborder omhandler. |
- - - CompanyRecruitmentComment | string | Length: 1-2000 | 0 - 1 | Beskrivelse/kommentar til jobcentret / a-kassen vedrørende henvendelse. |
- - - CompanyRecruitmentTypeIdentifier | CompanyRecruitmentTypeIdentifierType | 1 | Angiver type af virksomhedens henvendelse. | |
- - - CompanyRecruitmentStatusTypeIdentifier | CompanyRecruitmentStatusTypeIdentifierType | 1 | Status på henvendelsen. | |
- - - CompanyRecruitmentStartDate | dateTime | 0 - 1 | Startdato for jobtilbuddet (ansættelsesdato). Hvis ikke angivet betragtes jobtilbuddet at være tilgængeligt fra oprettelsen. | |
- - - CompanyRecruitmentPeriod | int | 0 - 1 | Længden i dage af jobtilbuddet. Angives kun hvis der er en kendt midlertidig ansættelse. | |
- - - CompanyRecruitmentValidToDate | dateTime | 0 - 1 | Seneste svar dato for jobcenter/a-kasse der er mulig/relevant. | |
- - - CompanyRecruitmentRespondTypeIdentifier | CompanyRecruitmentRespondTypeIdentifierType | 0 - 1 | Den type af svar fra jobcenter/a-kasse virksomheden ønsker. | |
- - - MaximumNumberOfResponses | int | 0 - 1 | Maksimalt antal ansøgere virksomhed ønsker. | |
- - - WeeklyWorkTimeTypeIdentifier | WeeklyWorkTimeTypeIdentifierType | 0 - 1 | Hvorvidt joborder er fuldtid eller deltid. | |
- - - HoursPerWeek | int | Pattern: ^[0-9]{2}$ | 0 - 1 | Samlet antal timer der tilbydes i hele timer. |
- - - RecruitmentIsInternal | boolean | 1 | TRUE indikerer at rekrutteringen er intern og kun kan redigeres af de primære rekrutteringsmyndigheder, og kun kan ses af disse samt jobcentre som har fået formidlet en borger. | |
- - - NumberOfPositions | int | 0 - 1 | Antallet af stillinger der skal besættes. | |
- - - CompanyRecruitmentProvider | CompanyRecruitmentProviderType | 1 | Angiver den virksomhed der udbyder tilbuddet. | |
- - - - CVRnumberIdentifier | string | Length: 8-8 | 1 | CVR-nummeret er et 8-cifret nummer, der er unikt for den enkelte virksomhed. |
- - - - ProductionUnitIdentifier | string | Length: 10-10 | 0 - 1 | P-nummer på virksomheden. |
- - - CompanyRecruitmentLocationName | string | Length: 1-500 | 0 - 1 | Tilbudsudbyder. Angiver den virksomhed der udbyder aktiviteten. |
- - - CompanyRecruitmentLocationAddress | AddressPostalType | 0 - 1 | Stedsangivelse for jobtilbuddet. | |
- - - - MailDeliverySublocationIdentifier | string | Length: 1-34 | 0 - 1 | Navn på bygning |
- - - - StreetName | string | Length: 1-40 | 1 | Vejnavn |
- - - - StreetNameForAddressingName | string | Length: 1-20 | 0 - 1 | Forkortet vejnavn. Må ikke må overstige 20 tegn. |
- - - - StreetBuildingIdentifier | string | Pattern: ^([1-9]|[1-9][0-9]|[1-9][0-9]{2})|([1-9][A-Z]|[1-9][0-9][A-Z]|[1-9][0-9]{2}[A-Z])$ | 1 | Husnummer |
- - - - FloorIdentifier | string | Pattern: ^[1-9]|[1-9][0-9]|KL|ST|kl|st|k[2-9]|K[2-9]$ | 0 - 1 | Etagenummer |
- - - - SuiteIdentifier | string | Length: 1-4 | 0 - 1 | Dør-angivelse, fx th. |
- - - - DistrictSubdivisionIdentifier | string | Length: 1-34 | 0 - 1 | Yderligere bynavn eller områdenavn hvor nødvendigt. |
- - - - PostOfficeBoxIdentifier | int | MinInclusive: 1 MaxInclusive: 9999 | 0 - 1 | Postboksnummer |
- - - - PostCodeIdentifier | string | Pattern: ^[0-9]{4}$ | 1 | Postnummer |
- - - - DistrictName | string | Length: 1-20 | 1 | Bynavn |
- - - - CountryIdentificationCode | CountryIdentificationCodeType | 0 - 1 | Landekode | |
- - - - - Scheme | CountryIdentificationSchemeType Base: string | Enumeration:
| 1 | Dette er en støttetype til CountryIdentificationCodeType. Det regulære udtryk er et valg for de 4 forskellige regulære udtryk for de forskellige formater. ISO 3166 standard, alpha 2: [a-z,A-Z]{2}. Eksempel 'DK' for Danmark. ISO 3166 standard, alpha 3: [a-z,A-Z]{3}. Eksempel 'DKN' for Danmark. UN Statistics Divisions country codes: [0-9]{3}. Eksempel '208' for Danmark AuthorityCode from the Central Office of Civil Registration: [0-9]{4}. Eksempel '5100' for Danmark. |
- - - - - Value | string | 1 | ||
- - - ContactInformation | ContactInformationType | 1 | Kontaktperson for stillingen. | |
- - - - PersonGivenName | string | Length: 1-50 | 1 | Kontaktpersons fornavn. |
- - - - PersonMiddleName | string | Length: 1-40 | 1 | Kontaktpersons mellemnavn. |
- - - - PersonSurnameName | string | Length: 1-40 | 1 | Kontaktpersons efternavn. |
- - - - TelephoneNumberIdentifier | string | Pattern: ^(\+)?[0-9]{3,20}$ | 0 - 1 | Kontaktpersons telefonnummer. |
- - - - EmailAddressIdentifier | string | Pattern: ^([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64})$ | 0 - 1 | Kontaktpersons email. |
- - - ResponsibleJobcenterCode | string | Pattern: ^[0-9]{5}$ | 0 - 1 | Det jobcenter der er ansvarlig i forhold til virksomheden. |
- - - IsCreatedByCompany | boolean | 1 | Angiver om det er virksomheden der selv har oprettet jobtilbuddet. | |
- - - JobAdId | int | 0 - 1 | Entydigt ID på Jobannoncen i Jobnet. | |
- - - RecruitmentCaseWorker | ResponsibleAuthorityType | 0 - 1 | Sagsbehandler der er tovholder i forhold til virksomheden. | |
- - - - AuthorityStructure | AuthorityStructureType | 1 | Myndighedsopl | |
- - - - - AuthorityCode | string | 1 | Myndighedskode | |
- - - - - AuthorityName | string | 1 | Myndighedsnavn | |
- - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType | 1 | Myndighedstype | |
- - - - CaseWorker | ResponsibleCaseWorkerStructureType | 1 | Sagsbehandler | |
- - - - - CaseWorkerGivenName | string | 1 | Sagsbehandler fornavn | |
- - - - - CaseWorkerMiddleName | string | 0 - 1 | Sagsbehandler mellemnavn | |
- - - - - CaseWorkerSurname | string | 1 | Sagsbehandler efternavn | |
- - - - - TelephoneNumberIdentifier | string | 0 - 1 | Telefonnummer | |
- - - - - EmailAddressIdentifier | string | 0 - 1 | ||
- - - - - CaseWorkerIdentifier | string | 1 | Sagsbehandler identifikation | |
- - - InternalAuthorityComment | string | Length: 1-2000 | 0 - 1 | Intern kommentar, der ikke vises på JobAG. |
- - - PrimaryRecruitmentAuthorities | AuthorityStructureWithoutNameTypeCollection | 0 - 1 | De myndigheder der efter egen aftale er de primære formidlingsmyndigheder. | |
- - - - AuthorityStructureWithoutNameType | AuthorityStructureWithoutNameType | 0 - * | ||
- - - - - AuthorityCode | string | Pattern: ^[-][1]|[0-9]{1,8}$ | 1 | Myndighedskode. |
- - - - - OrganisationTypeIdentifier | int | MinInclusive: 1 MaxInclusive: 100 | 1 | Myndighedstype. |
- - - RecruitmentCaseWorkerAllowed | boolean | 1 | Angiver hvorvidt tovholder er tilladt. |
976.16.3 Brugergrænseflader understøtter ESCO-STAR inkl. alias i stedet for DISCOAMS
Intern STAR acceptkriterie:
JobAG rette brugergrænseflade således, at virksomheder anvender ESCO STAR samt får mulighed for at også vælge alias. Modellen skal følge modellen fra Jobanet. P.tt vises stillingsbetegnelser med alias i parentes.
@Bjarne Hansen (Edora) tage eventuel snak med Kenneth om hvordan de endte med at lave type ahead på Jobnet.
976.16.4 Som STAR vil jeg have dataleverencen fra BI tilrettet til ESCO STAR i forhold til aftagere f.els. VOA
Intern STAR acceptkriterie:
@Jørgen Fischer, leverance til VOA skal udvides med de to ESCO STAR felter. Hvorvidt der er f.eks. omlægning i leverencemodellen til VOA også her ved jeg ikke, Bjarne og jeg har ikke tage højde for det i estimat.
976.16.5 Som STAR/SF/landssupport vil jeg have løftet datakanon til ny version af service og dermed også anvender ESCO STAR
Intern STAR acceptkriterie:
Datakanonen anvender til at generere testdata for SF og Landssuportten, Datakanon skal derfor læftes til den nye version af servicen og dermed anvende ESCO STAR.
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
* 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: Ja
Skal der køres databasescripts for opdatering af tabeller i databasen: Ja
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.