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 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 Webdiensts auf dem NI-Webserver
  5. Zugreifen auf Webdienste über einen Client

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 (RT-Zielsystem) veröffentlichen, indem Sie unter dem Real-Time-Zielsystem im Projekt-Explorer ein Webdienst-Projekt erstellen. Wenn Sie Ihre Webdienste auf RT-Zielsystemen veröffentlichen möchten, können Sie Ihre Webdienste nur mit Hilfe des Webservers von Anwendungen 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-Header und Authentifizierung 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 den Webdienst auf dem NI-Webserver direkt aus dem LabVIEW-Projekt ausführen, um einem Client das Senden von Anfragen an HTTP-Methoden-VIs zu ermöglichen.

  1. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Start.
  2. Wenn Sie den NI-Webserver zum ersten Mal auf Ihrem Computer verwenden, müssen Sie ihn zunächst wie folgt aktivieren und konfigurieren:
    1. Klicken Sie im Dialogfeld Webdienst starten auf NI-Webserver konfigurieren, um "NI-Webserver-Konfiguration" zu öffnen.
    2. Wählen Sie für diese Anleitung die Konfigurationsvoreinstellung Einfacher lokaler Zugriff aus und klicken Sie auf Weiter.
    3. Wählen Sie auf der Registerkarte Authentifizierung die Option Zur Serververwaltung als Administratorbenutzer anmelden aus und erstellen Sie Ihr Passwort. Klicken Sie auf Weiter.
    4. Klicken Sie auf Beenden, um diese Konfiguration zu übernehmen.
  3. Wechseln Sie zurück zum LabVIEW-Projekt und wiederholen Sie Schritt 1. Der Webdienst wird jetzt auf dem NI-Webserver ausgeführt.
  4. Ö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 NI-Webserver für Clients bereitgestellt wird.
  5. Schließen Sie das VI Addieren.vi.
  6. 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 aus dem Pulldown-Menü Verfügbare Server den Eintrag mit NI-Webserver aus und klicken Sie auf URL kopieren.
    3. Schließen Sie das Dialogfeld.
      Hinweis Der Webdienst antwortet nicht auf Anfragen vom Client, wenn das Dialogfeld HTTP-Methoden-URL geöffnet ist.
  7. Fügen Sie die URL aus Schritt 6 in einen Standardwebbrowser ein und ersetzen Sie alle durch {Wert} gekennzeichneten Variablen durch numerische Werte, beispielsweise http://127.0.0.1:80/AnleitungDienst/Addieren?b=2&a=3.
    Hinweis Gemäß dem HTTP-/HTTPS-Protokoll verwendet der NI-Webserver 80/443 als Standardport. Die Portnummer kann sich jedoch ändern, wenn eine andere Anwendung den Port belegt. Sie können die Portnummer in der NI-Webserver-Konfiguration anpassen. Unter Konfigurieren des NI-Webservers finden Sie weitere Informationen zu Servereinstellungen wie Authentifizierung, Port und Netzwerkverbindungen.
  8. 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 Bedienelemente, c und value, 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. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Stopp.
  9. Wiederholen Sie Schritte 6 und 7 für das VI Subtrahieren.vi oder aktualisieren Sie die URL in Schritt 7, um das URL-Mapping für Subtrahieren.vi anzuzeigen: http://127.0.0.1:80/AnleitungDienst/WeitereOperationen/Subtrahieren?b=2&a=3.
  10. Wiederholen Sie Schritt 8 für das VI Subtrahieren.vi.
  11. Klicken Sie mit der rechten Maustaste auf das Webdienst-Projektobjekt und wählen Sie Stopp.

Weitere Informationen

Testen von Webdiensten und Fehlersuche

Einstellungen des NI-Webservers für Webdienste

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 Registerkarten 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 Webdiensts auf dem NI-Webserver

Sie können den erstellten Webdienst auf dem NI-Webserver veröffentlichen. Der NI-Webserver ist ein einsatzreifer Webserver, auf dem vom Benutzer erstellte Dienste (wie LabVIEW-Webdienste und von NI erstellte SystemLink™-Dienste) gehostet werden können. Der NI-Webserver ermöglicht das Verwalten von Geräten, bietet Schutz vor Sicherheitsbedrohungen aus dem Web und lässt sich auf viele in Unternehmen gängige Datendienste erweitern. In dieser Anleitung veröffentlichen Sie den Webdienst, indem Sie ihn in ein NI-Paket aufnehmen und das Paket installieren.

Hinweis Sie können Ihren Webdienst auch auf dem Webserver von Anwendungen veröffentlichen. Weitere Informationen 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 NI-Webserver, der auf dem lokalen Computer ausgeführt wird, mit Hilfe eines Pakets folgendermaßen vor:

  1. Klicken Sie im Projekt-Explorer mit der rechten Maustaste auf die Build-Spezifikationen und wählen Sie Neu»Paket aus, um das Dialogfeld Eigenschaften für Paket zu öffnen.
  2. Geben Sie auf der Seite Information im Textfeld Paket-Ausgabeverzeichnis den Speicherort an, an dem das Paket erstellt werden soll.
  3. Aktivieren Sie auf der Seite Webdienste die Option AnleitungDienst, um den Webdienst in das Paket aufzunehmen.
  4. Klicken Sie auf Build, woraufhin das Dialogfeld Build-Status angezeigt wird.
  5. Wenn LabVIEW die Erstellung des Pakets abgeschlossen hat, klicken Sie auf Im Explorer öffnen, um das Zielverzeichnis zu öffnen, in dem LabVIEW die Paketdatei (*.nipkg) speichert.
  6. Klicken Sie doppelt auf das Paket, um es mit Hilfe des NI-Paketmanagers zu installieren. Nach Abschluss der Installation wird der Webdienst auf dem NI-Webserver auf dem Host-Computer veröffentlicht.
  7. Schließen Sie das LabVIEW-Projekt. Veröffentlichte Webdienste werden in der LabVIEW-Runtime ausgeführt und sind nicht vom LabVIEW Development System abhängig.

Weitere Informationen

Veröffentlichen von Webdiensten

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. Fügen Sie die URL aus Schritt 7 im Abschnitt Testen von Webdiensten und Fehlersuche in einen Standardwebbrowser ein und ersetzen Sie die Variablen {Wert} mit numerischen Werten, wie beispielsweise http://127.0.0.1:80/AnleitungDienst/Addieren?b=2&a=3.
    Hinweis Wenn sich der Client auf einem anderen System als der veröffentlichte Webdienst befindet, müssen Sie 127.0.0.1 durch die tatsächliche IP-Adresse des Host-Systems oder durch den in der NI-Webserver-Konfiguration festgelegten Host-Namen ersetzen.
  2. 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

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