Addons a medida / 5390 - UPCnet Tech, SLU / Sit.UPCNet.Renombrador
Resolución de problemas
Tabla de síntomas#
| Síntoma | Causa probable | Solución |
|---|---|---|
| La aplicación no arranca | .NET 6.0 Desktop Runtime no instalado | Instalar .NET 6.0 Desktop Runtime desde el sitio oficial de Microsoft |
| "No se ha podido extraer el fichero ZIP" | ZIP dañado, en uso por otra aplicación o no válido | Verificar que el fichero no está abierto en otra aplicación y que es un ZIP válido |
| "La relación de NIFs (fichero excel) está vacía" | configNIF.xlsx sin filas de datos |
Abrir el Excel y verificar que tiene datos a partir de la segunda fila |
| "Error en fichero excel" | .xlsx corrupto, en uso o no accesible |
Cerrar Excel si está abierto con ese fichero y reintentar |
| "El trabajador con nº X no se encuentra en el Excel" (en el log) | El número de trabajador del fichero no está en el Excel | Añadir la fila correspondiente en configNIF.xlsx |
| "Ha habido un problema al intentar subir los archivos al servidor FTP" | Credenciales SFTP incorrectas, servidor inaccesible o sin red | Verificar el bloque FTP en config.json y la conectividad de red |
| El desplegable "Tipo documento" aparece vacío | config.json no se encuentra o está mal formado |
Verificar que Configuracion\config.json existe y es JSON válido |
| Ficheros de salida con nombre incorrecto | El patron no contiene los marcadores esperados o el formato de fecha es incorrecto |
Revisar patron y formatoFecha en config.json para el tipo afectado |
| El proceso termina con éxito pero no aparecen ficheros en el SFTP | El cifrado está activo y el servidor solo acepta .pgp, o el directorio por defecto del usuario SFTP no es el esperado |
Verificar el directorio de llegada del usuario en el SFTP y el campo cifrar |
| Tras pulsar "Renombrar y subir" la aplicación termina sin ningún mensaje | Error en la fase de cifrado: publicKey.asc no existe, está dañado o tiene formato incorrecto |
Abrir el log del día (carpeta Logs\); si la causa es la clave, seguir Renovación de la clave PGP |
El receptor no puede abrir o descifrar los .pgp recibidos |
La clave PGP del receptor se ha renovado pero publicKey.asc no se ha actualizado |
Solicitar la nueva clave y seguir Renovación de la clave PGP |
Comportamientos y limitaciones conocidos#
Conviene tenerlos presentes al diagnosticar incidencias:
-
Fallo de cifrado silencioso. Si el cifrado falla, la aplicación termina sin mostrar ningún diálogo (ni de éxito ni de error). Además, en ese caso el directorio temporal no se elimina: queda en
%TEMP%\Esofitec_Renombrador{timestamp}\. El error completo sí queda en el log del día. Ante un final sin mensaje, el primer sitio donde mirar es el log. -
Ficheros que superan el tamaño máximo. Si un fichero individual del ZIP supera los 20.000.800 bytes, se omite de los ZIPs de salida y no se notifica por pantalla. Verificar el log si falta algún documento en el destino.
-
Trabajador sin NIF. Si el número de trabajador no está en el Excel, ese fichero no se renombra y se registra el error, pero el proceso continúa con el resto.
-
Dependencia del SFTP en tiempo de ejecución. Si la conexión al SFTP falla, el renombrado y empaquetado ya se habrán completado; solo falla la subida. Se registra el error y se notifica al operador.
-
Subida al directorio por defecto. Los ficheros se suben al directorio por defecto del usuario SFTP (no se cambia de directorio). Si no aparecen donde se esperaba, revisar la configuración del usuario en el servidor.
El log es la fuente de verdad
Casi cualquier incidencia que no muestre mensaje en pantalla queda registrada en Logs\log-{yyyyMMdd}.txt. Empiece siempre por ahí.