En esta página

Connection QML Type

Se conecta a un servidor. Más...

Import Statement: import QtOpcUa
Since: QtOpcUa 5.12
Status: Deprecated since 6.9

Este tipo está obsoleto desde QtOpcUa 6.9. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Señales

Métodos

Descripción detallada

La API principal utiliza backends para establecer conexiones. Debes configurar el backend antes de cualquier intento de conexión.

import QtOpcUa as QtOpcUa

QtOpcUa.Connection {
    backend: "open62541"
}

Component.onCompleted: {
    connection.connectToEndpoint("opc.tcp://127.0.0.1:43344");
}

Documentación de propiedades

authenticationInformation : AuthenticationInformation

Configura la información de autenticación para esta conexión. La información de autenticación debe configurarse antes de llamar a ` connectToEndpoint`. Si no se configura ninguna información de autenticación, se utilizará el modo anónimo. Esto no afecta a la conexión actual. Si el cliente se desconecta y luego se vuelve a conectar, se utilizarán las nuevas credenciales. Al leer y escribir esta propiedad antes de que se haya establecido un ` backend `, las escrituras se ignoran y las lecturas devuelven un ` AuthenticationInformation` no válido.

availableBackends : stringlist [read-only]

Devuelve los nombres de todos los backends disponibles en forma de lista. Estos se utilizan para seleccionar un backend al conectarse.

Véase también Connection::backend.

backend : string

Configura el backend que se va a utilizar para conectarse al servidor. Debe configurarse antes de cualquier intento de conexión.

Véase también Connection::availableBackends.

connected : bool [read-only]

Estado de la conexión. « true » cuando hay conexión; en caso contrario, « false ».

connection : QOpcUaClient

Esta propiedad se utiliza únicamente para establecer una conexión desde C++. En caso de que la configuración de la conexión sea compleja, puedes utilizar C++ para gestionar todos los detalles. Una vez establecida la conexión, esta se puede pasar a QML mediante esta propiedad. La gestión del cliente pasa a manos de QML.

class MyClass : public QObject {
    Q_OBJECT
    Q_PROPERTY(QOpcUaClient* connection READ connection NOTIFY connectionChanged)

public:
    MyClass (QObject* parent = nullptr);
    QOpcUaClient *connection() const;

signals:
    void connectionChanged(QOpcUaClient *);

Al emitir la señal « connectionChanged » cuando se haya completado la configuración del cliente, el código QML que se muestra a continuación utilizará la conexión.

import QtOpcUa as QtOpcUa

MyClass {
    id: myclass
}

QtOpcUa.Connection {
    connection: myclass.connection
 }

currentEndpoint : QOpcUaEndpointDescription

Descripción del punto final del servidor al que está conectada la conexión. Cuando la conexión no está establecida, se devuelve una descripción del punto final vacía.

defaultConnection : bool

Establece esta como la conexión predeterminada. Normalmente, hay que asignar una conexión a cada nodo para que la utilice. Si esta propiedad se establece en « true », se utilizará esta conexión en todos los casos en los que un nodo no tenga ninguna conexión configurada. Las conexiones ya establecidas no se ven afectadas. Si « defaultConnection » se establece en « true » en el caso de conexiones múltiples, se utilizará la última.

QtOpcUa.Connection {
    ...
    defaultConnection: true
    ...
}

Véase también Node.

namespaces : stringlist [read-only]

Lista de cadenas de todos los URI de espacio de nombres registrados en el servidor conectado.

supportedSecurityPolicies : stringlist

Una lista de cadenas que contienen las políticas de seguridad compatibles

Esta propiedad está disponible actualmente como vista previa tecnológica y, por lo tanto, la API y la funcionalidad proporcionadas pueden estar sujetas a cambios en cualquier momento sin previo aviso.

supportedUserTokenTypes : array[tokenTypes]

Una matriz que recoge los tipos de políticas de tokens de usuario de todos los tipos de tokens de usuario compatibles.

Esta propiedad está disponible actualmente como «Technology Preview» y, por lo tanto, la API y la funcionalidad proporcionadas pueden estar sujetas a cambios en cualquier momento sin previo aviso.

Documentación de Signal

nodeChanged()

Se emite cuando el nodo subyacente ha cambiado. Esto ocurre cuando cambia el espacio de nombres o el identificador de NodeId.

Nota: El controlador correspondiente es onNodeChanged.

readNodeAttributesFinished(readResults)

Se emite cuando finaliza la solicitud de lectura iniciada mediante ` readNodeAttributes()`. El parámetro ` readResults ` es un array de entradas ` ReadResult ` que contienen los valores solicitados al servidor.

connection.onReadNodeAttributesFinished(results) {
    for (var i = 0; results.length; i++) {
        if (results[i].status.isGood) {
            console.log(results[i].value);
        } else {
            // handle error
        }
    }
}

Nota: El controlador correspondiente es onReadNodeAttributesFinished.

Véase también readNodeAttributes() y ReadResult.

writeNodeAttributesFinished(writeResults)

Se emite cuando finaliza la solicitud de escritura iniciada mediante ` writeNodeAttributes()`. El parámetro ` writeResults ` es una matriz de entradas ` WriteResult `, que contiene los valores solicitados al servidor.

for (var i = 0; i < writeResults.length; i++) {
    console.log(writeResults[i].nodeId);
    console.log(writeResults[i].namespaceName);
    console.log(writeResults[i].attribute);

    if (writeResults[i].status.isBad) {
        // value was not written
    }
}

Nota: El controlador correspondiente es onWriteNodeAttributesFinished.

Véase también writeNodeAttributes() y WriteResult.

Documentación del método

void connectToEndpoint(endpointDescription)

Se conecta al punto final especificado con « endpointDescription ».

Véase también EndpointDescription.

void disconnectFromEndpoint()

Desconecta una conexión establecida.

bool readNodeAttributes(valuesToBeRead)

Esta función se utiliza para leer varios valores de un servidor de una sola vez. Devuelve ` true ` si la solicitud de lectura se ha enviado correctamente.

El parámetro ` valuesToBeRead ` debe ser una matriz de JavaScript con entradas de tipo ` ReadItem `.

// List of items to read
var readItemList = [];
// Item to be added to the list of items to be read
var readItem;

// Prepare an item to be read

// Create a new read item and fill properties
readItem = QtOpcUa.ReadItem.create();
readItem.ns = "http://qt-project.org";
readItem.nodeId = "s=Demo.Static.Scalar.Double";
readItem.attribute = QtOpcUa.Constants.NodeAttribute.DisplayName;

// Add the prepared item to the list of items to be read
readItemList.push(readItem);

// Add further items
[...]

if (!connection.readNodeAttributes(readItemList)) {
    // handle error
}

El resultado de la solicitud de lectura se obtiene mediante la señal readNodeAttributesFinished().

Véase también readNodeAttributesFinished() y ReadItem.

bool writeNodeAttributes(valuesToBeWritten)

Esta función se utiliza para escribir varios valores en un servidor de una sola vez. Devuelve ` true ` si la solicitud de escritura se ha enviado correctamente.

El parámetro ` valuesToBeWritten ` debe ser un array de JavaScript con entradas de tipo ` WriteItem `.

// List of items to write
var writeItemList = [];
// Item to be added to the list of items to be written
var writeItem;

// Prepare an item to be written

// Create a new write item and fill properties
writeItem = QtOpcUa.WriteItem.create();
writeItem.ns = "http://qt-project.org";
writeItem.nodeId = "s=Demo.Static.Scalar.Double";
writeItem.attribute = QtOpcUa.Constants.NodeAttribute.Value;
writeItem.value = 32.1;
writeItem.valueType = QtOpcUa.Constants.Double;

// Add the prepared item to the list of items to be written
writeItemList.push(writeItem);

// Add further items
[...]

if (!connection.writeNodeAttributes(writeItemList)) {
    // handle error
}

El resultado de la solicitud de escritura se obtiene mediante la señal ` Connection::writeNodeAttributesFinished()`.

Véase también Connection::writeNodeAttributesFinished() y WriteItem.

© 2026 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.