Addons a medida / 5390 - UPCnet Tech, SLU / Sit.UPCNet.Renombrador
Instalación y configuración
Requisitos previos#
| Requisito | Detalle |
|---|---|
| Sistema operativo | Windows 10 o Windows 11. |
| Runtime .NET | .NET 6.0 Desktop Runtime para Windows (https://dotnet.microsoft.com/download/dotnet/6.0 — seleccionar Desktop Runtime, no el de servidor). |
| Microsoft Excel | Opcional: solo si se quiere editar configNIF.xlsx desde el botón Abrir excel de NIFs. No es obligatorio si se edita con otra herramienta compatible con .xlsx. |
| Conectividad de red | Acceso al servidor SFTP configurado durante la ejecución. |
| Licencia | Credenciales válidas (clienteId, clienteSecret, licenciaId) proporcionadas por Esofitec, configuradas en config.json. |
Instalación#
La aplicación no dispone de instalador. La instalación consiste en copiar los ficheros distribuidos por Esofitec al equipo de destino. No requiere registro de componentes ni modificación del sistema operativo.
- Copiar el directorio completo de la aplicación a la ubicación deseada (por ejemplo,
C:\Aplicaciones\Renombrador\). - Verificar que la estructura es la siguiente:
Renombrador\
├── Sit.UPCNet.Renombrador.exe
├── Configuracion\
│ └── config.json
├── Excel\
│ └── configNIF.xlsx
├── PublicKey\
│ └── publicKey.asc
└── (resto de ficheros .dll y dependencias)
Distribución y actualizaciones
Como no hay instalador, una actualización consiste en sustituir el contenido del directorio de instalación por la nueva versión, conservando los ficheros de configuración del cliente (config.json, configNIF.xlsx, publicKey.asc).
Configuración principal: config.json#
Este fichero controla el comportamiento del proceso. Se abre desde la aplicación con el botón Configuración (Bloc de notas) o con cualquier editor de texto.
{
"renombrado": [
{
"descripcion": "Nóminas",
"documento": "NOMINA",
"formatoFecha": "MMyyyy",
"patron": "{{codTipoDoc}}{{Fecha}}_{{documento}}_{{nifTrabajador}}"
},
{
"descripcion": "Certificados",
"documento": "CERTIFICAT",
"formatoFecha": "yyyy",
"patron": "{{codTipoDoc}}{{Fecha}}_{{documento}}_{{nifTrabajador}}"
}
],
"FTP": {
"host": "nombre-o-ip-del-servidor-sftp",
"port": 22,
"usuario": "usuario_sftp",
"password": "contraseña_sftp"
},
"cifrar": true,
"licenciamiento": {
"clienteId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"clienteSecret": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"licenciaId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
}
| Campo | Descripción |
|---|---|
renombrado[].descripcion |
Nombre del tipo de documento que aparece en el desplegable. |
renombrado[].documento |
Código corto del tipo, usado en el nombre de los ficheros de salida ({{codTipoDoc}}). |
renombrado[].formatoFecha |
Formato .NET de la fecha de periodo. Ej.: MMyyyy (mes y año), yyyy (solo año). |
renombrado[].patron |
Plantilla del nombre de salida con marcadores. Ver Funcionamiento. |
FTP.host |
Host o IP del servidor SFTP de destino. |
FTP.port |
Puerto SFTP. Valor habitual: 22. |
FTP.usuario |
Usuario de autenticación SFTP. |
FTP.password |
Contraseña del usuario SFTP. |
cifrar |
true para cifrar los ZIPs con PGP antes de subirlos; false para subirlos sin cifrar. |
licenciamiento.clienteId |
Identificador de cliente de licencia (Esofitec). |
licenciamiento.clienteSecret |
Secreto de cliente de licencia (Esofitec). |
licenciamiento.licenciaId |
Identificador de licencia (Esofitec). |
Datos sensibles en config.json
config.json contiene credenciales SFTP y de licencia. No lo compartas con sus valores reales: usa siempre marcadores ficticios en ejemplos y documentación, y trata el fichero como confidencial.
Relación de NIFs: configNIF.xlsx#
Mapea cada número de trabajador con su NIF. Se abre desde la aplicación con el botón Abrir excel de NIFs.
- Primera fila: cabecera (puede tener cualquier texto; se ignora).
- Columna A: número de trabajador (debe coincidir exactamente con el del nombre de fichero del ZIP, ceros a la izquierda incluidos).
- Columna B: NIF del trabajador.
| Número trabajador | NIF |
|---|---|
| 00123 | 12345678A |
| 00456 | 87654321B |
Clave pública PGP: publicKey.asc#
Contiene la clave pública PGP del receptor de los ficheros cifrados. La proporciona el receptor y debe estar en formato OpenPGP ASCII-armored: un fichero de texto plano que empieza y termina con líneas características.
-----BEGIN PGP PUBLIC KEY BLOCK-----
<contenido codificado de la clave>
=XXXX
-----END PGP PUBLIC KEY BLOCK-----
El receptor puede renovar su clave periódicamente. Cuando ocurra, hay que sustituir este fichero: ver Renovación de la clave PGP.
Builds de Release ofuscadas
Las versiones de Release que distribuye Esofitec se ofuscan con ConfuserEx. Esto no afecta a la instalación ni a la configuración: el operador trabaja igual con el ejecutable distribuido.