Compartir a través de

Reglas de archivo y errores de validación

  • Artículo

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 de origen y de destino

Todos los nombres de columna o encabezado de campo de origen y de destino deben:

  1. Solo contienen caracteres alfanuméricos ASCII (letras y números, por ejemplo, Date1) o caracteres de subrayado (_). No se admiten caracteres no alfanuméricos especiales como @, #, %, & u otros caracteres.
  2. Contener un valor.
  3. Sea único.

Reglas para encabezados de campo de destino personalizados

Todos los encabezados de campo de destino personalizados o los nombres de columna deben:

  1. No tenga espacios en blanco iniciales, intermedios o finales.
  2. No contienen campos del sistema, que son:
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • Dominio
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • WeekendDays
    • InferredTeamSize
    • ObjectId
    • IsActive
    • A partir de "Microsoft_"
    • MetricDate
    • PrimaryCollaborator_PersonId
    • SecondaryCollaborator_PersonId

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 de 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:

Captura de pantalla que muestra un bucle de jerarquía de administrador entre tres personas.

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 de 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
  • {Nombre de encabezado} contiene un valor no válido. Las filas con valores no válidos no se cargan. {Nombre de encabezado} debe ser una fecha que siga el formato MM/DD/AAAA, MM/DD/AAAA, MM/DD/AAAA seguido de más texto (por ejemplo, el tiempo), MM-DD-AAAA, MM-DD-AAAA, AAAA-MM-DD, miércoles, 14 de marzo de 2012, 14 de marzo de 2012, 14-mar-2012 o 14-Mar-12.
  • OR
  • {Nombre de encabezado} contiene un valor no válido. Las filas con valores no válidos no se cargan. {Nombre de encabezado} debe ser una fecha que siga el formato DD/MM/AAAA, DD/MM/AAAA seguido de más texto (por ejemplo, hora), D/MM/AAAA, D/MM/AAAA, DD-MM-AAAA, DD-MM-AAAA , AAAA-DD-MM, miércoles, 14 de marzo de 2012, 14 de marzo de 2012, 14-mar-2012 o 14-mar-12.
    		•  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