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.

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 Ihre Anmeldedaten ein oder aktivieren Sie das Kontrollkästchen Anonym Verbinden. Beachten Sie, dass nicht alle Server die anonyme Kommunikation unterstützen.
8. 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.
9. Klicken Sie auf die Schaltfläche Speichern & Verbinden, um die Verbindung zum OPC UA Server herzustellen.

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.

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.

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. Enter your login data or activate the checkbox Connect anonymously. Note that not all servers support anonymous communication.
8. Check the connection to the server by clicking the button Test connection. If necessary, check the server address or your login data.
9. Click the button Save and connect to establish the connection to the OPC UA Server.

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.

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.

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.

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.

Di seguito viene spiegato il funzionamento del client OPC UA nel GridVis®-Web.
In GridVis®-Desktop, la gestione è analoga. Si apre il client OPC UA tramite l’icona corrispondente nella barra degli strumenti.

Creare una nuova connessione

1. Aprire il client OPC UA tramite la voce di menu Amministrazione.
2. Fare clic sul pulsante Creare una nuova connessione.
3. Assegnare un nome e una descrizione alla connessione.
4. Assegnare la connessione ad un progetto. Si noti che l’assegnazione non può essere modificata in un momento successivo.
5. Attivare la casella di controllo per consentire la connessione al server OPC UA.
6. Inserire l'indirizzo e la porta del server OPC UA.
7. Inserire i dati di accesso o attivare la casella di controllo Connettiti in modo anonimo. Si noti che non tutti i server supportano la comunicazione anonima.
8. Verificare la connessione al server facendo clic sul pulsante Prova connessione. Se necessario, controllare l'indirizzo del server o i dati di accesso.
9. Fare clic sul pulsante Salva e connetti per stabilire la connessione al server OPC UA.

Aggiungere i tag ai preferiti di una connessione & impostarli

1. Fare clic su una connessione creata.
2. Attivare la casella di controllo di un tag in Tag Browser per aggiungere questo tag ai preferiti. Il tag viene automaticamente assegnato al gruppo attualmente selezionato. Se non è presente ancora nessun gruppo, viene automaticamente creato un nuovo gruppo.
3. Fare clic sul tag aggiunto ai preferiti e assegnargli una variabile. È possibile utilizzare una variabile di sistema di GridVis® predefinita o crearne una personalizzata.
   1. Per assegnare una variabile di sistema GridVis® al tag, procedere come segue:
      1. Fare clic sul pulsante di opzione Utilizzare variabile di sistema GridVis®.
      2. Fare clic sull’area a discesa Variabile di sistema GridVis® ed immettere il nome della lettura per visualizzare un elenco di possibili variabili di sistema. Selezionare la variabile di sistema desiderata. 
   2. Per assegnare una variabile personalizzata al tag, procedere come segue:
      1. Fare clic sul pulsante di opzione Utilizzare una variabile personalizzata.
      2. Inserire un nome per la variabile nel campo di immissione Nome. Inserire l'unità di misura della variabile nel campo Unità e selezionare una definizione dall'elenco a discesa Definizione.
4. Per visualizzare i dati cronologici, è necessario registrare la lettura. Attivare la casella di controllo Registrazione tag e selezionare la Base temporale della registrazione dal menu a discesa.

Creare un nuovo gruppo

1. Fare clic sul pulsante Crea gruppo.
2. Nel campo di immissione Nome modificare il nome del gruppo.
3. Per visualizzare i dati cronologici, è necessario registrare le letture. Attivare la casella di controllo Registra gruppo per registrare tutte le letture del gruppo. Con il menu a discesa Base temporale della registrazione configurare la registrazione di tutte le letture del gruppo.

Connessione per l'esportazione e l'importazione

È possibile esportare e importare una connessione OPC UA come file CSV tramite il client OPC UA. È possibile compilare questo file CSV anche manualmente.

Struttura del file CSV
Il separatore predefinito è la virgola. È possibile configurare ulteriori separatori durante l'esportazione e l'importazione.

• groupName
  Nome di un gruppo di tag.
• subGroupName [opzionale]
  Nome di un sottogruppo all'interno di un gruppo di tag. I sottogruppi non possono contenere altri sottogruppi.
• displayName
  Nome visualizzato di un punto di dati sul server OPC UA. Il nome visualizzato deve essere identico al nome del punto di dati utilizzato nel server OPC UA.
• nodeId
  ID del nodo di un punto di dati sul server OPC UA.
• browsePath
  Percorso del browser verso un punto di dati sul server OPC UA.
• record
  Flag per registrare un tag.
  I valori possibili sono
  • TRUE
  • FALSE
• scaleFactor
  Fattore di scala di una lettura.
  I valori possibili sono
  • MICRO: Micro (µ)
  • MILLI: Milli (m)
  • NO: Nessun adattamento
  • KILO: Kilo (k)
  • MEGA: Mega (M)
  • GIGA: Giga (G)
  • TERA: Tera (T)
• tagDefinition
  Indica se GridVis® tratta il punto di dati come una variabile di sistema GridVis® o una variabile personalizzata.
  I valori possibili sono
  • Variabile di sistema
  • UserDefined

• systemValue [opzionale]
  Definizione della variabile di sistema di GridVis®. Non deve contenere nessun valore se tagDefinition è impostato su UserDefined.

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

• timebase
  Base temporale della registrazione in secondi. Deve contenere un valore come segnaposto anche se il tag non viene registrato.
  I valori possibili sono
  • 60 (1 minuto)
  • 300 (5 minuti)
  • 600 (10 minuti)
  • 900 (15 minuti)
  • 1800 (30 minuti)
  • 3600 (1 ora)
• userValueDefinition
  Definizione della variabile personalizzata.
  I valori possibili sono
  • ConsumedEnergy: Valore energetico Consumo
  • DeliveredEnergy: Valore energetico Immissione
  • ConsumedDeliveredEnergy: Valore energetico Consumo + Immissione
  • Interval: Intervallo del valore energetico
  • Measurement: Lettura
  • SalesVolume: Fatturato
  • Item: Numero di pezzi
  • Square: Area
  • Employee: Dipendente
  • Maximum: Massimo
  • Average: AVG
  • Sum: Somma
• userValueName
  Nome della variabile personalizzata.
• userValueUnit [opzionale]
  Unità della variabile personalizzata.