EventFilter Class
class QOpcUaMonitoringParameters::EventFilterDefines an EventFilter for a monitored item. More...
Public Functions
EventFilter(const QOpcUaMonitoringParameters::EventFilter &rhs) | |
QList<QOpcUaSimpleAttributeOperand> | selectClauses() const |
QList<QOpcUaSimpleAttributeOperand> & | selectClausesRef() |
void | setSelectClauses(const QList<QOpcUaSimpleAttributeOperand> &selectClauses) |
void | setWhereClause(const QList<QOpcUaContentFilterElement> &whereClause) |
QList<QOpcUaContentFilterElement> | whereClause() const |
QList<QOpcUaContentFilterElement> & | whereClauseRef() |
const QVariant | operator const QVariant() |
QOpcUaMonitoringParameters::EventFilter & | operator<<(const QOpcUaContentFilterElement &whereClauseElement) |
QOpcUaMonitoringParameters::EventFilter & | operator<<(const QOpcUaSimpleAttributeOperand &selectClauseElement) |
QOpcUaMonitoringParameters::EventFilter & | operator=(const QOpcUaMonitoringParameters::EventFilter &rhs) |
bool | operator==(const QOpcUaMonitoringParameters::EventFilter &rhs) const |
Detailed Description
An event filter is required for monitoring events on the server. It consists of select
clauses and a where
clause.
The select
clauses are used to specify the data the user wants to receive when an event occurs. It consists of QOpcUaSimpleAttributeOperand simple attribute operands which select attributes of child nodes of an event type, for example the value attribute of the "Message" property of BaseEventType.
The where
clause is used to restrict the reported events by matching against certain criteria. Several operators and four different operand types allow filtering based on the values of the attributes of the child nodes of an event type.
Filters can be constructed using the setter or the streaming operator. Streaming a QOpcUaSimpleAttributeOperand into an event filter adds a new select
clause to the filter, a QOpcUaContentFilterElement is appended to the where
clause. A content filter element can be constructed by streaming operands of the types QOpcUaLiteralOperand, QOpcUaElementOperand, QOpcUaAttributeOperand and QOpcUaSimpleAttributeOperand and an operator into a content filter element. Only the last operator is used, previous operators will be discarded.
The following EventFilter tells the server to report the value of the "Message" field for events that have a "Severity" field with value >= 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
For a more complex example with two conditions, see QOpcUaElementOperand.
Member Function Documentation
EventFilter::EventFilter(const QOpcUaMonitoringParameters::EventFilter &rhs)
Constructs an event filter from rhs.
QList<QOpcUaSimpleAttributeOperand> EventFilter::selectClauses() const
Returns the selected event fields that shall be included when a new event is reported.
See also setSelectClauses().
QList<QOpcUaSimpleAttributeOperand> &EventFilter::selectClausesRef()
Returns a reference to the select clauses.
void EventFilter::setSelectClauses(const QList<QOpcUaSimpleAttributeOperand> &selectClauses)
Sets the select clauses to selectClauses.
See also selectClauses().
void EventFilter::setWhereClause(const QList<QOpcUaContentFilterElement> &whereClause)
Sets the where clause to whereClause.
See also whereClause().
QList<QOpcUaContentFilterElement> EventFilter::whereClause() const
Returns the content filter used to restrict the reported events to events matching certain criteria.
See also setWhereClause().
QList<QOpcUaContentFilterElement> &EventFilter::whereClauseRef()
Returns a reference to the where clause.
See also whereClause().
const QVariant EventFilter::operator const QVariant()
Converts this event filter to QVariant.
QOpcUaMonitoringParameters::EventFilter &EventFilter::operator<<(const QOpcUaContentFilterElement &whereClauseElement)
Adds the content filter element whereClauseElement to the where clause of this event filter.
QOpcUaMonitoringParameters::EventFilter &EventFilter::operator<<(const QOpcUaSimpleAttributeOperand &selectClauseElement)
Adds the simple attribute operand selectClauseElement to the select clause of this content filter element.
QOpcUaMonitoringParameters::EventFilter &EventFilter::operator=(const QOpcUaMonitoringParameters::EventFilter &rhs)
Sets the values from rhs in this event filter.
bool EventFilter::operator==(const QOpcUaMonitoringParameters::EventFilter &rhs) const
Returns true
if this event filter has the same value as rhs.
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.