1a. Is het mogelijk?
Het is zeker mogelijk om zelf een import uit te voeren, afhankelijk van het niveau van technisch inzicht dat beschikbaar is voor de klant en hun geduld bij het doorwerken ervan.
Dit zou werken door een interne bron een script te laten schrijven dat informatie uit hun bestaande database kan halen, het kan omzetten in een Teamtailor-gereed formaat en het dan naar ons kan sturen. Dit kan gebeuren door de gegevens uit de bestaande database van de klant via API of via een document te halen.
Uiteindelijk is het enige wat telt dat ze mensen hebben die in staat zijn om gegevens en API's te begrijpen.
1b. Moet ik het doen?
Dit is een veel moeilijkere vraag - er zijn veel voor- en nadelen aan verbonden. Normaal gesproken zou dit vaker worden aanbevolen voor grotere bedrijven die meer middelen hebben om dit te doen, evenals een grotere behoefte aan een snellere oplossing.
Voordelen
Kan worden gedaan binnen je eigen schema
Je kunt zelf beslissen welke attributen en parameters moeten worden geïmporteerd en hoe het eruit moet zien
Het is helemaal gratis
We kunnen ondersteuning bieden bij het uitleggen hoe dit in zijn werk zou gaan
Nadelen
Vereist het schrijven van een essentieel uniek script dat informatie van de ene bron naar een formaat voor Teamtailor kan vertalen
De openbare API heeft een snelheidslimiet - 50 verzoeken per 10 seconden, wat betekent dat het importeren van een grote database veel tijd kan kosten
Vereist goede kennis van hoe gegevens en API's werken
2. Het proces
Begrijpen van de gegevens van Teamtailor
Begrijpen van Teamtailor's openbare API
Het schrijven van het script
Teamtailor heeft een relationeel gegevensmodel, wat betekent dat objecten attributen kunnen hebben die uniek voor hen zijn en relaties met andere objecten die dat niet zijn. Deze relaties zijn cruciaal om te begrijpen hoe Teamtailor werkt.
Attributen bevatten gegevens die uniek zijn voor deze specifieke sollicitatie - wanneer deze is aangemaakt, als deze is afkomstig enzovoort.
Relaties bevatten gegevens die niet uniek zijn voor deze sollicitatie, maar daarbuiten bestaan. Bijvoorbeeld, elke sollicitatie heeft relatie met kandidaat en functie.
Deze worden gebruikt om beter te begrijpen wie dit sollicitatieformulier heeft ingevuld en voor welke functie het is aangemaakt.
Dit is handig omdat als er wijzigingen zijn in de kandidaat of de functie, de sollicitatie functioneel zal blijven, aangezien het er alleen een link naar heeft. Het wordt niet direct beïnvloed door de wijzigingen in de andere twee. Dit betekent echter ook dat het maken van bepaalde objecten binnen Teamtailor mogelijk meer dan één verzoek vereist.
Kandidaatobject
Meestal worden importen gedaan om kandidaten te importeren en daarom is het belangrijk om te begrijpen hoe het kandidaatobject werkt en welke gegevens als attributen aan het object kunnen worden toegevoegd of als relaties.
Zoals eerder vermeld, zal een Kandidaatobject een relatie hebben met een Sollicitatie als er eerder een sollicitatie is geweest, maar er zijn nog veel meer van dergelijke relaties. Uiteindelijk, het kandidaatobject is de belangrijkste op het platform.
Attributen
De meest basale kandidaatgegevens kunnen hier worden gevonden - het belangrijkste is de naam, contactgegevens, toestemmingsgegevens en andere informatie die je daar zou willen bewaren.
Echter, je zult merken dat sommige andere gegevens hier niet worden gevonden - bijvoorbeeld, er is geen veld voor 'geslacht' of 'leeftijd'. Dat komt omdat Teamtailor werkt met een model voor gegevens met een open einde in gedachten. De basis is hier in de kenmerken, maar aanvullende gegevens moeten worden toegevoegd als aangepaste velden of antwoorden.
Relaties
Zoals je kunt zien aan de hand van deze tabel, kan de kandidaat vele verschillende relaties hebben.
Relevant voor de import:
Vragen en antwoorden bevatten gegevens over welke vragen de kandidaat heeft beantwoord en welke antwoorden zijn gegeven. Beide bestaan als afzonderlijke objecten buiten de kandidaat.
Aangepaste-veld waarden bevatten antwoorden op alle aangepaste velden die eerder zijn ingesteld. Bijvoorbeeld, als er een aangepast veld is met de naam 'ouder', dan zal de waarde van de kandidaat 'ja' of 'nee' zeggen. Het aangepaste veld zal hetzelfde worden gebruikt, maar de waarde zal uniek zijn voor de kandidaat. De waarde van het aangepaste veld (ja of nee) zal gerelateerd zijn aan de kandidaat en het aangepaste veld (geslacht).
Notities (Opmerkingen) kunnen alle vrije tekstinformatie bevatten die de recruiter heeft ingevoerd en kan ook worden toegevoegd via de API. Dit kan ook informatie bevatten die nergens anders past, bijvoorbeeld een cv-transcript.
Niet relevant voor de import:
Activiteiten bevatten de informatie over elke actie die op de kandidaat is uitgevoerd.
Uploads bevatten alle aanvullende documenten die de kandidaat heeft geüpload.
Partnerresultaten bevatten alle gegevens die wij hebben ontvangen van andere integraties die je mogelijk gebruikt, bijvoorbeeld testresultaten.
Afdeling, rol, regio's en locaties bevatten verschillende gegevens over waar de kandidaat solliciteert - deze worden automatisch overgenomen van elke functie waarop ze hebben gesolliciteerd en hebben geen directe betrekking op de locatie van de kandidaat.
2. Kennis van Teamtailor's openbare API
Teamtailor's openbare API is ontworpen in overeenstemming met de JSON: API-specificatie. Dit betekent dat we voornamelijk JSON gebruiken bij communicatie via de API. De documentatie bevat indien nodig voorbeelden en een handige bibliotheek die ook in je Postman kan worden geïmporteerd.
Bekijken van de gegevens
Zoals eerder uitgelegd heeft Teamtailor een relationeel gegevensmodel, wat betekent dat veel objecten met betrekking tot elkaar bestaan, inclusief kandidaten en hun aangepaste veldwaarden en antwoorden. Aangezien per verzoek slechts één nieuw object kan worden gemaakt, zijn hiervoor een bepaald aantal verzoeken nodig voor elke kandidaat.
Om dit gemakkelijker te maken, is het mogelijk om enkele van deze relaties in de respons te "openen" door een include-parameter toe te voegen. Bijvoorbeeld, als je wilt weten wat de aangepaste-veldwaarden zijn voor een kandidaat, kun je aan het verzoek ?include=aangepaste-veld-waarden
toevoegen, wat een aanvullende sectie onder de gegevens zal toevoegen die inbegrepen
wordt genoemd, die alle gegevens zal bevatten over de afzonderlijke aangepaste-veldwaarden die onder die relatie worden gevonden.
Dit betekent ook dat elk aangepast-veld-waarde, antwoord of notitie (opmerking) die aan de kandidaat wordt toegevoegd, als een afzonderlijk verzoek moet worden toegevoegd.
Snelheidslimiet
De snelheidslimiet is 50 verzoeken per 10 seconden, dus het script moet afkoelen wanneer dit is bereikt of de verzoeken moeten gespreid worden, zodat ze deze limiet nooit overschrijden. Normaal gesproken is het toevoegen van een vertraging van 300 ms tussen elk verzoek een goede manier om te voorkomen dat de snelheidslimiet wordt overschreden.
3. Het schrijven van het script
Hier is een proces voor een basisaangepaste import:
Post Candidate endpoint - use this to create a brand new candidate. Als er duplicaten zijn, worden deze standaard samengevoegd (als het attribuut 'samenvoegen' op true is ingesteld). Dit moet de basisinformatie voor de kandidaat bevatten - naam, e-mail, telefoonnummer, foto en cv. Dit moet de basisinformatie voor de kandidaat bevatten - naam, e-mail, telefoonnummer, foto en cv.
Als een cv nodig is, moet je deze eerst gedurende minstens 30 seconden op een openbare server uploaden en vervolgens de URL als het cv verstrekken. We zullen het cv-bestand binnen die 30 seconden uploaden, zodat je ze daarna kunt verwijderen.
Eindpunt voor aangepast veldwaarde posten - gebruik dit om aangepaste veldwaarden aan de kandidaat toe te voegen. Je hebt de kandidaat-ID en het aangepaste veld-ID nodig voordat je dat doet. Aangepaste velden kunnen worden gemaakt via hun eigen eindpunt of toegevoegd aan het platform, wat het makkelijkst is.
Eindpunt voor antwoord posten - gebruik dit om antwoorden aan de kandidatenkaart toe te voegen. Antwoorden kunnen ook betrekking hebben op een baan als de vraag specifiek is voor die vacature. Antwoorden zijn vergelijkbaar met aangepaste veldwaarden, maar ze zijn bedoeld om door de kandidaat zelf te worden ingevuld tijdens de sollicitatie, in plaats van iets dat door de recruiter is ingevoerd.
Eindpunt voor notities (Opmerkingen) - gebruik dit als je veel gegevens wilt uploaden en je niet helemaal zeker weet hoeveel van die gegevens er zijn. Dit komt op de kandidatenkaart, onder het tabblad Opmerkingen, als een feed. Notities (Opmerkingen) vereisen een gebruiker en een kandidaat.
Zodra de upload is voltooid, kunt u de informatie op het platform valideren door het aantal kandidaten te controleren en te controleren of ze de gewenste gegevens hebben.
Ondersteuningsteam
Als je problemen tegenkomt zoals foutmeldingen of als iets gewoon niet werkt zoals het zou moeten, kun je contact opnemen met onze ondersteuning door te klikken op de chatbox in het platform of door een e-mail te sturen naar support@teamtailor.com
Als je hulp nodig hebt bij bredere vragen, zoals het beter begrijpen van het proces of de gegevensstructuur, neem dan contact op met je Sales of CSM contact persoon en zij zullen je in contact brengen met iemand die je kan helpen.