Denne integrationsvejledning beskriver hvordan systemer udenfor STAR (udenfor Styrelsen for Arbejdsmarked og Rekruttering (STAR) kan anvende JobAD CV webservice til dels at levere jobannoncer til publicering på at hente en borgeres aktuelle CV fra jobnet.dk, dels til at afhente jobannoncer, der er publiceret på jobnet.dk.
| Table of Contents |
|---|
Introduktion
STAR tilbyder en webservice, som sætter eksterne organisationer i stand til dels at levere jobannoncer til jobnet.dk, dels til at hente aktuelt publicerede jobannoncer.
STAR har indtil 2018 udstillet to webservices, JobIn og JobOut, til hhv, at levere jobannoncer til publicering på jobnet.dk og til at afhente jobannoncer, der er publiceret på jobnet.dk. Disse udfases i 2018 og erstattes med den nye JobAD webservice.
Roller
JobAD webservicen tilbyder to roller til systemer udenfor STAR:
- Levering af jobannoncer til jobnet.dk
- Afhentning af publicerede jobannoncer fra jobnet.dk
...
hente en borgeres aktuelle CV, når borgere har givet samtykke hertil.
STAR vil fra [tidspunkt] udstillet denne webservices og den vil erstatte hidtidige løsninger. Tidligere løsninger blev udfaset i december 2020, hvor det nye CV på Jobnet blev idriftsat.
Denne vejledning gælder for trediepart der ønsker at tilgå CV oplysninger uden at kende borgers CPR nr.
Denne service skal således ikke anvendes af a-kasser og jobcentre eller disses databehandlere, der integrerer til DFDG generelt.
Roller
CV webservicen tilbyder en rolle til systemer udenfor STAR:
- Afhentning af aktuelt CV fra jobnet.dk
CV snitfladebeskrivelse
Herunder finder du beskrivelse af den tekniske webservicekontrakt (swagger), samt detaljeret beskrivelse af metoder og datafelter i webservicen.
Du kan finde forretningsregler for webservicen her:
WSDL til JobAD webservice
WSDL'en specificerer teknisk webservicekontrakt til JobAD webservicen.
Du kan finde WSDL'er til testmiljø her: https://jobt1Det skal bemærkes, at snitfladen indeholder alle metoder
- Produktionversion
- Testmiljø T1
- Testmiljø (seneste udviklingsversion - kun intern brug i STAR)
- T3 testmiljø (release-next) (pr. 24.09-2020 med 2020-3 kode): https://jobsearcht3.jobnettest.dk/
...
...
...
- html?urls.primaryName=Cv%20V1
- T4 testmiljø (release next-next) (pr. 24.9.2020 med 2020-4 kode): https://
...
...
...
...
...
...
For hele cv strukturen se under Get /v3/Cv
Du kan finde en beskrivelse af metoder og datafelter i JobAD webservicen her.
Begrænsninger i annoncetyper
JobAD forretningsregler for CV webservicen her:
Du kan finde forretningsbeskrivelse CV her:
Begrænsninger i forhold til CV data
CV webservicen anvendes af flere forskellige systemer, som har forskellige rettigheder i forhold til borgerens CV data.
Systemer uden for STAR kan oprette samme typer (JobAdDetails/Type) af jobannoncer, som arbejdsgivere kan på Jobnet for arbejdsgivere.:
- Job med almindelige ansættelsevilkår (Normal)
- Fleksjob for personer med nedsat erhvervsevne (Flexjob)
- Job for førtidspensionister på særlige vilkår (EarlyRetirement)
- Job med almindelige ansættelsesvilkår - egnet til efterlønnere (NormalAndEarlyRetiree)
- Skal annoncen have logoet 'Hotjob', da jobbet er for alle - også uden særlige forudsætninger (HotJob)
Der må ikke anvendes anonyme arbejdsgivere (JobDetails/IsAnonymousEmployer).
Eksempler
Herunder finder du eksempler på kald af webservicen, dels som SOAP requests og response, dels som et C# projekt.
Eksempler på SOAP kald
Fælles for disse eksempler er at [brugernavn] og [adgangskode] skal erstattes med faktiske værdier.
AddJob - opret jobannonce på jobnet.dk
Dette SOAP kald opretter en jobannonce på jobnet.dk. Ved succesfuld oprettelse returneres jobannoncens ID.
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract" xmlns:job2="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:AddJobRequestType>
<job:jobAd>
<job:ApplicationDetails>
<job:ApplicationMethods>
<job:ApplyOnline>
<job:Url><![CDATA[https://ssl1.peoplexs.com/Peoplexs22/CandidatesPortalNoLogin/ApplicationForm.cfm?PortalID=2035&VacatureID=929638]]></job:Url>
</job:ApplyOnline>
</job:ApplicationMethods>
<job:JobContactList>
<job2:JobContactType>
<job:Email>test@testing.dk</job:Email>
<job:PersonNameStructure>
<job:PersonGivenName>Nora</job:PersonGivenName>
<job:PersonSurnameName>Malkeko</job:PersonSurnameName>
</job:PersonNameStructure>
<job:Title>HR-teamleder</job:Title>
<job2:HidePhoneNumbers>false</job2:HidePhoneNumbers>
<job2:TelephoneNumberStructure>
<job:PrimaryNumber>22334455</job:PrimaryNumber>
</job2:TelephoneNumberStructure>
</job2:JobContactType>
</job:JobContactList>
</job:ApplicationDetails>
<job:HiringOrganizationDetails>
<job:AddressStructure>
<job:CountryCode>DK</job:CountryCode>
<job:MunicipalityId>101</job:MunicipalityId>
<job:MunicipalityName>København</job:MunicipalityName>
<job:PostalCity>København Ø</job:PostalCity>
<job:PostalCode>2100</job:PostalCode>
<job:StreetBuildingIdentifier>11</job:StreetBuildingIdentifier>
<job:StreetName>Lyngbyvej</job:StreetName>
</job:AddressStructure>
<job:CvrNumber>35954716</job:CvrNumber>
<job:Name>FØTEX</job:Name>
<job:PNumber>1013466951</job:PNumber>
</job:HiringOrganizationDetails>
<job:JobAdDetails>
<job:JobPublishDates>
<job:PublishEndDate>2017-11-08T00:00:00.0000000+01:00</job:PublishEndDate>
<job:PublishStartDate>2017-09-14T00:00:00.0000000+02:00</job:PublishStartDate>
</job:JobPublishDates>
<job:PostedBy>
<job:Email>fra@test.dk</job:Email>
<job:PersonNameStructure>
<job:PersonGivenName>Fætter</job:PersonGivenName>
<job:PersonSurnameName>Højben</job:PersonSurnameName>
</job:PersonNameStructure>
<job:Title>HR-konsulent</job:Title>
<job2:ContactGuid>eef750d1-2bb6-e511-80cc-40f2e9c3d2fc</job1:ContactGuid>
<job2:PrimaryNumber>87785000</job1:PrimaryNumber>
</job:PostedBy>
<job:Type>Normal</job:Type>
</job:JobAdDetails>
<job:JobDetails>
<job:AuthorityId>0</job:AuthorityId>
<job:Classification>
<job:EmploymentType>PermanentJob</job:EmploymentType>
<job:IsEuresJob>false</job:IsEuresJob>
<job:IsPublicSectorJob>false</job:IsPublicSectorJob>
<job:IsWorkInDenmarkJob>false</job:IsWorkInDenmarkJob>
</job:Classification>
<job:Description><![CDATA[<p>Som teamkoordinator i Kundeservice refererer du til service- og personalechefen, samt teamlederen. Du bliver ansvarlig for dine egne opgaver relateret til den daglige drift af kasselinje, bager og kundeservice.</p>
<p>Dine fokusområder er optimering af bemanding og driften af kundeservice og kasselinje, hvor du skal sikre den bedste indkøbsoplevelse for vores kunder. <br /><br /><strong>Dine opgaver</strong></p>
<ul>
<li>Du står for at planlægge og optimere bemandingen - herunder udarbejdelse af bemandingsplaner i vores postbutik og bagerudsalg.</li>
<li>Du kommer til at følge op på driftsrutiner i Kundeservice</li>
<li>Du arbejder med at vedligeholde og videreudvikle vores høje serviceniveau</li>
</ul>
<p>I takt med, at du udvikler dig, vil du få mere og mere ledelsesansvar for afdelingens medarbejdere.<br /><br />
<strong>Kvalifikationer<br /></strong>
Du er udadvendt, service- og kundeorienteret, og du gør dit til at sikre kunden den bedste oplevelse. Du har et stort overblik, en bred viden om service generelt og er en god rollemodel. Dine evner til at samarbejde og kommunikere er i top, og du kan motivere dine kolleger til at yde deres bedste.<br /><br />
<strong>Gode karrieremuligheder<br /></strong>
Vi tilbyder til gengæld et spændende job med gode karrieremuligheder inden for Dansk Supermarked. Varehuset beskæftiger ca. 200 medarbejdere, som glæder sig til at byde dig velkommen.<br /><br />
<strong>Løn</strong><br />Efter kvalifikationer.</p>]]>
</job:Description>
<job:HidePhonenumbers>false</job:HidePhonenumbers>
<job:IsAnonymousEmployer>false</job:IsAnonymousEmployer>
<job:IsDisabilityFriendly>false</job:IsDisabilityFriendly>
<job:JobDates>
<job:ApplicationDeadlineDate>2017-11-08T00:00:00.0000000+01:00</job:ApplicationDeadlineDate>
<job:StartAsSoonAsPossible>true</job:StartAsSoonAsPossible>
</job:JobDates>
<job:JobLocation>
<job:Address>
<job:CountryCode>DK</job:CountryCode>
<job:MunicipalityId>101</job:MunicipalityId>
<job:MunicipalityName>København</job:MunicipalityName>
<job:PostalCity>København Ø</job:PostalCity>
<job:PostalCode>2100</job:PostalCode>
<job:StreetBuildingIdentifier>11</job:StreetBuildingIdentifier>
<job:StreetName>Lyngbyvej</job:StreetName>
</job:Address>
<job:NoLocalBusinessAddress>false</job:NoLocalBusinessAddress>
</job:JobLocation>
<job:NumberOfPositions>1</job:NumberOfPositions>
<job:OccupationId>1219902</job:OccupationId>
<job:Schedule>
<job:DailyWorkTime>
<job:Day>false</job:Day>
<job:Evening>false</job:Evening>
<job:Night>false</job:Night>
<job:Weekend>false</job:Weekend>
</job:DailyWorkTime>
<job:WeeklyWorkTimeTypes>PartTime</job:WeeklyWorkTimeTypes>
<job:WorkHour>
<job:Max>25</job:Max>
<job:Min>20</job:Min>
</job:WorkHour>
</job:Schedule>
<job:Title>Teamkoordinator til serviceafdelingen</job:Title>
</job:JobDetails>
</job:jobAd>
</job:AddJobRequestType>
</soapenv:Body>
</soapenv:Envelope>
Påkrævet felter
Det kan være svært at se hvilke felter der påkrævet ud fra requestet. Men følgende felter kræves udfyldt:
<job:JobAdDetails>
<job:Type>...</job:Type>
</job:JobAdDetails>
<ApplicationDetails>
<JobContactList>
<PersonNameStructure>
<PersonGivenName>...</PersonGivenName>
<PersonSurnameName>...</PersonSurnameName>
</PersonNameStructure>
</JobContactList>
</ApplicationDetails>
<HiringOrganizationDetails>
<AddressStructure>
<Contact>
<PersonNameStructure>
<PersonGivenName>...</PersonGivenName>
<PersonSurnameName>...</PersonSurnameName>
</PersonNameStructure>
</Contact>
</AddressStructure>
</HiringOrganizationDetails>
Response:
...
SearchJob - søg publicerede jobannoncer
Dette SOAP kald fremsøger aktuelt publicerede jobannonce på jobnet.dk.
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:SearchJobRequestType>
<job:SearchParameters>
<job:CreatedFrom>2001-01-01</job:CreatedFrom>
<job:CreatedTo>2018-01-01</job:CreatedTo>
</job:SearchParameters>
</job:SearchJobRequestType>
</soapenv:Body>
</soapenv:Envelope>
Da dette request potentielt kan levere ganske mange søgeresultater kan man med fordel sætte paging op eller præcisere søgningen med fx JobAttributes.
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:SearchJobRequestType>
<job:SearchParameters>
<job:CompanyName>FØTEX</job:CompanyName>
<job:CreatedFrom>2017-01-01</job:CreatedFrom>
<job:CreatedTo>2018-01-01</job:CreatedTo>
<job:JobAttributes>
<job:JobAttribute>WorkInDenmark</job:JobAttribute>
<job:JobAttribute>EURES</job:JobAttribute>
<job:JobAttribute>Foreign</job:JobAttribute>
<job:JobAttribute>State</job:JobAttribute>
</job:JobAttributes>
</job:SearchParameters>
</job:SearchJobRequestType>
</soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<SearchJobResponse xmlns="http://jobnet.af.dk/JobAdService">
<SearchJobResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<SearchResult>
<Created>2017-02-14T00:00:00</Created>
<JobAdId>4410682</JobAdId>
<NumberOfViews>0</NumberOfViews>
<OccupationName i:nil="true"/>
<PublishedBy i:nil="true"/>
<PublishedFrom>9999-12-31T00:00:00</PublishedFrom>
<PublishedTo>9999-12-31T00:00:00</PublishedTo>
<Status>NotReady</Status>
<Title/>
</SearchResult>
<SearchResult>
<Created>2017-02-14T00:00:00</Created>
<JobAdId>4410850</JobAdId>
<NumberOfViews>0</NumberOfViews>
<OccupationName i:nil="true"/>
<PublishedBy i:nil="true"/>
<PublishedFrom>9999-12-31T00:00:00</PublishedFrom>
<PublishedTo>9999-12-31T00:00:00</PublishedTo>
<Status>NotReady</Status>
<Title/>
</SearchResult>
</SearchJobResult>
</SearchJobResponse>
</s:Body>
</s:Envelope>
GetJob - hent jobannonce
Dette SOAP kald henter en jobannonce, som er fremsøgt i listen herover
[id] skal erstattes med et kendt JobAdId.
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:GetJobRequestType>
<job:JobAdId>[id]</job:JobAdId>
</job:GetJobRequestType>
</soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetJobResponseType xmlns="http://jobnet.af.dk/JobAdService">
<JobAd xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ApplicationDetails>
<ApplicationMethods>
<ApplyByEmail>
<Email>test@igen.dk</Email>
</ApplyByEmail>
<ApplyByLetter>false</ApplyByLetter>
<ApplyByTelephone>
<TelephoneNumber>33445566</TelephoneNumber>
</ApplyByTelephone>
<ApplyOnline i:nil="true"/>
</ApplicationMethods>
<Description i:nil="true"/>
<JobContactList xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<a:JobContactType>
<Email>test@mer.dk</Email>
<PersonNameStructure>
<PersonGivenName>Anders</PersonGivenName>
<PersonSurnameName>And</PersonSurnameName>
</PersonNameStructure>
<Title>Entreprenør</Title>
<a:HidePhoneNumbers>false</a:HidePhoneNumbers>
<a:TelephoneNumberStructure>
<MobileNumber/>
<PrimaryNumber>55667788</PrimaryNumber>
<SecondaryNumber/>
<Telefax>55667789</Telefax>
</a:TelephoneNumberStructure>
</a:JobContactType>
</JobContactList>
<Referral>Karsten Elbæk</Referral>
</ApplicationDetails>
<HiringOrganizationDetails>
<AddressStructure>
<CountryCode>DK</CountryCode>
<FloorIdentifier/>
<MunicipalityId>360</MunicipalityId>
<MunicipalityName>Lolland</MunicipalityName>
<PostalCity>Maribo</PostalCity>
<PostalCode>4930</PostalCode>
<StreetBuildingIdentifier>7</StreetBuildingIdentifier>
<StreetName>V Henriksens Vej</StreetName>
<SuiteIdentifier/>
</AddressStructure>
<BranchCode i:nil="true"/>
<BranchDescription i:nil="true"/>
<Contact xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<Email>mne@mne.dk</Email>
<PersonNameStructure>
<PersonGivenName i:nil="true"/>
<PersonSurnameName i:nil="true"/>
</PersonNameStructure>
<Title i:nil="true"/>
<a:PrimaryNumber>55667788</a:PrimaryNumber>
<a:SecondaryNumber i:nil="true"/>
<a:Telefax>55667789</a:Telefax>
</Contact>
<CvrNumber>24212254</CvrNumber>
<Name>M.N. Entreprise A/S</Name>
<PNumber>1006412573</PNumber>
<Url/>
</HiringOrganizationDetails>
<Id>1188921</Id>
<JobAdDetails>
<JobPublishDates>
<LastModifiedDate>2007-12-13T16:47:32.05</LastModifiedDate>
<PublishEndDate>2017-09-10T00:00:00</PublishEndDate>
<PublishStartDate>2017-08-02T00:00:00</PublishStartDate>
</JobPublishDates>
<NumberOfReadsByCitizen>504</NumberOfReadsByCitizen>
<PostedBy i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract"/>
<Status>PublicationEnd</Status>
<Type>Normal</Type>
</JobAdDetails>
<JobDetails>
<AuthorityId>0</AuthorityId>
<AuthorityPhoneNumber/>
<Classification>
<EmploymentType>PermanentJob</EmploymentType>
<IsEuresJob>false</IsEuresJob>
<IsPublicSectorJob>false</IsPublicSectorJob>
</Classification>
<Description>Tømrersvende søges til selvstændigt arbejde. Må kunne tale og forstå dansk. Henvendelse til Karsten Elbæk på tlf. 20826213 eller Martin Nielsen tlf. 25377500.</Description>
<DriversLicences/>
<HidePhonenumbers>false</HidePhonenumbers>
<IsAnonymousEmployer>false</IsAnonymousEmployer>
<IsDisabilityFriendly>false</IsDisabilityFriendly>
<JobDates>
<ApplicationDeadlineDate>2017-09-10T00:00:00</ApplicationDeadlineDate>
<EmploymentDate i:nil="true"/>
<StartAsSoonAsPossible>true</StartAsSoonAsPossible>
</JobDates>
<JobLocation>
<Address>
<CountryCode>DK</CountryCode>
<FloorIdentifier i:nil="true"/>
<MunicipalityId>360</MunicipalityId>
<MunicipalityName>Lolland</MunicipalityName>
<PostalCity i:nil="true"/>
<PostalCode i:nil="true"/>
<StreetBuildingIdentifier i:nil="true"/>
<StreetName i:nil="true"/>
<SuiteIdentifier i:nil="true"/>
</Address>
<NoLocalBusinessAddress>false</NoLocalBusinessAddress>
</JobLocation>
<NumberOfPositions>3</NumberOfPositions>
<OccupationId>7115101</OccupationId>
<Schedule>
<DailyWorkTime>
<Day>false</Day>
<Evening>false</Evening>
<Night>false</Night>
<Weekend>false</Weekend>
</DailyWorkTime>
<WeeklyWorkTimeTypes>FullTime</WeeklyWorkTimeTypes>
<WorkHour>
</WorkHour>
</Schedule>
<Title>Tømrer/Snedkere søges</Title>
</JobDetails>
</JobAd>
</GetJobResponseType>
</s:Body>
</s:Envelope>
Fejlkoder
Dette SOAP kald returnerer en fejlkode på grund af valideringsfejl. Se oversigt over fejlkoder her
Eksempel på kald med ugyldigt JobAdID.
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:GetJobRequestType>
<job:JobAdId>42</job:JobAdId>
</job:GetJobRequestType>
</soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<s:Fault>
<faultcode>s:Client</faultcode>
<faultstring xml:lang="en-US">JobAd exception when calling GetJob method. Details: The job with id 42 could not be found</faultstring>
<detail>
<JobAdFault xmlns="http://jobnet.af.dk/JobAdService" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Code>JobAdNotFound</Code>
<Message>JobAd exception when calling GetJob method. Details: The job with id 42 could not be found</Message>
</JobAdFault>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>
Eksempel i C#
Her vises et eksempel hvordan et kald til JobAdService skabes med C#. Her er vist et kald til hhv. funktionen GetJob og SearchJob.
private void GetJob()
{
JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
JobAd jobb = jobAdService.GetJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, 4534569);
Console.WriteLine(jobb);
}
private void SearchJob()
{
JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
SearchParameters sp = new SearchParameters();
sp.CreatedFrom = DateTime.Now.AddDays(-400);
sp.CreatedTo = DateTime.Now;
sp.PageSize = 10;
sp.PageNumber = 0;
sp.Status = Status.Publication;
sp.JobAttributes = new JobAttribute[] { JobAttribute.EURES };
SearchResult[] jobs = jobAdService.SearchJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, sp);
Console.WriteLine(jobs);
}
Her kan du se en demo console application i c#.
| View file | ||||
|---|---|---|---|---|
|
Processer
Levering af jobannoncer til jobnet.dk
Jobannoncer sendes til publicering på jobnet.dk ved at kalde metoden AddJob med de data, der skal indgå i jobannoncen. Herefter sendes jobannoncen straks til godkendelse.
Hvis jobannoncen godkendes, vil jobannoncen blive publiceret på jobnet.dk på det tidspunkt, der er angivet i jobannoncen, og jobannoncen afpubliceres automatisk, når den angivne publiceringsdato udløber.
Hvis jobannoncen ikke godkendes, vil der blive sendt en e-mail til jobannoncens kontaktperson, der beskriver årsagen til at jobannoncen ikke kunne godkendes. Jobannoncen kan opdateres ved at kalde metoden UpdateJob med revideret indhold og derefter kalde PublishJob.
En jobannonce kan afpubliceres på jobnet.dk ved at kalde CloseJob.
En jobannonce kan slettes fra jobnet.dk ved at kalde DeleteJob.
Arbejdsgivere vil kunne se deres egne (identificeret ved CVR-nummer) jobannoncer på Jobnet for Arbejdsgivere uanset status (godkendt, publiceret, ikke-godkendt mv).
Afhentning af publicerede jobannoncer fra jobnet.dk
Du kan hente alle publicerede jobannoncer på jobnet.dk ved først at fremsøge jobannoncerne ved kald af metoden SearchJob med de ønskede fremsøgningskriterier. Bemærk, at SearchJob anvender paging, dvs. at man skal kalde metoden med fortløbende sidenumre indtil alle jobannoncer er fremsøgt. Man kan hente jobannoncernes indhold ved at kalde GetJob for hver jobannonce med det ID, der er returneret af SearchJob.
Bemærk, at man kun kan fremsøge og hente publicerede jobannoncer, samt at det kun er offentligt tilgængeligt indhold på jobannoncerne, der returnes
...
Borger kan hente sine CV oplysninger ned til det pågældende eksterne system. De CV oplysninger der bliver tilgængelige omfatter:
- CV's indhold
- Relevante ansættelsesbetingelser
Det er kun muligt at hente CV oplysninger på borger via metoden GetCVOnToken. Der kan f.eks. ikke adgang til foretages CV søgning, opdateres i borgers CV m.v.
Model for integration med eksterne systemer
Når en borger ønsker at hente sit CV ned til en trediepart (Kunde til CV) anvendes følgende model
| Drawio | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Trin 1 Token hentes
- Borger ønsker at hente sit CV fra Jobnet
- Trediepartsystem (kundesystem) redirecter borger til dedikeret loginside på Jobnet
- Borger giver Jobnet login informationer
- Hvis Borgers login er succesfuldt og trediepart (kundesystem) er kendt i DFDG fås Token med tilbage til trediepartsystemet (kundesystemet)
Trin 2 CV hentes
- Trediepart (kundesystem) kalder GetCVOnTokeni DFDG, med token
- Hvis Token er valid modtages CV informationer
Processer
Denne model understøtter kun, at borger ønsker at hente sit CV til trediepart (kundesystem).
Før trediepart (kundesystem) kan hente et CV, skal følgende være opfyldt:
- Trediepart (kundesystem) skal have en tilslutningsaftale til DFDG
- Have hentet en token for borgeren.
Token
En token udstedes:
- Til en given trediepart (kundesystem)
- På en given borger
- I en given kontekst
- Med en given gyldighedsperiode
Konteksten (tokentypen) vil i denne sammenhæng være "Hent CV"
Gyldighedsperioden vil for at hente CV oplysninger være en periode på (fx) 24 timer. Dvs. trediepart (kundesystem) kan kun hente CV oplysninger i en 24 timers periode efter token er udstedt. Ønsker borger efter de 24 timer at hente sit CV igen udstedes en ny token.
Procedure for tilslutning til CV webservice
Nye brugere, der er interesseret i at bruge JobAD CV webservice, skal starte med at kontakte Dorthe Uglebjerg.teamchef Kirsten Vestergaard på e-mail kiv@star.dk. Selve tilslutningen vil ske gennem STAR's systemforvalter
Telefon og mail
En indledende afklaring kan foregå via telefon på 72 21 75 77, men processen startes først, når der sendes en mail på DUG@star.dk. I mailen skal det fremgå:
- Hvem der er den nye kunde, adresse, firmanavn, kontaktperson og kontaktoplysninger
- Hvilke(en) af de to roller, der ønskes at få adgang til at bruge: Publicering af jobannoncer på jobnet.dk eller Afhentning af publicerede jobannoncer fra jobnet.dk
- Hvad webservice adgangen skal bruges til, fx visning af job på egen hjemmeside
Efter modtagelse af mail oprettes en intern sag, og webservice supporten får besked om, at give den nye kunde adgang til relevant web-service test-miljø.
Kunden går i gang
Den nye kunde udvikler herefter det software, der skal ende med, at de kan udveksle data med Jobnets webservicer. Udviklingstiden afhænger af de kompetencer og forudsætninger kunden råder over. Styrelsen for Arbejdsmarked og Rekruttering (STAR) udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservicer og viden til rådighed.
Support
Alle nye kunder får fem timers gratis support fra webservice supporten. De fem timer kan bruges i udviklingsperioden og i den efterfølgende drift. Support ud over fem timer skal godkendes af Dorthe Uglebjerg. Hvis det fravælges at betale for yderligere support, faktureres denne support mellem den nye kunde og web-service supporten og er Styrelsen for Arbejdsmarked og Rekruttering (STAR) uvedkommende.
Testmiljø og integrationstest
Du skal have gennemført integrationstest inden du kan publicere jobannoncer på Jobnet. Integrationstesten gennemføres på et testmiljø, hvor JobAD webservicen har følgende URL: ???.
Du kan fremsøge og vise dine (og andres) jobannoncer på Jobnet i testmiljøet.
Efter test
Testen er velgennemført, når webservice supporten meddeler, at der ingen fejl er i udveksling af data mellem kundens system og test-miljøet.
Dorthe Uglebjerg sender herefter pr. mail en Jobnet-webservice kontrakt, der skal underskrives af den nye kunde og derefter sendes retur med posten til Dorthe Uglebjerg.
Når STAR modtager den underskrevne kopi med posten, åbnes der for drifts-miljøet for den nye kunde72217560, men processen startes først, når der sendes en mail på teamchef Kirsten Vestergaard på e-mail kiv@star.dk. I mailen skal det fremgå:
- Hvem der er den nye kunde, adresse, firmanavn, CVR nr, kontaktperson og kontaktoplysninger
- Hvad webservice adgangen skal bruges til, fx i hvilken sammenhæng CV oplysningerne ønskes anvendt
Efter modtagelse af mail oprettes en intern sag i STAR, og der sendes en tilslutningsaftale til trediepart (kunden) til underskrift. Når den underskrevne tilslutningsaftale er modtaget i STAR, får webservice supporten (systemforvalter) besked om, at give den nye kunde adgang til relevant web-service test-miljø.
Trediepart (kunden) går i gang
Den nye trediepart (kunde) udvikler herefter det software, der skal ende med, at de kan udveksle data med CV webservice. Udviklingstiden afhænger af de kompetencer og forudsætninger, kunden råder over. STAR udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservice og viden til rådighed.
Support
Alle nye tredieparter (kunder) får fem timers gratis support fra webservice supporten (systemforvalter). De fem timer kan bruges i udviklingsperioden og i den efterfølgende drift. Support ud over fem timer faktureres mellem den nye kunde og web-service supporten (systemforvalter) og er STAR uvedkommende.
Testmiljø og test
STAR stiller testmiljø til rådighed og har nedestående forslag til testcase.
Testcase
- Trediepart (kunden) opretter et test NemID på en testbruger hos NemID
- Dette test NemID anvendes af trediepart (kunden) til at logge ind på Jobnet på det aftalte testmiljø.
- På Jobnet opretter trediepart (kunden) et CV med alle de ønskede oplysninger. Bemærk CV'et behøver ikke at være søgbart, for at det kan hentes
- Når CV'et er oprettet går trediepart (kunden) på eget system og aktiverer sin funktion til at hente CV
- På Jobnets dedikerede side til at hente en token, logger trediepart (kunden) ind med test NemID og token modtages herefter
- Med token hentes test borgers CV oplysninger af trediepart (kunden)
- Trediepart (kunden) verificerer nu, at de forventede CV oplysninger er modtaget
Efter test
Når trediepart (kunden) har gennemført sin test kontaktes teamchef Kirsten Vestergaard på e-mail kiv@star.dk med henblik at idriftsætte løsningen.
Eksempler
På denne side /wiki/spaces/ISB/pages/2091188585 finder du eksempler på kald af CV webservicen.
| Child pages (Children Display) |
|---|