1a. Conditions
Il est tout à fait possible de réaliser une importation vous-même, selon vos compétences techniques et la patience dont vous disposez pour suivre le processus.
Cela passe par la création d'un script interne capable de récupérer les données de votre base existante, de les convertir en format compatible avec Teamtailor, puis de nous les transmettre. Cela peut être fait en récupérant les données de la base de données existante via une API ou à travers un fichier.
En résumé, tout ce qui compte, c'est d'être en capacité de comprendre les données et les API.
1b. Points à considérer
Cette méthode présente des avantages et des inconvénients à prendre en compte. En général, elle est plutôt recommandée aux grandes entreprises disposant de ressources dédiées et ayant besoin d'une solution rapide.
Avantages
Peut être fait à votre propre rythme
Vous pouvez décider de chaque attribut et paramètre qui est importé et ce à quoi il devrait ressembler
C'est complètement gratuit
Nous pouvons offrir un soutien pour vous expliquer le fonctionnement de l'importation
Inconvénients
Nécessite l'écriture d'un script unique qui traduisant les informations d'une source à un format accepté par Teamtailor
L' API publique a une limite de 50 requêtes toutes les 10 secondes, ce qui signifie qu'importer une grande base de données pourrait prendre beaucoup de temps
Nécessite une bonne compréhension de la façon dont les données et les API fonctionnent
2. Le processus
Comprendre les données de Teamtailor
Comprendre les données de l'API publique de Teamtailor
Écriture du script
Teamtailor a un modèle a un mode de données relationnelles, ce qui signifie que les objets peuvent avoir des attributs qui leur sont propres et des relations avec d'autres objets qui ne le sont pas. Ces relations sont essentielles pour comprendre le fonctionnement de Teamtailor.
Les attributs contiennent des données propres à chaque candidature : date de création, source, etc.
Les relations contiennent des données qui ne sont pas uniques à cette candidature mais qui existent en dehors d'elle. Par exemple, chaque candidature est en relation avec un candidat et une offre d'emploi.
Ces relations sont utilisées pour mieux comprendre qui a rempli cette demande d'emploi et pour quel poste elle a été créée.
Cela trouve son utilité en cas de modification du candidat ou de l'offre d'emploi, la candidature reste fonctionnelle puisqu'elle n'a pas de lien avec elles. La candidature n'est donc pas directement affectée par le changement des deux autres. Cependant, cela signifie aussi que la création de certains objets au sein de Teamtailor peut nécessiter plus d'une demande.
Objet Candidat
Le plus souvent, les importations sont effectuées pour importer des candidats, il est donc important de comprendre comment fonctionne l'objet candidat et quelles données peuvent être ajoutées en tant qu'attributs à l'objet ou en tant que relations.
Comme mentionné précédemment, un objet Candidat aura une relation avec une candidature à un offre d'emploi s'il y a eu une candidature précédente, mais il existe de nombreuses autres relations de ce type. Après tout, l'objet candidat est le plus important sur la plateforme.
Attributs
Les données de candidat les plus élémentaires peuvent être trouvées ici - c'est surtout le nom, les coordonnées, les données d'autorisation, et d'autres informations que vous souhaiteriez conserver.
Cependant, vous pourriez remarquer que certaines données ne se trouvent pas dans l'attribut - le 'sexe' ou 'l'âge' par exemple. Ceci car Teamtailor opère avec un modèle de données 'open-ended'. Les données de base sont ici dans les attributs, mais des données supplémentaires peuvent être ajoutées comme des champs personnalisés ou des réponses aux questions.
Relations
Comme vous pouvez le voir sur ce tableau, un candidat peut avoir de nombreuses relations différentes.
Pertinent à l'importation :
Questions et réponses contiennent des données sur les questions posées ainsi que les réponses fournies par le candidat. Ces deux dernières existent en tant qu'objets individuels en dehors du candidat.
Les Valeurs des champs personnalisés contiennent les réponses à tous les champs personnalisés qui ont été précédemment configurés. Par exemple, s'il y a un champ personnalisé appelé "parent", la valeur sur le candidat dira "oui" ou "non". Le champ personnalisé sera utilisé de la même manière, mais la valeur sera unique au candidat. La valeur du champ personnalisé (oui ou non) sera liée au candidat et au champ personnalisé (genre).
Notes (Commentaires) peuvent contenir toutes sortes d'informations de texte libre que le recruteur a saisies et peuvent aussi être ajoutées via l'API. Cela peut également contenir des informations qui ne correspondent nulle part ailleurs, par exemple, un transcript de CV.
Non pertinent à l'importation :
Activités contiennent les informations sur chaque action qui a été effectuée sur le candidat.
Téléchargements contiennent tous les documents supplémentaires que le candidat a téléversés.
Résultats du partenaire contiennent toutes les données que nous avons reçues d'autres intégrations que vous pourriez utiliser, par exemple, les résultats de tests.
Département, rôle, régions et localisations contiennent différentes données sur l'endroit où le candidat postule - elles sont automatiquement héritées de tout emploi auquel ils ont postulé et ne sont pas liées directement à l'emplacement du candidat.
2. Comprendre l'API publique de Teamtailor
L'API publique de Teamtailor est conçue conformément à la spécification JSON:API. Cela signifie que nous utilisons principalement JSON lors de la communication via l'API. La documentation contient des exemples fournis si nécessaire et une bibliothèque utile qui peut également être importée dans votre Postman.
Visualisation des données
Comme expliqué précédemment, Teamtailor a un modèle de données relationnel, ce qui signifie que bon nombre des objets existent en relation les uns avec les autres, y compris les candidats et leurs valeurs de champs personnalisés et réponses. Étant donné qu'un seul nouvel objet peut être créé par requête, cela nécessite un certain nombre de requêtes à effectuer pour chaque candidat.
Pour faciliter les choses, il est possible d"ouvrir" certaines de ces relations dans la réponse en ajoutant un paramètre include. Par exemple, si vous souhaitez connaître les valeurs des champs personnalisés pour un candidat, dans la requête vous pouvez ajouter ?include=custom-field-values ce qui ajoutera une section supplémentaire en dessous des données appelée included, qui contiendra toutes les données sur les valeurs des champs personnalisés individuels qui se trouvent sous cette relation.
Cela signifie également que chaque valeur de champ personnalisé, réponse, ou note (commentaire) qui seront ajoutées au candidat devraient être ajoutées comme une requête distincte.
Rate limit
La limite de requêtes est de 50 requêtes toutes les 10 secondes, ce qui signifie que le script s'arrête lorsque cela est atteint ou les requêtes devraient être espacées pour ne jamais atteindre cette limite. Ajouter un délai de 300ms entre chaque requête est un bon moyen d'éviter d'atteindre la limite de taux.
3. Écrire le script
Voici le process pour une importation personnalisée basique :
Post Candidate endpoint - utilisez ceci pour créer un nouveau candidat. S'il y a des doublons, ils seront fusionnés par défaut (si l'attribut de fusion est défini sur true). Cette requête doit contenir les informations de base du candidat - nom, email, numéro de téléphone, photo et CV.
Si un CV est nécessaire, vous devrez d'abord le télécharger sur un serveur public pendant au moins 30 secondes, puis fournir l'URL en tant que CV. Nous téléchargeons le fichier du CV en moins de 30 secondes, vous pourrez ensuite le supprimer.
Post Custom-field-value endpoint - utilisez ceci pour ajouter des valeurs de champ personnalisé au candidat. Vous aurez besoin de l'ID du candidat et de l'ID du champ personnalisé avant de le faire. Des champs personnalisés peuvent être créés via leur propre endpoint ou ajoutés à la plateforme, selon ce qui est le plus simple pour vous.
Post Answer endpoint - utilisez ceci pour ajouter des réponses à la fiche du candidat. Les réponses peuvent également avoir un lien avec un emploi si la question est spécifique à cet emploi. Les réponses sont similaires aux valeurs de champ personnalisées, mais elles sont destinées à être rempli par le candidat lui-même lors de la candidature, plutôt qu'ajouté par le recruteur.
Notes (Commentaires) endpoint - utilisez ceci si vous souhaitez télécharger beaucoup de données et que vous n'êtes pas certain de la quantité existante de ces données. Cela se retrouvera sur la fiche du candidat, sous l'onglet Commentaires, sous forme de flux. Les notes (commentaires) nécessitent un utilisateur et un candidat.
Une fois l’import terminé, vérifiez sur la plateforme le nombre de candidats et la présence des données souhaitées pour valider l’import.
Support
Si vous rencontrez des soucis comme des messages d’erreur ou un dysfonctionnement, contactez notre assistance via le chat ou à support@teamtailor.com
Pour des questions plus larges—sur le processus ou la structure des données par exemple—contactez votre équipe commerciale ou votre CSM, ils vous mettront en relation avec la bonne personne.
🤖 Cet article est traduit à l’aide de l’IA. Faites-nous savoir si quelque chose vous semble incorrect.

