Configuración del archivo appsettings.json
Las configuraciones de este módulo se encuentran en un archivo llamado appsettings.json.
Este archivo reúne todos los parámetros necesarios para configurar el NDD Print Host Proxy Reverse según el entorno de instalación.
Localización del archivo
Tras la instalación, el archivo appsettings.json estará disponible en el siguiente directorio:
C:\Program Files\NDDigital\nddPrint\HostProxyReverse\Host.FilesReceiver
Hay otros archivos appsettings.json en otras carpetas, pero solo este debe utilizarse para configurar el módulo.
Estructura del archivo
La estructura está organizada de tal forma que cada función cuenta con parámetros específicos, lo que permite modificarlos según sea necesario.
A continuación se describen las principales funciones y sus características.
Kestrel
Se encargará de los puertos que antes gestionaba Nancy. De este modo, todas las solicitudes del NDD Print Agent serán capturadas por el proxy y enviadas a los puertos definidos en la instalación de los nuevos servicios. Estos servicios (NDDigital nddPrint Host NPL Receiver y NDDigital nddPrint Host NSL Receiver) procesarán los paquetes de información.
No modifique este parámetro, salvo en caso de conflicto entre puertos.
RateLimiting
Mecanismo de limitación de la tasa de solicitudes que controla la cantidad permitida, evitando la sobrecarga o el abuso (p. ej., DDoS o exceso de llamadas).
Parámetros:
|
Parámetro |
Descripción |
Valor estándar |
|---|---|---|
|
PermitLimit |
Número de solicitudes permitidas en el intervalo definido. |
2 |
|
WindowSeconds |
Intervalo de tiempo (en segundos) para el recuento de solicitudes. |
1 |
|
QueueLimit |
Cantidad máxima de solicitudes que pueden estar en cola. |
0 |
Ejemplo:
Con los valores estándar, se permiten 2 solicitudes por segundo, sin cola adicional.
SerilogEnabled
Indicador para activar la función de registro de la aplicación, que captura y registra datos de log.
Configuración:
-
False → Desactivado (estándar)
-
True → Activado, con generación de logs estructurados.
Ubicación de los logs:
Cuando está habilitado (True), los logs se guardan en:
C:\Windows\Temp\NDDigital\nddPrint\Host\Traces
Configuración necesaria
Es necesario que las claves del registro estén configuradas correctamente para garantizar el correcto funcionamiento del procesamiento.
|
Clave |
Descripción |
|---|---|
|
NplConsolitationInterval |
Define el intervalo de procesamiento de los archivos NPL. |
|
NplNslSendInterval |
Define el intervalo de procesamiento de los archivos NSL. |
|
LogTransformEnabled |
Cuando se establece en Recomendação: manter desativado, pois o Files Receiver já é responsável por essa movimentação. |
|
ProxyReverseApiEnabled |
Cuando se establece en |
|
EnabledRetryNPLProcess |
Cuando se establece en |
|
NPLRetryConsolidationLimit |
Establece la cantidad máxima de archivos que se volverán a procesar. |
|
EnableConsolidateBigFiles |
Cuando se establece en |
Configurações adicionais
|
Parámetro |
Descripción |
Valor estándar |
|---|---|---|
|
SerilogEnabled |
Habilita el registro de logs y errores. |
|
|
ProxyReverseApiEnabled |
Habilita el uso del Proxy Reverse para el procesamiento de los archivos. |
|
|
NplFileBigLengthMb |
Tamaño máximo (en MB) para que un archivo NPL se considere “grande”. |
|
|
NslFileBigLengthMb |
Tamaño máximo (en MB) para que un archivo NSL se considere “grande”. |
|
|
TimerLogTransformInSeconds |
Intervalo (en segundos) para mover los archivos de la carpeta |
|
|
MaxFilesToTransfer |
Cantidad máxima de archivos transferidos por ejecución. |
|
|
DeleteErrorFiles |
Cuando |
|
|
TimerRemoveBigFilesInSeconds |
Intervalo (en segundos) para la limpieza de archivos grandes que no se consolidarán. |
|
|
DeleteBigFiles |
Cuando |
|
|
MaxBigFilesToRemove |
Cantidad máxima de archivos grandes eliminados por ejecución. |
|
Atención:
Se recomienda mantener estas configuraciones con los valores estándar. Realice cambios solo si existe una necesidad específica del servidor; en tal caso, póngase en contacto con el servicio técnico para que lo analicen.