Appel à l’API Microsoft 365 pour transférer des données organisationnelles pour l’importation basée sur l’API (étape 2 sur 3) (préversion)

Importante

Cette fonctionnalité est réservée aux clients de la préversion publique. Les fonctionnalités en préversion ne seront peut-être pas complètes et risquent de subir des modifications avant d’être disponibles dans la version plus large.

S’applique à : Administrateur général Microsoft 365, administrateur de source de données organisationnelle ou administrateur de système d’information des ressources humaines

1. Préparez et exportez vos données selon une fréquence définie

Exportez les données organisationnelles de tous les employés de l’entreprise et ajoutez tous les champs que vous souhaitez importer dans un modèle .csv ou une sortie .csv automatisée dans une source externe comme Workday Report as a Service (RaaS). Découvrez comment structurer ce fichier de données.

À la fréquence que vous décidez (par exemple, une fois par mois ou une fois par semaine), demandez à votre application personnalisée ou intégration de source externe d’exporter les données organisationnelles de votre système source.

2. Appeler l’API pour importer vos données

Pour importer vos données dans Microsoft 365, vous avez le choix entre l’une des cinq options suivantes :

  1. Utilisez notre API pour créer une application personnalisée qui exporte et importe vos données à la fréquence de votre choix. Découvrir comment.

  2. Exécutez notre solution C# sur votre console, qui est basée sur notre API. Découvrir comment.

  3. Exécutez notre script PowerShell, qui est également basé sur notre API. Découvrir comment.

  4. Utilisez un modèle Azure Data Factory pour envoyer des données à l’importation basée sur l’API. Découvrir comment.

  5. Exécutez notre script Node pour récupérer des jetons OAuth. Utilisez ensuite ces jetons pour envoyer des données directement à partir d’une source externe comme Workday vers l’importation basée sur l’API. Découvrir comment.

Remarque

Nos solutions C# et PowerShell importent uniquement des données dans le service de données organisationnelles Microsoft 365. Ils n’exportent pas les données de votre système source.

Si vous utilisez l’option 1, 2, 3 ou 4, vérifiez que vous disposez des informations suivantes :

  • ID d’application (client). Trouvez cet ID dans les informations de l’application enregistrée dans le centre d’administration Microsoft Entra sous ID d’application (client).

  • Secret client : il s’agit d’une chaîne secrète que l’application utilise pour prouver son identité lorsque vous demandez un jeton. Il est également appelé mot de passe d’application. Ce secret s’affiche uniquement pour la première fois lors de la création du secret client. Pour créer une nouvelle clé secrète client, procédez comme suit.

  • Nom du certificat. Ce nom est configuré dans votre application inscrite. Une fois le certificat téléchargé, le nom du certificat s’affiche sous Description dans le portail Azure. Vous pouvez utiliser le nom du certificat au lieu de la clé secrète client.

  • ID de locataire Microsoft Entra. Vous trouverez cet ID sur la page de vue d’ensemble de l’application sous ID d’annuaire (locataire).

  • Unité d’échelle : unité d’échelle qui vous a été fournie pour votre client, par exemple « novaprdwus2-01 ».

  • Le fichier .csv et le chemin d’accès au fichier .csv.

Ou, si vous utilisez l’option 5, assurez-vous de disposer des informations suivantes :

  • ID d’application (client). Trouvez cet ID dans les informations de l’application enregistrée dans le Centre d’administration Microsoft 365 sous ID d’application (client).

  • Secret client : il s’agit d’une chaîne secrète que l’application utilise pour prouver son identité lorsque vous demandez un jeton. Il est également appelé mot de passe d’application. Ce secret s’affiche uniquement lorsque vous créez le secret client. Découvrez comment créer une nouvelle clé secrète client.

  • ID de locataire Microsoft Entra. Vous trouverez cet ID sur la page de vue d’ensemble de l’application sous ID d’annuaire (locataire).

  • ID du connecteur : Il s’agit de la chaîne à la fin de l’URL qui s’affiche lorsque vous sélectionnez votre connecteur basé sur l’API dans le Centre d’administration Microsoft 365, tel https://admin.cloud.microsoft/OrganizationalDataInM365/connection-details/[Connector ID here]que .

  • Unité d’échelle : unité d’échelle qui vous a été fournie pour votre client, par exemple « novaprdwus2-01 ».

Données Push

Application pour appeler l’API Microsoft 365 pour envoyer du contenu

[POST] https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion

Si le connecteur n’est pas défini :

403: Forbidden

Si le connecteur est défini mais que l’ingestion précédente n’est pas encore terminée :

400: Bad request: Previous ingestion is not complete.

Option 1 : Utiliser l’API Microsoft 365 pour créer une application d’importation/exportation personnalisée

Vous pouvez utiliser l’API Microsoft 365 pour créer une application personnalisée qui exporte automatiquement les données de votre système source, puis les importe vers le Centre d’administration Microsoft 365.

Votre application peut prendre n’importe quelle forme, comme un script PowerShell, mais elle doit exporter vos données sources sous forme de fichier .csv à la fréquence que vous choisissez, et importer ces fichiers dans les applications et services Microsoft 365.

Option 2 : importer des données via notre solution C# après les avoir exportées via votre application personnalisée

Une fois que vous avez exporté vos données sources sous la forme d’un fichier .csv à la fréquence que vous choisissez, vous pouvez exécuter la solution DescriptiveDataUploadApp C# sur la console. La solution C# DescriptiveDataUploadApp intègre ensuite vos données stockées localement dans Microsoft 365. En savoir plus sur GitHub.

Pour 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
    • Chemin d’accès absolu au fichier .csv. Formatez le chemin d’accès de cette façon : C:\\Users\\JaneDoe\\OneDrive - Microsoft\\Desktop\\info.csv
    • ID de locataire Microsoft Entra
    • Nom du certificat

Option 3 : exécuter la solution PowerShell DescriptiveDataUpload après avoir exporté des données via votre application personnalisée

Comme pour l’option 2, une fois que vous avez exporté vos données sources en tant que fichier .csv à la fréquence que vous choisissez, vous pouvez exécuter la solution PowerShell DescriptiveDataUpload sur la console. La solution PowerShell DescriptiveDataUpload intègre ensuite vos données stockées localement dans Microsoft 365. En savoir plus sur GitHub.

  1. Clonez le code source sur votre ordinateur en exécutant cette commande sur la ligne de commande :

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

  2. Ouvrez une nouvelle fenêtre PowerShell en tant qu’administrateur.

  3. Dans votre fenêtre PowerShell, exécutez la commande suivante :

    Install-Module -Name MSAL.PS

    Ou accédez à ce lien de galerie PowerShell pour obtenir des instructions sur l’installation.

  4. Définir les paramètres.

    • ClientID
    • pathTocsvFile
    • TenantId
    • novaScaleUnit
    • ingressDataType: HR
    • ClientSecret ou certificateName

Apporter des modifications à la connexion ou aux données

  • Last updated on