Vad är ett XML-flöde?
Först och främst ska vi förklara vad ett XML-flöde är!
Kortfattat så är det ett informationsflöde som kontinuerligt och löpande hämtar specifik information från Talent Hire. I det här fallet så är den specifika informationen som hämtas information om de annonser som publiceras på ert konto.
Vad används ett XML-flöde till?
Jo, det används för att kunna visa information om publicerade annonser! Det är alltså ett sätt att få över era publicerade annonser till exempelvis er hemsida eller intranät för att göra annonserna så tillgängliga som möjligt för potentiella kandidater.
Varför ska vi använda ett XML-flöde?
Om ni ska använda ett XML-flöde för att visa era publicerade annonser på er hemsida och/eller ert intranät är helt upp till er och vad som fungerar bäst på just er hemsida. Här finns inget rätt eller fel, utan helt enkelt olika behov utifrån vad ni redan har för lösningar på plats att jobba med 😊
Fördelen med att använda ett XML-flöde är att ni själva kan designa annonslistans utseende och funktionalitet. Ni har full frihet över designen eftersom flödet endast innehåller rådata och kan visas precis så som ni vill att det ska visas. Det ger er möjlighet att helt och hållet integrera jobblistan på er webbsida.
Den ökade friheten och kontrollen över design och funktionalitet innebär att hur ni väljer att formatera rådatan i flödet är helt upp till er, och inget som vi kommer kunna bistå med stöd eller support för.
Hur får vi tag på ett XML-flöde?
Okej, du är såld på det här och vill beställa ett XML-flöde för att kunna använda på er webbsida, hur gör du?
Du tar kontakt med er Customer Success Manager! 😄 De kommer då vilja veta följande:
Vilka annonser ska flödet hämta information om?
De annonser ni publicerar externt
De annonser ni publicerar internt
Alla annonser som ni publicerar
Ska flödet gälla för hela ert konto eller ska det hämta information om en enskild organisationsdel?
Vem ska flödet skickas till när det är klart?
Det är allt!
Hur fungerar ett XML-flöde?
Resten av informationen i den här guiden är av lite mer teknisk karaktär och riktar sig främst till de som kommer att jobba med era XML-flöden på er webbsida!
Ett XML-flöde innehåller data om era publicerade annonser på ett strukturerat sätt, kika på bilden nedan för att se ett exempel på innehållet i ett XML-flöde.
Ett XML-flöde är strukturerat som en textfil med en hierarkisk ordning, liknande en mappstruktur. Informationen organiseras i så kallade "element" som omsluts av taggar, exempelvis:
<AssignmentTitle>Vi söker en HR-chef till Talent Hire!</AssignmentTitle>
<AssignmentTitle>
Namnet på elementet i XML-flödet. Detta element refererar exempelvis till annonstiteln.
Vi söker en HR-chef till Talent Hire!
Efter namnet på elementet visas den information som ni skrivit in/angivit i Talent Hire.
</AssignmentTitle>
Till sist stängs elementet med taggen </. Man kan tolka detta som en punkt i en mening.
Varje element kan innehålla data eller andra element. Till exempel har ett XML-flöde från Talent Hire ett huvudelement för en annons "<Assignment>", och inom det finns element för titel, beskrivning, plats, och så vidare.
Det är alltså med hjälp av dessa element som den ansvariga för er webbplats kan bygga en helt kundanpassad lösning, precis efter era behov.
Detaljerat XML-flöde för individuella annonser
I det generella XML-flödet ni mottagit hittar ni grundläggande information om era publicerade annonser. Ni hittar däremot inte all annonsinformation i det generella flödet. För att kunna få fram detaljerad information om en specifik annons (ex. ansökningsmetod, kvalifikationer, etc.) behöver ni länken till XML-flödet ändras.
Så här går du tillväga:
Byt ut AssignmentList till AssignmentItem.
Lägg till &guidAssignment= i slutet av länken.
Efter likhetstecknet ska koden för taggen <Guid> klistras in.
<Assignment AssignmentId="313319">
<Guid>093C4C8F-4CF4-4A56-8FD5-4046021A872A</Guid>
<AccountId>489</AccountId>
<AccountName>Arbetsgivaren</AccountName>
<PublishStartDate>2023-02-04T00:00:00</PublishStartDate>
Länken ändras alltså från:
Förklaring av ansökningslänk <ApplicationMethods>
I det detaljerade XML-flödet om en individuell annons hittar ni elementet <ApplicationMethods>. Detta element innehåller information om ansökningsmetoderna för tjänsten. När man klickar på ansökningslänken skickas man direkt till inloggningssidan/ansökningsformuläret.
På ansökningssidan finns det två flikar: "Jobbeskrivning" som innehåller innehåller annonstexten och "Ansökan" där man kan skicka in sin ansökan.
Om ni vill att man ska landa på fliken med jobbeskrivningen när man klickar på ansökningslänken kan ni lägga till &description=true eller &description=1 i slutet.
Exempelvis: https://hire.vismatalent.com/spa/public/apply?guidAssignment=7d3ac9b5-e609-4f45-8348-962343c8027a&description=true
Förenklat annonssteg
Om ni använder inställningen “Förenklat annonssteg” (gemensamt annonsfält) behöver ni ändra vilket element i XML-flödet som ni plockar upp information i flödet från, då den förändras när man aktiverar det nya annonsfältet.
När ni inte har förenklat annonssteg aktiverat används följande element i XML:en:
● <WorkDescr> - Arbetsuppgifter
● <DepartmentDescr> - Om arbetsplatsen
● <Qualifications> - Kvalifikationer
● <AdditionalInfo> - Övrig information
Elementet för förenklat annonssteg kommer synas i XML-flödet, men kommer vara självstängande <AdDescription/>.
När ni aktiverar förenklat annonssteg behöver följande element användas för att hämta annonstexten:
● <AdDescription>
● <DepartmentDescr>
Elementen för de gamla annonsfälten kommer fortfarande synas i XML-flödet, men kommer vara självstängande, ex. <WorkDescr/>.
Om ni har annonser publicerade till er hemsida när ni aktiverar denna inställning behöver ni lägga in ett stöd när ni hämtar de nya elementen. Gamla annonser kommer fortfarande behöva hämtas från <WorkDescr> etc. och nya annonser från <AdDescription>. Därför behöver stöd implementeras på er webbsida för att hämta annonstexterna baserat på vilka element i XML-en annonstexten finns i.
Notera att supporten tyvärr inte kommer kunna ge stöd eller råd gällande hur ni ska använda det XML-flöde som ni får!