Seitenhistorie

Im Folgenden wird die Funktion des OPC UA Clients in der GridVis-Web erklärt.
In der GridVis-Desktop ist die Handhabung analog. Dort öffnen Sie den OPC UA Client über das entsprechende Symbol in der Symbolleiste.

Anker
neu neu

Neue Verbindung anlegen

1. Öffnen Sie den OPC UA Client über den Menüpunkt Verwaltung.
2. Klicken Sie auf die Schaltfläche Neue Verbindung anlegen.
3. Geben Sie einen Namen und eine Beschreibung der Verbindung ein.

4. Weisen Sie die Verbindung einem Projekt zu, falls Sie mehrere Projekte eingebunden haben. Beachten Sie, dass diese Zuweisung nachträglich nicht geändert werden kann.

5. Aktivieren Sie das Kontrollkästchen, um die Verbindung zum OPC UA Server zuzulassen.
6. Geben Sie die Adresse und den Port des OPC UA Servers ein.
7. Geben Sie an, wie Sie Ihre Verbindung signieren und verschlüsseln möchten.
8. Geben Sie Ihre Anmeldedaten ein oder aktivieren Sie das Kontrollkästchen Anonym Verbinden. Beachten Sie, dass nicht alle Server die anonyme Kommunikation unterstützen.
9. Prüfen Sie die Verbindung zum Server, indem Sie auf die Schaltfläche Verbindung testen klicken. Überprüfen Sie gegebenenfalls die Serveradresse oder Ihre Zugangsdaten.
10. Klicken Sie auf die Schaltfläche Speichern & Verbinden, um die Verbindung zum OPC UA Server herzustellen.

Mit Tags arbeiten

Tags in einer Verbindung abonnieren & definieren

1. Klicken Sie auf eine angelegte Verbindung.
2. Aktivieren Sie das Kontrollkästchen eines Tags im Tag Browser, um dieses Tag zu abonnieren. Das Tag wird automatisch der aktuell ausgewählten Gruppe zugeordnet. Sofern noch keine Gruppe vorhanden ist, wird automatisch eine neue Gruppe erstellt.
3. Klicken Sie auf das abonnierte Tag und weisen Sie diesem eine Variable zu. Sie haben die Möglichkeit, eine bereits vorhandene GridVis-Systemvariable zu verwenden oder eine benutzerdefinierte Variable anzulegen.
   1. Um dem Tag eine GridVis-Systemvariable zuzuweisen, gehen Sie wie folgt vor:
      
      1. Klicken Sie auf den Radiobutton GridVis-Systemvariable verwenden.
      2. Klicken Sie auf die Dropdown-Fläche GridVis-Systemvariable und geben Sie den Namen des Messwerts ein, um eine Liste der möglichen Systemvariablen zu erhalten. Wählen Sie die gewünschte Systemvariable aus. 
   2. Um dem Tag eine benutzerdefinierte Variable zuzuweisen, gehen Sie wie folgt vor:
      1. Klicken Sie auf den Radiobutton Benutzerdefinierte Variable verwenden.
      2. Geben Sie im Eingabefeld Name einen Namen für die Variable ein. Geben Sie im Eingabefeld Einheit die Einheit für die Variable ein und wählen Sie eine Definition in der Dropdown-Liste Definition aus.
4. Um historische Daten zu erhalten, müssen Sie den Messwert aufzeichnen. Aktivieren Sie das Kontrollkästchen Tag aufzeichnen und wählen Sie aus dem Dropdown-Menü die Zeitbasis der Aufzeichnung aus.

Neue Gruppe erstellen

1. Klicken Sie auf die Schaltfläche Gruppe erstellen.
2. Passen Sie im Eingabefeld Name den Namen der Gruppe an.
3. Um historische Daten zu erhalten, müssen Sie die Messwerte aufzeichnen. Aktivieren Sie das Auswahlkästchen Gruppe aufzeichnen, um alle Messwerte der Gruppe aufzuzeichnen. Mit dem Dropdown-Menü Zeitbasis der Aufzeichnung konfigurieren Sie die Aufzeichnung aller Messwerte der Gruppe.

Verbindung exportieren und importieren

Über den OPC UA Client können Sie eine OPC UA Verbindung als CSV-Datei exportieren und importieren. Sie können diese CSV-Datei auch manuell zusammenstellen.

Aufbau der CSV-Datei
Das Standardtrennzeichen ist das Komma. Weitere Trennzeichen können beim Ex- und Import konfiguriert werden.

• groupName
  Name eine Taggruppe.
• subGroupName [optional]
  Name einer Subgruppe innerhalb einer Taggruppe. Subgruppen können keine weiteren Subgruppen enthalten.
• displayName
  Anzeigename eines Datenpunkts am OPC UA Server. Der Anzeigename muss mit der Bezeichnung des Datenpunkts identisch sein, die im OPC UA Server verwendet wird.
• nodeId
  Node ID eines Datenpunkts am OPC UA Server.
• browsePath
  Browserpfad zu einem Datenpunkt am OPC UA Server.
• record
  Flag zur Aufzeichnung eines Tags.
  Mögliche Werte sind
  • TRUE
  • FALSE
• scaleFactor
  Skalierungsfaktor eines Messwerts.
  Mögliche Werte sind
  • MICRO: Mikro (µ)
  • MILLI: Milli (m)
  • NO: Keine Skalierung
  • KILO: Kilo (k)
  • MEGA: Mega (M)
  • GIGA: Giga (G)
  • TERA: Tera (T)
• tagDefinition
  Gibt an, ob die GridVis den Datenpunkt als GridVis-Systemvariable oder benutzerdefinierte Variable behandelt.
  Mögliche Werte sind
  • SystemVariable
  • UserDefined

• systemValue [optional]
  Definition der GridVis-Systemvariable. Darf keinen Wert enthalten, wenn für tagDefinition der Wert UserDefined gesetzt ist.

  Codeblock
  theme Eclipse title Wertebeispiel collapse true
  {"ns":"ValueWrap","obj":{"ns":"BasicValue","name":"U_Effective"},"tags":[{"ns":"TypeWrap","obj":{"ns":"BasicType","name":"L1"},"tags":[]}]}

• timebase
  Zeitbasis der Aufzeichnung in Sekunden. Muss einen Wert als Platzhalter enthalten, auch wenn der Tag nicht aufgezeichnet wird.
  Mögliche Werte sind

  • 60 (1 Minute)
  • 300 (5 Minuten)
  • 600 (10 Minuten)
  • 900 (15 Minuten)
  • 1800 (30 Minuten)
  • 3600 (1 Stunde)
• userValueDefinition
  Definition der benutzerdefinierten Variable.
  Mögliche Werte sind
  • ConsumedEnergy: Energiewert Verbrauch
  • DeliveredEnergy: Energiewert Einspeisung
  • ConsumedDeliveredEnergy: Energiewert Verbrauch + Einspeisung
  • Interval: Energiewert Intervall
  • Measurement: Messwert
  • SalesVolume: Umsatz
  • Items: Stückzahl
  • Square: Fläche
  • Employee: Mitarbeiter
  • Maximum: Maximum
  • Average: AVG
  • Sum: Summe
• userValueName
  Name der benutzerdefinierten Variable.
• userValueUnit [optional]
  Einheit der benutzerdefinierten Variable.

Signieren und verschlüsseln

Die Nutzung von signierten und verschlüsselten Verbindungen im OPC UA Protokoll bietet Ihnen Vorteile für den Schutz sensibler Informationen und die sichere Kommunikation. Signaturen gewährleisten die Authentizität und Integrität der Daten. Verschlüsselungen stellen die Vertraulichkeit sicher und gewähren nur autorisierten Parteien Zugriff. Wie Sie die Verschlüsselung bereits während der Konfiguration des OPC UA Servers anlegen erfahren Sie im Abschnitt Neue Verbindung anlegen. 

1. Klicken Sie auf die Schaltfläche Signieren und Verschlüsseln.
2. Klicken Sie auf den Link Zertifikatsdatei auswählen und laden Sie das X.509-Zertifikat hoch.
3. Klicken Sie auf den Link Private Schlüsseldatei auswählen und laden Sie die Schlüsseldatei hoch.
4. Geben Sie das Passwort für den privaten Schlüssel ein.
5. Klicken Sie abschließend auf die Schaltfläche Importieren.

The function of the OPC UA Client in the GridVis Web is explained below.
The handling is analogous in the GridVis Desktop. There, you can open the OPC UA Client via the corresponding icon in the toolbar.

Anker
neu neu

Creating a new connection

1. Open the OPC UA Client via the Administration menu item.
2. Click the Create new connection button. 
3. Enter a name and description of the connection.
4. Assign the connection to a project if you have integrated several projects. Note that this assignment cannot be changed later.
5. Activate the checkbox to allow the connection to the OPC UA Server.
6. Enter the address and the port of the OPC UA Server. 
7. Specify how you want to sign and encrypt your connection.
8. Enter your login data or activate the checkbox Connect anonymously. Note that not all servers support anonymous communication.
9. Check the connection to the server by clicking the button Test connection. If necessary, check the server address or your login data.
10. Click the button Save and connect to establish the connection to the OPC UA Server.

Working with tags

Subscribe to tags in a connection & define them

1. Click on a created connection.
2. Select the checkbox of a tag in the Tag Browser to subscribe to that tag. The tag is automatically assigned to the currently selected group. If no group exists yet, a new group will be created automatically.
3. Click on the subscribed tag and assign a variable to it. You have the option of using an existing GridVis system variable or creating a user-defined variable.
   1. Proceed as follows to assign the tag a GridVis system variable:
      1. Click on the radio button Use GridVis system variable.
      2. Click on the drop-down area GridVis System Variable and enter the name of the measured value to obtain a list of possible system variables. Select the desired system variable.
   2. Proceed as follows to assign the tag a user-defined system variable:
      1. Click on the radio button Use user-defined system variable.
      2. Enter a name for the variable in the Name input field. In the Unit input field, enter the unit for the variable and select a definition from the Definition drop-down list.
4. To obtain historical data, you must record the measured value. Activate the checkbox Record Tag and select the Time base for recording from the drop-down menu.

Create a new group

1. Click on the Create Group button.
2. Use the Name input field to edit the name of the group.
3. To obtain historical data, you must record the measured value. Activate the checkbox Record Group to record all measured values of the group. Use the Time base for recording drop-down menu to configure the recording of all measured values of the group.

Exporting and importing a connection

The OPC UA Client can be used to export and import an OPC UA connection as a CSV file. You can also compile this CSV file manually.

Structure of the CSV file
The default separator is the comma. Other separators can be configured during export and import.

• groupName
  Name of a tag group.
• subGroupName [optional]
  Name of a subgroup within a tag group. Subgroups cannot contain other subgroups.
• displayName
  Display name of a data point on the OPC UA Server. The display name must be identical to the name of the data point used in the OPC UA Server.
• nodeId
  Node ID of a data point on the OPC UA Server.
• browsePath
  Browser path to a data point on the OPC UA Server.
• record
  Flag to record a tag.
  Possible values are
  • TRUE
  • FALSE
• scaleFactor
  Scaling factor of a measured value.
  Possible values are
  • MICRO: Micro (µ)
  • MILLI: Milli (m)
  • NO: No scaling
  • KILO: Kilo (k)
  • MEGA: Mega (M)
  • GIGA: Giga (G)
  • TERA: Tera (T)
• tagDefinition
  Specifies whether GridVis treats the data point as a GridVis system variable or user-defined variable.
  Possible values are
  • SystemVariable
  • UserDefined

• systemValue [optional]
  Definition of the GridVis system variable. Must not contain a value if tagDefinition is set to UserDefined.

  Codeblock
  theme Eclipse title Value example collapse true
  {"ns":"ValueWrap","obj":{"ns":"BasicValue","name":"U_Effective"},"tags":[{"ns":"TypeWrap","obj":{"ns":"BasicType","name":"L1"},"tags":[]}]}

• timebase
  Time base of the recording in seconds. Must contain a value as a placeholder even if the tag is not recorded.
  Possible values are
  • 60 (1 minute)
  • 300 (5 minutes)
  • 600 (10 minutes)
  • 900 (15 minutes)
  • 1800 (30 minutes)
  • 3600 (1 hour)
• userValueDefinition
  Definition of the user-defined variable.
  Possible values are
  • ConsumedEnergy: Consumption energy value
  • DeliveredEnergy: Feed-in energy value
  • ConsumedDeliveredEnergy: Energy value of consumption + feed-in
  • Interval: Energy value interval
  • Measurement: Measured value
  • SalesVolume: Sales
  • Items: Quantity
  • Square: Area
  • Employee: Employees
  • Maximum: Maximum
  • Average: AVG
  • Sum: Total
• userValueName
  Name of the user-defined variable.
• userValueUnit [optional]
  Unit of the user-defined variable.

Signing and encrypting

The use of signed and encrypted connections in the OPC UA protocol offers you advantages for the protection of sensitive information and secure communication. Signatures ensure the authenticity and integrity of the data. Encryption ensures confidentiality and only grants access to authorized parties. You can find out how to create the encryption during the configuration of the OPC UA Server in the section Creating a new connection. 

1. Click on the button Signing and Encrypting.
2. Click on the link Select Certificate File and upload the X.509 certificate.
3. Click on the link Select Private Key File and upload the key file.
4. Enter the password for the private key.
5. Finally, click the Import button.

A continuación se explica la función del cliente OPC UA en GridVis-Web.
El uso en GridVis-Desktop es análogo. Allí usted abre el cliente OPC UA a través del símbolo correspondiente de la barra de herramientas.

Anker
neu neu

Crear una nueva conexión

1. Abra el cliente OPC UA a través de la opción de menú Administración. 
2. Haga clic en el botón Crear una nueva conexión.
3. Introduzca un nombre y una descripción de la conexión.
4. Asigne la conexión a un proyecto si ha integrado varios proyetos. Tenga en cuenta que esta asignación no puede cambiarse posteriormente.
5. Active la casilla de verificación para permitir la conexión con el servidor OPC UA.
6. Introduzca la dirección y el puerto del servidor OPC UA. 
7. Introduzca sus datos de inicio de sesión o active la casilla de verificación Conectar anónimamente. Tenga en cuenta que no todos los servidores admiten la comunicación anónima.
8. Pruebe la conexión con el servidor haciendo clic en el botón Probar conexión. Dado el caso, compruebe la dirección del servidor o sus datos de acceso.
9. Haga clic en el botón Guardar y conectar para establecer la conexión con el servidor OPC UA.

Trabajar con tags

Suscribirse a tags en una conexión y definirlos

1. Haga clic en una conexión creada.
2. Active la casilla de verificación de un tag en el Navegador de tags para suscribirse a este tag. El tag es asignado automáticamente al grupo actualmente seleccionado. Si aún no existe ningún grupo, automáticamente se crea un grupo nuevo.
3. Haga clic al tag al que se ha suscrito y asigne una variable al mismo. Usted tiene la posibilidad de utilizar una variable de sistema GridVis ya existente o de crear una variable definida por el usuario.
   1. Para asignar una variable de sistema GridVis al tag, proceda de la siguiente manera:
      1. Haga clic en el botón de opción Utilizar variable de sistema GridVis.
      2. Haga clic en el botón desplegable Variable de sistema GridVis e introduzca el nombre del valor de medición para obtener una lista de las posibles variables de sistema. Seleccione la variable de sistema deseada.
   2. Para asignar una variable de sistema definida por el usuario al tag, proceda de la siguiente manera:
      1. Haga clic en el botón de opción Utilizar variable de sistema definida por el usuario.
      2. Introduzca en el campo de entrada Nombre un nombre para la variable. Introduzca en el campo de entrada Unidad la unidad para la variable y seleccione una definición en la lista desplegable Definición.
4. Para obtener los datos históricos, usted deberá registrar el valor de medición. Active la casilla de verificación Registrar tag y seleccione en el menú desplegable la base de tiempo del registro.

Crear un nuevo grupo

1. Haga clic en el botón Crear grupo.
2. Adapte el nombre del grupo en el campo de entrada Nombre.
3. Para obtener los datos históricos, usted deberá registrar los valores de medición. Active la casilla de verificación Registrar grupo para registrar todos los valores de medición del grupo. Con el menú desplegable Base de tiempo del registro podrá configurar el registro de todos los valores de medición del grupo.

Exportar e importar una conexión

A través del cliente OPC UA, usted puede exportar e importar una conexión OPC UA como archivo CSV. Usted también puede preparar este archivo CSV manualmente.

Estructura del archivo CSV
El separador predeterminado es la coma. Otros separadores pueden configurarse durante la exportación e importación.

• groupName
  Nombre de un grupo de tags.
• subGroupName [opcional]
  Nombre de un subgrupo dentro de un grupo de tags. Los subgrupos no pueden contener subgrupos adicionales.
• displayName
  Nombre de visualización de un punto de datos en el servidor OPC UA. El nombre de visualización debe ser idéntico a la denominación del punto de datos utilizada en el servidor OPC UA.
• nodeId
  ID de nodo de un punto de datos en el servidor OPC UA.
• browsePath
  Ruta de navegación a un punto de datos en el servidor OPC UA.
• record
  Flag para el registro de un tag.
  Posibles valores:
  • TRUE
  • FALSE
• scaleFactor
  Factor de escala de un valor de medición.
  Posibles valores:
  • MICRO: micro (µ)
  • MILI: mili (m)
  • NO: ninguna escala
  • KILO: kilo (k)
  • MEGA: mega (M)
  • GIGA: giga (G)
  • TERA: tera (T)
• tagDefinition
  Indica si GridVis trata el punto de datos como variable de sistema de GridVis o como variable definida por el usuario.
  Posibles valores:
  • SystemVariable
  • UserDefined

• systemValue [opcional]
  Definición de la variable de sistema de GridVis. No debe contener ningún valor si para tagDefinition está ajustado el valor UserDefined.

  Codeblock
  theme Eclipse title Ejemplo de valores collapse true
  {"ns":"ValueWrap","obj":{"ns":"BasicValue","name":"U_Effective"},"tags":[{"ns":"TypeWrap","obj":{"ns":"BasicType","name":"L1"},"tags":[]}]}

• timebase
  Base de tiempo del registro en segundos. Debe contener un valor como comodín, aunque no se registre el tag.
  Posibles valores:
  • 60 (1 minuto)
  • 300 (5 minutos)
  • 600 (10 minutos)
  • 900 (15 minutos)
  • 1800 (30 minutos)
  • 3600 (1 hora)
• userValueDefinition
  Definición de la variable definida por el usuario.
  Posibles valores:
  • ConsumedEnergy: valor de energía consumo
  • DeliveredEnergy: valor de energía alimentación
  • ConsumedDeliveredEnergy: valor de energía consumo + alimentación
  • Interval: valor de energía intervalo
  • Measurement: valor de medición
  • SalesVolume: volumen de ventas
  • Items: número de unidades
  • Square: superficie
  • Employee: empleados
  • Maximum: máximo
  • Average: promedio
  • Sum: suma
• userValueName
  Nombre de la variable definida por el usuario.
• userValueUnit [opcional]
  Unidad de la variable definida por el usuario.

Firmar y cifrar

La utilización de unas conexiones firmadas y cifradas en el protocolo OPC UA le ofrece ventajas para la protección de información sensible y para la comunicación segura. Las firmas garantizan la autenticidad y la integridad de los datos. Los cifrados aseguran la confidencialidad y conceden el acceso únicamente a partes autorizadas. Para saber cómo crear el cifrado durante la configuración del servidor OPC UA, consulte el apartado Crear una nueva conexión. 

1. Haga clic en el botón Firmar y cifrar.
2. Haga clic en el enlace Seleccionar archivo de certificado y cargue el certificado X.509.
3. Haga clic en el enlace Seleccionar archivo de clave privado y cargue el archivo de clave.
4. Introduzca la contraseña para la clave privada.
5. Para finalizar, haga clic en el botón Importar.