Resumen
Cuando importa usuarios en Integrations, la pantalla de revisión muestra cómo se gestionó cada fila de su archivo y señala las filas que necesitan atención. Este artículo le guía a través de la lectura de los resultados de la tarea de importación, la comprensión de las columnas de conflicto y error, y la descarga de las filas afectadas para que pueda corregirlas y volver a importarlas. El objetivo es corregir las filas conflictivas o fallidas antes de considerar la importación como completa.
Introducción
Las importaciones de usuarios en Integrations convierten un archivo preparado en un lote de creaciones y actualizaciones de cuentas. Después de que se ejecuta una tarea, no todas las filas siempre tienen éxito: algunas filas entran en conflicto con cuentas existentes, y otras fallan porque sus datos no se pueden procesar. La pantalla de revisión de importación existe para mostrar exactamente cuáles son esas filas.
Esta pantalla la utilizan administradores que incorporan alumnos de forma masiva o que mantienen a KnowledgeCity alineado con una lista gestionada en otro lugar. En lugar de adivinar qué sucedió, obtiene un desglose por tarea de las filas creadas, actualizadas y fallidas, con las filas fallidas explicadas y disponibles para descargar, de modo que pueda repararlas y volver a ejecutar la importación.
Conceptos clave
- Import job (tarea de importación): una única ejecución de una importación de usuarios. Cada tarea se lista con su nombre de archivo, quién la ejecutó, la fecha de importación y el total de filas en el archivo.
- Row statuses (estados de fila): cada fila se resuelve en una de las columnas de resultado, Created para cuentas nuevas, Updated para cuentas existentes que fueron modificadas, y Failed para filas que no se pudieron procesar.
- Match-by field (campo de coincidencia): el identificador (como Email, Employee ID o Username) que decide si una fila coincide con una cuenta existente. Es lo que diferencia una actualización de un registro nuevo, y es la fuente habitual de conflictos.
- Add, update, and skip actions (acciones de agregar, actualizar y omitir): el comportamiento de importación que eligió determina cómo se trata cada fila, ya sea agregando usuarios nuevos, actualizando usuarios existentes, u omitiendo una columna asignada y dejándola fuera de la importación.
- Failed rows and error descriptions (filas fallidas y descripciones de errores): filas que el sistema no pudo procesar. Las celdas que contienen errores se resaltan en rojo, y la última columna lleva una descripción del error o los errores de esa fila.
- Downloadable rows (filas descargables): cada columna de resultado ofrece un informe que puede descargar: una lista de Excel de los perfiles creados, una lista de Excel de los perfiles actualizados, y un informe de errores para las filas fallidas.
Pasos a seguir
Abrir la lista de tareas de importación
Comience desde el área de importación, que se abre en una lista de todos los procesos de importación anteriores. Cada entrada representa una import job y muestra sus detalles clave: el File Name que se cargó, el administrador Imported By, la Import Date, y el recuento de Rows in File. Use esta lista para localizar la tarea que acaba de ejecutar o una tarea anterior que necesita revisar.
Leer las columnas de resultado
Para la tarea que está revisando, observe las columnas de resultado que resumen lo que sucedió con cada fila. Created muestra el recuento de cuentas nuevas que se agregaron correctamente. Updated muestra el recuento de cuentas existentes que se modificaron correctamente. Failed muestra el número de filas que no se pudieron procesar. En conjunto, estas columnas le indican de un vistazo cuánto de su archivo se procesó sin problemas y cuánto aún necesita trabajo.
Identificar las filas conflictivas y fallidas
Las filas que no terminaron como cuentas nuevas bajo Created son en las que debe centrarse. Una fila se trata como una actualización en lugar de una cuenta nueva cuando coincide con un usuario existente según el match-by field que seleccionó, así que revise su elección de Match user by field (Email, Employee ID o Username) si las filas se resolvieron de forma diferente a la esperada. Las filas en el recuento de Failed son las que el sistema rechazó por completo y son la prioridad para la corrección.
Descargar las filas afectadas
Para ver el detalle detrás de cada recuento, descargue el informe adjunto a esa columna. Use la opción de descarga en Created y Updated para obtener una lista de Excel de los perfiles de cada grupo, y use la opción de descarga en Failed para obtener el informe de errores. El informe de errores es la copia de trabajo que corregirá, porque aísla exactamente las filas que no se procesaron.
Leer los detalles del error
Abra el informe de errores descargado y busque las celdas resaltadas en rojo, que marcan los valores específicos que causaron un problema. Lea la última columna, que contiene una descripción del error o los errores de esa fila. Los problemas comunes incluyen un campo obligatorio faltante o un identificador que no se resuelve claramente frente a las cuentas existentes. Use estas descripciones para entender qué cambiar en cada fila marcada.
Corregir y volver a importar
Corrija los valores resaltados en su archivo corregido para que cada fila tenga datos válidos y coherentes, prestando especial atención al match-by field para que las acciones de agregar y actualizar se resuelvan como pretende. Luego vuelva a ejecutar la importación con las filas corregidas. Confirme los resultados comprobando que las filas que antes fallaron ahora aparecen bajo Created o Updated, y verifique puntualmente algunos registros contra su fuente antes de considerar la importación como completa.
Conclusión
La pantalla de revisión de importación en Integrations le ofrece un registro claro, por tarea, de qué filas se crearon, actualizaron o fallaron, y le permite descargar las filas exactas detrás de cada resultado. Al leer las descripciones de errores, corregir los valores marcados y volver a importar, resuelve conflictos y errores para que sus registros de usuarios se registren con precisión y se mantengan sincronizados con su fuente.