AutoControlActionValues

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

La sección AutoControlActionValues del fichero QueryCustom.xml permite definir expresiones de evaluación que validen acciones realizadas por la persona usuaria previas a la grabación de las mismas. Las características de estas definiciones son las siguientes:

• EventName: Define el tipo de evento que se trata (puede ser: BeforeRunAction o AfterRunAction )
• ActionName: Define el nombre de la acción sobre el que se actúa. La lista de acciones existente en el sistema se puede consultar en el siguiente artículo: WP_ACTIONLIST. Se puede indicar la misma expresión de control a aplicar para múltiples acciones separando el nombre de las acciones con una coma.
• Name: Nombre del elemento (es descriptivo)
• UserAccess: Define el tipo de usuario o usuaria y/o usuarios/as y/o Grupos de usuarios o usuarias que van a estar sujetos a la evaluación. Valores posibles: u_Administrador, u_Parametrizador, u_Planificador, u_Integrador, u_Consultor, u_Supervisor…, admingps, GRUPO_ZETA

La expresión a evaluar siempre debe retornar un string. En blanco (NULO) si todo ha ido bien, o un mensaje de error/aviso que indique a la persona usuaria la imposibilidad de llevar a cabo la acción solicitada. En dicha expresión, el contexto de la acción viene determinado por los siguientes parámetros:

• pFrom: Fecha de inicio del contexto de la acción (en el cambio de guardia fecha de inicio del intercambio)
• pIdCase: Identificador del escenario en el contexto de la acción
• pTo: Fecha de fin del contexto de la acción (en el cambio de guardia fecha de retorno del intercambio)
• pIdWorker: Identificador del empleado o empleada en el contexto de la acción
• pIdCW: Identificador del contrato en el contexto de la acción
• pIdNeed: Identificador de la necesidad en el contexto de la acción
• pIdIncidence: Identificador de la incidencia en el contexto de la acción
• pDestinoWorkerID: En el cambio de guardia Identificador del worker de destino
• psParams: String que contiene los SmartParams de la acción en el contexto de la acción

Cualquiera de estos parámetros, exceptuando los 2 primeros: pFrom y pIdCase, pueden ser 0 dependiendo de la acción.

Si deseas convertir la función de control en aviso debes asegurarte que el mensaje de retorno contenga en el inicio del mismo la cadena “WARNING#”

<AutoControlActionValues>
     <AutoControlActionValue EventName="BeforeRunAction" ActionName="AddScheduleAction" Name="AddScheduleAction_CheckDates" UserAccess="u_Administrador,u_Parametrizador,u_Planificador,u_Consultor">
	<![CDATA[
            IfElse(Month(@pFrom)==1," XXX Horas incorrectas antes de aplicar","")
        ]]>
      </AutoControlActionValue>
 </AutoControlActionValues>

Las acciones que tienen definido el contexto en fecha 31-12-2015 son las siguientes: AddScheduleAction, BlockIntervalAction, ApplyScheduleAction, CopyScheduleAction, EraseDayAction, FreeActivityAction, AssignActivityAction, ApplyIncidenceAction, ApplySeqScheduleAction, ExtendedAction