EventFilter QML Type

Définit un EventFilter pour un élément surveillé. Plus...

Ce type est obsolète depuis QtOpcUa 6.9. Il est fortement déconseillé de l'utiliser dans un nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• select : list<SimpleAttributeOperand>
• where : list<FilterElement>

Description détaillée

Un filtre d'événements 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 sont utilisées pour spécifier les données que l'utilisateur souhaite recevoir lorsqu'un événement se produit. Elles consistent en SimpleAttributeOperand opérandes d'attributs simples 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 est utilisée pour 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 de filtrer sur la base des valeurs des attributs des nœuds enfants d'un type d'événement.

La clause select consiste en un tableau de SimpleAttributeOperand. La clause where consiste en un tableau de SimpleAttributeOperand, LiteralOperand, ElementOperand ou AttributeOperand.

Le filtre EventFilter suivant indique au serveur de signaler la valeur du champ "Message" pour les événements dont le champ "Gravité" a une valeur >= 500 :

import QtOpcUa as QtOpcUa
QtOpcUa.Node {
    ...

    eventFilter: QtOpcUa.EventFilter {
        select: [
                  QtOpcUa.SimpleAttributeOperand {
                    browsePath: [
                                  QtOpcUa.NodeId {
                                      identifier: "Severity"
                                      ns: "http://opcfoundation.org/UA/"
                                  }
                                ]
                  },
                  QtOpcUa.SimpleAttributeOperand {
                    browsePath: [
                                  QtOpcUa.NodeId {
                                      identifier: "Message"
                                      ns: "http://opcfoundation.org/UA/"
                                  }
                                ]
                  }
        ]

        where: [
            QtOpcUa.FilterElement {
                operator: QtOpcUa.FilterElement.GreaterThanOrEqual
                firstOperand: QtOpcUa.SimpleAttributeOperand {
                    browsePath: [
                                  QtOpcUa.NodeId {
                                      identifier: "Severity"
                                      ns: "http://opcfoundation.org/UA/"
                                  }
                                ]
                }
                secondOperand: QtOpcUa.LiteralOperand {
                                value: 700
                                type: QtOpcUa.Constants.UInt16
                 }
            }
        ]
    }
}

Pour un exemple plus complexe avec deux conditions, voir QOpcUaElementOperand.

Voir également FilterElement.

Documentation sur les propriétés

select : list<SimpleAttributeOperand>

Champs d'événement sélectionnés qui doivent être inclus lorsqu'un nouvel événement est déclaré.

where : list<FilterElement>

Filtre de contenu utilisé pour restreindre les événements signalés aux événements correspondant à certains critères.