Reglas de archivo y errores de validación

En este artículo, se describe cómo se debe dar formato al archivo de carga y se proporcionan errores que puede encontrar al incorporar datos a la aplicación de conclusiones avanzadas.

Reglas de archivo y campo

Cuando cualquier fila o columna de datos tiene un valor no válido para cualquier atributo, se producirá un error en toda la carga hasta que el archivo de origen sea fijo (o la asignación cambie el tipo de validación del atributo de forma que el valor sea válido).

Reglas para el archivo

El archivo de datos debe tener el formato UTF-8 .csv y no puede estar vacío.

Reglas para encabezados de campo

Todos los nombres de columna o encabezado de campo deben:

• Solo contienen caracteres alfanuméricos ASCII (letras y números, por ejemplo, Date1) o caracteres de subrayado (_). No se admiten otros caracteres.
• Contener un valor.
• No tenga espacios en blanco iniciales, intermedios o finales, ni caracteres no alfanuméricos especiales como @, #, %o &.
• Sea único.
• No contienen campos del sistema, que son:
  • PeopleHistoricalId
  • StartDate
  • EndDate
  • Dominio
  • PopulationType
  • TimeZone
  • StandardTimeZone
  • WorkdayStart
  • WorkDayEnd
  • WeekendDays
  • InferredTeamSize
  • ObjectId
  • Microsoft_

Los campos necesarios deben tener un valor para cada fila.

Después de cargar el archivo, solo puede asignar un encabezado de columna a cada campo de datos Viva Insights.

Reglas para valores de campo

Los valores de campo deben proporcionarse en el tipo de datos correcto. Consulte Referencia de atributos.

Reglas para caracteres en valores de campo

• La longitud de caracteres de los valores de campo de las filas no puede superar los 128 KB, que es de aproximadamente 1024 x 128 caracteres.
• No se permiten caracteres de "nueva línea" (\n) en los valores de campo.

Nota:

Puede usar caracteres de doble byte, como caracteres japoneses, en los valores de campo.

Reglas para valores en el campo ManagerId

Cada PersonId debe tener un ManagerId único. En otras palabras, no puede haber varios administradores para una persona.

No puede haber bucles donde:

• Los administradores y los empleados se comunican entre sí.
• Los administradores informan a los empleados.

Supongamos que Dylan es el mánager de Kris. Los datos de la organización no se pudieron mostrar:

• Kris reportando a Dylan y también a Dylan reportando de vuelta a Kris.
• Dylan informando a Kris.

Las dos jerarquías siguientes producirían errores en las experiencias del usuario final:

Ejemplo .csv archivo de exportación

Este es un fragmento de código de ejemplo de un archivo de exportación de .csv válido:

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

Errores de validación

Estos son los errores de validación que puede encontrar al cargar datos en la aplicación de conclusiones avanzadas. En la mayoría de los casos, tendrá que corregir los errores y volver a cargar el archivo. Revise nuestro artículo Preparar datos de la organización para obtener información sobre cómo dar formato a los datos y prepararlos para su carga.

Categoría	Regla relacionada	Mensaje	Se aplica a
Extensiones de archivo y archivo	El archivo de datos debe tener el formato UTF-8 .csv y no puede estar vacío.	El archivo está vacío. Seleccione otro archivo y vuelva a cargarlo.	solo .csv carga
		Este archivo tiene una extensión no válida de ''{0}. Seleccione un archivo .csv y vuelva a cargarlo.	solo .csv carga
		Formato de .csv no válido. El número de columnas en fila no coincide con el número de columnas del encabezado. Compruebe si faltan comas o no están colocadas y vuelva a cargarlas.	todas
		Se encontró un carácter no UTF-8. Asegúrese de que el archivo .csv usa la codificación UTF-8 y cárguelo de nuevo.	todas
Encabezados de columna	Todos los nombres de encabezado o columna de campo deben ser únicos.	Dos o más encabezados de columna del archivo son los mismos. Incluya encabezados únicos para cada columna.	todas
	Todos los nombres de columna o encabezado de campo deben contener un valor.	Falta el encabezado en las columnas {J}. Incluya el nombre del encabezado en el archivo seleccionado y vuelva a cargarlo.	todas
	Todos los nombres de columna o encabezado de campo solo deben contener caracteres alfanuméricos (letras y números, por ejemplo, Date1) o los símbolos siguientes: ~ ! @ # $ % ^ & * + > : <> [] ?. No se admiten otros caracteres	{Nombre de encabezado} contiene caracteres especiales no admitidos. Quite los caracteres especiales y vuelva a cargarlos.
	Todos los nombres de columna o encabezado de campo no deben contener campos del sistema.	{nombre de encabezado} es un campo del sistema. Cambie el nombre de {nombre de encabezado} para que no use un campo del sistema y vuelva a cargar el archivo.	todas
	Después de cargar el archivo, solo puede asignar un encabezado de columna a cada campo de datos Viva Insights.	El archivo tiene más de una columna de origen asignada a un campo de datos. Asegúrese de que cada columna de origen está asignada a un campo único.	todas
Valores de campo	Los valores de campo deben proporcionarse en el tipo de datos correcto. Consulte Referencia de atributos.	Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser una dirección de correo electrónico que siga el formulario employee@contoso.com.	todas
		Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser una cadena.	todas
		Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser una fecha que siga el formato MM/DD/AAAA.	todas
		Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser doble siguiendo el formato 23.75.	todas
		Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser un entero.	todas
	Los campos necesarios deben tener un valor para cada fila.	Falta la columna {nombre de encabezado} o el valor {nombre de encabezado}. {Nombre de encabezado} es un campo obligatorio y necesita un valor para cada fila. Agregue el valor {nombre de encabezado} y vuelva a cargar el archivo.	todas
		Falta el valor de ManagerId para el nuevo campo PersonId. ManagerId es un campo obligatorio. Agregue el campo ManagerId correspondiente y vuelva a cargarlo.	todas
	Cada PersonId debe tener un ManagerId único.		todas
	No puede haber bucles donde: Los administradores y los empleados se comunican entre sí. Los administradores informan a los empleados.		todas