QOpcUaGdsClient Class

QOpcUaGdsClient c;

// Falls Anmeldedaten benötigt werden
QObject::connect(&c, &QOpcUaGdsClient::authenticationRequired, [&](QOpcUaAuthenticationInformation&authInfo) {
        authInfo.setUsernameAuthentication("root", "secret");
 });

// Auf Erfolg warten
QObject::connect(&c, &QOpcUaGdsClient::applicationRegistered, [&]() {
    qDebug() << "Application" << c.applicationId() << "registered";
});

c.setBackend(...);
c.setEndpoint(...);
c.setApplicationIdentity(...);
c.setPkiConfiguration(...);
c.setApplicationRecord(...);
c.setCertificateSigningRequestPresets(...);
c.start();

Dokumentation der Mitgliedsfunktionen

QOpcUaGdsClient::QOpcUaGdsClient(QObject *parent = nullptr)

Erstellt einen GDS-Client mit „ parent “ als übergeordnetem Objekt.

[virtual noexcept] QOpcUaGdsClient::~QOpcUaGdsClient()

Löst einen GDS-Client auf.

QString QOpcUaGdsClient::applicationId() const

Gibt die vom Server zugewiesene Anwendungs-ID zurück.

Dies ist eine Abkürzung, um die Anwendungs-ID aus den Anwendungsdatensatzdaten abzurufen.

Siehe auch ` applicationRecord()`.

const QOpcUaApplicationIdentity &QOpcUaGdsClient::applicationIdentity() const

Gibt die aktuelle applicationIdentity zurück.

Siehe auch ` setApplicationIdentity()`.

const QOpcUaApplicationRecordDataType &QOpcUaGdsClient::applicationRecord() const

Gibt die vom Client verwendeten Anwendungsdatensatzdaten zurück.

Siehe auch „ setApplicationRecord()“.

[signal] void QOpcUaGdsClient::applicationRegistered()

Dieses Signal wird ausgegeben, wenn eine Anwendung erfolgreich registriert wurde.

[signal] void QOpcUaGdsClient::authenticationRequired(QOpcUaAuthenticationInformation &authInfo)

Dieses Signal wird ausgegeben, wenn der GDS-Client versucht, eine erstmalige Authentifizierung bei einem Server durchzuführen, für die Administratorrechte erforderlich sind.

authInfo Muss mit gültigen Authentifizierungsdaten gefüllt werden. Dieser Slot darf nicht über Thread-Grenzen hinweg verwendet werden.

const QString &QOpcUaGdsClient::backend() const

Gibt die aktuelle Backend-Einstellung zurück.

Wurde das Backend nach dem Start des Clients geändert, wird die geänderte Einstellung zurückgegeben, jedoch nicht die tatsächlich verwendete Instanz.

Siehe auch ` setBackend()`.

int QOpcUaGdsClient::certificateCheckInterval() const

Gibt das Intervall in Millisekunden für die Überprüfung der Gültigkeit des Client-Zertifikats zurück.

Siehe auch ` setCertificateCheckInterval()`.

[signal] void QOpcUaGdsClient::certificateGroupsReceived(QStringList certificateGroups)

Dieses Signal wird ausgelöst, wenn der GDS-Client eine neue Liste von „ certificateGroups “ für diese Anwendung empfängt.

[signal] void QOpcUaGdsClient::certificateUpdateRequired()

Dieses Signal wird ausgegeben, wenn der GDS-Client feststellt, dass eine Aktualisierung des derzeit verwendeten Zertifikats erforderlich ist.

Dies kann dadurch verursacht werden, dass der Server den Client auffordert, das Zertifikat zu aktualisieren, wenn das Ablaufdatum des Zertifikats erreicht ist oder wenn es sich um ein selbstsigniertes Zertifikat handelt.

Die Zertifikatsaktualisierung erfolgt automatisch. Dieses Signal dient lediglich zu Informationszwecken und weist darauf hin, dass eine Aktualisierung bevorsteht.

[signal] void QOpcUaGdsClient::certificateUpdated()

Dieses Signal wird ausgegeben, wenn der GDS-Client ein neues Zertifikat empfangen hat, das auf der Festplatte gespeichert war.

const QOpcUaX509DistinguishedName &QOpcUaGdsClient::distinguishedNameCertificateSigningRequestPreset() const

Gibt den voreingestellten Distinguished Name für Zertifikatssignierungsanfragen zurück.

const QString &QOpcUaGdsClient::dnsCertificateSigningRequestPreset() const

Gibt die DNS-Voreinstellung für Zertifikatssignierungsanfragen zurück.

const QOpcUaEndpointDescription &QOpcUaGdsClient::endpoint() const

Gibt die aktuelle Endpunktkonfiguration zurück.

Wurde der Endpunkt nach dem Start des Clients geändert, wird die geänderte Einstellung zurückgegeben, nicht jedoch der tatsächlich verwendete Endpunkt.

Siehe auch ` setEndpoint()`.

QOpcUaGdsClient::Error QOpcUaGdsClient::error() const

Gibt den aktuellen Fehlerstatus zurück.

[signal] void QOpcUaGdsClient::errorChanged(QOpcUaGdsClient::Error error)

Dieses Signal wird ausgegeben, wenn ein „ error “ aufgetreten ist.

const QOpcUaPkiConfiguration &QOpcUaGdsClient::pkiConfiguration() const

Gibt die aktuelle pkiConfiguration zurück.

Siehe auch „ setPkiConfiguration()“.

void QOpcUaGdsClient::setApplicationIdentity(const QOpcUaApplicationIdentity &appIdentity)

Legt die vom Client zu verwendende Anwendungsidentität „ appIdentity “ fest.

Diese Identität wird zur Registrierung beim GDS-Server verwendet. Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden. Eine nachträgliche Änderung dieser Einstellung hat keine Auswirkungen.

Siehe auch applicationIdentity().

void QOpcUaGdsClient::setApplicationRecord(const QOpcUaApplicationRecordDataType &appRecord)

Legt die vom Client zu verwendenden Anwendungsdatensätze „ appRecord “ fest.

Diese Daten werden für die Registrierung beim GDS-Server verwendet. Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden.

Die meisten Daten entsprechen denen der Anwendungsidentität. Nach der Registrierung kann die zugewiesene Anwendungs-ID abgerufen werden.

Siehe auch applicationRecord() und setApplicationIdentity.

void QOpcUaGdsClient::setBackend(const QString &backend)

Legt das Backend fest, das der Client für die Kommunikation mit dem Server unter backend verwenden soll.

Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden. Eine nachträgliche Änderung dieser Einstellung hat keine Auswirkungen.

Siehe auch backend(), QOpcUaProvider::availableBackends() und start().

void QOpcUaGdsClient::setCertificateCheckInterval(int interval)

Legt das Intervall in Millisekunden fest, in dem die Gültigkeit des Client-Zertifikats gegenüber interval überprüft wird.

Siehe auch certificateCheckInterval().

void QOpcUaGdsClient::setCertificateSigningRequestPresets(const QOpcUaX509DistinguishedName &dn, const QString &dns)

Legt die Voreinstellungen für Zertifikatssignierungsanfragen fest: den Distinguished Name „ dn “ und die DNS-Zeichenkette „ dns “.

Beim Erstellen einer Zertifikatssignierungsanforderung werden einige zusätzliche Informationen benötigt, die von der Anwendungsidentität nicht bereitgestellt werden.

Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden.

Siehe auch setApplicationIdentity().

void QOpcUaGdsClient::setEndpoint(const QOpcUaEndpointDescription &endpoint)

Legt den Endpunkt fest, über den der Client mit dem Server kommunizieren soll: endpoint.

Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden. Eine nachträgliche Änderung dieser Einstellung hat keine Auswirkungen.

Die Kommunikation mit einem GDS-Server ist nur über einen verschlüsselten Endpunkt möglich. Die Verwendung eines unverschlüsselten Endpunkts schlägt fehl.

Siehe auch endpoint().

void QOpcUaGdsClient::setPkiConfiguration(const QOpcUaPkiConfiguration &pkiConfig)

Legt das vom Client zu verwendende PKI-Konfigurations pkiConfig fest.

Alle Zertifikate, Schlüssel und Vertrauenslisten werden von den angegebenen Speicherorten verwendet bzw. dort gespeichert. Um das vom GDS erhaltene Zertifikat zu verwenden, muss dieselbe Konfiguration unter „ QOpcUaClient “ verwendet werden.

Diese Funktion muss vor dem Start des GDS-Clients aufgerufen werden. Eine nachträgliche Änderung dieser Einstellung hat keine Auswirkungen.

Siehe auch ` pkiConfiguration()`.

void QOpcUaGdsClient::setTrustListUpdateInterval(int interval)

Legt das Intervall in Millisekunden für die Aktualisierung der Vertrauensliste vom Server auf interval fest.

Siehe auch trustListUpdateInterval().

void QOpcUaGdsClient::start()

Startet den Client-Prozess.

Nachdem alle Informationen eingerichtet wurden, kann der Client gestartet werden.

• setBackend
• setEndpoint
• setApplicationIdentity
• setPkiConfiguration
• setApplicationRecord
• setCertificateSigningRequestPresets

QOpcUaGdsClient::State QOpcUaGdsClient::state() const

Gibt den aktuellen Client-Status zurück.

[signal] void QOpcUaGdsClient::stateChanged(QOpcUaGdsClient::State state)

Dieses Signal wird ausgegeben, wenn sich der interne Zustand des Clients ändert. Die „ state “ gibt den neuen Zustand an.

int QOpcUaGdsClient::trustListUpdateInterval() const

Gibt das Intervall in Millisekunden für die Aktualisierung der Vertrauensliste durch den Server zurück.

Siehe auch ` setTrustListUpdateInterval()`.

[signal] void QOpcUaGdsClient::trustListUpdated()

Dieses Signal wird ausgegeben, wenn der GDS-Client eine neue Vertrauensliste vom Server empfangen und auf der Festplatte gespeichert hat.

void QOpcUaGdsClient::unregisterApplication()

Hebt die Registrierung einer Anwendung auf dem Server auf.

Diese Funktion kann verwendet werden, wenn eine Anwendung dauerhaft aus dem Netzwerk entfernt werden muss. Sie muss beim Neustart oder Herunterfahren nicht aufgerufen werden.

[signal] void QOpcUaGdsClient::unregistered()

Dieses Signal wird ausgesendet, wenn der GDS-Client die Anwendung abgemeldet hat.