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 source et cible
Tous les noms d’en-têtes ou de colonnes de champ source et cible doivent :
- Contiennent uniquement des caractères alphanumériques ASCII (lettres et chiffres, par exemple , Date1) ou un trait de soulignement (_). Les caractères non alphanumériques spéciaux tels que @, #, %, & ou d’autres caractères ne sont pas pris en charge.
- Contiennent une valeur.
- 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 :
- N’ont pas d’espaces vides de début, de milieu ou de fin.
- 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.
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. Vérifiez les virgules manquantes ou mal placées et chargez à 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 | ||
| 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ù :
|
tous |