search
Workday Push — Mise à niveau de l’API v44.1

Last Updated:

Nous activons cette fonctionnalité pour tous les clients Workday Push au moyen d’un déploiement progressif. Afin d’organiser les modifications de permissions requises, nous vous contacterons. Si vous avez des questions ou des demandes, veuillez contacter votre responsable de la réussite client.

Présentation

Beamery a effectué une mise à niveau complète de ses pipelines d’intégration Workday Push vers la version v44.1 de l’API SOAP Workday. Cette mise à niveau améliore les performances, la stabilité et l’intégrité des données de la plateforme, et introduit plusieurs améliorations clés qui n’étaient pas disponibles avec l’ancienne version de l’API (v31.2).

Principales mises à jour

  • Performances et stabilité : L’ancien pipeline envoyait tous les champs des candidats ainsi que toutes les candidatures associées dans une seule requête Put_Candidate volumineuse, ce qui entraînait des délais d’expiration et une dégradation des performances. La mise à niveau découple les pipelines et optimise les charges utiles de données.
  • Intégrité des données : La mise à niveau garantit une meilleure intégrité des données et résout les limitations de l’ancienne API. Par exemple, l’API v31.2 ne pouvait pas transmettre les seconds prénoms des candidats aux États-Unis ; la version v44.1 résout ce problème.

Modifications

  1. Mise à niveau de l’API Workday Candidate Push
    Le pipeline Workday Candidates Push utilise désormais la version v44.1 de l’API Workday Put_Candidate (et utilise également Get_Candidates et Get_References).
     

    Champ/Domaine Avant Après
    Mises à jour des champs du candidat (nom, lieu, téléphone) Tous les champs étaient envoyés, qu’ils aient été modifiés ou non. Seuls les champs modifiés (nom, lieu, téléphone) sont envoyés, ce qui évite les remplacements inutiles.
    Candidats fusionnés Les mises à jour étaient envoyées, mais l’API renvoyait de faux positifs sans effectuer réellement la mise à jour. Les mises à jour ne sont plus envoyées pour les candidats fusionnés dans Workday, mais pas dans Beamery. Ceux-ci sont désormais traités comme des rejets.
    Type d’appareil téléphonique Non obligatoire ; « Mobile » était utilisé par défaut. Obligatoire dans la version v44.1. Le mappage vérifie d’abord la configuration, puis recherche le type disponible le plus proche, avec « Mobile » comme solution de repli finale.
    URL Twitter/X Envoyée à la fois dans les champs Website data et Social Network Username. Envoyée uniquement en tant que Website data. Social Network Username ne fonctionne plus comme prévu dans l’API actuelle.
    Second prénom Non envoyé pour les candidats aux États-Unis (limitation de la version v31.2) ou dans les pays non pris en charge. Désormais envoyé pour les candidats aux États-Unis. Il n’est toujours pas envoyé pour les pays non pris en charge (Canada, Royaume-Uni, Inde, etc.).
    Employé existant (Worker_Reference) Les champs restreints du candidat pouvaient être remplacés, ce qui entraînait des échecs non signalés. La version v44.1 applique les restrictions. Le nom, le lieu, l’adresse e-mail, le téléphone, le site web et les réseaux sociaux ne sont PAS transmis pour les enregistrements avec un Worker_Reference. Les balises et les données de CV du prospect SONT toujours transmises.
    Données du prospect (Résumé, Compétences, Expérience) Transmises à toutes les candidatures existantes et nouvelles. Transmises uniquement aux nouvelles candidatures et au profil du prospect (pas aux candidatures préexistantes). Si aucun profil de prospect n’existe, un profil sera activé.
  2. Workday Application Push — Pipeline découplé
    Un pipeline distinct pour Workday Application Push a été mis en place, utilisant également Put_Candidate v44.1.
    Modification principale : les données de CV de la candidature (Résumé, Compétences, Expérience) sont désormais envoyées uniquement pour les nouvelles candidatures. Les candidatures existantes ne reçoivent plus de données de CV mises à jour par ce processus.
  3. Workday Attachment Push — Pipeline découplé
    Workday Attachment Push est désormais un pipeline découplé utilisant Put_Candidate_Attachment v44.1. Il n’y a aucun changement de fonctionnalité ou de comportement : cela correspond à l’implémentation précédente, dans laquelle les pièces jointes utilisaient une requête API distincte.

Modification des permissions

  • La mise à niveau de l’API SOAP v31.2 vers la version v44.1 nécessite une modification de permission pour le contenu Resume_Data.
  • Champs concernés : 
    • Prospect_Data.Prospect
    • Resume_Data.Summary
    • Resume_Data.Skill_Data
    • Resume_Data.Experience_Data
  • Permission requise :
    • « PUT Candidate Data: Attachments »

Sans cette permission, le système renvoie le message suivant : « You don’t have security access to add or make changes to a prospect’s attachments. »

Si l’envoi des pièces jointes est déjà activé, cette permission est déjà configurée et aucune action n’est requise.

--

Comment ajouter ou valider de nouvelles permissions pour le compte ISU


Pour ajouter ou valider des permissions pour un compte ISU, consultez la section « Assign Domain Security Policies » de l’article consacré à la création d’un compte ISU Workday et suivez les étapes ci-dessous :

Vérifier les permissions actuelles :
Comme indiqué à l’étape 4 de l’article, vous pouvez consulter les permissions existantes en accédant à la page View Integration System Security Group.

  • Repérez l’Integration System Security Group associé à l’Integration System User de Beamery.
  • Dans le tableau Domain Security Policy Permissions, recherchez la permission : « Candidate Data: Attachments » avec l’opération PUT .
  • Vérifiez si cette permission a déjà été accordée.
Ajouter une nouvelle permission :
Si la permission requise n’est pas présente :
  • Suivez l’étape 5 et accédez à la page Maintain Domain Permissions for Security Group.
  • Dans la section Integration Permissions, dans la liste Domain Security Policies permitting Put access, ajoutez la permission requise : « Candidate Data: Attachments »
Activer les modifications :
Après avoir ajouté la permission :
  • Terminez l’étape 6 : la tâche Activate your security policy changes.
  • Cette étape est requise pour garantir que les mises à jour sont appliquées et que la modification de permission est entièrement mise en œuvre.

     


Remarques importantes

  • Si votre tenant Workday exige que « Source » soit obligatoire lors de l’activation des profils de prospect, vous devrez créer une nouvelle source « Beamery » à l’aide de la tâche Maintain Recruiting Sources dans Workday.
  • Les URL LinkedIn et Facebook continuent d’être transmises dans le champ Social Network URLs.
  • Workday ne prend plus en charge les opérations Get ou Put pour les candidats fusionnés dans les versions récentes de l’API.

     


Foire aux questions

  • Pourquoi avez-vous découplé les candidats et les candidatures lors de l’envoi ?
    • Le fait de transmettre les deux dans une seule requête API entraînait des temps de traitement plus longs et de fréquents délais d’expiration des requêtes. Leur séparation réduit le risque de temps de traitement longs et d’échecs d’envoi.
  • Qu’implique ce découplage pour l’envoi distinct des candidatures ?
    • Les candidatures constituent désormais leur propre entité dans le modèle de données Beamery, conformément au modèle de données Workday. Auparavant, les mises à jour des compétences, de l’expérience et du résumé étaient envoyées aux candidatures nouvelles et anciennes. Elles sont désormais envoyées uniquement aux nouvelles candidatures.
  • Que se passe-t-il lorsqu’il n’existe aucun profil de prospect dans Workday ?
    • Les compétences, l’expérience et le résumé sont transmis au profil du prospect via Candidate Push. Si aucun profil de prospect n’existe, un profil est activé et renseigné. Toutes les nouvelles candidatures créées à partir du profil du prospect hériteront des dernières mises à jour.
  • Pourquoi la permission PUT Candidate Data: Attachments est-elle requise même sans pièces jointes ?
    • Workday a rendu les permissions plus granulaires à partir de la version v43.1 (version 2024R2). Les compétences, l’expérience et le résumé font partie de « Resume Data » dans le modèle de données Workday, et cette permission est requise pour mettre à jour ces données. Même lorsque l’envoi des pièces jointes n’est pas activé, cette permission reste nécessaire. Cela a été vérifié en collaboration avec Workday.