Option 4 : Utiliser le modèle Azure Data Factory pour envoyer des données à notre importation basée sur l’API

Suivez les étapes ci-dessous pour utiliser un modèle Azure Data Factory pour envoyer des données à l’importation basée sur l’API.

1. Créer un Azure Data Factory

  1. Connectez-vous à https://adf.azure.com/en/datafactories.

  2. Créez une fabrique de données ou utilisez une fabrique de données existante. Renseignez les champs, puis sélectionnez Créer.

    Capture d’écran montrant comment créer une fabrique de données ou utiliser une fabrique de données existante.

2. Créer un pipeline et une activité

  1. Créez un pipeline et entrez un nom pour le pipeline.

    Capture d’écran montrant comment créer un pipeline.

  2. Sous Activités, ajoutez Copier les données.

    Capture d’écran montrant comment ajouter des données de copie.

3. Paramètres d’activité de copie des données : Général

Sélectionnez votre activité Copier des données , puis sélectionnez Général pour compléter chaque champ à l’aide des instructions ci-dessous.

Capture d’écran montrant comment copier les paramètres d’activité des données.

  • Nom : entrez un nom pour votre activité.
  • Description : entrez une description pour votre activité.
  • État de l’activité : sélectionnez Activé. Vous pouvez également sélectionner Désactivé pour exclure l’activité de l’exécution et de la validation du pipeline.
  • Délai d’expiration : il s’agit de la durée maximale pendant laquelle une activité peut s’exécuter. La valeur par défaut est de 12 heures, la durée minimale est de 10 minutes et la durée maximale autorisée est de sept jours. Le format est en D.HH :MM :SS.
  • Nouvelle tentative : nombre maximal de nouvelles tentatives. Cela peut être laissé comme 0.
  • Intervalle de nouvelle tentative (s) : nombre maximal de nouvelles tentatives. Cette valeur peut être laissée à 30 si la tentative de nouvelle tentative est définie sur 0.
  • Sortie sécurisée : lorsque cette option est sélectionnée, la sortie de l’activité n’est pas capturée dans la journalisation. Vous pouvez laisser cela effacé.
  • Entrée sécurisée : lorsque cette option est sélectionnée, l’entrée de l’activité n’est pas capturée dans la journalisation. Vous pouvez laisser cela effacé.

4. Paramètres d’activité de copie des données : Source

  1. Sélectionnez Source.

  2. Sélectionnez un jeu de données source existant ou sélectionnez +Nouveau pour créer un jeu de données source. Par exemple, sous Nouveau jeu de données, sélectionnez Stockage Blob Azure, puis sélectionnez le type de format de vos données.

    Capture d’écran montrant comment créer un jeu de données source.

  3. Définissez les propriétés du fichier .csv. Entrez un Nom et sous Service lié, sélectionnez un emplacement existant ou sélectionnez +Nouveau.

    Capture d’écran montrant comment définir les propriétés du fichier csv.

  4. Si vous avez sélectionné +Nouveau, entrez les détails du nouveau service lié en suivant les instructions ci-dessous.

    Capture d’écran montrant comment ajouter des détails pour le nouveau service lié.

  5. En regard de Jeu de données source, sélectionnez Ouvrir.

    Capture d’écran montrant comment ouvrir le jeu de données source.

  6. Sélectionnez Première ligne comme en-tête.

    Capture d’écran montrant comment sélectionner la première ligne comme en-tête.

5. Paramètres d’activité de copie des données : Récepteur

  1. Sélectionnez Récepteur.

  2. Sélectionnez +Nouveau pour configurer une nouvelle ressource rest afin de se connecter à l’API. Recherchez « Rest », puis sélectionnez Continuer.

    Capture d’écran montrant comment configurer une nouvelle ressource rest pour se connecter à l’API.

  3. Nommez le service. Sous Service lié , sélectionnez +Nouveau.

    Capture d’écran montrant comment nommer le service et ajouter un nouveau service lié.

  4. Recherchez « Rest » et sélectionnez-le.

    Capture d’écran montrant comment rechercher le jeu de données Rest.

  5. Entrez les champs en suivant les instructions ci-dessous.

    Capture d’écran montrant comment entrer les champs du jeu de données.

  • Nom : entrez un nom pour votre nouveau service lié.
  • Description : entrez une description de votre nouveau service lié.
  • Se connecter via le runtime d’intégration : entrez la méthode préférée.
  • URL de base : utilisez l’URL ci-dessous et remplacez {tenantid} par votre ID de locataire : https://api.orginsights.viva.office.com/v1.0/tenants/{tenantid}/modis/connectors/HR/ingestions/fileIngestion
  • Type d’authentification : sélectionnez votre type d’authentification comme Principal de service, puis sélectionnez Secret ou Certificat. Exemple de principal de service :

    • Inline : sélectionnez-la.

    • ID du principal de service : entrez l’ID d’application autorisé pour le connecteur d’API.

    • Clé du principal de service : entrez la clé.

      Capture d’écran montrant comment entrer la clé du principal de service.

    • Locataire : entrez l’ID de locataire.

    • ressource Microsoft Entra ID :https://api.orginsights.viva.office.com

    • Azure type de cloud : sélectionnez votre type de cloud Azure.

    • Validation du certificat de serveur : sélectionnez Activé.

  1. Entrez les paramètres récepteur en suivant les instructions ci-dessous.

    Capture d’écran montrant comment entrer les paramètres du récepteur.

  • Jeu de données récepteur : sélectionnez le jeu de données existant ou nouvellement créé.
  • Méthode de requête : sélectionnez POST.
  • Délai d’expiration de la demande : cinq minutes sont la valeur par défaut.
  • Intervalle de demande (ms) : 10 est la valeur par défaut.
  • Taille du lot d’écriture : la taille du lot doit être supérieure au nombre maximal de lignes dans votre fichier.
  • Type de compression Http : Aucun est la valeur par défaut. Vous pouvez également utiliser GZip.
  • En-têtes supplémentaires : sélectionnez +Nouveau.
    • Boîte 1 : x-nova-scaleunit
    • Valeur : vous pouvez récupérer la valeur en accédant à la page Connexions de données de la page Données organisationnelles dans Microsoft 365 (Accueil>Setup>Migration et importe>les données organisationnelles dans Microsoft 365>Data Connections). Ensuite, sélectionnez Nouvelle importation> Sélectionner le type > de connexion Démarrer la configuration> basée sur l’APIPage Configurer la connexion basée sur l’API.

6. Paramètres d’activité de copie des données : Mappage

  1. Sélectionnez Mappage.

  2. Pour le chargement de démarrage, veillez à inclure PersonId, ManagerId et Organization dans le mappage (nom de destination). Pour le chargement incrémentiel, vérifiez que les noms de destination sont cohérents avec ceux du chargement précédent, ainsi que PersonId. Vous ne pouvez pas effectuer de chargements incrémentiels avec de nouvelles colonnes, et PersonId est requis dans tous les chargements.

    Capture d’écran montrant comment entrer les paramètres d’activité pour mappage.

7. Paramètres d’activité de copie des données : Paramètres et propriétés de l’utilisateur

Aucune autre personnalisation n’est requise pour paramètres ou propriétés utilisateur. Vous pouvez modifier ces paramètres au cas par cas si nécessaire.

8. Activité de copie de données : Configuration du déclencheur (Automation)

Pour ajouter un déclencheur à la configuration d’Automation, sélectionnez Ajouter un déclencheur. L’automatisation recommandée est hebdomadaire. Vous pouvez également personnaliser la fréquence.

Capture d’écran montrant comment configurer le déclencheur.

Apporter des modifications à la connexion ou aux données

  • Last updated on