Artículos de Importador
Configuración
Casos prácticos
GuíaNivel intermedio4 min de lecturaRevisado el
Seguir una importación y descargar sus resultados
Revisa el avance de cada carga, entiende los estados de las filas, encuentra los errores y descarga un Excel con el resultado.
Cada importación que ejecutas queda registrada en Historial de Importaciones. Desde ahí ves cuántas filas se procesaron, cuáles fallaron y por qué, y puedes descargar el resultado en Excel con las columnas que tú definas.
En WeSyncro:ImportadorImportaciones
Qué muestra el historial#
| Columna | Contenido |
|---|---|
| Fecha | Día y hora en que se registró la carga. |
| Nombre / Archivo | Nombre automático de la importación y el archivo de origen. |
| Transformador | El transformador usado. |
| Progreso | Filas procesadas sobre el total, una barra de avance y una etiqueta roja con la cantidad de errores. |
| Estado | Estado general de la carga. |
| Acciones | Botón Detalles. |
El listado muestra 15 importaciones por página y se actualiza en vivo mientras una carga avanza, sin recargar la página.
Estados#
Los mismos estados se usan para la importación completa y para cada fila.
| Estado | En una fila | En la importación |
|---|---|---|
| Pendiente | Aún no se envía al destino. | Recién registrada. |
| Procesando | Se está enviando. | Quedan filas por procesar. |
| Completado | El destino respondió sin error. | No quedan filas pendientes y al menos una terminó bien. |
| Error | Falló la transformación o el destino. | No quedan filas pendientes y todas fallaron. |
Revisar el detalle#
Haz clic en Detalles. La ventana muestra:
- Destino Configurado: a dónde se enviaron los registros y su tipo.
- Cuatro contadores: Total, Pendientes, Exitosos y Errores.
- Una tabla con una fila por registro, de 10 en 10.
| Columna de la tabla | Qué contiene |
|---|---|
| Datos origen | La fila tal como venía en tu archivo. |
| Resultado transformación | El registro después de pasar por el transformador. |
| Estado | Estado de esa fila. |
| Mensaje / Log destino | El error en rojo, o el recuadro Respuesta Destino con lo que contestó el sistema de destino. |
Encontrar la causa de un error#
| Lo que ves en Mensaje / Log destino | Dónde está el problema |
|---|---|
| "Error: Error en la transformación:" y un detalle | En el transformador. Compara Datos origen con lo que espera el transformador: suele faltar una columna o venir con otro nombre. |
| "Error:" con un mensaje del sistema de destino | En el destino. El dato llegó, pero el destino lo rechazó. Revisa Resultado transformación para ver qué se envió. |
| Respuesta Destino con un código distinto al esperado | En el destino o en su configuración: dirección, método o cabeceras. |
El historial no tiene botones para reintentar, cancelar ni eliminar una importación. Para repetir filas con error, corrige la causa, deja en un archivo solo esas filas y ejecuta una importación nueva.
Descargar el resultado en Excel#
El botón Descargar Excel del detalle exporta todas las filas de la importación, no solo las que fallaron. Antes debes definir qué columnas llevará el archivo.
Abre la configuración
En el detalle haz clic en Configurar descarga.
Define las columnas
Con Agregar columna crea cada columna y completa Columna Excel con el título, Fuente con el origen del dato y la ruta del campo. El botón Elegir abre Elegir campo desde JSON, donde seleccionas el campo con un clic.
Guarda
Haz clic en Guardar configuración. Verás "Configuración de descarga guardada."
Descarga
Haz clic en Descargar Excel. El archivo lleva el nombre de la importación y una hoja llamada "Registros".
Opciones de Fuente:
| Fuente | De dónde lee |
|---|---|
| Datos origen | Las columnas de tu archivo original. |
| Resultado transformación | El registro ya convertido. |
| Respuesta / log destino | Lo que respondió el destino, por ejemplo un identificador creado. Usa rutas como response.data.id. |
| Registro completo | Datos de la fila en el importador, como su estado y su mensaje de error. |
La configuración se guarda por destino: todas las importaciones que usen el mismo destino comparten las mismas columnas de descarga.
Problemas frecuentes#
"Configura las columnas de descarga antes de generar el Excel."#
Aún no defines columnas para ese destino. Se abre la ventana de configuración para que las crees.
"Define al menos una columna con nombre y ruta."#
Intentaste guardar la configuración con columnas incompletas. Cada columna necesita título y ruta.
"Este proceso no tiene destino asociado para guardar una configuración."#
La importación no tiene destino, por lo que no se puede guardar una configuración de descarga para ella.
"No hay registros para descargar."#
La importación no tiene filas.
"No se pudieron cargar los detalles."#
El detalle no se pudo obtener. Cierra la ventana y vuelve a presionar Detalles.