Configuración y ejecución del WMS-Print-Agent

• Java versión 11 o superior.
• Se requiere soporte de infraestructura del cliente. Los responsables de la infraestructura de red del cliente deben asegurarse de que el puerto TCP 38451 (puerto predeterminado) esté liberado en el firewall, para la comunicación con la Nube. Es importante resaltar que no se debe bloquear el puerto TCP 38451, ya que es a través de este puerto que la aplicación WMS-Print-Agent se conecta al servidor Senior Cloud.
• Es obligatorio informar a Cloud Senior de la IP externa/de salida del cliente. Haga clic aquí para abrirllamado en la Nube. El tiempo de respuesta del SLA seguirá el estándar establecido en el contrato.
• Las impresoras que se utilizarán deben estar asignadas en el sistema operativo de la máquina que se utilizará y disponibles para ser utilizadas por el usuario que ejecutará laAplicación WMS-Print-Agent.
• El agente CLIENTE debe estar instalado en la máquina cliente.

• Sólo se permite un CLIENTE por instalación de cliente.
• Las versiones anteriores a la 3.0.0 de WMS-Print-agent no incluyen la reconexión automática. Por otro lado, la versión 3.0.0 de WMS-Print-agent ofrece reconexión automática, pero sólo es compatible con la versión de Storage Management | WMS Senior 8.12.7.257 o superior.

CLIENTE está disponible enPortal del Cliente de Mayor.

El agente ya está incluido en Gestión de almacenamiento | WMS Senior.

1. Acceda al Portal del Cliente Senior con sus credenciales;
   
2. Navegue a la carpeta de dirección remota /tools/WMS-Print-Agent;
3. Descargue el archivo application.properties a una carpeta local, ejemplo:
   C:/WMS-Imprimir;
4. Navegue a la carpeta de dirección remota /tools/WMS-Print-Agent/3.0.0:
   • La carpeta 3.0.0 hace referencia a la versión de WMS-Print-agent, por lo tanto, seleccione la carpeta con la última versión en este momento.
5. Descargue el archivo WMS-Print-agent-XXXjar (el más actual) en la misma carpeta local, por ejemplo: C:/WMS-Print;
6. Realizar configuración de archivospropiedades.de.aplicación;
7. Abra la carpeta local que contiene los archivos descargados;
8. Ejecute el archivo WMS-Print-agent-XXXjar.
   • Haga doble clic en WMS-Print-agent-XXXjar o ejecute el comando
     
     java -jar .\WMS-Print-agent-XXXjar

Al final de la instalación exitosa, se muestra el mensaje "listAllPrintersRequest Response Complete". Informando que las impresoras ya están listadas en el WMS.

• Es compatible con cualquier SO (sistema operativo), ya que se ejecuta en una JVM.
• El agente ya está registrado en Gestión de Almacenamiento | WMS sénior
• Compatible con versiones superiores a 8.12.7.7 y 8.12.6.30 de Storage Management | WMS Senior.
• La versión 3.0.0 de WMS-Print-agent ofrece reconexión automática, pero solo es compatible con la versión de Storage Management | WMS Senior 8.12.7.257 o superior.

Vaya a Configuración > Configuración general > botón Cambiar > pestaña Impresión remota

1. Elija entre las opciones debajo del campoTipo de impresión utilizada:
   • Impresión local
   • Impresión de agente remoto: informa la dirección donde el agente configurado brinda acceso al WMS para ser invocado mediante llamadas REST y se debe informar esta dirección junto con los datos de autenticación necesarios para realizar la llamada REST.
   • Impresión de mensajería: es necesario informar dos puertos, uno para conexión directa vía TCP y otro para uso vía WebSocket, estos puertos son utilizados por el agente remoto para conectarse a las colas de mensajes publicadas en el WMS para poder atender solicitudes de impresión y obtener impresoras disponibles. Esta conexión requiere un nombre de usuario y contraseña.
   • si en el campoTipo de impresión utilizada elige la opciónImpresión de agente remoto, rellene los siguientes campos:
   1. Dirección del agente de impresión remota
   2. Usuario del agente de impresión remota: ingrese un usuario en este campo para identificar el agente de impresión, como "impresión".
   3. Contraseña del agente de impresión remota: proporciona una contraseña aleatoria que se asociará con elUsuario del agente de impresión remota.
   • Pero si eligesImpresión de mensajería en el campoTipo de impresión utilizada, el sistema te pedirá que completes los campos restantes:
   1. Puerto TCP disponible para conexión
   2. Tiempo de espera para comunicaciones: se requiere informar cuánto tiempo esperará el WMS para que el agente remoto responda a las solicitudes de impresión y devolución de las impresoras instaladas, esta definición se realiza en el campo Tiempo de espera para comunicaciones
   3. Tiempo de caché para impresoras cargadas : se usa para optimizar el rendimiento de la consulta de impresoras disponibles, por defecto se definió un tiempo para mantener una lista de impresoras que están disponibles en caché, esto se hizo porque las instalaciones y disponibilidad de las impresoras no suelen cambiar mucho con el tiempo, por lo que podemos acelerar la respuesta a la consulta de impresoras disponibles que utilizan recursos almacenados en caché disponibles. Es decir, es posible definir el tiempo máximo que se reutilizará la lista de impresoras obtenida.
      Establecer cero segundos desactiva esta función.
   4. Puerto WS disponible para conexión
   5. Usuario de acceso a mensajería: ingrese un usuario en este campo para identificar el acceso al mensaje, como "imprimir".
   6. Contraseña de acceso a mensajería: proporciona una contraseña aleatoria que se asociará con elUsuario de acceso a mensajería.
2. Haga clic en el botónValidar agente de impresión

Vaya a Configuración > Configuración General > botónObtener datos Conexión Mensajería

1. El botón se habilitará si la configuración para usar la impresión a través de mensajería está configurada correctamente.
2. Al hacer clic en este botón, se presentará una pantalla con las propiedades de autenticación debidamente completadas, listas para ser insertadas en el archivo application.properties del agente de impresión.
   
   

Vaya a Configuración > Configuración General > Botón Cambiar >Conexión

Activar elSoporte senior de WMS para rellenar correctamente estos campos.

1. RUTA_TSUNAMI: se refiere acamino fijo para acceder y mostrar impresoras en WMS Enterprise.
2. RUTA_TSUNAMI_INTERNA: Este campo debe completarse correctamente para mostrar las impresoras en el recopilador de datos.

1. wms.printagent.solicitudes.fue
   • nte
   Esta propiedad indica qué contexto de uso se utilizará, los valores pueden ser MENSAJE o WEB, indique MENSAJE para el contexto de mensajería
2. wms.printagent.messaging.clientID
   • Identificador único del cliente que se conectará al WMS
3. wms.printagent.messaging.nombredelcliente
   • Nombre de usuario definido en el WMS para autenticación - Obtenido de la siguiente ruta: Configuración > Configuración General > botón Obtener Mensaje de Conexión de Datos
4. wms.printagent.messaging.clientKey
   • Clave definida en el WMS para autenticación - Se obtiene de la siguiente ruta: Configuración > Configuración General > botón Obtener Mensaje de Conexión de Datos
5. wms.printagent.messaging.uri
   • Dirección para conexión mediante WebSocket(WS), ejemplows://HOST:PORT_WS/mqtt, cuando se usa, no es necesario informar las propiedades wms.printagent.messaging.host y wms.printagent.messaging.port
     - Donde HOST es donde se aloja el WMS SILT
     - PORT_WS es el puerto definido en la siguiente ruta: Configuración > Configuración General > Impresión Remota > Puerto WS Disponible para conexión.
6. wms.printagent.messaging.host
   • Host utilizado para acceder a la mensajería directamente mediante el protocolo TCP; cuando se utiliza una conexión TCP, no se debe informar la propiedad wms.printagent.messaging.uri
7. wms.printagent.messaging.port
   Puerto WMS definido para acceso a mensajería usando el protocolo TCP, al usar una conexión TCP no se debe informar la propiedad wms.printagent.messaging.uri
8. wms.printagent.messaging.connectionTimeout
   • Se deben ingresar valores mayores a cero y menores o iguales a cinco minutos.
   • Tiempo máximo que esperará para realizar la conexión y volver a conectarse en caso de desconexión. Utilice el formato de duración establecido, como se describe en la API de Java enhttps://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Duration.html#parse(java.lang.CharSequence), para informar el tiempo de espera
   • Para utilizar esta propiedad utilice el estándar “PTnMn.nS” donde los sufijos ASCII de “M” y “S” significan minutos y segundos y se aceptan en letras mayúsculas y minúsculas, en el caso de segundos todavía tiene la definición de dos números “nn” la primera n es la que especifica el valor de los segundos y la segunda n que está después de los puntos significa nanosegundos y se puede omitir si no se desea informar la duración con tanta precisión. Por lo tanto, se puede definir la duración que definirá esta propiedad, por ejemplo: PT5M se identifica como 5 minutos y PT3M30S se identifica como 3 minutos y 30 segundos.

1. wms.printagent.seguridad.credenciales
   • Ingrese las credenciales en el formato "usuario: contraseña" para que sean las credenciales de acceso a la interfaz REST del proyecto.
2. wms.printagent.seguridad.clave.secreta
   • Semilla de cadena utilizada para cifrar el token JWT durante la autenticación
3. wms.printagent.security.token.expiración.minutos
   Tiempo en minutos que tardará el token en caducar

En el escenario donde el host estará realizando la descarga, y cuando lo resuelve el DNS devuelve más de una IP y una de estas IP está tardando mucho en responder, y estás notando que la impresión está tardando mucho. para ser llevado a cabo. Una vez insertada la propiedad a continuación con la información en ms y con valores entre 500ms y 10000ms que representan 0.5 y 10 segundos respectivamente, la propiedad es:

1. wms.printagent.descargando.connectionTimeout
   • Tiempo de espera definido en MS con valores entre 500 y 10000
   • Si no se define ningún valor o el valor especificado está fuera del rango 500 y 10000, se utilizará el valor predeterminado de la API de solicitudes http, que es 10000 ms, es decir, 10 segundos.

Además de todos los parámetros específicos de WMS-Print-Agent, también hay patrones de aplicación SpringBoot que están disponibles y se pueden consultar enhttps://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html.

Ejemplo de cómo completar el archivo.

wms.printagent.security.credentials=usuarioActuador:123456

wms.printagent.security.secret.key=SECRETO

wms.printagent.security.token.expiración.minutos=15

wms.printagent.requests.source=MENSAJE

wms.printagent.messaging.clientID=agente_999

wms.printagent.messaging.clientName=imprimiendo

wms.printagent.messaging.clientKey="9QDlAKqlBTrF9N9NJEvdluTMWf7P58yYsdBJnu5A1uYqPnKk56OepLFthuAlSzbD"

wms.printagent.messaging.uri=ws://coloque_aqui_o_endereço_do_servidor_senior:38451/mqtt

wms.printagent.rendimiento.timemeasure=true

wms.printagent.downloading.connectionTimeout=500

 

Es imprescindible añadir la siguiente línea para la versión 3.0.0 de WMS-Print-agent:
wms.printagent.messaging.urlServiceStatus=//endereco_WMS:porta_do_WMS_Senior/siltwms/config/ConfiguracaoService/statusMessagingPrinting

 

Nota lanombre del cliente y el clavecliente debe copiarse del botónObtener datos Conexión Mensajería, que aparece en elConfiguración general.