UA_MonitoredItemAddList

Descripción general

Tipo:	Bloque de funciones
Disponible desde:	V2.0.0.0

Descripción funcional

El bloque de funciones UA_MonitoredItemAddList se usa para añadir elementos supervisados a una suscripción usando una lista de controladores de nodos.

El bloque de funciones actualiza los valores de SamplingTime y QueueSize usando el parámetro de entrada/salida MonitoringParameters.

Los parámetros de entrada/salida restantes se actualizan de forma independiente en función de la SyncMode seleccionada:

Para SyncMode UAMS_ControllerSync, llame al bloque de funciones UA_MonitoredItemOperateList para actualizar valores.
Para SyncMode UAMS_FwSync, el firmware actualiza los valores automáticamente en función del intervalo configurado con el PublishingInterval de entrada/salida correspondiente a la suscripción. Opcionalmente, puede llamarse al bloque de funciones UA_SubscriptionProcessed para verificar si se han publicado los nuevos valores.

NOTA: SyncMode UAMS_FwSync solo es compatible usando NodeDataType UATypeIECSymbol para hacer referencia a variables de tipos de datos básicos con un tamaño máximo de 8 bytes.

NOTA: Un error de coincidencia de tipo de datos entre un elemento que se debe supervisar especificado en las variables de entrada/salida y la variable correspondiente declarada en el lado del servidor no se puede detectar. Cuando se produce un error de coincidencia de tipo de datos, se realiza una conversión implícita.

NOTA: ByteString se representa como ARRAY OF BYTE unidimensional en el cliente. Si ByteString se declara en el servidor, utilice un búfer del tipo ARRAY OF BYTE y NodeDataType UATypeByte.

NOTA: El bloque de funciones no admite la función MaxAge especificada por el protocolo OPC UA.

Interfaz

Input	Tipo de datos	Descripción
Execute	BOOL	El bloque de funciones se ejecuta en un flanco ascendente. Consulte también Comportamiento de los bloques de funciones con la entrada Execute.
Timeout	TIME	Tiempo máximo para responder. Rango de valores: de 2 s a 60 s Si el valor se encuentra fuera del rango, se aplicará el límite superior o inferior. Valor predeterminado: GPL.Timeout
SubscriptionHdl	DWORD	Controlador de suscripción.
NodeHdlCount	UINT	Número de controladores de nodos en la matriz NodeHdls. Rango de valores: 1..GPL.MAX_ELEMENTS_NODELIST]
NodeHdls	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF DWORD	Matriz que contiene los controladores de nodos.
SyncMode	UAMonitoringSyncMode	Modalidad de sincronización.
NodeAddInfos	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF UANodeAdditionalInfo	Matriz que contiene información adicional sobre el nodo, como el rango de índices y atributos.

Entrada/salida	Tipo de datos	Descripción
Variables	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF UAMonitoredVariables	Matriz que contiene información acerca de las variables que se van a leer y las áreas de memoria correspondientes. NOTA: No procese las variables hasta que el bloque de funciones indique Done.
MonitoringParameters	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF UAMonitoringParameter	Matriz que contiene parámetros de supervisión para cada elemento válido de la matriz NodeHdls.
ValuesChanged	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF BOOL	Indica que los valores del elemento supervisado se han modificado.
MinLostValueCount	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF UINT	Indica el número de valores que faltan si el tamaño de cola es mayor que 1 en caso de que el tamaño de cola del lado del cliente sea menor que el tamaño de cola del lado del servidor.

Salida	Tipo de datos	Descripción
Done	BOOL	Indica que la ejecución del bloque de funciones se ha llevado a cabo correctamente.
Busy	BOOL	Indica que la ejecución del bloque de funciones está en curso.
Error	BOOL	Indica que se ha detectado un error durante la ejecución. NOTA: Aunque Error indique FALSE, compruebe los ErrorIDs correspondientes antes de procesar los índices de espacios de nombres.
ErrorID	ET_Result	Proporciona información de diagnóstico adicional en forma de valor numérico. Se incluye un resultado individual para cada URI de espacio de nombres especificado.
NodeErrorIDs	ARRAY [1..GPL. MAX_ELEMENTS_MONITORLIST] OF ET_Result	Contiene un valor de error para cada elemento de la matriz NodeHdls.
MonitoredItemHdls	ARRAY [1..GPL. MAX_ELEMENTS_NODELIST] OF DWORD	Contiene controladores de elementos supervisados para cada elemento válido de la matriz NodeHdls.