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 échoue jusqu’à ce que le fichier source soit corrigé (ou que le mappage modifie le type de validation de l’attribut de manière à rendre la valeur valide).

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

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

• Contiennent uniquement des caractères alphanumériques ASCII (lettres et chiffres, par exemple , Date1) ou un trait de soulignement (_). Les autres caractères ne sont pas pris en charge.
• Contiennent une valeur.
• N’ont pas d’espaces vides de début, de milieu ou de fin, ni de caractères non alphanumériques spéciaux tels que @, #, % ou &.
• Soyez unique.
• Ne contiennent aucun champ système, qui sont :
  • PeopleHistoricalId
  • StartDate
  • EndDate
  • Domain
  • Type de population
  • TimeZone
  • StandardTimeZone
  • WorkdayStart
  • WorkDayEnd
  • Week-endDays
  • InferredTeamSize
  • ObjectId
  • Microsoft_

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.

Remarque

Vous pouvez utiliser des caractères codés sur deux octets, tels que des caractères japonais, 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

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

Catégorie	Règle associée	Message	S’applique à
Extensions de fichier et de fichier	Le fichier de données doit être au format UTF-8 .csv et ne peut pas être vide.	Votre fichier est vide. Sélectionnez un autre fichier et chargez à nouveau.	.csv chargement uniquement
		Ce fichier a l’extension « »{0} non valide. Sélectionnez un fichier .csv et chargez à nouveau.	.csv chargement uniquement
		Format .csv non valide. Le nombre de colonnes dans la ligne ne correspond pas au nombre de colonnes dans l’en-tête. Veuillez case activée pour les virgules manquantes ou mal placées et charger à nouveau.	tous
		Caractère non UTF-8 trouvé. Vérifiez que votre fichier .csv utilise l’encodage UTF-8 et chargez-le à nouveau.	tous
En-têtes de colonne	Tous les noms d’en-tête ou de colonne de champ doivent être uniques.	Au moins deux en-têtes de colonne dans votre fichier sont identiques. Inclure des en-têtes uniques pour chaque colonne.	tous
	Tous les noms d’en-tête ou de colonne de champ doivent contenir une valeur.	L’en-tête est manquant dans la ou les colonnes {J}. Incluez le nom de l’en-tête dans le fichier sélectionné et chargez à nouveau.	tous
	Tous les noms d’en-tête ou de colonne de champ doivent contenir uniquement des caractères alphanumériques (lettres et chiffres, par exemple , Date1) ou les symboles suivants : ~ ! @ # $ % ^ & * + > : <> [] ?. Les autres caractères ne sont pas pris en charge	{Nom d’en-tête} contient des caractères spéciaux non pris en charge. Supprimez les caractères spéciaux et chargez à nouveau.
	Tous les noms d’en-tête ou de colonne de champ ne doivent contenir aucun champ système.	{nom d’en-tête} est un champ système. Renommez {nom d’en-tête} afin qu’il n’utilise pas de champ système et chargez à nouveau le fichier.	tous
	Après avoir chargé votre fichier, vous ne pouvez mapper qu’un en-tête de colonne à chaque champ de données Viva Insights.	Votre fichier a plusieurs colonnes sources mappées à un champ de données. Vérifiez que chaque colonne source est mappée à un champ unique.	tous
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.	Valeur {nom d’en-tête} non valide. {Nom d’en-tête} doit être une adresse e-mail au format employee@contoso.com.	tous
		Valeur {nom d’en-tête} non valide. {Nom d’en-tête} doit être une chaîne.	tous
		Valeur {nom d’en-tête} non valide. {Nom d’en-tête} doit être une date au format MM/JJ/AAAA.	tous
		Valeur {nom d’en-tête} non valide. {Nom d’en-tête} doit être un double suivant la forme 23.75.	tous
		Valeur {nom d’en-tête} non valide. {Nom d’en-tête} doit être un entier.	tous
	Les champs obligatoires doivent avoir une valeur pour chaque ligne.	Colonne {nom d’en-tête} manquante ou valeur {nom d’en-tête}. {Nom d’en-tête} est un champ obligatoire et nécessite une valeur pour chaque ligne. Ajoutez la valeur {nom d’en-tête} et chargez à nouveau le fichier.	tous
		Valeur ManagerId manquante pour le nouveau champ PersonId. ManagerId est un champ obligatoire. Ajoutez le champ ManagerId correspondant et chargez à nouveau.	tous
	Chaque PersonId doit avoir un ManagerId unique.		tous
	Il ne peut pas y avoir de boucles où : Les gestionnaires et les employés se rapportent mutuellement. Les gestionnaires rapportent aux employés.		tous