Configurer un connecteur pour importer des données RH

  • Article

Vous pouvez configurer un connecteur de données pour importer des données de ressources humaines (RH) liées à des événements tels que la démission d’un utilisateur ou une modification du niveau de travail d’un utilisateur. Les données RH peuvent ensuite être utilisées par la solution de gestion des risques internes pour générer des indicateurs de risque qui peuvent vous aider à identifier une activité malveillante ou un vol de données par des utilisateurs au sein de votre organization.

La configuration d’un connecteur pour les données RH que les stratégies de gestion des risques internes peuvent utiliser pour générer des indicateurs de risque consiste à créer un fichier CSV qui contient les données RH, à créer une application dans Microsoft Entra utilisée pour l’authentification, à créer un connecteur de données RH dans le portail Microsoft Purview ou le portail de conformité Microsoft Purview, puis en exécutant un script (sur une base planifiée) qui ingère les données RH dans les fichiers CSV dans le cloud Microsoft afin qu’elles soient disponibles pour la solution de gestion des risques internes.

Importante

Une nouvelle version du connecteur RH est désormais disponible en préversion publique. Pour créer un connecteur RH ou importer des données pour le nouveau scénario de profil d’employé pour le scénario de stratégie de santé pour la gestion des risques internes, accédez à la page Connecteurs de données dans le portail Microsoft Purview ou le portail de conformité, sélectionnez l’onglet Connecteurs , puis sélectionnez Ajouter un connecteur > RH (préversion) pour démarrer la configuration. Les connecteurs RH existants continueront de fonctionner sans interruption.

Conseil

Si vous n’êtes pas un client E5, utilisez la version d’évaluation de 90 jours des solutions Microsoft Purview pour découvrir comment des fonctionnalités Supplémentaires purview peuvent aider vos organization à gérer les besoins en matière de sécurité et de conformité des données. Commencez dès maintenant au hub d’essais portail de conformité Microsoft Purview. En savoir plus sur les conditions d’inscription et d’essai.

Avant de commencer

  • Déterminez les scénarios rh et les données à importer dans Microsoft 365. Cela vous aidera à déterminer le nombre de fichiers CSV et de connecteurs RH que vous devez créer, ainsi que la façon de générer et de structurer les fichiers CSV. Les données RH que vous importez sont déterminées par les stratégies de gestion des risques internes que vous souhaitez implémenter. Pour plus d’informations, consultez Étape 1.

  • Déterminez comment récupérer ou exporter les données à partir du système RH de votre organization (et régulièrement) et ajoutez-les aux fichiers CSV que vous créez à l’étape 1. Le script que vous exécutez à l’étape 4 charge les données RH dans les fichiers CSV dans le cloud Microsoft.

  • L’utilisateur qui crée le connecteur RH à l’étape 3 doit se voir attribuer le rôle de Administration connecteur de données. Ce rôle est nécessaire pour ajouter des connecteurs sur la page Connecteurs de données du portail Microsoft Purview ou du portail de conformité. Ce rôle est ajouté par défaut à plusieurs groupes de rôles. Pour obtenir la liste de ces groupes de rôles, consultez Rôles dans Microsoft Defender pour Office 365 et Conformité Microsoft Purview. Un administrateur de votre organization peut également créer un groupe de rôles personnalisé, attribuer le rôle de Administration connecteur de données, puis ajouter les utilisateurs appropriés en tant que membres. Pour plus d’informations, voir :

  • L’exemple de script que vous exécutez à l’étape 4 charge vos données RH dans le cloud Microsoft afin qu’elles puissent être utilisées par la solution de gestion des risques internes. Cet exemple de script n’est pris en charge dans aucun programme ou service de support standard Microsoft. L’exemple de script est fourni tel quel, sans garantie d’aucune sorte. Microsoft Corporation décline aussi toute garantie implicite, y compris et sans limitation, les garanties implicites de qualité marchande ou d’adéquation à un usage particulier. La totalité des risques découlant de l’utilisation ou de la performance de l’exemple de script et de la documentation repose sur vous. En aucun cas Microsoft, ses auteurs ou quiconque impliqué dans la création, la production ou la livraison des scripts ne sera responsable de tous dommages quels qu’ils soient (y compris, sans limitation, les dommages pour perte de profits, interruption d’activité, perte d’informations commerciales ou toute autre perte pécuniaire) découlant de l’utilisation ou de l’impossibilité d’utiliser les exemples de scripts ou la documentation, même si Microsoft a été informé de la possibilité de tels dommages.

  • Ce connecteur est disponible dans les environnements GCC dans le cloud Microsoft 365 US Government. Les applications et services tiers peuvent impliquer le stockage, la transmission et le traitement des données client de votre organization sur des systèmes tiers qui se trouvent en dehors de l’infrastructure Microsoft 365 et ne sont donc pas couverts par les engagements de Microsoft Purview et de protection des données. Microsoft ne fait aucune déclaration selon laquelle l’utilisation de ce produit pour se connecter à des applications tierces implique que ces applications tierces sont conformes à FEDRAMP. Pour obtenir des instructions pas à pas sur la configuration d’un connecteur RH dans un environnement GCC, consultez Configurer un connecteur pour importer des données RH dans le gouvernement des États-Unis.

  • Ajoutez le domaine webhook.ingestion.office.com à votre liste d’autorisation de pare-feu pour votre organization.

Étape 1 : Préparer un fichier CSV avec vos données RH

La première étape consiste à créer un fichier CSV qui contient les données RH que le connecteur importera dans Microsoft 365. Ces données seront utilisées par la solution de risque interne pour générer des indicateurs de risque potentiels. Les données des scénarios RH suivants peuvent être importées dans Microsoft 365 :

  • Démission de l’employé. Informations sur les employés qui ont quitté votre organization.

  • Changements au niveau du travail. Informations sur les changements de niveau d’emploi pour les employés, telles que les promotions et les rétrogradations.

  • Révisions des performances. Informations sur les performances des employés.

  • Plans d’amélioration des performances. Informations sur les plans d’amélioration des performances pour les employés.

  • Profil d’employé (préversion). Informations générales sur un employé.

Le type de données RH à importer dépend de la stratégie de gestion des risques internes et du modèle de stratégie correspondant que vous souhaitez implémenter. Le tableau suivant indique le type de données RH requis pour chaque modèle de stratégie :

Modèle de stratégie Type de données RH
Vol de données par des employés quittant votre organisation Démissions d’employés
Fuites de données Non applicable
Fuites de données par des utilisateurs prioritaires Non applicable
Fuites de données par des utilisateurs à risque Changements au niveau du travail, révisions des performances, plans d’amélioration des performances
Violations de stratégie de sécurité Non applicable
Violations de stratégie de sécurité par des utilisateurs quittant l’entreprise Démissions d’employés
Violations de la stratégie de sécurité par des utilisateurs prioritaires Non applicable
Violations de stratégie de sécurité par les utilisateurs à risque Changements au niveau du travail, révisions des performances, plans d’amélioration des performances
Langage offensant dans les messages électroniques Non applicable
Politique de santé Profil de l’employé

Pour plus d’informations sur les modèles de stratégie pour la gestion des risques internes, consultez Stratégies de gestion des risques internes.

Pour chaque scénario RH, vous devez fournir les données RH correspondantes dans un ou plusieurs fichiers CSV. Le nombre de fichiers CSV à utiliser pour votre implémentation de gestion des risques internes est décrit plus loin dans cette section.

Après avoir créé le fichier CSV avec les données RH requises, stockez-le sur l’ordinateur local sur lequel vous exécutez le script à l’étape 4. Vous devez également implémenter une stratégie de mise à jour pour vous assurer que le fichier CSV contient toujours les informations les plus actuelles afin que, quelle que soit l’exécution du script, les données RH les plus actuelles soient chargées dans le cloud Microsoft et accessibles à la solution de gestion des risques internes.

Importante

Les noms de colonnes décrits dans les sections suivantes ne sont pas des paramètres obligatoires, mais seulement des exemples. Vous pouvez utiliser n’importe quel nom de colonne dans vos fichiers CSV. Toutefois, les noms de colonnes que vous utilisez dans un fichier CSV doivent être mappés au type de données lorsque vous créez le connecteur RH à l’étape 3. Notez également que les exemples de fichiers CSV dans les sections suivantes sont affichés en mode Bloc-notes. Il est beaucoup plus facile d’afficher et de modifier des fichiers CSV dans Microsoft Excel.

Les sections suivantes décrivent les données CSV requises pour chaque scénario RH.

Fichier CSV pour les données de démission des employés

Voici un exemple de fichier CSV pour les données de démission des employés.

UserPrincipalName,ResignationDate,LastWorkingDate
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,2019-04-29T15:18:02.4675041+05:30
pilarp@contoso.com,2019-04-24T09:15:49Z,2019-04-29T15:18:02.7117540

Le tableau suivant décrit chaque colonne du fichier CSV pour les données de démission des employés.

Colonne Description
UserPrincipalName Microsoft Entra UserPrincipalName (UPN) utilisé pour identifier l’utilisateur terminé.
SignationDate Spécifie la date à laquelle l’emploi de l’utilisateur a été officiellement arrêté dans votre organization. Par exemple, il peut s’agir de la date à laquelle l’utilisateur a donné son avis de quitter votre organization. Cette date peut être différente de la date du dernier jour de travail de la personne. Utilisez le format de date suivant : yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm, qui est le format de date et d’heure ISO 8601.
LastWorkingDate Spécifie le dernier jour de travail de l’utilisateur arrêté. Utilisez le format de date suivant : yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm, qui est le format de date et d’heure ISO 8601.

Fichier CSV pour les données de modification au niveau du travail

Voici un exemple de fichier CSV pour les données de modification au niveau du travail.

UserPrincipalName,EffectiveDate,OldLevel,NewLevel
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Level 61 - Sr. Manager,Level 60- Manager
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30,Level 62 - Director,Level 60- Sr. Manager

Le tableau suivant décrit chaque colonne du fichier CSV pour les données de modification au niveau du travail.

Colonne Description
UserPrincipalName Microsoft Entra UserPrincipalName (UPN) utilisé pour spécifier l’adresse e-mail de l’utilisateur.
EffectiveDate Spécifie la date à laquelle le niveau de travail de l’utilisateur a été officiellement modifié. Utilisez le format de date suivant : yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm, qui est le format de date et d’heure ISO 8601.
Remarques Spécifie les remarques que l’évaluateur a fournies sur le changement de niveau de travail. Vous pouvez entrer une limite de 200 caractères. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.
OldLevel Spécifie le niveau de travail de l’utilisateur avant sa modification. Il s’agit d’un paramètre de texte libre qui peut contenir une taxonomie hiérarchique pour votre organization. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.
NewLevel Spécifie le niveau de travail de l’utilisateur après sa modification. Il s’agit d’un paramètre de texte libre qui peut contenir une taxonomie hiérarchique pour votre organization. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.

Fichier CSV pour les données d’évaluation des performances

Voici un exemple de fichier CSV pour les données de performances.

UserPrincipalName,EffectiveDate,Remarks,Rating
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Met expectations but bad attitude,2-Below expectation
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team

Le tableau suivant décrit chaque colonne du fichier CSV pour les données d’évaluation des performances.

Colonne Description
UserPrincipalName Microsoft Entra UserPrincipalName (UPN) utilisé pour spécifier l’adresse e-mail de l’utilisateur.
EffectiveDate Spécifie la date à laquelle l’utilisateur a été officiellement informé du résultat de son examen des performances. Il peut s’agir de la date à laquelle le cycle d’évaluation des performances s’est terminé. Utilisez le format de date suivant : yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm, qui est le format de date et d’heure ISO 8601.
Remarques Spécifie toutes les remarques que l’évaluateur a fournies à l’utilisateur pour l’évaluation des performances. Il s’agit d’un paramètre de texte avec une limite de 200 caractères. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.
Rating Spécifie l’évaluation fournie pour l’évaluation des performances. Il s’agit d’un paramètre de texte qui peut contenir n’importe quel texte de forme libre que votre organization utilise pour reconnaître l’évaluation. Par exemple, « 3 Attentes satisfaites » ou « 2 En dessous de la moyenne ». Il s’agit d’un paramètre de texte avec une limite de 25 caractères. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.

Fichier CSV pour les données du plan d’amélioration des performances

Voici un exemple de fichier CSV pour les données du plan d’amélioration des performances.

UserPrincipalName,EffectiveDate,ImprovementRemarks,PerformanceRating
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Met expectation but bad attitude,2-Below expectation
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team

Le tableau suivant décrit chaque colonne du fichier CSV pour les données d’évaluation des performances.

Colonne Description
UserPrincipalName Microsoft Entra UserPrincipalName (UPN) utilisé pour spécifier l’adresse e-mail de l’utilisateur.
EffectiveDate Spécifie la date à laquelle l’utilisateur a été officiellement informé de son plan d’amélioration des performances. Vous devez utiliser le format de date suivant : yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm, qui est le format de date et d’heure ISO 8601.
Remarques Spécifie toutes les remarques que l’évaluateur a fournies sur le plan d’amélioration des performances. Il s’agit d’un paramètre de texte avec une limite de 200 caractères. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.
Rating Spécifie toute évaluation ou toute autre information liée à l’évaluation des performances. Il s’agit d’un paramètre de texte qui peut contenir n’importe quel texte de forme libre que votre organization utilise pour reconnaître l’évaluation. Par exemple, « 3 Attentes satisfaites » ou « 2 En dessous de la moyenne ». Il s’agit d’un paramètre de texte avec une limite de 25 caractères. Ce paramètre est facultatif. Vous n’avez pas besoin de l’inclure dans le fichier CSV.

Fichier CSV pour les données de profil des employés (préversion)

Remarque

La possibilité de créer un connecteur RH pour les données de profil des employés est en préversion publique. Pour créer un connecteur RH qui prend en charge les données de profil des employés, accédez à la page Connecteurs de données dans le portail de conformité, sélectionnez l’onglet Connecteurs , puis sélectionnez Ajouter un connecteur>RH (préversion) . Suivez les étapes pour créer un connecteur à l’étape 3 : Créer le connecteur RH.

Voici un exemple de fichier CSV pour les données du profil d’employé.

UserPrincipalName,UserName,EmployeeFirstName,EmployeeLastName,EmployeeAddLine1,EmployeeAddLine2,EmployeeCity,EmployeeState,EmployeeZipCode,EmployeeDept,EmployeeType,EmployeeRole
jackq@contoso.com,jackq,jack,qualtz,50 Oakland Ave,#206,City,Florida,32104,Orthopaedic,Regular,Nurse

Le tableau suivant décrit chaque colonne du fichier CSV pour les données de profil des employés.

Colonne Description
UserPrincipalName* Microsoft Entra UserPrincipalName (UPN) utilisé pour spécifier l’adresse e-mail de l’utilisateur.
EmployeeFirstName* Prénom de l’employé.
EmployeeLastName* Nom de l’employé.
EmployeeAddressLine1* Adresse postale de l’employé.
EmployeeAddressLine2 Informations d’adresse secondaire, telles que le numéro d’appartement, pour l’employé.
EmployeeCity Ville de résidence de l’employé.
EmployeeState État de résidence de l’employé.
EmployeeZipCode* Code postal de résidence de l’employé.
EmployeeCountry Pays de résidence de l’employé.
EmployeeDepartment Service de l’employé dans le organization.
EmployeeType Type d’emploi de l’employé, par exemple régulier, exempté ou entrepreneur.
EmployeeRole Le rôle, la désignation ou la fonction des employés dans le organization.

Remarque

* Cette colonne est obligatoire. Si une colonne obligatoire est manquante, le fichier CSV n’est pas validé et les autres données du fichier ne sont pas importées.

Nous vous recommandons de créer un connecteur RH qui importe uniquement les données de profil des employés. Pour ce connecteur, veillez à actualiser fréquemment les données de profil des employés, de préférence tous les 15 à 20 jours. Les enregistrements de profil des employés sont supprimés s’ils ne sont pas mis à jour au cours des 30 derniers jours.

Détermination du nombre de fichiers CSV à utiliser pour les données RH

À l’étape 3, vous pouvez choisir de créer des connecteurs distincts pour chaque type de données RH ou vous pouvez choisir de créer un connecteur unique pour tous les types de données. Vous pouvez utiliser des fichiers CSV distincts qui contiennent des données pour un scénario RH (comme les exemples de fichiers CSV décrits dans les sections précédentes). Vous pouvez également utiliser un seul fichier CSV qui contient des données pour deux scénarios RH ou plus. Voici quelques recommandations pour vous aider à déterminer le nombre de fichiers CSV à utiliser pour les données RH.

  • Si la stratégie de gestion des risques internes que vous souhaitez implémenter nécessite plusieurs types de données RH, envisagez d’utiliser un seul fichier CSV qui contient tous les types de données requis.

  • La méthode de génération ou de collecte des données RH peut déterminer le nombre de fichiers CSV. Par exemple, si les différents types de données RH utilisés pour configurer un connecteur RH se trouvent dans un système RH unique dans votre organization, vous pouvez exporter les données vers un seul fichier CSV. Toutefois, si les données sont distribuées sur différents systèmes RH, il peut être plus facile d’exporter des données vers différents fichiers CSV. Par exemple, les données de démission des employés peuvent se trouver dans un système RH différent de celui des données de niveau de travail ou d’évaluation des performances. Dans ce cas, il peut être plus facile d’avoir des fichiers CSV distincts plutôt que d’avoir à combiner manuellement les données dans un seul fichier CSV. Par conséquent, la façon dont vous récupérez ou exportez des données à partir de vos systèmes RH peut déterminer le nombre de fichiers CSV dont vous aurez besoin.

  • En règle générale, le nombre de connecteurs RH que vous devez créer est déterminé par les types de données dans un fichier CSV. Par exemple, si un fichier CSV contient tous les types de données requis pour prendre en charge votre implémentation de gestion des risques internes, vous n’avez besoin que d’un seul connecteur RH. Toutefois, si vous avez deux fichiers CSV distincts qui contiennent chacun un seul type de données, vous devez créer deux connecteurs RH. Une exception à cela est que si vous ajoutez une colonne HRScenario à un fichier CSV (voir la section suivante), vous pouvez configurer un seul connecteur RH qui peut traiter différents fichiers CSV.

Configuration d’un seul fichier CSV pour plusieurs types de données RH

Vous pouvez ajouter plusieurs types de données HR à un seul fichier CSV. Cela est utile si la solution de gestion des risques internes que vous implémentez nécessite plusieurs types de données RH ou si les types de données se trouvent dans un seul système RH dans votre organization. Avoir moins de fichiers CSV vous permet toujours d’avoir moins de connecteurs RH à créer et à gérer.

Voici les conditions requises pour configurer un fichier CSV avec plusieurs types de données :

  • Vous devez ajouter les colonnes requises (et facultatives si vous les utilisez) pour chaque type de données et le nom de colonne correspondant dans la ligne d’en-tête. Si un type de données ne correspond pas à une colonne, vous pouvez laisser la valeur vide.

  • Pour utiliser un fichier CSV avec plusieurs types de données RH, le connecteur RH doit savoir quelles lignes du fichier CSV contiennent le type de données HR. Pour ce faire, ajoutez une colonne HRScenario supplémentaire au fichier CSV. Les valeurs de cette colonne identifient le type de données RH dans chaque ligne. Par exemple, les valeurs qui correspondent aux scénarios RH peuvent être « Démission », « Changement au niveau de l’emploi », « Évaluation des performances », « Plan d’amélioration des performances » et « Profil de l’employé ».

  • Si vous avez plusieurs fichiers CSV qui contiennent une colonne HRScenario**, assurez-vous que chaque fichier utilise le même nom de colonne et les mêmes valeurs qui identifient les scénarios RH spécifiques.

L’exemple suivant montre un fichier CSV qui contient la colonne HRScenario . Les valeurs de la colonne HRScenario identifient le type de données dans la ligne correspondante. L’exemple ci-dessous couvre quatre scénarios RH « Démission », « Changement de niveau de travail », « Évaluation des performances » et « Plan d’amélioration des performances ».

HRScenario,EmailAddress,ResignationDate,LastWorkingDate,EffectiveDate,Remarks,Rating,OldLevel,NewLevel
Resignation,sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,2019-04-29T15:18:02.4675041+05:30,,,,
Resignation,pilarp@contoso.com,2019-04-24T09:15:49Z,2019-04-29T15:18:02.7117540,,,,
Job level change,sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,,,,,Level 61 Sr. Manager, Level 60 Manager
Job level change,pillarp@contoso.com,2019-04-23T15:18:02.4675041+05:30,,,,,Level 62 Director,Level 60 Sr Manager
Performance review,sarad@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Met expectation but bad attitude,2 Below expectations,,
Performance review,pillarp@contoso.com,,,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team,,
Performance improvement plan,sarad@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Met expectations but bad attitude,2 Below expectations,,
Performance improvement plan,pillarp@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Multiple conflicts with the team,,

Remarque

Vous pouvez utiliser n’importe quel nom pour la colonne qui identifie le type de données RH, car vous mapperez le nom de la colonne dans votre fichier CSV en tant que colonne qui identifie le type de données RH lorsque vous configurez le connecteur à l’étape 3. Vous allez également mapper les valeurs utilisées pour la colonne de type de données lorsque vous configurez le connecteur.

Ajout de la colonne HRScenario à un fichier CSV qui contient un type de données unique

En fonction des systèmes RH de votre organization et de la façon dont vous allez exporter les données RH vers un fichier CSV, vous devrez peut-être créer plusieurs fichiers CSV qui contiennent un seul type de données RH. Dans ce cas, vous pouvez toujours créer un connecteur RH unique pour importer des données à partir de différents fichiers CSV. Pour ce faire, il vous suffit d’ajouter une colonne HRScenario au fichier CSV et de spécifier le type de données HR. Vous pouvez ensuite exécuter le script pour chaque fichier CSV, mais utiliser le même ID de travail pour le connecteur. Voir l'étape 4.

Étape 2 : Créer une application dans Microsoft Entra ID

L’étape suivante consiste à créer et inscrire une application dans Microsoft Entra ID. L’application correspond au connecteur RH que vous créez à l’étape 3. La création de cette application permet Microsoft Entra ID d’authentifier le connecteur RH lorsqu’il s’exécute et tente d’accéder à votre organization. Cette application sera également utilisée pour authentifier le script que vous exécutez à l’étape 4 pour charger vos données RH dans le cloud Microsoft. Lors de la création de cette application Microsoft Entra, veillez à enregistrer les informations suivantes. Ces valeurs seront utilisées à l’étape 3 et à l’étape 4.

  • id d’application Microsoft Entra (également appelé ID d’application ou ID client)

  • Microsoft Entra secret d’application (également appelé secret client)

  • ID de locataire (également appelé ID d’annuaire)

Pour obtenir des instructions pas à pas sur la création d’une application dans Microsoft Entra ID, consultez Inscrire une application auprès du Plateforme d'identités Microsoft.

Étape 3 : Créer le connecteur RH

L’étape suivante consiste à créer un connecteur RH dans le portail Microsoft Purview ou le portail de conformité. Après avoir exécuté le script à l’étape 4, le connecteur RH que vous créez ingère les données RH du fichier CSV dans votre organization Microsoft 365. Avant de créer un connecteur, veillez à disposer d’une liste des scénarios RH et des noms de colonnes CSV correspondants pour chacun d’eux. Vous devez mapper les données requises pour chaque scénario aux noms de colonnes réels dans votre fichier CSV lors de la configuration du connecteur. Vous pouvez également charger un exemple de fichier CSV lors de la configuration du connecteur. L’Assistant vous aidera à mapper le nom des colonnes aux types de données requis.

Une fois cette étape terminée, veillez à copier l’ID de travail généré lorsque vous créez le connecteur. Vous utiliserez l’ID du travail lorsque vous exécuterez le script.

Sélectionnez l’onglet approprié pour le portail que vous utilisez. Pour en savoir plus sur le portail Microsoft Purview, consultez Portail Microsoft Purview. Pour en savoir plus sur le portail de conformité, consultez portail de conformité Microsoft Purview.

  1. Connectez-vous au portail Microsoft Purview.

  2. Sélectionnez Paramètres Connecteurs>de données.

  3. Sélectionnez Mes connecteurs, puis Ajouter un connecteur.

  4. Dans la liste, choisissez HR (préversion) .

  5. Dans la page Configurer la connexion , procédez comme suit, puis sélectionnez Suivant :

    1. Tapez ou collez l’ID d’application Microsoft Entra de l’application Azure que vous avez créée à l’étape 2.

    2. Tapez un nom pour le connecteur RH.

  6. Dans la page Scénarios RH, sélectionnez un ou plusieurs scénarios RH pour lesquels vous souhaitez importer des données, puis sélectionnez Suivant.

    Sélectionnez un ou plusieurs scénarios RH.

  7. Dans la page méthode de mappage de fichiers, sélectionnez un type de fichier si nécessaire, puis sélectionnez l’une des options suivantes, puis sélectionnez Suivant.

    • Chargez un exemple de fichier. Si vous sélectionnez cette option, sélectionnez Charger l’exemple de fichier pour charger le fichier CSV que vous avez préparé à l’étape 1. Cette option vous permet de sélectionner rapidement des noms de colonnes dans votre fichier CSV dans une liste déroulante pour les mapper aux types de données pour les scénarios RH que vous avez sélectionnés précédemment.

    OR

    • Fournissez manuellement les détails du mappage. Si vous sélectionnez cette option, vous devez taper le nom des colonnes dans votre fichier CSV pour les mapper aux types de données pour les scénarios RH que vous avez sélectionnés précédemment.

  8. Dans la page Détails du mappage de fichiers, effectuez l’une des opérations suivantes, selon que vous avez chargé un exemple de fichier CSV et que vous configurez le connecteur pour un seul scénario RH ou pour plusieurs scénarios. Si vous avez chargé un exemple de fichier, vous n’avez pas besoin de taper les noms de colonnes. Vous les choisissez dans une liste déroulante.

    • Si vous avez sélectionné un seul scénario RH à l’étape précédente, tapez les noms d’en-tête de colonne (également appelés paramètres) à partir du fichier CSV que vous avez créé à l’étape 1 dans chacune des zones appropriées. Les noms de colonnes que vous tapez ne respectent pas la casse, mais veillez à inclure des espaces si les noms de colonne de votre fichier CSV incluent des espaces. Comme expliqué précédemment, les noms que vous tapez dans ces zones doivent correspondre aux noms de paramètres dans votre fichier CSV. Par exemple, la capture d’écran suivante montre les noms des paramètres de l’exemple de fichier CSV pour le scénario RH de démission de l’employé indiqué à l’étape 1.

    • Si vous avez sélectionné plusieurs types de données à l’étape ci-dessus, vous devez entrer le nom de colonne d’identificateur qui identifiera le type de données HR dans votre fichier CSV. Après avoir entré le nom de la colonne d’identificateur, tapez la valeur qui identifie ce type de données HR, puis tapez les noms d’en-tête de colonne pour les types de données sélectionnés à partir des fichiers CSV que vous avez créés à l’étape 1 dans chacune des zones appropriées pour chaque type de données sélectionné. Comme expliqué précédemment, les noms que vous tapez dans ces zones doivent correspondre aux noms de colonnes dans votre fichier CSV.

  9. Dans la page Révision , passez en revue vos paramètres, puis sélectionnez Terminer pour créer le connecteur.

    Une page status qui confirme que le connecteur a été créé s’affiche. Cette page contient deux éléments importants dont vous avez besoin pour effectuer l’étape suivante pour exécuter l’exemple de script afin de charger vos données RH.

    Page de révision avec l’ID de travail et lien vers github pour l’exemple de script.

    1. ID du travail. Vous aurez besoin de cet ID de travail pour exécuter le script à l’étape suivante. Vous pouvez le copier à partir de cette page ou à partir de la page de menu volant du connecteur.

    2. Lien vers l’exemple de script. Sélectionnez le lien ici pour accéder au site GitHub afin d’accéder à l’exemple de script (le lien ouvre une nouvelle fenêtre). Gardez cette fenêtre ouverte afin de pouvoir copier le script à l’étape 4. Vous pouvez également ajouter un signet à la destination ou copier l’URL pour y accéder à nouveau lorsque vous exécutez le script. Ce lien est également disponible sur la page de menu volant du connecteur.

  10. Sélectionnez Terminé.

    Le nouveau connecteur s’affiche dans la liste sous l’onglet Connecteurs .

  11. Sélectionnez le connecteur RH que vous venez de créer pour afficher la page de menu volant, qui contient des propriétés et d’autres informations sur le connecteur.

    Page de menu volant pour le nouveau connecteur RH.

Si vous ne l’avez pas déjà fait, vous pouvez copier les valeurs de l’ID Azure App et de l’ID de travail du connecteur. Vous en aurez besoin pour exécuter le script à l’étape suivante. Vous pouvez également télécharger le script à partir de la page de menu volant (ou le télécharger à l’aide du lien à l’étape suivante).)

Vous pouvez également sélectionner Modifier pour modifier l’ID Azure App ou les noms d’en-têtes de colonne que vous avez définis dans la page Mappage de fichiers.

Étape 4 : Exécuter l’exemple de script pour charger vos données RH

Importante

Vous devez ajouter le domaine webhook.ingestion.office.com à votre liste d’autorisation de pare-feu pour votre organization. Si ce domaine est bloqué, le script ne s’exécute pas.

La dernière étape de la configuration d’un connecteur RH consiste à exécuter un exemple de script qui charge les données RH dans le fichier CSV (que vous avez créé à l’étape 1) dans le cloud Microsoft. Plus précisément, le script charge les données dans le connecteur RH. Après avoir exécuté le script, le connecteur RH que vous avez créé à l’étape 3 importe les données RH dans votre organization Microsoft 365, où ils sont accessibles par d’autres outils de conformité, tels que la solution de gestion des risques Internes. Après avoir exécuté le script, envisagez de planifier une tâche pour l’exécuter automatiquement quotidiennement afin que les données d’arrêt des employés les plus actuelles soient chargées dans le cloud Microsoft. Consultez Planifier l’exécution automatique du script.

  1. Accédez à la fenêtre que vous avez laissée ouverte à l’étape précédente pour accéder au site GitHub avec l’exemple de script. Vous pouvez également ouvrir le site avec signet ou utiliser l’URL que vous avez copiée. Vous pouvez également accéder au script ici.

  2. Sélectionnez le bouton Brut pour afficher le script en mode texte.

  3. Copiez toutes les lignes de l’exemple de script, puis enregistrez-les dans un fichier texte.

  4. Modifiez l’exemple de script pour votre organization, si nécessaire.

  5. Enregistrez le fichier texte en tant que fichier de script Windows PowerShell en utilisant un suffixe de nom de fichier de .ps1; par exemple, HRConnector.ps1. Vous pouvez également utiliser le nom de fichier GitHub pour le script, qui est upload_termination_records.ps1.

  6. Ouvrez une invite de commandes sur votre ordinateur local, puis accédez au répertoire dans lequel vous avez enregistré le script.

  7. Exécutez la commande suivante pour charger les données RH dans le fichier CSV dans le cloud Microsoft . par exemple :

    .\HRConnector.ps1 -tenantId <tenantId> -appId <appId>  -appSecret <appSecret>  -jobId <jobId>  -filePath '<filePath>'

    Le tableau suivant décrit les paramètres à utiliser avec ce script et leurs valeurs requises. Les informations que vous avez obtenues dans les étapes précédentes sont utilisées dans les valeurs de ces paramètres.

    Paramètre Description
    tenantId Il s’agit de l’ID de votre organization Microsoft 365 que vous avez obtenu à l’étape 2. Vous pouvez également obtenir l’ID de locataire de votre organization dans le panneau Vue d’ensemble du centre d'administration Microsoft Entra. Cela permet d’identifier vos organization.
    appId Il s’agit de l’ID d’application Microsoft Entra de l’application que vous avez créée dans Microsoft Entra ID à l’étape 2. Il est utilisé par Microsoft Entra ID pour l’authentification lorsque le script tente d’accéder à votre organization Microsoft 365.
    appSecret Il s’agit du secret Microsoft Entra de l’application que vous avez créée dans Microsoft Entra ID à l’étape 2. Il est également utilisé pour l’authentification.
    jobId Il s’agit de l’ID de travail du connecteur RH que vous avez créé à l’étape 3. Il permet d’associer les données RH chargées dans le cloud Microsoft au connecteur RH.
    filePath Il s’agit du chemin d’accès du fichier (stocké sur le même système que le script) que vous avez créé à l’étape 1. Essayez d’éviter les espaces dans le chemin d’accès au fichier ; sinon, utilisez des guillemets simples.

    Voici un exemple de syntaxe pour le script de connecteur RH utilisant des valeurs réelles pour chaque paramètre :

     .\HRConnector.ps1 -tenantId d5723623-11cf-4e2e-b5a5-01d1506273g9 -appId 29ee526e-f9a7-4e98-a682-67f41bfd643e -appSecret MNubVGbcQDkGCnn -jobId b8be4a7d-e338-43eb-a69e-c513cd458eba -filePath 'C:\Users\contosoadmin\Desktop\Data\employee_termination_data.csv'

    Si le chargement réussit, le script affiche le message Chargement réussi .

    Remarque

    Si vous rencontrez des problèmes lors de l’exécution de la commande précédente en raison de stratégies d’exécution, consultez À propos des stratégiesd’exécution et Set-ExecutionPolicy pour obtenir des conseils sur la définition des stratégies d’exécution.

Étape 5 : Surveiller le connecteur RH

Après avoir créé le connecteur RH et exécuté le script pour charger vos données RH, vous pouvez afficher le connecteur et charger status dans le portail Microsoft Purview ou le portail de conformité. Si vous planifiez que le script s’exécute automatiquement régulièrement, vous pouvez également afficher le status actuel après la dernière exécution du script.

Sélectionnez l’onglet approprié pour le portail que vous utilisez. Pour en savoir plus sur le portail Microsoft Purview, consultez Portail Microsoft Purview. Pour en savoir plus sur le portail de conformité, consultez portail de conformité Microsoft Purview.

  1. Connectez-vous au portail Microsoft Purview.

  2. Sélectionnez Paramètres Connecteurs>de données.

  3. Sélectionnez Mes connecteurs, puis sélectionnez le connecteur RH que vous avez créé pour afficher la page de menu volant. Cette page contient les propriétés et les informations relatives au connecteur.

  4. Sous Progression, sélectionnez le lien Télécharger le journal pour ouvrir (ou enregistrer) le journal status pour le connecteur. Ce journal contient des informations sur chaque fois que le script s’exécute et charge les données du fichier CSV dans le cloud Microsoft.

    Le fichier journal du connecteur RH affiche les lignes numériques du fichier CSV qui ont été chargées.

    Le RecordsSaved champ indique le nombre de lignes dans le fichier CSV chargé. Par exemple, si le fichier CSV contient quatre lignes, la valeur des RecordsSaved champs est 4, si le script a correctement chargé toutes les lignes du fichier CSV.

Si vous n’avez pas exécuté le script à l’étape 4, un lien pour télécharger le script s’affiche sous Dernière importation. Vous pouvez télécharger le script, puis suivre les étapes pour exécuter le script.

(Facultatif) Étape 6 : Planifier l’exécution automatique du script

Pour vous assurer que les données RH les plus récentes de votre organization sont disponibles pour des outils tels que la solution de gestion des risques internes, nous vous recommandons de planifier l’exécution automatique du script de manière périodique, par exemple une fois par jour. Cela nécessite également que vous mettez à jour les données RH du fichier CSV selon une planification similaire (sinon identique) afin qu’elles contiennent les informations les plus récentes sur les employés qui quittent votre organization. L’objectif est de charger les données RH les plus actuelles afin que le connecteur RH puisse les mettre à la disposition de la solution de gestion des risques internes.

Vous pouvez utiliser l’application Planificateur de tâches dans Windows pour exécuter automatiquement le script tous les jours.

  1. Sur votre ordinateur local, sélectionnez le bouton Démarrer de Windows, puis tapez Planificateur de tâches.

  2. Sélectionnez l’application Planificateur de tâches pour l’ouvrir.

  3. Dans la section Actions , sélectionnez Créer une tâche.

  4. Sous l’onglet Général , tapez un nom descriptif pour la tâche planifiée. par exemple, script de connecteur HR. Vous pouvez également ajouter une description facultative.

  5. Sous Options de sécurité, procédez comme suit :

    1. Déterminez s’il faut exécuter le script uniquement lorsque vous êtes connecté à l’ordinateur ou l’exécuter lorsque vous êtes connecté ou non.

    2. Vérifiez que la case Exécuter avec les privilèges les plus élevés est cochée.

  6. Sélectionnez l’onglet Déclencheurs , sélectionnez Nouveau, puis procédez comme suit :

    1. Sous Paramètres, sélectionnez l’option Quotidien , puis choisissez une date et une heure pour exécuter le script pour la première fois. Le script s’exécute tous les jours à la même heure spécifiée.

    2. Sous Paramètres avancés, vérifiez que la case Activé est cochée .

    3. Sélectionnez OK.

  7. Sélectionnez l’onglet Actions , sélectionnez Nouveau, puis procédez comme suit :

    Paramètres d’action pour créer une tâche planifiée pour le script de connecteur RH.

    1. Dans la liste déroulante Action , vérifiez que l’option Démarrer un programme est sélectionnée.

    2. Dans la zone Programme/script , sélectionnez Parcourir, puis accédez à l’emplacement suivant et sélectionnez-le afin que le chemin d’accès s’affiche dans la zone : C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe.

    3. Dans la zone Ajouter des arguments (facultatif), collez la même commande de script que celle que vous avez exécutée à l’étape 4. Par exemple, .\HRConnector.ps1 -tenantId "d5723623-11cf-4e2e-b5a5-01d1506273g9" -appId "c12823b7-b55a-4989-faba-02de41bb97c3" -appSecret "MNubVGbcQDkGCnn" -jobId "e081f4f4-3831-48d6-7bb3-fcfab1581458" -filePath "C:\Users\contosoadmin\Desktop\Data\employee_termination_data.csv"

    4. Dans la zone Démarrer dans (facultatif), collez l’emplacement du dossier du script que vous avez exécuté à l’étape 4. Par exemple : C:\Users\contosoadmin\Desktop\Scripts.

    5. Sélectionnez OK pour enregistrer les paramètres de la nouvelle action.

  8. Dans la fenêtre Créer une tâche , sélectionnez OK pour enregistrer la tâche planifiée. Vous serez peut-être invité à entrer les informations d’identification de votre compte d’utilisateur.

    La nouvelle tâche s’affiche dans la bibliothèque du planificateur de tâches.

    La nouvelle tâche s’affiche dans la bibliothèque du planificateur de tâches.

    La dernière fois que le script a été exécuté et la prochaine fois qu’il est planifié pour s’exécuter sont affichés. Vous pouvez double-sélectionner la tâche pour la modifier.

    Vous pouvez également vérifier la dernière fois que le script a été exécuté dans la page volante du connecteur RH correspondant dans le centre de conformité.

(Facultatif) Étape 7 : Charger des données à l’aide de modèles Power Automate

Vous pouvez charger des données RH à l’aide de modèles Power Automate et définir des déclencheurs. Par exemple, vous pouvez configurer un modèle Power Automate pour qu’il se déclenche lorsque de nouveaux fichiers de connecteur RH sont disponibles dans des emplacements SharePoint ou OneDrive. Vous pouvez également simplifier ce processus en stockant des informations confidentielles telles que Microsoft Entra secret d’application (créé à l’étape 2) dans Azure Key Vault et en l’utilisant avec Power Automate pour l’authentification.

Effectuez les étapes suivantes pour charger automatiquement les données RH lorsque de nouveaux fichiers deviennent disponibles sur OneDrive Entreprise :

  1. Téléchargez le package ImportHRDataforIRM.zip à partir du site GitHub.

  2. Dans Power Automate, accédez à Mes flux.

  3. Sélectionnez Importer et chargez le package ImportHRDataforIRM.zip .

  4. Une fois le package chargé, mettez à jour le contenu (nom & OneDrive Entreprise connexion), puis sélectionnez Importer.

    Importation de flux Power Automate.

  5. Sélectionnez Ouvrir le flux et mettez à jour les paramètres. Le tableau suivant décrit les paramètres à utiliser dans ce flux Power Automate et leurs valeurs requises. Les informations que vous avez obtenues dans les étapes précédentes sont utilisées dans les valeurs de ces paramètres.

    Paramètre Description
    ID de l’application Il s’agit de l’ID d’application Microsoft Entra de l’application que vous avez créée dans Microsoft Entra ID à l’étape 2. Il est utilisé par Microsoft Entra ID pour l’authentification lorsque le script tente d’accéder à votre organization Microsoft 365.
    Secret de l’application Il s’agit du secret Microsoft Entra de l’application que vous avez créée dans Microsoft Entra ID à l’étape 2. Utilisé pour l’authentification.
    Emplacement du fichier Il s’agit de l’emplacement OneDrive Entreprise où Power Automate surveille les activités « nouveau fichier créé » pour déclencher ce flux.
    N° du travail Identificateur du connecteur RH créé à l’étape 3. Cela permet d’associer les données RH chargées dans le cloud Microsoft au connecteur RH.
    ID client L’identificateur de votre organization Microsoft 365 obtenu à l’étape 2. Vous pouvez également obtenir l’ID de locataire de votre organization dans le panneau Vue d’ensemble du centre d'administration Microsoft Entra. Cela permet d’identifier vos organization.
    URI Vérifiez que la valeur de ce paramètre est https://webhook.ingestion.office.com/api/signals

    Flux Power Automate.

  6. Sélectionnez Enregistrer.

  7. Accédez à Vue d’ensemble du flux , puis sélectionnez Activer.

    Activez le flux Power Automate.

  8. Testez le flux manuellement en chargeant un nouveau fichier dans votre dossier OneDrive Entreprise et vérifiez qu’il s’est correctement exécuté. Cette opération peut prendre quelques minutes après le chargement avant que le flux ne soit déclenché.

    Test de flux Power Automate.

  9. Vous pouvez maintenant surveiller le connecteur RH comme décrit à l’étape 5.

Si nécessaire, vous pouvez mettre à jour le flux pour créer des déclencheurs en fonction des événements de disponibilité et de modification des fichiers sur SharePoint et d’autres sources de données prises en charge par Les flux Power Automate.

Connecteurs RH existants

Le 13 décembre 2021, nous avons publié le scénario de données de profil des employés pour les connecteurs RH. Si vous avez créé un connecteur RH avant cette date, nous allons migrer les instances existantes ou les connecteurs RH de votre organization afin que vos données RH continuent d’être importées dans le cloud Microsoft. Vous n’avez rien à faire pour maintenir cette fonctionnalité. Vous pouvez continuer à utiliser ces connecteurs sans interruption.

Si vous souhaitez implémenter le scénario de données de profil d’employé, vous créez un connecteur RH et le configurez en fonction des besoins. Après avoir créé un connecteur RH, exécutez le script à l’aide de l’ID de travail du nouveau connecteur et des fichiers CSV avec les données de profil des employés décrites précédemment dans cet article.