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
• Replace: true/false por defecto false. Permite indicar si este autocontrol debe reemplazar al resto de autocontroles de misma clase, evento y nombre.

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.

Para poder utilizar estos SmartParams en el AutocontrolAction podemos utilizar la función GetParam, por ejemplo, cuando modificamos una incidencia por otra, podemos obtener el ID de la nueva incidencia mediante la siguiente expresión

GetParam( @psParams, «IDNEWINCIDENCE», «int», 0)

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 21-03-2025 son las siguientes: AddScheduleAction, BlockIntervalAction, ApplyScheduleAction, CopyScheduleAction, EraseDayAction, FreeActivityAction, AssignActivityAction, ApplyIncidenceAction, ApplySeqScheduleAction, ExtendedAction,RecoveryToUndoRedoAction,AddPactAction,ApplyHolidayCalendarAction,ApplyIncidenceCalendarAction,ApplyIncidenceOnWorkerListAction,ApplySeqScheduleAction,AssignNeedByAreaAction,CambioGuardiaAction,ChangeDiaryAction,ChangeHolidayAction,ClockControlIncidenceAction,CopySeqScheduleAction,CoverageAction,DelContractPactAction,DelPactAction,PlanifyAction,RecoveryVersionPlanAction,RecoveryVersionWorkerPlanAction,SwapScheduleAction,TimeAndAttendanceAction,WorkAssignAction