Partager via

Appeler 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 destinée uniquement aux clients en préversion publique. Les fonctionnalités de la préversion peuvent ne pas être complètes et subir des modifications avant de devenir disponibles dans la version plus large.

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

1. Préparer et exporter vos données sur une fréquence définie

Importez 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. Découvrez comment structurer ce fichier de données.

À la fréquence que vous choisissez (par exemple, une fois par mois ou une fois par semaine), faites en sorte que votre application personnalisée exporte les données organisationnelles à partir de votre système source.

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

Pour importer vos données dans Microsoft 365, vous pouvez choisir parmi trois options :

  • Utilisez notre API pour créer une application personnalisée qui exporte et importe vos données à la fréquence que vous choisissez. Découvrir comment.

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

  • Exécutez notre script PowerShell, qui est également basé sur notre API. [Liens vers l’option 3 ci-dessous.]

Remarque

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

Avant d’utiliser l’une des options ci-dessous, vérifiez que vous disposez des informations suivantes :

  • ID d’application (client). Recherchez cet ID dans les informations de l’application inscrite dans le centre d’administration Microsoft Entra sous ID d’application (client).

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

  • Nom du certificat. Ce nom est configuré dans votre application inscrite. Une fois que vous avez chargé le certificat, le nom du certificat s’affiche sous Description dans le portail Azure. Vous pouvez utiliser le nom du certificat comme alternative à la clé secrète client.

  • Microsoft Entra l’ID de locataire. Vous trouverez cet ID dans la page de vue d’ensemble de l’application sous ID de répertoire (locataire).

  • Unité d’échelle : unité d’échelle fournie pour votre locataire, telle que « novaprdwus2-01 ».

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

Envoyer des données

Application d’enquête 1P/3P 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

[Corps] contenu du fichier en tant que multipart/form-data

Type : Archive zip

Contenu à archiver :

Metadata.json

Data.csv

[Corps de la demande]

Body: 

{ 

   "$content-type": "multipart/form-data", 

   "$multipart":  

    [ 

        { 

            "headers":  

                { 

                    "Content-Disposition": "form-data; name=\"file\"; filename=info" 

                   }, 

            "body": @{body('Get_blob_content_(V2)')} 

         } 

    ] 

}

[Corps de la réponse]

200:  
{ 

  "FriendlyName": "Data ingress", 

  "Id": "<ingestion Id>", 

  "ConnectorId": "<connector Id>", 

  "Submitter": "System", 

  "StartDate": "2023-05-08T19:07:07.4994043Z", 

  "Status": "NotStarted", 

  "ErrorDetail": null, 

  "EndDate": null, 

  "Type": "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 dans 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 en tant que fichier .csv à la fréquence choisie, puis importer ce fichier dans les applications et services Microsoft 365.

Option 2 : Importer des données via notre solution C# après l’exportation de données via votre application personnalisée

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 C# DescriptiveDataUploadApp sur la console. La solution C# DescriptiveDataUploadApp apporte 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 absolu du fichier .csv. Mettez en forme le chemin comme suit : 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 l’exportation de 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 apporte 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

    Vous pouvez également accéder à ce lien de la galerie PowerShell pour obtenir des instructions sur l’installation.

  4. Définissez les paramètres.

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

Apporter des modifications à la connexion ou aux données

  • Last updated on