Option 5 : Exécutez la solution Node pour récupérer des jetons, puis créez une intégration dans une source externe comme Workday pour l’importation basée sur l’API

Après avoir inscrit une nouvelle application dans le Centre d’administration Microsoft 365, généré une clé secrète client et configuré l’importation dans le Centre d’administration Microsoft 365, vous pouvez exécuter notre solution Node pour récupérer des jetons sur la console. L’exécution de cette solution génère les jetons dont vous avez besoin pour créer ensuite l’intégration de l’API dans votre source externe, comme Workday. Découvrez comment procéder sur GitHub.

1. Exécuter la solution

  1. Clonez cette application sur votre ordinateur en exécutant la commande suivante sur la ligne de commande :

    git clone https://github.com/microsoft/orgdata_apibasedimport.git

  2. Incluez les valeurs de console suivantes :

  • AppID/ClientID
  • Clé secrète client
  • ID de locataire Microsoft Entra
  • ID du connecteur
  • Unité d’échelle
  1. Le script s’exécute et ouvre une nouvelle fenêtre de navigateur. Connectez-vous avec le même e-mail que vous avez entré sous ID d’application ou UPN lors de la configuration de l’importation dans le Centre d’administration Microsoft 365.

  2. Dans la page Configuration de l’intégration HRIS , copiez en toute sécurité les valeurs suivantes, que vous utiliserez pour créer l’intégration dans votre source externe , comme Workday Report as a Service (RaaS) :

  • Adresse HTTP
  • Access token (Jeton d’accès)
  • Jeton d’actualisation
  • URL du jeton d’actualisation

2. Créer un rapport personnalisé dans Workday

S’applique à : Administrateur général Microsoft 365 ou Administrateur de source de données organisationnelle

  1. Ouvrez Workday, recherchez « Créer un rapport personnalisé », puis sélectionnez-le.

    Capture d’écran montrant comment rechercher un rapport personnalisé.

  2. Entrez un nom pour votre rapport.

  3. En regard de Type de rapport, sélectionnez Avancé.

  4. En regard de Source de données, sélectionnez Workers pour les rapports HCM.

  5. Laissez Optimisé pour les performances effacé pour filtrer les workers qui n’ont pas d’adresse e-mail. Microsoft identifie les workers par adresse e-mail. Il s’agit donc d’un champ obligatoire.

    Capture d’écran montrant la page des détails du rapport.

  6. En bas de la page, sélectionnez OK.

  7. Pour ajouter des champs d’e-mail du responsable :

    1. Sélectionnez le menu à trois points à droite du nom de votre rapport.

    2. Sélectionnez Champ calculé pour Le rapport>Créer un champ calculé.

      Capture d’écran montrant comment créer un champ calculé.

    3. Entrez un nom pour le nouveau champ, par exemple « Manager Email ».

    4. En regard de Objet métier, entrez « Worker ».

    5. En regard de Fonction, entrez « Valeur associée à la recherche ».

      Capture d’écran montrant les détails du champ calculé.

    6. Sélectionnez OK.

    7. Dans l’écran suivant, en regard de Champ de recherche, entrez « Gestionnaire – Niveau 01 ».

    8. En regard de Valeur de retour, entrez le champ d’e-mail souhaité, tel que Adresse de Email de travail principale publique.

      Capture d’écran montrant les détails de la recherche de champ calculé.

    9. En bas de la page, sélectionnez OK.

  8. Ajoutez des champs et personnalisez le rapport en fonction des besoins de votre organization :

    1. Sélectionnez le menu à trois points à droite du nom de votre rapport.

    2. Sélectionnez Modification de rapport> personnalisé.

    3. En regard de Filtre de source de données, entrez « Tous les workers actifs (tous les types) ».

    4. Sous l’onglet Colonnes , sélectionnez l’icône « + » en haut à gauche pour ajouter des champs.

      Capture d’écran montrant comment personnaliser le rapport.

Exemple de mappages pour la plupart des champs réservés répertoriés ici

  • Le champ Manager Email fait référence au champ calculé que vous avez configuré ci-dessus.

  • Il s’agit d’une meilleure estimation pour le mappage de chaque champ ; il peut y avoir des mappages plus appropriés pour votre locataire en particulier.

  • Tous les champs réservés liés ci-dessus peuvent être ajoutés ici s’ils ne le sont pas déjà. Vous pouvez également ajouter tous les champs personnalisés de votre choix avec n’importe quel nom, et ceux-ci peuvent être importés dans toutes les applications qui utilisent des champs personnalisés.

Objet métier Field Remplacement de l’en-tête de colonne Alias XML de remplacement de l’en-tête de colonne
Travailleur ID d’employé Microsoft_EmployeeID Définissez cette colonne sur la même valeur que remplacement de l’en-tête de colonne
Travailleur Adresse de Email de travail principale publique Microsoft_PersonEmail
Travailleur Email du gestionnaire Microsoft_ManagerEmail
Travailleur Organisation de surveillance Microsoft_Organization
Travailleur Niveau de gestion Microsoft_LevelDesignation
Travailleur Famille d’emplois uniques Microsoft_JobDiscipline
Travailleur Titre de l’entreprise Microsoft_JobTitle
Travailleur Emplacement - Nom Microsoft_CompanyOfficeLocation
Travailleur Date d’embauche Microsoft_HireDate
Travailleur Prénom Microsoft_FirstName
Travailleur Nom Microsoft_LastName
Travailleur Nom légal au format d’affichage des rapports Microsoft_DisplayName
Travailleur Société - Nom Microsoft_Company
Travailleur Adresse professionnelle - Ligne 1 mise en forme Microsoft_CompanyOfficeStreet
Travailleur Adresse professionnelle - Ville Microsoft_CompanyOfficeCity
Travailleur Adresse professionnelle - État/province Microsoft_CompanyOfficeState
Travailleur Adresse professionnelle - Code postal Microsoft_CompanyOfficePostalCode
Travailleur Adresse professionnelle - Pays/région Microsoft_CompanyOfficeCountryOrRegion
Travailleur Type de worker - Texte Microsoft_EmploymentType
Travailleur Compétences actives Microsoft_UserSkillNames
Travailleur Numéro de téléphone professionnel principal public Microsoft_Phone
Travailleur Centre de coûts - ID Microsoft_CostCenter
Travailleur Division Microsoft_Division

Filtrez les workers qui n’ont pas d’e-mail en ajoutant à l’onglet Filtre , par exemple :

Capture d’écran montrant comment filtrer les employés qui n’ont pas d’e-mail.

Après avoir personnalisé le rapport, sélectionnez Avancé. Ensuite, sous Options des services web, sélectionnez Activer en tant que service web.

3. Créer l’intégration dans votre source externe

Procédez comme suit pour créer l’intégration de l’API dans Workday.

  1. En haut de l’écran dans Workday, recherchez « Créer une BEI », puis sélectionnez-la.

  2. Dans la page Créer une BEI :

    1. Entrez un nom pour l’intégration.
    2. Sélectionnez Sortant.
    3. Sélectionnez OK.
  3. Passez en revue et confirmez les détails dans la page Paramètres généraux . Si tout semble correct, sélectionnez Suivant.

  4. Dans la page Obtenir des données :

    1. En regard de Type de source de données, sélectionnez Rapport personnalisé.

    2. En regard de Rapport personnalisé, sélectionnez le rapport que vous souhaitez intégrer à votre connecteur Stockage Blob Azure.

    3. Sous Détails, en regard de Autre format de sortie, sélectionnez CSV.

      Capture d’écran montrant comment entrer des détails dans la page Obtenir des données.

    4. En bas de la page, sélectionnez Suivant.

  5. Dans la page Transformer , vous n’avez pas besoin d’apporter de modifications. Sélectionnez Suivant.

  6. Dans la page Remise :

    1. En regard de Méthode de remise, sélectionnez HTTP/SSL.
    2. En regard de Adresse HTTP, entrez l’adresse générée à partir des étapes ci-dessus.
    3. En regard de Type d’appel de service web, sélectionnez OAuth 2.0.
    4. En regard de Jeton d’accès, entrez le jeton d’accès généré à partir des étapes ci-dessus.
    5. En regard de Jeton d’actualisation, entrez le jeton d’actualisation généré à partir des étapes ci-dessus.
    6. En regard de Actualiser l’URL du jeton, entrez l’URL du jeton d’actualisation générée à partir des étapes ci-dessus.
    7. En regard de ID client, entrez appID/ClientID.
    8. En regard de Clé secrète client, entrez la clé secrète client.
    9. En regard de Nom de fichier, entrez le nom de fichier souhaité, qui doit être .csv.
    10. En bas de la page Remise , sélectionnez Suivant.
  7. Passez en revue les détails de la page Vérifier et envoyer . Si tout semble correct, sélectionnez OK.

  8. En regard du nom de votre intégration, sélectionnez Actions.

  9. Pointez sur Intégration, puis sélectionnez Lancer/Planifier l’intégration.

  10. Dans la page Intégration de lancement/planification :

    1. En regard de Intégration, sélectionnez le nom de l’intégration que vous avez créée.
    2. En regard de Fréquence d’exécution, choisissez la fréquence souhaitée.
    3. Sélectionnez OK.

    Capture d’écran montrant comment entrer les détails de l’intégration lancée.