Capturar eventos de cliente

ATENCIÓN: El siguiente contenido es de uso avanzado y su utilización puede ocasionar daños irreparables en la configuración del sistema

En la sección ClientScripts del QueryCustom se definen los diferentes eventos que se desean capturar en la aplicación cliente BOLD WorkPlanner.

El formato de cada una de las configuraciones de los eventos varía en función del objetivo del mismo:

Cada uno de los elementos a configurar se compone de un nodo Script con una serie de atributos que personalizan el comportamiento del evento capturado.

Atributos permitidos en el nodo Script

• Class:Identifica la clase sobre la que se desea capturar el evento. Consultar Clases y atributos para encontrar la lista de clases disponible.
• Queries: si se quiere asociar el script a una pantalla defnida mediante una consulta SQL, es necesario introducir la lista de consultas separadas por comas. Por ejemplo la consulta: CCPayRollReportToPublish que nos proporciona los informes de contadores de nómina publicados.
• Name: Nombre del script que se ejecutará si la acción se debe lanzar.
• ShowName: Nombre con el que se muestra la opción al usuario cuando se ejecuta.
• Description:Permite ofrecer al usuario una descripción largo del evento a lanzar.
• Event: Cadena de texto que identifica el evento que se está capturando. La lista de eventos que se puede capturar es:
  • OnUserMenu: Al seleccionar este evento, se capturará el botón derecho sobre las filas de los maestros de objetos. Ofreciendo un submenú llamado Tareas, con tantas opciones como scripts OnUserMenu asociados a la clase estén definidos.
  • ….:
• Wait: Máximo nº de segundos a esperar por la correcta finalización de la tarea lanzada. 0 significa esperar de forma indefinida. -1 indica que el servidor no se esperará a que termine el script (ejecución asíncrona)
• Enabled: 1 para activar el uso del script, 0 para desactivarlo.
• UserAccess: Tipos de usuarios o nombres de usuarios, que pueden lanzar el script. Es una lista separada por comas, donde se puede especificar el nombre interno de cada tipo de usuario que deseamos que pueda ejecutar el script, o bien el nombre de usuarios concretos.
• Monitored: 1 indica que el script se ha de lanzar como operación monitorizada. Recomendado activar.
• UserAccess: Perfiles o nombres de usuario separados por comas, que pueden ejecutar la tarea.

Eventos OnUserMenu

Es posible asociar un conjunto de acciones personalizadas que se realizarán teniendo como contexto un conjunto de filas seleccionadas de cualquier listado.

Evento lanzado desde la pantalla de un maestro

En el siguiente ejemplo se muestra cómo agregar la posibilidad de lanzar desde el listado de empleados un script determinado asociado a un conjunto de filas seleccionadas en el maesto correspondiente a la clase interna Empleados (Worker):

<ClientScripts>
    <Script Class="Worker" Name="Task_ExportNomina.bat" ShowName="Exportar contadores de nómina (mes en curso)" Description="Traspasa los contadores de nómina consolidados del mes en curso de los empleados seleccionados" UserAccess="administrador" Event="OnUserMenu" Wait="-1" Enabled="1" Monitored="1"/>
</ClientScripts>

El script anterior implementado en el fichero Task_ExportNomina.bat se ejecutará cuando el usuario seleccione la opción “Exportar contadores de nómina (mes en curso)” en la pantalla del maestro de empleados, menú contextual Tareas. El script recibe como parámetros la lista de ids de los empleados seleccionados.

Evento lanzado desde una pantalla de consulta configurada (ejemplo: exportación de nómina o conceptos variables)

La siguiente configuración activa una nueva tarea Exportar contadores de nómina dentro de la pantalla de consulta de las versiones calculadas de contadores de nómina (consulta CCPayRollReportToPublish). En este caso la definición de la consulta SQL debe indicar el nombre de la columna que actuará como clave y de la cual se extraeran los valores a pasar al script para que actúe sólo sobre ellos. Para ello se define el campo KeyField de la Query. Para más información consultar la categoria Consultas preprogramadas.

<ClientScripts>
    <Script Class="Undefined" Queries="CCPayRollReportToPublish" Name="Task_ExportNominaVersion.bat" ShowName="Exportar contadores de nómina" Description="Traspasa los contadores de nómina consolidados de la versión seleccionada" UserAccess="administrador" Event="OnUserMenu" Wait="-1" Enabled="1" Monitored="1"/>
</ClientScripts>

Ubicación de logs para tareas lanzadas desde el cliente Windows

Se guardan en una subcarpeta con un nombre autogenerado único debajo de la siguiente carpeta:

C:\Windows\Temp\GPSScripts

Dentro podemos encontrar los ficheros:

• execution.log: log completo de ejecución del comando
• InputParameters.xml: datos de entrada que recibe el script
• OutputParameters.xml: datos de salida