Ces directives vous aideront à guider votre client pour créer un objet personnalisé dans son locataire Workday, l'inclure dans sa grille de candidats et écrire dans cet objet personnalisé via une API.

Étapes du client

Demandez au client d’ouvrir son compte Workday et de suivre les étapes ci-dessous.

1. Saisissez et sélectionnez la tâche Créer un objet personnalisé depuis la barre de recherche.
2. À l'ouverture de la tâche, définissez le nom de l'objet personnalisé . Assurez-vous de respecter une convention de nommage définie pour les objets personnalisés que votre équipe utilisera lors de leur création dans Workday. 
3. Saisissez un alias de service Web pour l’objet personnalisé.
   • Remarque : l’alias du service Web ne peut pas être modifié après la création de l’objet personnalisé.
4. Dans le champ « Autoriser plusieurs instances par objet personnalisé ? » , sélectionnez « Non » ou « Oui » pour indiquer si vous souhaitez stocker des données propres à chaque instance ou les partager entre plusieurs instances. Le client peut ouvrir ce lien pour plus d'informations sur ce paramètre.
5. Dans la section Définitions de champ , saisissez une étiquette de champ pour l’objet personnalisé.
6. Sélectionnez le type de champ approprié. Nous suggérons généralement de choisir entre la sélection par liste ou le texte libre .
   • Si l'objet personnalisé doit être utilisé pour gérer les statuts , List Select est une option viable car il permettra des capacités de reporting améliorées dans Workday.
     • Si le client choisit une liste de sélection, il devra alors créer une liste personnalisée qui sera alors disponible dans la liste déroulante Type de champ .
   • Si l'objectif est de capturer les réponses des candidats , le texte libre est plus approprié. 
7. Dans la section « Autorisations » , sélectionnez le domaine . Il est courant d'ajouter l'objet au domaine « Données du candidat : Candidature » .
8. Cliquez sur OK pour enregistrer l’objet personnalisé.
9. Pour activer un objet personnalisé dans Workday, ouvrez à nouveau la tâche Créer un objet personnalisé à partir de la barre de recherche.
10. Localisez et sélectionnez l’objet personnalisé que vous souhaitez activer.
11. Cliquez sur Activer .
12. Une fenêtre « Activer un objet personnalisé » s'ouvre. Sélectionnez l'objet souhaité dans les champs « Valeur d'affichage » et « ID de référence » .
13. Cochez la case « Masquer à l'affichage si vide » si vous préférez que l'objet reste masqué lorsqu'il est vide. Cette option est utile si un sous-ensemble de demandes n'utilise pas l'objet personnalisé. 
14. Cliquez sur OK pour activer l'objet.
15. Une fois l'objet personnalisé créé et activé, vous pouvez l'ajouter à l'interface utilisateur, généralement à la grille des candidats . Pour cela, saisissez « Modifier la configuration de la grille » et sélectionnez-la dans la barre de recherche.
16. Sélectionnez la configuration de grille que vous allez modifier. 
17. Sélectionnez l'emplacement de ce nouvel objet personnalisé sur la grille en sélectionnant l'icône + dans le groupe approprié. Assurez-vous de sélectionner le bon objet métier ; votre nouveau champ sera alors disponible. 
18. Cliquez sur OK pour ajouter l'objet.

Syntaxe API pour les objets personnalisés

La collection Postman fournie permet de collecter la syntaxe API nécessaire à l'écriture dans l'objet personnalisé lorsqu'il se trouve dans le domaine « Données candidat : Candidature » (le plus courant). La collection comprend trois requêtes API :

• Notre demande standard d'obtention de candidat : cette demande nécessite un paramètre de courrier électronique pour la récupération.
• Demande d'obtention de données supplémentaires sur la candidature : cette demande nécessite un paramètre Job App ID issu de la demande précédente. Pour garantir son efficacité, l'objet personnalisé doit être pré-rempli via l'interface utilisateur Workday. Le schéma renvoyé par l'appel d'API peut être utilisé pour écrire dans l'objet personnalisé.
• Exemple de requête POST pour l'écriture dans un objet personnalisé : cette requête est un exemple d'écriture dans un objet personnalisé. Il est important de noter que la syntaxe de cette action varie selon l'objet personnalisé concerné.

Objet personnalisé Workday.postman_collection