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, toda la carga puede producir errores o generar advertencias en función de si cargar filas válidas y excluir filas con datos no válidos en Configuración avanzada está activada o desactivada.
Si cargar filas válidas y excluir filas con datos no válidos en Configuración avanzada está desactivada, se produce un error en toda la carga debido a errores de validación hasta que se corrigió el archivo de origen (o la asignación cambia el tipo de validación del atributo de forma que el valor sea válido).
Si cargar filas válidas y excluir filas con datos no válidos en Configuración avanzada está activada, solo cargará las filas que incluyan valores válidos y mostrará advertencias para las filas que no se ingierieron debido a errores. Esta opción está desactivada de forma predeterminada.
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:
- 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.
- Contener un valor.
- Sea único.
Reglas para encabezados de campo de destino personalizados
Todos los encabezados de campo de destino personalizados o los nombres de columna deben:
- No tenga espacios en blanco iniciales, intermedios o finales.
- 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 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
Descarga del registro de empleados con datos que faltan
La página Calidad de los datos le permite saber si faltan usuarios medidos en el archivo de datos de la organización. Si es así, verá el mensaje "{número} de usuarios medidos que faltan datos de la organización. Descargue qué usuarios faltan en los datos de la organización y cargue sus datos para obtener información de mayor calidad".
El registro de descarga muestra los usuarios medidos a los que les falta cualquier campo de datos , excepto los campos del sistema dominio y zona horaria.
Errores y advertencias 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, debe 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 | ||
| El archivo de datos para la importación basada en API y la importación de blobs de Azure debe estar en .zip formato de archivo e incluir un archivo .csv en formato UTF-8 y uno .json archivo de asignación. Los archivos no pueden estar vacíos. | Hay un problema con los archivos en el archivo .zip. Asegúrese de que el archivo .zip solo contiene un archivo .json y un archivo .csv y vuelva a cargarlo. | Importación basada en API e importación de blobs de Azure | |
| El archivo .csv del archivo .zip está vacío. Agregue un archivo .csv no vacío y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure | ||
| El archivo .json del archivo .zip está vacío. Agregue un archivo .json no vacío y vuelva a cargar el archivo de .zip. | Importación basada en API e importación de blobs de Azure | ||
| El archivo .json no es válido. Use un archivo .json válido y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure | ||
| 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 | |
| El archivo .csv se asigna a un campo nulo o vacío en el archivo .json. Asígnelo a un campo no vacío y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure | ||
| 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 | |
| Los nombres de encabezado del archivo .csv no coinciden con los campos asignados en el archivo .json. Asegúrese de que el archivo .json contiene los mismos campos que el archivo .csv y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure | ||
| El número de encabezados del archivo .csv no coincide con los campos asignados en el archivo .json. Asegúrese de que el archivo .json contiene los mismos campos que el archivo .csv y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure | ||
| Todas las columnas de origen deben asignarse a un tipo de datos compatible. | La columna de origen no está asignada a un tipo de datos admitido. Asigne a un tipo de datos admitido y vuelva a cargar el archivo. | Importación basada en API e importación de blobs de Azure | |
| El archivo .json especifica un "DatasetType" que no se espera. Especifique el valor correcto y vuelva a cargar el archivo .zip. | Importación basada en API e importación de blobs de Azure |
A continuación se muestran los errores de validación y las advertencias relacionadas con los valores de campo. Si cargar filas válidas y excluir filas con datos no válidos en Configuración avanzada está desactivada, se crean errores y se produce un error en la validación. Si está activado, solo cargará filas que incluyan valores válidos y mostrará advertencias para las filas que no se ingierieron debido a errores. Esta opción está desactivada de forma predeterminada.
| Categoría | Regla relacionada | Mensaje | Error o advertencia | Se aplica a |
|---|---|---|---|---|
| Valores de campo | El archivo de datos debe tener el formato UTF-8 .csv. | 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. | Error | todas |
| Formato de .csv no válido. El número de columnas en fila no coincide con el número de columnas del encabezado. Las filas con valores no válidos no se cargan. Compruebe si faltan comas o no están colocadas y vuelva a cargarlas. | Advertencia | 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. | Error | todas | ||
| Se encontró un carácter no UTF-8. Las filas con valores no válidos no se cargan. Asegúrese de que el archivo .csv usa la codificación UTF-8 y cárguelo de nuevo. | Advertencia | todas | ||
| 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. |
Advertencia | 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 dirección de correo electrónico que siga el formulario employee@contoso.com. |
Advertencia | todas | ||
| Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser una cadena. | Error | 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 cadena. | Advertencia | todas | ||
| Advertencia | todas | |||
| Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser doble siguiendo el formato 23.75. | Error | 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 doble siguiendo el formato 23.75. | Advertencia | todas | ||
| Valor {nombre de encabezado} no válido. {Nombre de encabezado} debe ser un entero. | Error | 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 un entero. | Advertencia | 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. | Error | 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. | Error | todas | ||
| Cada PersonId debe tener un ManagerId único. | todas | |||
No puede haber bucles donde:
|
Error | todas |