Règles de fichier et erreurs de validation

Dans cet article, nous décrivons comment votre fichier de chargement doit être mis en forme et nous fournissons les erreurs que vous pouvez rencontrer lors de l’apport de données dans l’application Insights avancés.

Règles de fichier et de champ

Quand une ligne ou une colonne de données a une valeur non valide pour un attribut, le chargement entier peut échouer ou générer des avertissements selon que charger des lignes valides et exclure des lignes avec des données non valides sous Configuration avancée sont activés ou désactivés.

Si charger des lignes valides et exclure des lignes avec des données non valides sous Configuration avancée est désactivé, l’intégralité du chargement échoue en raison d’erreurs de validation jusqu’à ce que le fichier source soit corrigé (ou le mappage modifie le type de validation de l’attribut d’une manière qui rend la valeur valide).

Si l’option Charger des lignes valides et exclure des lignes avec des données non valides sous Configuration avancée est activée, elle charge uniquement les lignes qui incluent des valeurs valides et affiche des avertissements pour les lignes qui n’ont pas été ingérées en raison d’erreurs. Ce paramètre est désactivé par défaut.

Règles pour le fichier

Le fichier de données doit être au format UTF-8 .csv et ne peut pas être vide.

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

Tous les noms d’en-têtes ou de colonnes de champ source et cible doivent :

1. Contiennent uniquement des caractères alphanumériques ASCII (lettres et chiffres, par exemple , Date1) ou un trait de soulignement (_). Les caractères non alphabétiques spéciaux tels que @, #, %, & ou d’autres caractères ne sont pas pris en charge.
2. Contiennent une valeur.
3. Soyez unique.

Règles pour les en-têtes de champs cibles personnalisés

Tous les en-têtes de champs cibles personnalisés ou noms de colonnes doivent :

1. N’ont pas d’espaces vides de début, de milieu ou de fin.
2. Ne contiennent aucun champ système, qui sont :
   • PeopleHistoricalId
   • StartDate
   • EndDate
   • Domain
   • Type de population
   • TimeZone
   • StandardTimeZone
   • WorkdayStart
   • WorkDayEnd
   • Week-endDays
   • InferredTeamSize
   • ObjectId
   • IsActive
   • À partir de « Microsoft_ »
   • MetricDate
   • PrimaryCollaborator_PersonId
   • SecondaryCollaborator_PersonId

Les champs obligatoires doivent avoir une valeur pour chaque ligne.

Après avoir chargé votre fichier, vous ne pouvez mapper qu’un en-tête de colonne à chaque champ de données Viva Insights.

Règles pour les valeurs de champ

Les valeurs de champ doivent être fournies dans le type de données correct. Reportez-vous à Informations de référence sur les attributs.

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

• La longueur des caractères des valeurs de champ dans les lignes ne peut pas dépasser 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.

Règles pour les valeurs dans le champ ManagerId

Chaque PersonId doit avoir un ManagerId unique. En d’autres termes, il ne peut pas y avoir plusieurs gestionnaires pour une seule personne.

Il ne peut pas y avoir de boucles où :

• Les gestionnaires et les employés se rapportent mutuellement.
• Les gestionnaires rapportent aux employés.

Supposons que Dylan soit le manager de Kris. Les données organisationnelles n’ont pas pu afficher :

• Kris rendant compte à Dylan et Dylan rapportant à Kris.
• Dylan rendant compte à Kris.

Les deux hiérarchies suivantes génèrent des erreurs dans les expériences des utilisateurs finaux :

Exemple .csv fichier d’exportation

Voici un exemple d’extrait de code d’un fichier d’exportation .csv valide :

PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest

Télécharger le journal pour les employés avec des données manquantes

La page Qualité des données vous permet de savoir s’il manque des utilisateurs mesurés dans votre fichier de données d’organisation. Si c’est le cas, vous verrez le message « {nombre} les utilisateurs mesurés ont des données organisationnelles manquantes. Téléchargez les utilisateurs qui ont des données organisationnelles manquantes et chargez leurs données pour obtenir des insights de meilleure qualité. »

Le journal de téléchargement affiche les utilisateurs mesurés qui n’ont aucun champ de données à l’exception des champs système Domaine et TimeZone.

Erreurs et avertissements de validation

Voici les erreurs de validation que vous pouvez rencontrer lors du chargement de données dans l’application Advanced Insights. Dans la plupart des cas, vous devez corriger les erreurs et charger à nouveau votre fichier. Consultez notre article Préparer les données organisationnelles pour savoir comment mettre en forme et préparer vos données pour le chargement.

Vous trouverez ci-dessous les erreurs de validation et les avertissements liés aux valeurs de champ. Si charger des lignes valides et exclure des lignes avec des données non valides sous Configuration avancée est désactivé, cela crée des erreurs et échoue la validation. S’il est activé, il charge uniquement les lignes qui incluent des valeurs valides et affiche des avertissements pour les lignes qui n’ont pas été ingérées en raison d’erreurs. Ce paramètre est désactivé par défaut.