Charger des données d’organisation (premier chargement)

Les données de votre organisation peuvent apparaître dans l’application Insights avancées du Microsoft Viva Insights de deux manières : via Microsoft Entra ID, qui est la source par défaut, ou via un fichier .csv que vous chargez en tant qu’administrateur.

Cet article traite de la deuxième option : le chargement d’un fichier .csv.

Importante

Utilisez les étapes suivantes uniquement si vous téléchargez des données organisationnelles pour la première fois. S’il ne s’agit pas de votre premier chargement, consultez Charger des données organisationnelles (chargements suivants) pour mettre à jour les données précédemment chargées.

Pour les clients qui proviennent de notre application héritée :

Si vous effectuez une migration à partir de l’application Insights avancées héritée et que vous chargez des données organisationnelles vers Viva Insights pour la première fois, nous vous recommandons d’utiliser uniquement la nouvelle application pour les chargements de données. L’utilisation de la nouvelle application empêche l’incohérence des données.

Flux de travail

Après avoir préparé les données sources, procédez comme suit :

  1. Vous chargez le fichier .csv.
  2. Vous mappez des champs.
  3. L’application valide vos données. (Si la validation échoue, vous pouvez choisir parmi quelques options décrites dans Échec de la validation.)
  4. L’application traite vos données. (Si le traitement échoue, vous pouvez choisir parmi quelques options décrites dans Échec du traitement.)

Une fois les données validées et les processus réussis, vous avez terminé la tâche de chargement de données globale.

File upload

Pour charger votre fichier .csv, procédez comme suit :

  1. Ouvrez l’expérience d’administration de l’application Insights avancés .

  2. Dans la page Hub de données, accédez à l’carte .csv de chargement sur le côté droit de l’écran, sous Source de données. Capture d’écran montrant .csv vignette de chargement et l’option Démarrer.

  3. Sélectionnez Démarrer.

  4. Sous Étape 1 sur 2 : Préparer et charger :

    1. Entrez un nom de chargement.
    2. Sous Charger un fichier, sélectionnez le fichier .csv que vous souhaitez charger.

    Vérifiez que le fichier .csv est :

    • Encodé en UTF-8.

    • Ne pas ouvrir dans un autre programme lorsque vous commencez le processus de chargement.

    • Pas plus de 1 Go.

      Capture d’écran montrant l’option Préparer et charger des données.

Remarque

Pour afficher la structure et les instructions relatives aux fichiers .csv et éviter les problèmes courants lors du chargement, vous pouvez télécharger un modèle via le lien Télécharger le modèle .csv .

  1. Pour charger, sélectionnez Suivant. Pour annuler le chargement, sélectionnez Annuler.

Mappage de champs

Après avoir chargé votre fichier, la page Étape 2 sur 2 : Mappage s’affiche . Pour afficher des insights à partir de vos données, vous devez mapper des champs (colonnes) de votre fichier .csv aux noms de champs que l’application reconnaît.

Il existe deux types de champs : Système par défaut et Personnalisé.

Système par défaut (obligatoire ou facultatif)

Les champs système par défaut peuvent être obligatoires ( PersonId, ManagerId et Organisation) ou Réservées facultatives. Ces champs représentent des attributs que Viva Insights connaît et utilise dans des calculs spécifiques, au-delà du regroupement et du filtrage.

Importante

Chaque champ requis doit avoir une valeur valide et non null dans chaque ligne. Vous devez mapper toutes les valeurs Viva Insights requises, même si les en-têtes de colonne dans vos fichiers .csv ne correspondent pas exactement au nom de la valeur Viva Insights.

Les champs facultatifs sont des champs système couramment rencontrés que l’application suggère d’utiliser. Vous n’avez pas besoin de mapper des champs facultatifs si votre organization n’a pas de données pour eux.

Pour savoir si un champ est obligatoire ou facultatif, reportez-vous à la section Attributs Viva à droite de la liste de mappage. Les attributs obligatoires ont une étiquette « Obligatoire » sous le nom du champ, tandis que les attributs facultatifs ont une étiquette « Réservé facultatif ».

Si vous avez besoin de la définition d’un champ, pointez sur l’icône d’informations (i).

Capture d’écran montrant les attributs Viva et une définition de champ.

Personnalisé

Les champs personnalisés sont des attributs facultatifs que vous pouvez créer. La section suivante explique le mappage et le nommage d’un attribut personnalisé.

Pour mapper des champs

Suivez les étapes ci-dessous pour mapper vos données .csv aux attributs Viva Insights.

Importante

Tous les champs d’en-tête .csv, qui apparaissent sous Nom de la colonne source, doivent être mappés avant de pouvoir passer à la partie suivante du processus de chargement.

  1. Pour chaque champ de Viva Insights obligatoire :

    1. Recherchez l’en-tête de colonne correspondant sous Nom de la colonne source. Pour éviter une erreur de validation ultérieurement, vérifiez que cette colonne est le type de données approprié.
    2. Sous la colonne Mapper à Viva Insights champ, ouvrez la liste déroulante et sélectionnez l’attribut Viva Insights qui correspond à l’en-tête de colonne que vous avez identifié à l’étape 1a.
  2. Répétez les étapes 1a et 1b pour les champs personnalisés et facultatifs.

    Pour ajouter un champ personnalisé, incluez-le simplement en tant que colonne dans votre fichier de données. L’application lui attribue automatiquement un nom et le mappe. Pour cette version de Viva Insights, tous les attributs personnalisés se voient attribuer un nom par défaut et peuvent uniquement être classés en tant que types de données String.

    Importante

    Ne chargez pas TimeZone en tant que colonne. Vous obtiendrez une erreur.

  3. Une fois que vous avez terminé le mappage de vos attributs, sélectionnez le bouton Suivant en bas à gauche de l’écran.

Une fois les champs mappés, l’application valide et traite vos données comme décrit dans les sections suivantes. Si la validation et le traitement réussissent, vous avez terminé votre partie dans le processus de chargement.

Validation

Une fois que vous avez mappé les attributs, l’application commence à valider vos données.

Dans la plupart des cas, la validation des fichiers doit se terminer rapidement. Si votre fichier de données d’organisation est volumineux, la validation peut prendre jusqu’à une ou deux minutes.

Une fois cette phase terminée, la validation a réussi ou échoué. Selon le résultat, vous recevrez une notification de réussite ou une notification d’échec dans le coin supérieur droit de l’écran Connexions de données .

Pour plus d’informations sur ce qui se passe ensuite, accédez à la section appropriée :

La validation réussit

Échec de la validation

La validation réussit

Une fois la validation réussie, Viva Insights commence à traiter vos nouvelles données. Le traitement peut prendre entre quelques heures et environ un jour. Pendant le traitement, vous verrez un status « Traitement » dans la table Connexions de données > Charger ou supprimer en cours.

Une fois le traitement terminé, il est réussi ou a échoué. Selon le résultat, vous recevrez une notification de réussite ou une notification d’échec dans le coin supérieur droit de l’écran Connexions de données .

Le traitement réussit

Lorsque le traitement réussit, un status « Réussite » s’affiche dans la table Historique de chargement ou de suppression. À ce stade, le processus de chargement est terminé.

Une fois que vous avez reçu le status « Réussite », vous pouvez :

  • Sélectionnez l’icône d’affichage (œil) pour afficher un résumé des résultats de validation. Capture d’écran montrant les résultats de la validation.
  • Sélectionnez l’icône de mappage pour afficher les paramètres de mappage du flux de travail. Capture d’écran montrant les paramètres de mappage.

Remarque

Chaque locataire ne peut avoir qu’un seul chargement en cours à la fois. Vous devez terminer le flux de travail d’un fichier de données, ce qui signifie que vous le guidez vers une validation et un traitement réussis ou que vous l’abandonnez avant de commencer le flux de travail du fichier de données suivant. La status ou l’étape du flux de travail de chargement s’affiche sous l’onglet Connexions de données.

Échec du traitement

Si le traitement échoue, vous verrez un status ayant échoué dans la table Charger ou supprimer en cours. La sélection du lien dans le status vous permet d’obtenir une explication de l’échec.

Sélectionnez Modifier ou démarrer un nouveau chargement. Ce bouton vous permet de recommencer le processus de chargement.

Remarque

Les échecs de traitement sont généralement dus à des erreurs back-end. Si vous constatez des échecs de traitement persistants et que vous avez corrigé les données dans votre fichier chargé, créez un ticket de support avec nous.

Échec de la validation

Si la validation des données échoue, vous verrez un nouvel écran avec une erreur « Échec de la validation » et des informations sur l’échec. Vous pouvez sélectionner le bouton Annuler le chargement si vous ne souhaitez pas poursuivre le processus de chargement.

Avant d’apporter des modifications au fichier source et de réessayer le chargement, vous pouvez sélectionner Télécharger les problèmes. Ce fichier journal décrit les problèmes dans vos données qui peuvent avoir provoqué les erreurs de validation. Utilisez ces informations pour décider de la procédure suivante : corriger les données sources ou modifier vos paramètres de mappage.

Instructions pour corriger les erreurs dans les données

Quand une ligne ou une colonne de données a une valeur non valide pour un attribut, le chargement entier échoue tant que vous n’avez pas corrigé le fichier source (ou que vous n’avez pas corrigé le mappage d’attributs).

Pour en savoir plus sur la mise en forme de votre fichier afin d’éviter les erreurs, consultez Règles de fichier et erreurs de validation.

Préparer les données de l’organisation