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

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

Cet article décrit la deuxième option, à savoir le chargement de données via un fichier .csv. Une fois que vous avez préparé les données comme décrit dans Préparer les données organisationnelles, vous devez effectuer les étapes suivantes.

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.

Flux de travail

Une fois que vous avez préparé les données sources, le processus de chargement suit ces étapes, qui sont décrites dans les sections suivantes :

  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, la tâche globale de chargement des données est terminée.

File upload

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

  1. Dans la page Données organisationnelles , sélectionnez .csv charger. Capture d’écran montrant le hub de page données organisationnelles.

  2. Entrez un nom de chargement.

  3. 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

Une fois que vous avez chargé votre fichier, la page de mappage de champs 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 facultatifs. 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 organisation 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 » et les attributs facultatifs ont une étiquette « Facultatif ».

Capture d’écran montrant les attributs Viva et les champs mappés et non mappés.

Personnalisé

Les champs personnalisés sont des attributs facultatifs que vous pouvez créer. La section suivante, étape 2a, 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 a.

    Capture d’écran montrant le mappage des attributs Viva.

    Conseil

    Pointez sur un nom d’attribut pour lire sa description. Capture d’écran montrant le pointage sur un attribut.

  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, votre entrée dans le processus de chargement est terminée.

Validation

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

Capture d’écran montrant la validation en cours.

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 état « 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, l’état « Réussite » s’affiche dans la table Charger ou supprimer l’historique . À ce stade, le processus de chargement est terminé.

Capture d’écran montrant un traitement réussi.

Une fois que vous avez reçu l’état « 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. L’état 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 état d’échec dans la table Charger ou supprimer en cours . La sélection du lien dans l’état vous amène à une explication de l’échec.

Capture d’écran montrant l’échec du traitement.

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

Cette section contient de l’aide pour corriger les données d’un fichier source chargé qui provoque des erreurs de validation.

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 avez corrigé le mappage d’attributs).

Règles pour les en-têtes de champ

Tous les noms d’en-tête ou de colonne de champ doivent :

  • Commencer par une lettre (pas un nombre).
  • Contiennent uniquement des caractères alphanumériques (lettres et chiffres, par exemple , Date1).
  • N’ont pas d’espaces vides de début ou de fin ou de caractères spéciaux (ceux qui sont non alphanumériques, comme @, #, %, &).
Règles pour les valeurs de champ

Les valeurs de champ dans les lignes de données doivent respecter les règles de mise en forme suivantes :

  • Les valeurs des champs EffectiveDate et HireDate doivent être au format MM/JJ/AAAA.
  • Les valeurs de champ PersonId et ManagerId requises doivent être une adresse e-mail valide (par exemple, gc@contoso.com).
  • Les valeurs du champ Layer doivent contenir uniquement des nombres.
  • Les valeurs de champ HourlyRate doivent contenir uniquement des nombres, que l’application suppose en dollars américains pour les calculs et l’analyse des données.

Remarque

L’application n’effectue actuellement pas de conversions monétaires pour les données HourlyRate . Tous les calculs et analyses de données supposent que les données sont en dollars américains.

Règles pour les caractères dans les valeurs de champ

Les règles de champ suivantes s’appliquent aux caractères dans les valeurs de champ :

  • Les caractères codés sur deux octets, tels que les caractères japonais, sont autorisés dans les valeurs de champ.
  • La longueur maximale des caractères des valeurs de champ dans les lignes est de 128 Ko, soit environ 1 024 x 128 caractères.
  • Les caractères « Nouvelle ligne » (\n) ne sont pas autorisés dans les valeurs de champ.

Préparer les données de l’organisation