Hva er en XML-feed?
Først og fremst skal vi forklare hva en XML-feed er!
Kort fortalt er det en informasjonsflyt som kontinuerlig og løpende henter spesifikk informasjon fra Talent Hire. I dette tilfellet er den spesifikke informasjonen som hentes, informasjon om annonsene som publiseres på kontoen deres.
Hva brukes en XML-feed til?
Jo, den brukes til å kunne vise informasjon om publiserte annonser! Det er altså en måte å få overført de publiserte annonsene deres til for eksempel hjemmesiden eller intranettet, for å gjøre annonsene så tilgjengelige som mulig for potensielle kandidater.
Hvorfor skal vi bruke en XML-feed?
Om dere skal bruke en XML-feed for å vise de publiserte annonsene på hjemmesiden og/eller intranettet, er helt opp til dere og hva som fungerer best på akkurat deres nettside. Her finnes det ingen rett eller galt, men helt enkelt ulike behov ut fra hvilke løsninger dere allerede har på plass å jobbe med 😊
Fordelen med å bruke en XML-feed er at dere selv kan designe jobblistens utseende og funksjonalitet. Dere har full frihet over designet ettersom feeden kun inneholder rådata, og kan vises akkurat slik dere vil at den skal vises. Det gir dere muligheten til å integrere jobblisten fullstendig på nettsiden deres.
Den økte friheten og kontrollen over design og funksjonalitet innebærer at hvordan dere velger å formatere rådataene i feeden er helt opp til dere, og ikke noe vi vil kunne bistå med støtte eller support for.
Hvordan får vi tak i en XML-feed?
Ok, du er solgt på konseptet og vil bestille en XML-feed for å bruke på nettsiden deres, hvordan går du frem?
Du tar kontakt med deres Customer Success Manager! 😄 De vil da trenge å vite følgende:
Hvilke annonser skal feeden hente informasjon om?
De annonsene dere publiserer eksternt
De annonsene dere publiserer internt
Alle annonser som dere publiserer
Skal feeden gjelde for hele kontoen deres, eller skal den hente informasjon om en enkelt organisasjonsdel?
Hvem skal feeden sendes til når den er klar?
Det er alt!
Hvordan fungerer en XML-feed?
Resten av informasjonen i denne guiden er av litt mer teknisk karakter, og retter seg først og fremst mot de som skal jobbe med XML-feeden på nettsiden deres!
En XML-feed inneholder data om de publiserte annonsene deres på en strukturert måte. Se på bildet nedenfor for å se et eksempel på innholdet i en XML-feed.
En XML-feed er strukturert som en tekstfil med en hierarkisk rekkefølge, liknende en mappestruktur. Informasjonen organiseres i såkalte "elementer" som omsluttes av tagger, for eksempel:
<AssignmentTitle>Vi søker en HR-sjef til Talent Hire!</AssignmentTitle>
<AssignmentTitle>
Navnet på elementet i XML-feeden. Dette elementet refererer for eksempel til annonsetittelen.
Vi søker en HR-sjef til Talent Hire!
Etter navnet på elementet vises den informasjonen som dere har skrevet inn/angitt i Talent Hire.
</AssignmentTitle>
Til slutt lukkes elementet med taggen </. Man kan tolke dette som et punktum i en setning.
Hvert element kan inneholde data eller andre elementer. For eksempel har en XML-feed fra Talent Hire et hovedelement for en annonse "<Assignment>", og innenfor det finnes elementer for tittel, beskrivelse, sted, og så videre.
Det er altså ved hjelp av disse elementene at den ansvarlige for nettsiden deres kan bygge en helt kundetilpasset løsning, akkurat etter deres behov.
Detaljert XML-feed for individuelle annonser
I den generelle XML-feeden dere har mottatt, finner dere grunnleggende informasjon om de publiserte annonsene. Dere finner derimot ikke all annonseinformasjon i den generelle feeden. For å kunne få frem detaljert informasjon om en spesifikk annonse (f.eks. søknadsmetode, kvalifikasjoner, etc.) må lenken til XML-feeden endres.
Slik går du frem:
Bytt ut AssignmentList med AssignmentItem.
Legg til &guidAssignment= i slutten av lenken.
Etter likhetstegnet skal koden for taggen <Guid> limes inn.
<Assignment AssignmentId="313319">
<Guid>093C4C8F-4CF4-4A56-8FD5-4046021A872A</Guid>
<AccountId>489</AccountId>
<AccountName>Arbeidsgiveren</AccountName>
<PublishStartDate>2023-02-04T00:00:00</PublishStartDate>
Lenken endres altså fra:
Forklaring av søknadslenke <ApplicationMethods>
I den detaljerte XML-feeden om en individuell annonse finner dere elementet <ApplicationMethods>. Dette elementet inneholder informasjon om søknadsmetodene for stillingen. Når man klikker på søknadslenken sendes man direkte til innloggingssiden/søknadsskjemaet.
På søknadssiden finnes det to faner: "Jobbeskrivelse" som inneholder annonseteksten og "Søknad" der man kan sende inn søknaden sin.
Om dere vil at man skal lande på fanen med jobbeskrivelsen når man klikker på søknadslenken, kan dere legge til &description=true eller &description=1 på slutten.
For eksempel: https://hire.vismatalent.com/spa/public/apply?guidAssignment=7d3ac9b5-e609-4f45-8348-962343c8027a&description=true
Forenklet annonsesteg
Om dere bruker innstillingen "Forenklet annonsesteg" (felles annonsefelt), må dere endre hvilket element i XML-feeden dere henter informasjon fra, da den endres når man aktiverer det nye annonsefeltet.
Når dere ikke har forenklet annonsesteg aktivert, brukes følgende elementer i XML-en:
● <WorkDescr> - Arbeidsoppgaver
● <DepartmentDescr> - Om arbeidsplassen
● <Qualifications> - Kvalifikasjoner
● <AdditionalInfo> - Øvrig informasjon
Elementet for forenklet annonsesteg vil synes i XML-feeden, men vil være selvlukkende <AdDescription/>.
Når dere aktiverer forenklet annonsesteg, må følgende elementer brukes for å hente annonseteksten:
● <AdDescription>
● <DepartmentDescr>
Elementene for de gamle annonsefeltene vil fremdeles synes i XML-feeden, men vil være selvlukkende, f.eks. <WorkDescr/>.
Om dere har annonser publisert på hjemmesiden deres når dere aktiverer denne innstillingen, må dere legge inn støtte for dette når dere henter de nye elementene. Gamle annonser vil fremdeles måtte hentes fra <WorkDescr> osv., og nye annonser fra <AdDescription>. Derfor må det implementeres støtte på nettsiden deres for å hente annonsetekstene basert på hvilke elementer i XML-en annonseteksten finnes i.
Vær oppmerksom på at support dessverre ikke vil kunne gi støtte eller råd angående hvordan dere skal bruke XML-feeden dere mottar!