DE EN Anmelden

Erste Schritte

Schritt für Schritt zum Erfolg

Video ansehenchevron_right

Erste Schritte

Im folgenden Beispiel wird die Erstellung einer einfachen Bedien-App mit OPC-UA Kommunikation beschrieben. Die Beispiel-App besteht aus einer Ansicht mit einer Anzeige der aktuellen Temperatur und einem Eingabefeld für die Grenzwert-Eingabe.

  • Schritt 1:
      Bedien-App erstellen 

    Die Bedien-App wird mit dem Unified-E App Designer per Drag & Drop erstellt. Programmierkenntnisse für die App-Entwicklung sind dabei nicht erforderlich. Ihre App läuft automatisch auf Android, iOS und Windows Geräten.

    Neues Projekt anlegen

    1. Bitte laden Sie den Unified-E App Designer herunter und folgen Sie die Installationshinweise:
      Downloadfile_download
    2. Starten Sie den Unified-E App Designer.  Wählen Sie im Hauptmenü Datei -> Neu.
    3. Machen Sie sich mit der intuitiven Oberfläche vetraut. Sie sehen links die Projekt-Navigation, in der Mitte den Ansichten-Editor mit dem Eigenschaften-Bereich und ganz rechts den Katalog mit den Drag & Drop Ansichten-Elementen.

    Kommunikation mit den Endpunkten festlegen

    Als nächstes wird festgelegt, mit welchen Endpunkten bzw. Datenpunkten (z. B. SPS-Variablen, SQL Abfragen) die Bedien-App kommunizieren soll.

    1. Öffnen Sie den Endpunkt-Editor durch Doppelklicken des Knotens "Endpunkt_1" im Bereich "Projekt-Navigation".
    2. Unter Adapter auf "…" klicken und im Dialog den OPC UA Adapter auswählen.
    3. Setzen Sie die Adresse zum OPC UA Adapter. Details dazu finden Sie auch im Handbuch, welches mit der PDF-Schaltfläche geöffnet wird. Sie können hier auch einen anderen Endpunkt-Adapter wählen, der vom App-Designer PC aus erreichbar ist.
    4. Fügen Sie in der Datenpunkte-Liste die zwei Datenpunkte "Aktuelle Temperatur" und "Grenzwert" hinzu. Neue Datenpunkte können mit der Schaltfläche "+ Neuen Datenpunkt hinzufügen" angelegt werden.
    5. Setzen Sie die Adresse und die Datenpunkteigenschaften in der Tabelle wie im Bild unten zu sehen ist.

    Ansicht per Drag & Drop konfigurieren

    Jetzt, nachdem Sie die Datenpunkte definiert haben, wechseln Sie wieder zum Ansichten-Editor, um die Ansichten der Bedien-App zu konfigurieren.

    1. Öffnen Sie den Ansichten-Editor erneut durch Doppelklick auf den Knoten "Ansicht_1" in der Projekt-Navigation.
    2. Ziehen Sie mit der Maus zwei Bereiche vom Typ "Standard-Bereich" auf den Platzhalter "Bereich hier einfügen".
      Anschliessend den Anzeigetext in den Eigenschaften im unteren Fensterbereich analog Bild setzen.
    3. Temperatur-Anzeige einfügen:
      • Mit der Maus das Bereichselement "Anzeige" auf den Platzhalter "Element hier einfügen" ziehen.
      • Die neu erstellte Anzeige auswählen und im Eigenschaften-Bereich unter Bezeichnung den Anzeigetext setzen.
      • Zusätzlich unter Wert den Anzeigetyp  auf "Numerisch" und den Datenpunkt "Endpunkt_1: Aktuelle Temperatur" setzen.
    4. Grenzwert-Eingabe einfügen:
      • Mit der Maus das Bereichselement "Werteingabe" auf den Platzhalter "Element hier einfügen" ziehen.
      • Die neu erstellte Werteingabe auswählen und im Eigenschaften-Bereich unter Bezeichnung den Anzeigetext setzen.
      • Zusätzlich unter Wert den Anzeigetyp  auf "Numerisch" und den Datenpunkt "Endpunkt_1: Grenzwert" setzen.

    App-Konfiguration testen

    Die erstellte App kann ohne Bediengerät direkt auf dem App Designer PC getestet werden. Beim App-Test können simulierte Werten oder Werte eines realen Endpunktes mit Endpunkt-Verbindung verwendet werden. Die aktuellen Werte der Datenpunkte werden unter Endpunkt_1 angezeigt.

    1. Testen mit simulierten Werten:
      • Starten Sie den Test mit dem Befehl 'Ausführen->Starten (Simulator)'.
      • Sie können die Werte in der Datenpunkt-Tabelle unter der Spalte 'Simulierte Werte' verändern.
    2. Testen mit Endpunkt-Verbindung:
      • Stellen Sie sicher, dass eine Verbindung zwischen PC und Endpunkt vorhanden ist.
      • Starten Sie den Test mit dem Befehl 'Ausführen->Starten'.

  • Schritt 2:
    Gateway-PC einrichten

    Sollte Ihre Bedien-App ohne Gateway, also direkt mit den Endpunkten kommunizieren, dann brauchen Sie den App-Manager nicht und können direkt mit Schritt 3 fortfahren.

    Für eine Gateway-Kommunikation muss zuerst das Programm Unified-E App Manager heruntergeladen und auf dem PC, der in der Produktion oder an der Maschine steht, installiert werden. Damit wird der PC in der Produktion zum Gateway und ist das Bindeglied zwischen Endpunkte und Bediengeräte. Alle Endpunkte müssen daher vom Gateway-PC aus erreichbar sein.

    App-Manager installieren

    1. App-Manager herunterladen:
      Downloadfile_download
    2. App-Manager starten und lizenzieren:
      Die Funktionen des App Managers werden erst nach dem Anmelden mit einer Gateway-Lizenz freigeschaltet. Diese wird beim Starten der Applikation abgefragt. Sollten Sie noch keine Lizenz erworben haben, können Sie mit einer kostenlosen Testlizenz weitermachen.

      Am schnellsten gelangen Sie zur Testlizenz wie folgt:

      • Im App Manager den Reiter "Kommunikation" anwählen
      • Unter "Gateway anmelden" den Link "Kostenlose Lizenz" anwählen.
      • Wählen Sie im Dialog  "Kostenlose Gateway-Lizenz" (siehe unten) die Option "Kostenlose Testlizenz" aus.
      • Klicken Sie auf "Übernehmen". Nach ca. einer Minute ist der Messaging-Dienst aktiviert für die Firewall-freundliche Kommunikation. Nach erfolgreichem Einrichten erscheint der Status "Der Gateway ist betriebsbereit" rechts oben.
    3. Einstellung für spätere Installationen direkt aus App-Designer:
      Um später das zu veröffentlichende App-Paket entweder lokal oder remote über das Netz aus dem App-Designer direkt heraus registrieren zu können, muss folgende Einstellung im App-Manager gesetzt werden:
      • Wählen Sie im App-Manager unter Einstellungen (Icon mit dem Zahnrad im Hauptmenü) den Reiter "Sicherheit" aus.
      • Setzen Sie das Kontrolkästchen "Apps remote installieren" (siehe Bild).
      • Sicherheitshinweis: Dieses Kontrollkästchen sollte nur während der Testphase gesetzt bleiben. Während der Produktion sollte das Häkchen nicht gesetzt sein und eine Aktualisierung aus Sicherheitsgründen immer direkt am App-Manager erfolgen.

  • Schritt 3:
    App-Paket veröffentlichen

    Nach der Erstellung der Bedien-App im Schritt 1 und die Einrichtung des Gateway-PCs im Schritt 2 (nur notwendig falls die Kommunikation übers Gateway stattfinden soll)  muss zurück im App Designer aus der Bedien-App ein App-Paket erzeugt und veröffentlicht werden. Dieses App-Paket wird dann anschließend auf dem Bediengerät (z. B. Smartphone) installiert. Bei der Veröffentlichung des App-Paketes ist erneut zu unterscheiden, ob die Bedien-App später indirekt via Gateway oder direkt mit den Endpunkten kommunizieren soll.

    App-Paket für die Gateway Kommunikation veröffentlichen

    1. App-Paket bereitstellen:
      • Starten Sie im App-Designer Hauptmenü den Befehl "Ausführen" -> "App Paket veröffentlichen". 
        Anschließend erscheint ein Dialog zum Veröffentlichen des App-Pakets.
      • Wählen Sie im Dialog unten "Gateway Kommunikation" aus.
      • Klicken Sie auf "Weiter" damit das App-Paket generiert wird und im nächsten Schritt veröffentlich werden kann.
    2. App-Paket veröffentlichen:
      Die erstellte App-Paket Datei aus dem App-Designer wird als uea-Datei gespeichert und kann jetzt im Unified-E App Manager installiert werden. In diesem Beispiel wird ausgegangen, dass App-Designer und App-Manager auf dem gleichen PC installiert sind. Gehen Sie wie folgt vor:
      • Wählen Sie die Option "Diesen PC verwenden" an.
      • Unter "Aktion wählen" die Option "Neue App hinzufügen" wählen und den App-Namen "Erste Schritte" dort eingeben.
      • Durch Anwählen der Schaltfläche "Jetzt veröffentlichen" wird im App Manager eine neue Bedien-App installiert.

      Wäre der App-Manager auf einem remote PC installiert, dann wird eine Remote-Veröffentlichung durch Eingeben der Gateway-Lizenz und des App-Namens durchgeführt, wie hier veranschaulicht:

      • Wählen Sie die Option "Gatewayname verwenden" an.
      • Geben Sie den vollqualifizierten Gateway-Namen und das Ihnen bei der Lizenzierung zugeteilte Passwort ein.
      • Unter "Aktion wählen" die Option "Neue App hinzufügen" wählen und den App-Namen "Erste Schritte" dort eingeben.
      • Durch Anwählen der Schaltfläche "Jetzt veröffentlichen" wird im App Manager eine neue Bedien-App installiert.

    App-Paket für die direkte Kommunikation veröffentlichen

    1. App-Paket bereitstellen:
      • Starten Sie im App-Designer im Hauptmenü den Befehl "Ausführen" -> "App Paket veröffentlichen".
        Anschließend erscheint ein Dialog zum Veröffentlichen des App-Pakets.
      • Wählen Sie im Dialog unten "Direkte Kommunikation" aus. Für Testszwecke ist keine Direkt-Lizenz erforderlich, daher kann für die App-Paket Signierung die Option "Entwicklermodus: Keine Signierung erforderlich" auch gewählt werden.
      • Klicken Sie auf "Weiter" damit das App-Paket generiert werden kann und im nächsten Schritt veröffentlich werden kann.
    2. App-Paket veröffentlichen:
      Die erstellte App-Paket Datei wird als .uea-Datei gespeichert und ist nun für die Bediengeräte-Benutzer bereitzustellen.
      Dafür gibt es mehrere Varianten:
      • App-Paket als Anhang per Email an die berechtigten Benutzer schicken.
      • App-Paket per Http im Netzwerk bereitstellen und URL des App-Paketes bekanntgeben.
      • App-Paket wird von den berechtigten Benutzern direkt vom App Designer Computer durch Einscannen des QR Codes heruntergeladen (siehe Dialog unten).

  • Schritt 4:
    App-Paket auf Bediengerät installieren

    Um die erstellte Bedien-App zu betreiben, muss diese in einer Basis-App aus den App-Stores eingebettet werden. Die Basis-App muss zuerst auf das Bediengerät (z. B. Smartphone) installiert werden und dient als eine Art Bedien-App Container.

    Basis-App "Unified-E" vom Store installieren

    1. Basis-App "Unified-E" vom Store herunterladen und installieren
      Folgenden Plattformen werden derzeit unterstützt:
      • Windows ab Version 7.0: herunterzuladen aus unserem Downloads-Bereich
      • Android ab Version 5.0: herunterzuladen über Google Play
      • iOS ab Version 8.0: herunterzuladen über die App Store
    2. Bedien-App registrieren
      Auch hier ist zu unterscheiden, ob die Bedien-App direkt via Gateway oder direkt mit den Endpunkten kommunizieren soll.

    Bedien-App für Gateway Kommunikation registrieren

    Hierfür werden der App-Manager und die Basis-App benötigt. Im App-Manager muss zuerst ein berechtigter Benutzer den Registrierungs-Vorgang für die Bedien-App starten. Anschliessend wird die Bedien-App am Smartphone durch das Einscannen eines Registrierungs-Code registriert. 

    1. Administrator:
      • Unified-E App-Manager starten.
      • Im App-Manager den Reiter "Alle Apps" auswählen.
      • Bedien-App im Bereich "Installierte Apps" auswählen.
      • Schaltfläche "Registrieren" im Bereich "Benutzer" klicken.
      • In der Maske 'Neuen Benutzer registrieren' den Benutzernamen eingeben und 'Start' anwählen.
    2. App-Benutzer:
      • Unified-E Basis-App starten. 
      • Über das '+' Symbol zur App-Registrierung navigieren.
      • Im folgenden Bildschirm im Bereich "Gateway-Kommunikation" die Schaltfläche "Scannen" wählen.
      • Dann QR-Code aus dem Dialog im App-Manager einscannen. Damit ist der Registrierungsvorgang abgeschlossen.

    Bedien-App für die direkte Kommunikation registrieren

    In diesem Beispiel muss der OPC-UA Server direkt vom Bediengerät (z.B. Smartphone) via WLAN erreichbar sein, damit eine direkte Kommunikation zwischen Smartphone und OPC-UA Endpunkt möglich ist.

    Für die Registrierung der Bedien-App gibt es mehrere Möglichkeiten.

    Variante 1:
    App-Paket über URL in der Basis-App registrieren

    1. Starten Sie die Unified-E Basis App.
    2. Oben rechts das '+' Symbol anwählen zur App-Registrierung.
    3. Im folgenden Bildschirm im Bereich "Direkte Kommunikation" die Schaltfläche "Scannen" wählen und den QR-Code aus dem "App-Paket veröffentlichen" Dialog im App-Designer einscannen. Damit ist der Registrierungsvorgang abgeschlossen.

    Variante 2:
    App-Paket wird per Email an Smartphone gesendet (für iOS & Android). In diesem Fall muss mit der Basis-App der Email-Anhang (.uea Datei) geöffnet werden. Nach Vergabe einen neuen App-Namens ist die Bedien-App registriert.

    1. Öffnen Sie das App-Paket aus dem Email Anhang mit "Unified-E".
    2. Im folgenden Bildschirm die Auswahl "Neue App" wählen, neuer Name vergeben und die Schaltfläche "Übernehmen" klicken.
      Damit ist der Registrierungsvorgang abgeschlossen. 

  • Schritt 5:
    Bedien-App starten!

    Die registrierte Bedien-App kann nun in der Start-Ansicht der Unified-E Basis-App gestartet werden.
    Es erscheint die im Schritt 1 konfigurierte Ansicht.

    Fertig...

    es kann losgehen!