Descripción
Lee, escribe y valida setpoints en controladores con límites de seguridad configurables y registro de cambios.
Parámetros de la Tool
| Parámetro | Tipo | Req. | Default |
|---|---|---|---|
tagId | string | ✓ Sí | — |
action | string | ✓ Sí | — |
value | number | — | — |
operatorId | string | — | — |
| Campo | Tipo | Formato |
|---|---|---|
tagId | string | — |
previousValue | number | — |
newValue | number | — |
withinLimits | boolean | — |
changeLogged | boolean | — |
Guía de Implementación
Se necesita `tagId` para identificar el punto de control exacto en el PLC o DCS, ya que múltiples variables pueden tener setpoints en el mismo equipo. `action` ('read' o 'write') separa la lógica de solo consulta vs modificación, permitiendo auditar accesos de lectura diferente de cambios operativos. `value` es requerido solo en 'write' y debe ser validado antes de escribir. `operatorId` es trazabilidad obligatoria para el registro de cambios: cada modificación de setpoint debe tener un responsable identificado para auditorías de proceso y cumplimiento regulatorio.
Para 'read': consultar el valor actual del tag via OPC-UA ReadNode. Para 'write': primero verificar que `value` está dentro del rango [limitInferior, limitSuperior] configurado para ese tag; si viola límites, rechazar y retornar `withinLimits: false`. Si es válido, escribir al controlador via OPC-UA WriteNode o Modbus. Registrar en la tabla de change_log: tagId, previousValue, newValue, operatorId, timestamp. `changeLogged: true` confirma la persistencia en base de datos.
`previousValue` y `newValue` permiten al agente entender la magnitud del cambio y decidir si requiere confirmación adicional. `withinLimits` es la validación de seguridad: el agente debe abortar la operación si es false y alertar al supervisor. `changeLogged` garantiza la integridad de la auditoría de cambios de proceso, requerida por normas como FDA 21 CFR Part 11 en industria farmacéutica.
Formulario de setpoint con campo numérico que muestra los límites min/max configurados como hints. Indicador visual de rango (barra deslizante tipo slider solo visual). Historial de cambios recientes del tag en tabla con operador, valor anterior, nuevo valor y timestamp. Botón de confirmación con modal de doble verificación para cambios que excedan el 10% del rango.
Evento ISO que genera esta tool
standardEvent.module.iddebe usar este nombre exacto.setpoint_change_event→ se visualiza en el Dashboard ISO y Reporte de AuditoríaCláusulas ISO que cubre este evento
Cambio de setpoint con auditoría de quién, cuándo y por qué.
Registro auditado de cambios de setpoint para trazabilidad.
Demo en vivo
Presiona Ejecutar Demo para ver cómo actúa esta tool en tiempo real