QOpcUaMonitoringParameters::EventFilter Class

Description détaillée

Un filtre d'événement est nécessaire pour surveiller les événements sur le serveur. Il se compose de clauses « select » et d'une clause « where ».

Les clauses « select » permettent de spécifier les données que l’utilisateur souhaite recevoir lorsqu’un événement se produit. Elles se composent d’opérandes d’attributs simples de type « QOpcUaSimpleAttributeOperand » qui sélectionnent les attributs des nœuds enfants d’un type d’événement, par exemple l’attribut « value » de la propriété « Message » de BaseEventType.

La clause « where » sert à restreindre les événements signalés en les faisant correspondre à certains critères. Plusieurs opérateurs et quatre types d’opérandes différents permettent d’effectuer un filtrage en fonction des valeurs des attributs des nœuds enfants d’un type d’événement.

Les filtres peuvent être construits à l’aide de l’opérateur setter ou de l’opérateur de streaming. L’injection d’un filtre d’événement ( QOpcUaSimpleAttributeOperand ) dans un filtre d’événement ajoute une nouvelle clause « select » au filtre ; un élément « QOpcUaContentFilterElement » est ajouté à la clause « where ». Un élément de filtre de contenu peut être construit en injectant des opérandes des types « QOpcUaLiteralOperand », « QOpcUaElementOperand », « QOpcUaAttributeOperand » et « QOpcUaSimpleAttributeOperand », ainsi qu’un opérateur, dans un élément de filtre de contenu. Seul le dernier opérateur est utilisé ; les opérateurs précédents sont ignorés.

L’EventFilter suivant indique au serveur de signaler la valeur du champ « Message » pour les événements dont le champ « Severity » a une valeur >= 500 :

QOpcUaMonitoringParameters::EventFilter filter;
filter << QOpcUaSimpleAttributeOperand("Message"); // Select clause of the filter

QOpcUaContentFilterElement condition;
condition << QOpcUaContentFilterElement::FilterOperator::GreaterThanOrEqual;
condition << QOpcUaSimpleAttributeOperand("Severity");
condition << QOpcUaLiteralOperand(500, QOpcUa::Types::UInt16);
filter << condition; // Where clause of the filter

Pour un exemple plus complexe comportant deux conditions, consultez QOpcUaElementOperand.