746.2 Jobordrer til ordinære job, færdiggørelse og udstilling mod eksterne
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
4 Beskrivelse af epic
4.1 <Acceptkriterie nr> <Acceptkriterie overskrift>
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories

Ændringslog

Afgrænsning af epic

Oversigt over berørte web services

Beskrivelse af epic

Denne epic til denne ISB: https://dokumentationsarkiv.star.dk/Releasedokumentation/IT-Slutproduktbeskrivelser%20(ISB)/746%20ISB%20Jobordrer%20til%20ordinære%20job.docx

746.2.1 Sagsbehandler i jobcenter og a-kasse skal kunne søge i jobordrer

Som sagsbehandler eller virksomhed skal det være muligt at søge i ordinær jobordrer.
Der skelnes mellem tre grundlæggende aftagere (søgemønstre):

• Jobcenterets virksomhedskonsulent, der ønsker at sikre sig at virksomheden får dækket sine arbejdskraft behov. (Se afsnit 746.2.2)
• Jobcentrets eller a-kassen jobkonsulent vil med udgangspunkt i en ledig søge efter mulige jobtilbud. (Se afsnit 746.2.2)
• Virksomhedens medarbejderSøgning på egen ordinær jobordre via virksomhed samt status

Søgning for virksomheder etableres i dette acceptkriterie. Bemærk søgningen er også tilgængelig for KSS og a-kasse.

CompanyRecruitmentService Version 1

GetCompanyRecruitmentOnCompany

Giver en liste af ordinære jobordre fra en given virksomhed. Søgningen er målrettet JobAG og virksomheden, men kan f.eks. også bruges i relation til virksomhedskonsulenter i jobcenter der for en virksomhed kan få deres ordinære jobordre.
Forretningsregler

• Der findes ordinære jobordre på den angivende virksomhed ud fra CVR og P-nr.Er der kun angivet CVR-nr. findes på alle P-nr. under det CVR-nr.

Input

CompanyRecruitmentStatusCollectionType

Output

CompanyRecruitmentResultItem

746.2.2 Som sagsbehandler i jobcenter og a-kasse vil jeg kunne finde ordinær jobordrer

Som sagsbehandler skal det være muligt at finde ordinær jobordrer. Da DFDG kun kender de ordinære jobordre, der er oprettet i DFDG og ikke alle de ordinære jobordre der er lokalt registreret i jobcentret/a-kasse, kan DFDG ikke udstille en samlet søgning til en jobkonsulent. Løsningsmodeller er derfor at stille de ordinære jobordre der findes i DFDG til rådighed for KSS og a-kasserne, der så kan gemme disse lokalt og lave en kombineret søgning på de parametre som findes relevant.
Der skelnes mellem tre grundlæggende aftagere (søgemønstre):

• Jobcenterets virksomhedskonsulent, der ønsker at sikre sig at virksomheden får dækket sine arbejdskraft behov.Virksomhedskonsulent tænkes primært at søge på parametre som ansvarlig jobcenter, virksomhed (måske en collection af virksomheder), oprettelsesdag, status, udløbsdatoDet vil være KSS'erne og a-kasser ansvar at definere denne søgning i eget system
• Jobcentrets eller a-kassen jobkonsulent vil med udgangspunkt i en ledig søge efter mulige jobtilbud.Jobkonsulent tænkes primært at søge på parametre som titel, discoamskode, beskrivelse, ansvarligt jobcenter, virksomhed, geografi (collection af jobcentre)Det vil være KSS'erne og a-kasser ansvar at definere denne søgning i eget system
• Virksomhedens medarbejder via JobGAGSøgning på egen ordinær jobordre via virksomhed samt status. Denne søgning er impl. I metoden SearchCompanyRecruitmentOnCompany. KSS'erne og a-kasser er velkommen til at bruge denne søgning, men dens primærer brug er rette mod JobAG og dermed krav fra JobAG (Se afsnit 746.2.1)

CompanyRecruitmentService Version 1

GetCompanyRecruitments

Finder alle ordinære joborder, med den ønskede type og stati.
Forretningsregler

• Metode returnerer alle ordinære jobordre med de angivne stati.Bemærk: Der er ikke paging eller andre parametre på denne metode til at begrænse resultatsættet her i version 1. Det forventes at datamængden i første omgang ikke vil give udfordringer mht. antallet i resultatsæt. Skulle der viser sig et behov for paging eller anden begrænsning af resultatsættet vil dette kunne komme i en version 2.

Input

Output

746.2.3Som STAR vil jeg have sat ansvarlig jobcenter på hvis virksomheden ikke angiver det ved oprettelsen

CompanyRecruitmentService (Version 1)

Forretningsbeskrivelse af service

CreateCompanyRecruitment

Udvides med følgende forretningsregel.
Forretningsregler

• Ved oprettelse af en jobordre dannes der et entry i loggen
• Hvis ansvarligt jobcenter ikke er angivet sætter DFDG ResponcibleJobcenterCode ud fra virksomhedens lokation
  • ResponsibleJobcenterCode skal være validt hvis angivet ellers fejl nnnn

Løsningen baseres på at BI data vedrørende CVR udvides med at BI medtager Kommune nr. i adressedata der leveresse til DFDG.

746.2.4 Som STAR vil jeg have data stillet til rådighed for BI

For at BI kan får tilgang til data fra DFDG skal de havde overleveret den fysiske datamodel. Det forventes at BI selv henter data til deres DSA.

746.2.5 Som sagsbehandler vil jeg have mulighed for også at angive et link til borger egne informationer, f.eks. borgers LinkedIn profil eller anden site med målrettet CV

CompanyRecruitmentService (Version 1)

CreateCompanyRecruitmentEvent og GetCompanyRecruitment

Metoden udvides med et ekstra felt i CompanyRecruitmentEventType.CandidateCollectionType hvor et link kan angives.

CandidateCollectionType

GetCompanyRecruitment

Metoden udvides med et ekstra felter i CompanyRecruitmentItem for oprettelsesdato.
CompanyRecruitmentItem (kun nyt felt vises)

746.2.6 Som sagsbehandler og virksomhed vil jeg have et løbenr. på en ordinær joborder.

CompanyRecruitmentService (Version 1)

CreateCompanyRecruitment

Forretningsregler (udvidelse i forhold til eksisterende regler)

• Ved oprettelse danner DFDG et løbenummer. Løbenummeret er en fortløbende talrække pr CVR-nr der starter med 1

GetCompanyRecruitment

Metoden udvides med et ekstra felter i CompanyRecruitmentItem med løbenummeret.
CompanyRecruitmentItem (kun nyt felt vises)

746.2.7 Som sagsbehandler i et jobcenter vil jeg kunne finde ud af om der på en (flere) borger i et jobcenter er lavet formidling til hvilke ordinær joborder

I forbindelse med at et jobcenter ser på en borger er der behov for også at se hvilke formidlinger den pågældende borger har haft. Dette er til ren info for sagsbehandleren i Jobcenteret.

PersonStatusService (Version 18)

Kun den nye collection beskrives her.

GetVariablePersonStatus

Forretningsregler

• A-kassen må kun se CompanyRecruitmentsInfo data for egne medlemmer, dog 120 dage tilbage (Dvs. de alm. regler)
• Jobcenter har adgang til alle (dvs. de alm. regler)
• Ordinær joborder medtages hvis borger har haft en formidling.

Input
RequestVariableType udvides med en ny type CompanyRecruitmentsInfo.

CompanyRecruitmentsCollectionType

CompanyRecruitmentsType

746.2.8 Som AA vil jeg have adgang til at se hele formidlingslisten af borgere på en ordinær joborder, dog uden CPR

Forretningsregler

• Det er KSS der selv skal sikre at anden aktør ikke kan se CPR-nr for person der ikke er henvist til dem.

746.2.9 Som virksomhed eller sagsbehandler vil jeg have en specifik mulighed for at skifte status på en ordinær joborder

CompanyRecruitmentService (Version 1)

SetCompanyRecruitmentStatus

Metode der alene kan sætte en status på den ordinær joborder.
Forretningsregler

• Metoden sætter kun status, alle andre forretningsdata forbliver uændret.
• DFDG indsætte et element i formidlingsloggen om ordinær joborder er opdateret, der sendes ikke GetCompanyRecruitmentEventVesion1. DFDG danner ved oprette et entry i formidlingsloggen med CompanyRecruitmentEventActionTypeIdentifierActionTypeIdentifier = 74 (Jobordre status opdateretJobordren er opdateret)
• DFDG sender GetCompanyRecruitmentVesion1 WSRM

• Navn	Type	Detaljer
  RequestMetadata	RequestMetadataType-4	Forekomst: 1
  CompanyRecruitmentIdentifier	GUID	Entydigt ID på henvendelsen fra virksomhed Forekomst: 1
  CompanyRecruitmentStatusTypeIdentifier	CompanyRecruitmentStatusTypeIdentiferType	Status på henvendelsen Forekomst: 1
  CorrectionComment	CorrectionCommentType-2	Kommentar til opdatering Forekomst: 0-1

  CompanyRecruitmentEventActionTypeIdentifier

  Ny kodeliste.
  Se kodeliste GetCompanyRecruitmentActionTypeIdentifierCodeList på ws-wiki.

  Id	Navn	Beskrivelse	Startdato	Slutdato
  1	Formidling	Formidling af kandidater til ordinær joborder	01-06-2016	01-07-2100
  2	Orientering til arbejdsgiver	Besked vedrørende ordinær joborder uden formidling	01-06-2016	01-07-2100
  3	Jobordre oprettet	Jobodre oprettet. Jobcenter/a-kasse vil behandle orderen	01-06-2016	01-07-2100
  4	Jobordren er opdateret	Jobordren er opdateret	01-06-2016	01-07-2100
  5	Jobordren er lukket	Jobodren er lukket. Virksomheden ønsker ikke flere formidlinger	01-06-2016	01-07-2100
  6	Kandidat er fjernet fra formidling	Der er fjernet en kandidat fra formidlingen på en ordinær joborder	01-06-2016	01-07-2100
  7	Jobordre status opdateret	Jobordren status er opdateret	01-11-2016	01-07-2100

  746.2.10 Som virksomhed vil jeg have navne og evt. kontaktoplysninger på formidlede borger der ikke har et Cv i Jobnet

  Overordnet løsningsmodel

• Jobcenter formidler en borger uden Jobnet søgbart CV
  • Sagsbehandler har her flere muligheder
    • Sagsbehandler skriver kontaktinfo direkte i formidlingen på personen, hvis person intet CV har
    • Har borger et CV, men det ikke er søgbart, kan sagsbehandler aftale med borger at får det sat søgbart
    • Sagsbehandler kan registrere et link til borgers CV udenfor Jobnet, hvor kontaktinfo findes
    • Sagsbehandler kan oprette kontaktinfo i DFDG, hvis disse ikke findes
  • KSS kan hjælp sagsbehandler til at husk kontaktinfo, hvis der ikke er et Jobnet CV ved at kontrollerer i DFDG om der er et CV inden formidlingen sendes til DFDGDet forventes at være undtagelsen at en borger ikke har et CV
• Virksomhed Hvis en borger der er formidlet, men ikke har et søgbart CV, skal JobAG kunne hente kontakt oplysninger på borger:
  • Navn hentes i PersonStatusService.GetVariablePersonStatus .CoreInfo.PersonNameStructur
  • Address hentes fra PersonStatusService.GetVariablePersonStatus.Address-ContactInfo. Hvis der er adressebeskyttelse vistes adressen, kun flaget for der er adressebeskyttelse.
  • Kontaktinformation hentes enten i en af følgende steder (Det forventes at JobAG vil anvende PersonStatusService):
    • PersonStatusService.GetVariablePersonStatus.PersonContactInfo. Her vises ikke kontaktinfo der er markeret ugyldige
    • PersonNotificationReminderService metode GetPersonContactAndNotificationData indeholder bl.a. borgerens mobil og e-mail, hvis disse er oplyst, Memærk her vises også ugyldig kontaktdata.

PersonStatusService (Version 18)

I denne forbindelse sker der ingen snitfladeændringer til PSS.
Forretningsregler:

• Der skal sættes begrænsninger for afgang til GetVariablePersonStatus for myndighedstypen (OrganisationType) Virksomhed:
  • Der returneres ingenEr det ikke sådan det virker har man ikke sat en container true i input kommer den ikke med ud? containere for alt andet end: PersonStatusService.GetVariablePersonStatus.CoreInfo, PersonStatusService.GetVariablePersonStatus.Address-Contact og PersonStatusService.GetVariablePersonStatus.PersonContactInfo
    • I PersonStatusService.GetVariablePersonStatus.CoreInfo retuneres kun data i PersonCivilRegistrationIdentifier og  PersonNameStructureHvad gør vi lige med CitizenshipCode her kunne vi sætte 0 eller 9999 ind altid. 0 og 9999 er lovlige værdier i kodelisten
    • I PersonStatusService.GetVariablePersonStatus.Address-Contact kun AddressPostalCo, TemporaryResidence og TemporaryResidenceForeign hvis IsProtectedAddress er No. Er IsProtectedAddress = Yes medtages ingen af den og PersonStatusService.GetVariablePersonStatus.Address-Contact idenholder kun IsProtectedAddress
    • PersonStatusService.GetVariablePersonStatus.PersonContactInfo medtages ikke kontaktdata der er markeret ugyldig.

CodeListe (Version 5)

OrganisationTypeIdentifier

Ny værdi for virksomhed.

SystemAreaSubscriptionTypeIdentifier
Ny kodeliste.
Se kodeliste GetSystemAreaSubscriptionTypeIdentifierCodeList på ws-wiki.

SystemSubAreaSubscriptionTypeIdentifier

Ny kodeliste.
Se kodeliste GetSystemSubAreaSubscriptionTypeIdentifierCodeList på ws-wiki.

746.2.11 Som virksomhed vil jeg have en e-mail når der er sket en formidling på en ordinær joborder.

Overordnet løsningsmodel

• Når DFDG registrerer en formidling til en virksomhed sender DFDG en e-mail til virksomheden hvis virksomheden har angivet e-mail (ContactInformation.EmailAddressIdentifier)
• Det skal være muligt for virksomheden at kunne angive om virksomheden ønsker en e-mail når der formidles på en ordinær jobordre

Nyt felt på CreateCompanyRecruitment, UpdateCompanyRecruitment og GetCompanyRecruitment

Når der modtages en CreateCompanyRecruitmentEvent skal der dannes en e-mail til virsomheden hvis WantsEmailNotification = True
E-mailen der dannes til en virksomhed skal indeholde følgende:
Subject: Besked fra jobcenter [Jobcenter Navn] : CompanyRecruitmentActionType
Body:
Description
CandidateCollection (uden cpr-nummer)
Med venlig hilsen
[Jobcenter Navn] finds via ResponsibleAuthorityType-2
Følgende metoder vil generere en e-mail til arbejdsgiveren da de alle danner en formidling på joborderen:

• CreateCompanyRecruitment
• UpdateCompanyRecruitment
• CreateCompanyRecruitmentEvent
• RemoveCandidateFromCompanyRecruitment
• SetCompanyRecruitmentStatus

Beskederne dannes dynamisk ud fra to generiske strenge som ligger i form af static text i databasen BrokerServices (tabel tblStaticTextItem med GroupIdentifier 14 og TextIdentifier 0 og 1).
Subject: "Besked fra jobcenter [JobcenterName]: [ActionTypeDescription]"
Body: "[EventDescription] [EventCandidates]/n/n/n/nMed venlig hilsen/nJobcenter [JobcenterName]"

CompanyRecruitmentService (Version 1)

CreateCompanyRecruitmentMå de også vælge en SMS?

Virksomheder skal have mulighed for at sætte om de vil modtage en e-mail når der er sket en formidling.
Forretningsregler:

• EmailOnRecruitmentEvent må kun være TRUE hvis ContactInformation.EmailOnRecruitmentEvent er udfyldt

Metoden udvides med følgende felt, kun nyt felt er vist.

UpdateCompanyRecruitment

Udvides også med EmailOnRecruitmentEvent og forretningsregel, se CreateCompanyRecruitment.

GetCompanyRecruitment

Udvides også med EmailOnRecruitmentEvent, se CreateCompanyRecruitment.

GetCompanyRecruitmentOnCompany

Udvides også med EmailOnRecruitmentEvent, se CreateCompanyRecruitment.

746.2.12 Som Jobcenter vil jeg i periode frem til ultimo 2017, hvor det er frivilligt at være med på løsningen, have mulighed for tilmelde mig løsningen ved henvendelse til Landssupporten

Løsningsmodel

• DFDG udstiller en servicemetode til LSS, hvor Landssupporten kan registrerer at et givent Jobcenter tilmeldes til løsningen. Når en sådan tilmelding sker vil JobAG kunne registrere Jobcentret centret som ansvarligt jobcenter og Jobcenteret kan benytte DFDG's CompanyRecruitmentService. Derudover vil DFDG sende WSRM beskeder til jobcenteret.Bemærk: Jobcentret skal sikre sig de abonnerer på de relevante beskedtyper og inkl. hvis der er behov for sub-beskedkøer. Dette skal aftale separat med Systemforvalter og dette har Jobcebteret selv ansvar for inden de beder Landsupporten om tilmeldingen.
• DFDG udstiller en service metode til JobAG der fortæller hvilke jobcenter/kommuner en givent virksomhed (CVR plus P-nr) er geografisk tilknyttet.
• DFDG udstiller en service metode til JobAG der fortæller hvilke jobcenter/kommuner der er tilmeldt løsningen.

CompanyRecruitmentService Version 1

GetCompanyJobcenterAffiliation

Metoden giver en virksomheds tilknytning til et jobcenter/kommune ud fra dens CVR-nr og P-nr placering.
Forretningsregler:

• Hvis Virksomheden er tilknyttet et Jobcentret der ikke er tilmeldt til løsningen returneres ingen joncenter kode.

Input

Output

"Tilvalgsløsning" SystemAreaSubscription (Version 1)

I forbindelse med at et jobcenter kan tilmelde sig løsningen via Landssupporten kommer vi løsningsmæssigt ud med en mere generel DFDG- model for dette, det skal ses på baggrund at STAR har et mere generelt behov for at kunne åbneen og lukke for forskellige systemløsninger. Pprt. er der noget "business support" og en løsning vedr. profilafklaring. Derfor oprettes en ny service som kan håndtere tilmelding/afmelding af systemområder i DFDG. Der skal være en historiklog på ændringer.

Model for "tilvalgsløsning" i regi af CompamyRecruitment

Ny service "SystemAreaSubscription"
med metoder a la:UpdateSettingSubscription
Input

Output

GetSubscriptionetting

Input

Output

SystemAreaSubscriptionAuthority

GeubscriptionstSettings

Input

Output

SystemAreaSubscriptionAuthority

• Opret/Opdaterre abonnement Forretningsregler:
  • Fremtidig startdato tilladt, men ikke historisk
  • Fremtid og tom slutdato tilladt, men ikke historisk
  • Er kombinationen af Jobcenter og systemområde (kodeliste) ikke oprette er det det samme som der ikke er abonnement
  • Kun STAR kan benytte metoden (Der er pt. ikke selvbetjening for KSS og a-kasser)

Attributter:

• • Jobcenter
  • Systemområde (kodeliste)
  • Abonnement start
  • Abonnement slut
  • Seneste opdateret
• Liste at abonnementer Attributter input
  • Jobcenter (Null = alle jobcentre)
  • Systemområde (Nule = alle systemområder)

Attributter output

• • Jobcenter
  • Systemområde (kodeliste)
  • Abonnement start
  • Abonnement slut
  • Seneste opdateret

Flytning af Profilafklarings implementering til generel model? Ja i US for sig selv.

Særlige krav til test

I forbindelse med epic 746.1 er der ikke lavet en specifik test i forbindelse med systemforvalters 2016-4 testforløb (intern, eksternintegrationstest, end-to-end, kundetest m.v.). Dette betyder at både epic 746.1 og 746.2 skal indgå i systemforvalters 2017-1 testforløb.

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.