Gehen Sie zum Erstellen einer benutzerdefinierten Kommandozeilenoperation, die in der Kommandozeilen-Schnittstelle (CLI) für LabVIEW ausgeführt werden soll, folgendermaßen vor:

  • Teil 1: Festlegen des Namens der Operation
  • Teil 2: Festlegen der Funktionsweise der Operation
  • Teil 3 (Optional) Festlegen der Hilfe für die Operation

Teil 1: Festlegen des Namens der Operation

Kommandozeilenoperationen der CLI für LabVIEW verfügen über eine Klasse, und jede Operation wird von einer untergeordneten Klasse dieser Klasse erzeugt. Zum Festlegen des Namens der Operation müssen Sie daher eine untergeordnete Klasse erzeugen und dieser einen Namen geben.

Zum Festlegen des Namens der Operation gehen Sie wie folgt vor:

  1. Öffnen Sie eines der folgenden Verzeichnisse:
    • (Windows) C:\Programme (x86)\National Instruments\Shared\LabVIEW CLI\Operations
    • (macOS) /Library/Application Support/National Instruments/LabVIEW CLI/Operations
    • (Linux) /usr/local/natinst/nilvcli/Operations
  2. Öffnen Sie, je nachdem, ob die Operation nur die Entwicklungsumgebung oder zusätzliche LabVIEW-Module und -Toolkits erfordert, Operations.lvproj oder Toolkit-Operations.lvproj.
    Hinweis Damit Toolkit-Operations.lvproj geöffnet werden kann, müssen die folgenden Toolkits und die folgende Bibliothek installiert sein:
    • LabVIEW VI Analyzer Toolkit
    • LabVIEW Unit Test Framework Toolkit
    • UTF JUnit Report Library—Installieren Sie diese Bibliothek mit Hilfe des JKI VI Package Managers (VIPM).
  3. Klicken Sie mit der rechten Maustaste auf Mein Computer und wählen Sie Neu»Klasse.
  4. Geben Sie im Fenster Neue Klasse den Namen der Klasse an, z. B. AddTwoNumbers. Der Klassenname wird später als Name für die Operation verwendet.
  5. Klicken Sie in der Projektbaumstruktur mit der rechten Maustaste auf die soeben erstellte Klasse und wählen Sie Eigenschaften aus.
  6. Klicken Sie auf der Seite Vererbung auf Elternklasse ändern.
  7. Wählen Sie CoreOperation.lvclass aus. Klicken Sie auf Vom gewählten Objekt ableiten und dann auf OK.

Teil 2: Festlegen der Funktionsweise der Operation

Zum Festlegen der Funktionsweise der Operation müssen Sie die Methoden der Klasse, die Sie im Abschnitt zuvor erstellt haben, überschreiben und einer der überschriebenen Methoden Programmcode hinzufügen.

Zum Festlegen der Funktionsweise der Operation gehen Sie wie folgt vor:

  1. Klicken Sie in der Projektbaumstruktur mit der rechten Maustaste auf die Klasse, die Sie im vorherigen Abschnitt erstellt haben, und wählen Sie Neu»VI für Überschreiben aus.
  2. Wählen Sie im Fenster Neu - Überschreiben die VIs GetHelp.vi und RunOperation.vi aus und klicken Sie auf OK.
  3. Speichern Sie das Projekt. Speichern Sie bei entsprechender Aufforderung die neue Klasse und die überschriebenen Methoden in einem Ordner mit demselben Namen wie die Operation.
    Hinweis  Es wird empfohlen, dass Sie den Ordner in eines der nachfolgenden Verzeichnisse speichern, so dass Sie den Pfad zum Ordner nicht während der Ausführung mit Hilfe des Arguments −AdditionalOperationDirectory angeben müssen.
    • (Windows) C:\Programme (x86)\National Instruments\Shared\LabVIEW CLI\Operations
    • (macOS) /Library/Application Support/National Instruments/LabVIEW CLI/Operations
    • (Linux) /usr/local/natinst/nilvcli/Operations
  4. Öffnen Sie das Blockdiagramm der Methode RunOperation.vi.
  5. Entfernen Sie das SubVI und verbinden Sie die nach dem Löschen verbleibenden Verbindungsenden miteinander.
  6. Fügen Sie Programmcode ein, um die Funktionsweise der Operation zu definieren, und speichern Sie die Änderungen. Lassen Sie das Anschlussfeld unverändert (d. h. wie in der folgenden Abbildung dargestellt).
    AnschlussDatentypBeschreibung
    LabVIEW-Objekt der Klasse, die im vorherigen Abschnitt erstellt wurde.
    Argumente, die der Benutzer beim Ausführen dieser Operation in die CLI für LabVIEW eingibt. Jeder String im Array steht für ein Argument.
    LabVIEW-Objekt der Klasse, die im vorherigen Abschnitt erstellt wurde.
    Ein Programmcode, den die CLI für LabVIEW an die aufrufende Anwendung ausgibt, z. B. an eine Jenkins-Anwendung. Beispielsweise können Sie die CLI so konfigurieren, dass LabVIEW bei erfolgreicher Ausführung der Operation den Wert 0 und bei Auftreten eines Fehlers den Wert -1 ausgibt.
    Ausgabewerte der Operation oder Fehlerangaben, die in der CLI für LabVIEW angezeigt oder in der Protokolldatei gespeichert werden sollen.
    Das VI RunOperation.vi in einem der nachfolgenden Verzeichnisse ist ein Beispiel für das Festlegen der Funktionsweise der Operation "AddTwoNumbers", mit der zwei Zahlen als Eingangswerte hinzugefügt werden und deren Summe ausgegeben wird.
    • (Windows) C:\Benutzer\Öffentlich\Dokumente\National Instruments\LabVIEW CLI\Examples\AddTwoNumbers
    • (macOS) /Library/Application Support/National Instruments/LabVIEW CLI/Examples/AddTwoNumbers
    • (Linux) /usr/local/natinst/nilvcli/Examples/AddTwoNumbers

Teil 3: (Optional) Festlegen der Hilfe für die Operation

Um Benutzern die Verwendung der Operation zu erleichtern, können Sie die Operation dokumentieren. Dazu ist die Methode GetHelp.vi zu bearbeiten, die im vorherigen Abschnitt erstellt wurde. Durch Eingabe des Befehls LabVIEWCLI -OperationName <Name der Operation> -Help kann die Hilfe aufgerufen werden.

Führen Sie zum Dokumentieren der Operation folgende Schritte aus:

  1. Öffnen Sie die Methode GetHelp.vi von der Projektbaumstruktur aus.
  2. Erstellen Sie auf dem Frontpanel ein String-Element mit der Bezeichnung Hilfe und geben Sie eine Beschreibung in das Element ein.
  3. Klicken Sie mit der rechten Maustaste auf das Element Hilfe und wählen Sie Datenoperationen»Aktuellen Wert als Standard aus, um den aktuellen Text als Standardwert für dieses Element festzulegen. Wiederholen Sie diesen Schritt jedes Mal, wenn Sie den Text bearbeiten.
  4. Entfernen Sie das SubVI im Blockdiagramm und verbinden Sie die verbleibenden Verbindungsstücke miteinander.
  5. Verbinden Sie die Objekte wie nachfolgend dargestellt, wobei "AddTwoNumbers" der Name der Operation ist, und speichern Sie Ihre Änderungen.