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 afin d’envoyer des données à l’importation basée sur l’API.

1. Créer une nouvelle 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. Complétez les champs, puis sélectionnez Créer.

    Capture d’écran montrant comment créer une fabrique de données ou utiliser une fabrique 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 de données : général

Sélectionnez votre activité Copier les données , puis sélectionnez Général pour compléter chaque champ en suivant les instructions ci-dessous.

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

  • Nom : Entrez un nom pour votre activité.
  • Description : Entrez une description pour votre activité.
  • État de l’activité : Sélectionnez Activé. Ou sélectionnez 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 valeur 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 tentatives. Il peut être laissé à 0.
  • Intervalle des nouvelles tentatives (s) : nombre maximal de nouvelles tentatives. Il peut être laissé à 30 si la 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 cette option désactivée.
  • Entrée sécurisée : lorsque cette option est sélectionnée, l’entrée de l’activité n’est pas capturée dans le journalisation. Vous pouvez laisser cette option désactivée.

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

  1. Sélectionner la 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 la 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 » et 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 qui montre comment rechercher le jeu de données REST.

  5. Pour ce faire, 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 pour 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-le.

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

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

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

    • Client : entrez l’ID du client.

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

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

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

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

    Capture d’écran montrant comment accéder aux paramètres de l’évier.

  • 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’attente de la demande : cinq minutes est la valeur par défaut.
  • Intervalle de requête (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 de 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 sur la page Service de données organisationnel Microsoft 365(>Accueil Configuration>Migration et importations>Connexions de donnéesdu service de> données organisationnel Microsoft 365). Ensuite, sélectionnez Nouvelle importation> Sélectionner le type > de connexion Démarrer la configuration> basée surl’API Page Configurer la connexion basée sur l’API.

6. Paramètres d’activité de copie de 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 téléchargement incrémentiel, vérifiez que les noms de destination sont cohérents avec ceux du chargement précédent, ainsi qu’avec 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 le mappage.

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

Aucune autre personnalisation n’est requise pour les paramètres ou lespropriétés de l’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 (automatisation)

Pour ajouter un déclencheur à la configuration de l’automatisation, 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