Führen Sie zum Erstellen und Veröffentlichen eines LabVIEW-Webdienstes sowie zum Austausch von Daten zwischen einem LabVIEW-Webdienst und einem Web-Client (in diesem Fall einem Webbrowser) folgende Schritte aus:

Hinweis Weitere Informationen zu diesem Thema finden Sie in der Einführung in Webdienste. LabVIEW-Webdienste stehen nur im LabVIEW Full Development System und LabVIEW Professional Development System zur Verfügung.

Diese Anleitung ist in folgende Abschnitte unterteilt:

  1. Erstellen von Webdiensten
  2. Testen von Webdiensten und Fehlersuche
  3. Konfigurieren des Client-Zugriffs auf Webdienste
  4. Veröffentlichen des Webdienstes auf dem Webserver von Anwendungen
  5. Zugreifen auf Webdienste über einen Client
  6. Überwachen von Webdiensten

Erstellen von Webdiensten

Ein Webdienst wird in einem LabVIEW-Projekt erstellt. Die zur Erstellung des Webdienstes benötigten Dateien und VIs werden im Projekt zusammengefasst und konfiguriert. Erstellen Sie nun nach der folgenden Anleitung ein Webdienstprojekt und zwei HTTP-Methoden-VIs.

  1. Erstellen Sie zunächst ein LabVIEW-Projekt, um die Webdienstdateien zu organisieren. Speichern Sie das Projekt unter dem Namen Anleitung.lvproj.
  2. Klicken Sie mit der rechten Maustaste auf Mein Computer und wählen Sie Neu»Webdienst. Unter dem Ziel werden ein Webdienst-Projektobjekt und Ordner hinzugefügt.
    Hinweis
    • In dieser Anleitung werden das Erstellen eines Webdienstes und das Veröffentlichen des Webdienstes auf dem Host-Computer beschrieben. Sie können einen Webdienst auch auf einem Real-Time-Zielsystem veröffentlichen, indem Sie unter dem Real-Time-Zielsystem in einem LabVIEW-Projekt ein Webdienst-Projekt erstellen.
    • (Windows) Es wird empfohlen, den Webdienst auf einem Windows-Rechner mit Hilfe des NI-Webservers zu hosten. Detaillierte Hinweise dazu finden Sie unter Anleitung: Erstellen und Veröffentlichen eines LabVIEW-Webdienstes auf dem Webserver von Anwendungen.
  3. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Umbenennen aus. Geben Sie dem Webdienst den Namen AnleitungDienst. Das Projekt wird wie folgt angezeigt:

  4. Klicken Sie mit der rechten Maustaste auf Web-Ressourcen und wählen Sie Neues VI. Dadurch erstellen Sie ein neues HTTP-Methoden-VI, das HTTP-Anfragen von Clients empfängt und Daten an Clients ausgibt. Ein neues VI wird von einer Vorlage aus geöffnet.
    Hinweis Per Standardeinstellung sendet ein HTTP-Methoden-VI über das Anschlussfeld Daten an Clients. In dieser Anleitung geben die HTTP-Methoden-VIs die standardmäßigen JSON-formatierten Textantworten aus. Ein HTTP-Methoden-VI, das nicht als Teil dieser Anleitung erstellt wurde, kann Daten im benutzerdefinierten Format (z. B. eine angepasste HTML-Seite oder Bilddaten) an einen Client streamen. Das Ausgabeformat wird auf der Seite Einstellungen zum HTTP-Methoden-VI im Dialogfeld Eigenschaften für Webdienst konfiguriert.
  5. Erstellen Sie im neuen VI wie in den folgenden Abbildungen gezeigt das Blockdiagramm, das Frontpanel und das Anschlussfeld.
    BlockdiagrammFrontpanelAnschlussfeld
    Nachdem das VI als Teil eines Webdienstes veröffentlicht wurde, kann es von einem Web-Client über eine HTTP-Anfrage aufgerufen werden. Das VI führt nach dem Aufruf folgende Aktionen aus:
    • Es empfängt die Werte der ihm über das Anschlussfeld zugewiesenen Elemente aus der Client-HTTP-Anfrage (mit Ausnahme einerLabVIEW-Webdienst-Anfrage). Die LabVIEW-Webdienst-Anfrage arbeitet wie eine Referenz, indem sie die aktuelle HTTP-Anfrage identifiziert.
    • Die Summe von a und b wird berechnet.
    • Das VI gibt die Summe der Werte über das dem Anschlussfeld zugewiesene Anzeigeelement c an den Client aus.
    • Das VI "Anfragevariable lesen" wird ausgeführt und der Anfrage-String ausgegeben, der vom Client in der aktuellen HTTP-Anfrage hinzugefügt wurde. Dieser wird von der LabVIEW-Webdienst-Anfrage identifiziert.
      Tipp In einem komplexeren Webdienst können unter Umständen andere VIs auf der Palette Webdienste dazu verwendet werden, Komponenten wie HTTP-Sessions, Authentifizierung, HTTP-Header und Cookies zu aktivieren.
  6. Alle Bedien- und Anzeigeelemente erscheinen auch auf dem Anschlussfeld. Bei Verwendung des Standard-Ausgangsanschlusstpys können Webdienste nur über Ein- und Ausgänge, die eine Zuweisung auf dem Anschlussfeld eines HTTP-Methoden-VIs haben, Daten von Clients empfangen oder an Clients senden.
    Tipp Weisen Sie jedem Objekt einen eindeutigen Namen zu. Diese Namen werden Teil der URL, mit deren Hilfe Web-Clients Daten mit dem VI austauschen.
  7. Speichern Sie das VI unter dem Namen Addieren.vi.
  8. Wählen Sie Datei»Speichern unter und wählen Sie im angezeigten Dialogfeld Kopieren»Weitere Kopie öffnen aus. Vergewissern Sie sich, dass das Kästchen Kopie hinzufügen zu Anleitung.lvproj aktiviert ist, und klicken Sie dann auf Fortfahren.
  9. Speichern Sie die neue Kopie unter dem Namen Subtrahieren.vi.
  10. Öffnen Sie das Blockdiagramm des VIs Subtrahieren.vi und ersetzen Sie die "Addieren"-Funktion durch die "Subtrahieren"-Funktion. Verbinden Sie die Bedien- und Anzeigeelemente erneut.
  11. Kehren Sie zum Projekt zurück, klicken Sie mit der rechten Maustaste auf Web-Ressourcen und wählen Sie Neue Web-Ressource aus. Benennen Sie das Projektobjekt in WeitereOperationen um.
  12. Ziehen Sie das VI Subtrahieren.vi unter das Projektobjekt WeitereOperationen. Speichern Sie das Projekt, das mit der folgenden Abbildung übereinstimmen sollte:

Betrachten Sie folgende Komponenten in der Projektbaumstruktur:

  • Es wird ein HTTP-Anfragetyp (Standard: GET) an den Namen jedes HTTP-Methoden-VIs angehängt. Sie können den Typ der HTTP-Anfrage, die von Clients an ein bestimmtes HTTP-Methoden-VI gesendet wird, ändern (wie in der Anleitung weiter unten beschrieben).
  • Das Webdienst-Projektobjekt enthält auch einen Ordner Zu startende VIs. Start-VIs werden in diesen Übungen nicht verwendet. Sie finden jedoch weitere Informationen dazu am Ende der Anleitungen.

Weitere Informationen

Komponenten von Webdiensten

Zuweisen von Anschlüssen zu Bedien- und Anzeigeelementen

Entwickeln von HTTP-Methoden-VIs: Wahl des Formats für Ausgabedaten

Konfigurieren von HTTP-Headern, Streaming und Pufferung

Verwalten eines Projekts in LabVIEW

Testen von Webdiensten und Fehlersuche

Vor dem Veröffentlichen eines Webdienstes auf einem Zielsystem können Sie prüfen, ob die HTTP-Methoden-VIs wie erwartet mit den Clients kommunizieren. Sie können dazu den Webdienst direkt aus dem LabVIEW-Projekt auf einem Fehlersuch-Server bereitstellen, damit der Client Anfragen an HTTP-Methoden-VIs senden kann. Dieser Server ermöglicht so die Fehlersuche in einer "Sandbox-Umgebung".

  1. (Windows) Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt unter Mein Computer und wählen Sie Webserver von Anwendungen»Start (Debug Server) aus. (Real-Time) Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt unter dem Real-Time-Zielsystem und wählen Sie Start (Debug Server) aus.
  2. Öffnen Sie das VI Addieren.vi. Die Schaltfläche Ausführen zeigt an, dass das VI für die Ausführung reserviert ist , da der Webdienst von LabVIEW geladen und auf dem Fehlersuch-Server für Clients bereitgestellt wird.
  3. Schließen Sie das VI Addieren.vi.
  4. Führen Sie zum Ermitteln der URL, die Clients zum Aufrufen des VIs Addieren.vi benötigen, folgende Schritte aus:
    1. Klicken Sie mit der rechten Maustaste auf das VI Addieren.vi und wählen Sie Methoden-URL anzeigen, um das Dialogfeld HTTP-Methoden-URL anzuzeigen.
    2. Wählen Sie im Pulldown-Menü Verfügbare Server das Objekt mit dem Inhalt Lokale Fehlersuche aus und klicken Sie auf die Schaltfläche URL kopieren. Clients müssen mit Webdiensten auf dem Fehlersuch-Server über einen anderen Port kommunizieren als Clients mit Webdiensten, die auf einem Webserver veröffentlicht wurden.
    3. Schließen Sie das Dialogfeld.
      Hinweis Der Webdienst antwortet nicht auf Anfragen vom Client, wenn das Dialogfeld HTTP-Methoden-URL geöffnet ist.
  5. Fügen Sie die URL aus Schritt 4 in einen Standard-Webbrowser ein und ersetzen Sie die Variablen {Wert} mit numerischen Werten, wie beispielsweise http://127.0.0.1:8001/AnleitungDienst/Addieren?b=2&a=3.
  6. Gehen Sie zu der URL. Das VI Addieren.vi empfängt die HTTP-Anfrage vom Browser, berechnet die Summe der Werte a und b und gibt eine Antwort mit dem Namen und dem Ausgangswert jedes Anzeigeelements aus, das sich im Anschlussfeld des VIs Addieren.vi befindet. In diesem Fall ist die Antwort ein JSON-String - das Standardformat des Ausgangsanschlusses. Als Erinnerung: Das VI Addieren.vi hat zwei mit dem Anschlussfeld verbundene Anzeigeelemente, und zwar c und Wert, deren Werte vom HTTP-Methoden-VI in der Antwort ausgegeben werden.

    {"c":5,"value":"b=2&a=3"}

    Hinweis Beenden Sie bei unerwarteter Funktionsweise zunächst die Fehlersuche. Die Webdienstdateien können nicht bearbeitet werden, solange sie von LabVIEW für die Ausführung reserviert sind.
  7. Wiederholen Sie Schritte 4 und 5 für das VI Subtrahieren.vi oder aktualisieren Sie die URL in Schritt 5, um das URL-Mapping für Subtrahieren.vi anzuzeigen: http://127.0.0.1:8001/AnleitungDienst/WeitereOperationen/Subtrahieren?b=2&a=3.
  8. Wiederholen Sie Schritt 6 für das VI Subtrahieren.vi.
  9. (Windows) Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Webserver von Anwendungen»Stop (Debug Server) aus. (Real-Time) Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt unter dem Real-Time-Zielsystem und wählen Sie Start (Debug Server) aus.

Weitere Informationen

Testen eines Webdienstes und Fehlersuche auf dem Webserver von Anwendungen

Konfigurieren des Client-Zugriffs auf Webdienste

Web-Clients verwenden für den Datenaustausch mit HTTP-Methoden-VIs URLs. Sie werden zu einem späteren Zeitpunkt in dieser Anleitung eine spezifische URL in einen Webbrowser eingeben, um Daten direkt an die Elemente auf dem Anschlussfeld des HTTP-Methoden-VIs zu senden.

Gehen Sie wie folgt vor, um die URLs zu definieren, die von Clients zum Zugriff auf die HTTP-Methoden-VIs verwendet werden können.

  1. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Eigenschaften aus, um das Dialogfeld Eigenschaften für Webdienst anzuzeigen.
  2. Beachten Sie auf der Seite Einstellungen zum HTTP-Methoden-VI, dass HTTP-Methoden-VIs aus dem Ordner Web-Ressourcen im LabVIEW-Projekt in der Tabelle der Webdienst-VIs angezeigt werden. Sie sehen, wie sich das Platzieren des VIs Subtrahieren unter dem Projektobjekt WeitereOperationen auf das URL-Mapping auswirkt, verglichen mit Addieren.vi.
  3. Wählen Sie Subtrahieren.vi aus der Tabelle aus und betrachten Sie die folgenden Funktionen auf der Registerkarte URL-Mapping unten auf der Seite:
    • Sie können die Art der HTTP-Anfrage im Pulldown-Menü Methode ändern. Verwenden Sie den Standardwert GET für das VI Subtrahieren.vi.
    • Sie können das von LabVIEW für die Zuweisung einer URL zu einem VI verwendete Standardformat deaktivieren und stattdessen den Teil der URL nach dem Dienstnamen anpassen. Verwenden Sie in dieser Anleitung die Standard-URL-Zuweisung und fügen Sie den VI-Namen hinzu.
    • Das URL-Feld zeigt die Basis-URL an, die von LabVIEW für das HTTP-Methoden-VI erstellt wurde. Für das VI Subtrahieren.vi wird beispielsweise das Standard-URL-Mapping/WeitereOperationen/Subtrahieren erstellt.

    Hinweis In einem komplexeren Webdienst können Sie die verbleibenden Registerkarte auf dieser Seite verwenden, um das vom VI an den Web-Client ausgegebene Datenformat sowie die Sicherheitseinstellungen (zum Beispiel Berechtigungen) zu konfigurieren.
  4. Klicken Sie zum Schließen des Dialogfelds Eigenschaften für Webdienst auf OK.
  5. Speichern Sie Anleitung.lvproj.

Weitere Informationen

Hinweise zu URL-Mappings und Abfrage-Strings in Webdiensten

Veröffentlichen des Webdienstes auf dem Webserver von Anwendungen

Sie können den Webdienst auf dem Webserver von Anwendungen veröffentlichen. In dieser Anleitung veröffentlichen Sie einen eigenständigen Webdienst. In einer komplexeren Anwendung können Sie einen Webdienst jedoch auch über eine eigenständige LabVIEW-Anwendung oder ein Installationsprogramm veröffentlichen. Der Webserver von Anwendungen dient als Host für Webdienste in einem Netzwerk. Der Server ist mit zahlreichen Sicherheitsfunktionen ausgestattet, um den Datenaustausch im Netzwerk zu schützen. Eine Sicherheitsmaßnahme ist beispielsweise die SSL-Verschlüsselung (Secure Sockets Layer).

Hinweis (Windows) Sie können Ihren Webdienst auch auf dem NI-Webserver veröffentlichen. Detaillierte Hinweise dazu finden Sie unter Anleitung: Erstellen und Veröffentlichen eines LabVIEW-Webdienstes auf dem Webserver von Anwendungen.

Gehen Sie zum Veröffentlichen des Webdienstes an den Webserver von Anwendungen auf dem lokalen Computer folgendermaßen vor:

  1. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Webserver von Anwendungen»Webdienst veröffentlichen. Es öffnet sich das Dialogfeld Verteilungsfortschritt.
  2. Wenn LabVIEW den Webdienst ohne Fehler veröffentlicht, klicken Sie auf die Schaltfläche Schließen. Web-Clients können jetzt Daten mit den HTTP-Methoden-VIs austauschen.

Weitere Informationen

Veröffentlichen von Webdiensten

Einstellungen des Webservers von Anwendungen für Webdienste

Zugreifen auf Webdienste über einen Client

Gehen Sie wie folgt vor, um über eine URL Daten von einem Webbrowser an einen veröffentlichten Webdienst zu senden.

  1. Klicken Sie mit der rechten Maustaste auf das VI Addieren.vi und wählen Sie Methoden-URL anzeigen, um das Dialogfeld HTTP-Methoden-URL anzuzeigen.
  2. Wählen Sie im Pulldown-Menü Verfügbare Server das Objekt mit Anwendung aus und klicken Sie auf die Schaltfläche URL kopieren. Diese URL enthält eine andere Portnummer als die URL für den Fehlersuch-Server. LabVIEW verwendet diese Portnummer für die Kommunikation mit den Webdienst-Dateien, die auf dem Webserver von Anwendungen ausgeführt werden.
  3. Schließen Sie das Dialogfeld.
  4. Fügen Sie die URL in einen Standard-Webbrowser ein und ersetzen Sie die Variablen {Wert} mit numerischen Werten, wie beispielsweise http://127.0.0.1:8080/AnleitungDienst/Addieren?b=2&a=3.
    Hinweis Wenn sich der Client nicht auf demselben System wie der veröffentlichte Webdienst befindet, müssen Sie 127.0.0.1 durch die tatsächliche IP-Adresse des Host-Systems ersetzen.
  5. Der Browser gibt eine JSON-Antwort mit den Ausgangswerten aller Bedienelemente aus, die eine Zuweisung auf dem Anschlussfeld haben.

Weitere Informationen

Senden von Daten an eine Anwendung mit Hilfe von URLs

Überwachen von Webdiensten

Prüfen Sie den Status der an den Webserver von Anwendungen veröffentlichten Webdienste mit Hilfe folgender Schritte:

  1. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Webserver von Anwendungen»Webserver verwalten. Das Utility "NI-Webkonfiguration und Überwachung" wird in einem Webbrowser geöffnet.
  2. Klicken Sie auf die Schaltfläche Webdienstverwaltung links auf der Seite
  3. Wählen Sie AnleitungDienst aus der Liste Verteilte Webdienste aus. Klicken Sie auf die Schaltfläche Aktualisieren, falls die Liste leer ist.
  4. Sie sehen, dass der Status des Webdienstes Wird ausgeführt ist. Verwenden Sie die Schaltflächen unten auf der Seite, um Webdienste anzuhalten, fortzusetzen, neu zu starten und zu entfernen.
  5. Rechts auf dieser Seite sehen Sie, dass die URL-Mappings für die HTTP-Methoden-VIs Addieren und WeitereOperationen/Subtrahieren zusammen mit der entsprechenden HTTP-Methode erscheinen.

Weitere Informationen

Programmierbeispiele

Beispiele zur Verwendung von Webdiensten finden Sie in den folgenden LabVIEW-Projekten:

  • examples\Connectivity\Web Services\Weather Monitor\Web Services — Weather Monitor.lvproj