Først av alt, la oss forklare hva et XML-feed er!

Kort sagt, XML er en informasjonsfil som kontinuerlig henter spesifikke data fra Visma Recruit. I dette tilfellet er den spesifikke informasjonen som hentes informasjon om annonsene som publiseres på kontoen din.

Vel, det brukes til å vise informasjon om publiserte annonser! Det er en måte å overføre dine publiserte annonser til, for eksempel, nettstedet ditt eller intranettet ditt, for å gjøre annonsene så tilgjengelige som mulig for potensielle kandidater.

Om du skal bruke et XML-feed for å vise dine publiserte annonser på nettstedet ditt og/eller intranettet ditt eller ikke, er helt opp til deg og hva som fungerer best for nettstedet ditt. Det finnes ingen riktig eller feil her, bare ulike behov basert på løsningene du allerede har på plass 😊

Fordelen med å bruke et XML-feed er at du kan designe utseendet og funksjonaliteten til annonselisten selv. Du har full frihet over designet fordi feedet kun inneholder rådata, og du kan vise det akkurat som du ønsker. Dette gir deg muligheten til å fullt ut integrere stillingslisten på nettstedet ditt.

Den økte friheten og kontrollen over design og funksjonalitet betyr at hvordan du velger å formatere rådataene i feedet er helt opp til deg, og vi vil ikke kunne gi støtte eller hjelp med det.

Ok, du er overbevist om ideen og vil bestille et XML-feed for å bruke på nettstedet ditt. Hvordan går du frem?

Du tar kontakt med din Customer Success Manager! 😄 De vil ønske å vite følgende informasjon:

Det er alt!

Et XML-feed inneholder data om dine publiserte annonser i et strukturert format. Sjekk bildet nedenfor for å se et eksempel på innholdet i et XML-feed.

Et XML-feed er strukturert som en tekstfil med en hierarkisk orden, lik en mappestruktur. Informasjonen organiseres i såkalte "elementer" som er omsluttet av tagger, for eksempel:

<AssignmentTitle>

Navnet på elementet i XML-feedet. Dette elementet refererer til, for eksempel, stillingstittelen.

Vi søker en erfaren Controller!

Etter navnet på elementet vises informasjonen du har skrevet inn i Recruit.

</AssignmentTitle>

Til slutt lukkes elementet med taggen </. Du kan tenke på dette som et punktum i en setning.

Hvert element kan inneholde data eller andre elementer. For eksempel har et XML-feed fra Visma Recruit et hovedelement for en annonse, <Assignment>, og innenfor det finnes det elementer for tittel, beskrivelse, sted, og så videre.

Det er med hjelp av disse elementene at den ansvarlige for nettstedet ditt kan bygge en helt tilpasset løsning, skreddersydd etter dine behov.

I det generelle XML-feedet du mottok, finner du grunnleggende informasjon om dine publiserte annonser. Imidlertid er ikke all annonseinformasjon inkludert i det generelle feedet. For å få detaljert informasjon om en spesifikk annonse (f.eks. søknadsmåte, kvalifikasjoner, osv.), må du endre XML-feed-lenken.

Slik gjør du det:

Eksempel:

<Assignment AssignmentId="313319">

<Guid>77EAB8F9-5827-4701-A93D-E5FAAEC9905E</Guid>

<AccountId>489</AccountId>

<AccountName>Bedrift</AccountName>

<PublishStartDate>2023-02-04T00:00:00</PublishStartDate>

Så, lenken endres fra: https://recruit.visma.com/External/Feeds/AssignmentList.ashx?guidGroup=83a811b3-8f39-4871-8ce5-08f8167e1d48

Til: https://recruit.visma.com/External/Feeds/AssignmentItem.ashx?guidGroup=83a811b3-8f39-4871-8ce5-08f8167e1d48&guidAssignment=77EAB8F9-5827-4701-A93D-E5FAAEC9905E

I det detaljerte XML-feedet for en individuell annonse finner du elementet <ApplicationMethods>. Dette elementet inneholder informasjon om søknadsmåtene for jobben. Når du klikker på søknadslinken, blir du tatt direkte til påloggingssiden/søknadsskjemaet.

På søknadssiden er det to faner: "Stillingsbeskrivelse", som inneholder annonseteksten, og "Søknad", hvor du kan sende inn søknaden din.

Hvis du vil at brukerne skal lande på fanen "Stillingsbeskrivelse" når de klikker på søknadslinken, kan du legge til &description=true eller &description=1 på slutten av lenken.

For eksempel: https://recruit.visma.com/spa/public/apply?guidAssignment=77eab8f9-5827-4701-a93d-e5faaec9905e&description=true

Hvis du bruker innstillingen "Forenklet annonsetrinn" (kombinerte annonsefelt), må du justere hvilket element i XML-feedet du bruker for å hente informasjon, da det endres når du aktiverer det nye annonsefeltet.

Når innstillingen ikke er aktivert, brukes følgende elementer i XML:

Elementet for det kombinerte annonsefeltet vil fortsatt vises i XML, men som selvstengende <AdDescription/>.

Når du aktiverer innstillingen, må du bruke følgende elementer for å hente annonseteksten:

Elementene for de gamle annonsefeltene vil fortsatt vises i XML-feedet, men vil være selvstengende, f.eks. <WorkDescr/>.

Hvis du har annonser publisert på nettstedet ditt når du aktiverer denne innstillingen, må du implementere støtte for å hente de nye elementene. Gamle annonser må fortsatt hentes fra <WorkDescr>, osv., mens nye annonser vil komme fra <AdDescription>. Derfor må støtte implementeres på nettstedet ditt for å hente annonsetekstene basert på hvilke elementer i XML som inneholder annonseteksten.