Automatisierung, Skripte & Stapelverarbeitung

Wenn dieselbe Auswertung immer wieder anfällt, bietet UniPlot zwei Wege, sie zu automatisieren. Der Sequencer baut Abläufe aus fertigen Aktionen auf, etwa Daten laden, Daten im Bericht austauschen und PDF exportieren, mit Schleifen und Bedingungen und meist ohne Programmierung. UniScript-Automatisierungen bieten volle Kontrolle und lassen sich als Menüpunkt bereitstellen, sodass Kollegen sie mit zwei Klicks ausführen. Beide lassen sich über die Kommandozeile, von einem Prüfstand oder aus einem anderen Programm starten.

Anleitungen

Vier Berichtsseiten, eine je Messdatei
Auswertungen aus dem Menü

Kollegen eine Auswertung ohne Programmierung ausführen lassen.

Wie können Kollegen eine wiederkehrende Auswertung ohne Programmierung ausführen?
Stapel von Berichtsseiten
Tausende Dateien über Nacht

Einen Sequencer-Ablauf unbeaufsichtigt für jede Datei einer Liste ausführen.

Wie werte ich Tausende von Messdateien unbeaufsichtigt aus, zum Beispiel über Nacht?
Sechs Messdateien, von einem Skript geplottet
Import und Darstellung per Skript

Datendateien einlesen und eine Berichtsvorlage mit wenigen Zeilen UniScript füllen.

Wie importiere ich Datendateien und stelle Kanäle per Skript dar?
Sprungantworten aus 24 Messdateien mit Mittelwertkurve
Hunderte Dateien vergleichen

Denselben Kanal aus vielen Dateien in ein Diagramm laden.

Wie vergleiche ich denselben Kanal aus Hunderten von Messdateien?

Kurzantworten

Kann ein Ablauf Schritte wiederholen und andere überspringen?

Ja. Im Sequencer hat jede Aktion und jede Untersequenz die Option Loop, die sie einmal für jedes Element einer Liste in einem Runtime Value ausführt, und eine Bedingung, mit der sie nur läuft, wenn ein Runtime Value einen Vergleich erfüllt. Siehe Wie werte ich Tausende von Messdateien unbeaufsichtigt aus, zum Beispiel über Nacht?. Siehe auch Wie wende ich eine Vorlage automatisch auf alle Messdateien an und speichere jedes Ergebnis unter dem Namen der Messdatei?.

Kann ein Prüfstand oder ein anderes Programm eine Auswertung starten?

Ja, auf drei Wegen. Über die Kommandozeile startet UniPlot und führt eine Sequenz aus: uniplot.exe /ws <Workspace> /seq <Sequenz> /rv "<Name> = <Wert>, ...", mit /automation ohne Fenster. Als COM-Server (UniPlot.Application) lässt sich UniPlot aus jedem Programm steuern, das COM verwendet, außerdem unterstützt UniPlot DDE. Siehe COM-Schnittstelle. Siehe auch Kann UniPlot ohne Oberfläche auf einem Server laufen oder über eine Web-API gesteuert werden?.

Wie teste ich einen Sequencer-Ablauf Schritt für Schritt?

Schalten Sie die Aktionen einer Sequenz mit ihren Kontrollkästchen ein und aus, und führen Sie mit einem Doppelklick nur eine einzelne Aktion aus. Die Schaltfläche RV zeigt die aktuellen Runtime Values, die Aktion Snippet mit LOG RVs schreibt sie in das UniPlot-Log.

Wie verwende ich eine Gruppe von Schritten in mehreren Abläufen?

Legen Sie die Schritte in eine eigene Sequenz und rufen Sie diese mit der Aktion Starte Sequenz auf. In einem Skript startet Seq_RunSequence() eine Sequenz des aktuellen Workspace.

Wie lädt ein Skript eine Berichtsvorlage?

auto_LoadTemplate(ssFileName, ssPageName) kopiert eine Seite einer Vorlage (IPW-Datei) in ein neues Dokument und gibt das Seiten-Handle zurück. Für weitere Seiten im selben Dokument rufen Sie vor dem nächsten auto_LoadTemplate() die Funktion auto_AddPage() auf. Siehe auch Wie lade ich eine Vorlage und ersetze ihre Datendateien mit einem Script?.

Wie skaliere ich die Diagramme nach dem Laden der Daten neu?

auto_ScaleAxes() skaliert alle Diagramme der mit auto_LoadTemplate() erzeugten Seite so, dass alle Kurven vollständig sichtbar sind. Siehe auch Wie setze ich Achsengrenzen, Teilstrichabstand und Zahlenformat per Script?.

Wie speichere ich jeden Bericht unter einem eigenen Dateinamen?

Bilden Sie den Namen im Skript, zum Beispiel aus dem Namen der Datendatei, und rufen Sie auto_SaveDocumentAs(ssFileName) auf. Im Sequencer kann der Dateiname der Aktion PDF Export aus einem Runtime Value kommen; die Aktion Setze Runtime Values kann Feldfunktionen wie @f{time} verwenden. Siehe auch Wie speichert der Sequenzer ein PDF unter einem eigenen Pfad und Dateinamen?.

Kann ich UniPlot um eigene Funktionen erweitern?

Ja. UniScript-Funktionen in IC-Dateien im Autoload-Verzeichnis von UniPlot werden beim Start geladen. Mit auto_AddToUI() erscheinen sie im Menü Auswertung, und ein Funktionspaar _xy_filter_func_<Name> und _xy_filter_info_<Name> wird zu einer neuen Filterfunktion. Siehe auch Meine eigene XY-Filterfunktion im Autoload-Ordner erscheint nicht in der Filterliste. Was ist falsch?.

Kann ich UniPlot aus Python oder anderen Sprachen steuern?

Ja, über die COM-Schnittstelle. Jede Sprache, die COM-Objekte aufrufen kann, zum Beispiel VBA, VBScript, C# oder Python mit dem Paket pywin32, erzeugt das Objekt UniPlot.Application und ruft mit Call oder Call2 jede UniScript-Funktion auf. Siehe COM-Schnittstelle und UniPlot.Call2. Siehe auch Wie steuere ich UniPlot aus Python, MATLAB, Excel/VBA oder einem anderen Programm? und Kann ich Python mit UniPlot verwenden?.

Kann ein Skript Daten von einem Webserver laden?

Ja. curl_download(ssURL) lädt Daten über HTTP, HTTPS, FTP, SFTP und weitere Protokolle. Die Funktionen curl_easy_* geben Zugriff auf weitere Optionen von libcurl. Siehe curl_download.

Kann UniScript Datenbanken lesen und beschreiben?

Ja. UniScript enthält Funktionen für PostgreSQL (pq_connectdb, pq_exec, …), für SQLite (sqlite3_open, sqlite3_execute, …) und für MySQL und MariaDB (mysql). Siehe Überblick PostgreSQL und Überblick SQLite. Siehe auch Auf welche Datenbanken kann ich aus UniScript zugreifen, und wo führe ich SQL-Befehle aus?.

Kann UniPlot Daten von einem ASAM-ODS-Server lesen?

Ja, mit den ASAM-ODS-Browser-Add-Ins für ODS-Server mit CORBA- oder RPC-Schnittstelle. Siehe ASAM-ODS Browser (CORBA). Siehe auch Welche ASAM-ODS-Versionen und -Schnittstellen unterstützt UniPlot? Sind verschlüsselte Verbindungen (SSL) möglich?.

Wie teile ich Automatisierungen mit meinem Team?

Legen Sie die IC- und IPW-Dateien in einen Ordner auf einem Netzlaufwerk und tragen Sie ihn auf jedem PC unter Extras=>Weitere Optionen im Suchpfad für Automatisierungs-Skript-Dateien ein; mehrere Ordner werden durch Semikolon getrennt. Ein Sequencer-Workspace ist ein einzelner Ordner, der einfach kopiert oder freigegeben werden kann. Siehe auch Das Menü Auswertung verschwindet oder meine Funktionen fehlen, nachdem ich einen Pfad unter „Suchpfad für Automatisierungs-Skript-Dateien“ eingetragen habe. Warum?.

Wie protokolliere ich, was ein Stapellauf getan hat?

Die UniScript-Logging-Funktionen schreiben Meldungen mit einer Stufe in eine Log-Datei, zum Beispiel log_set_filename() und log_error(). Im Sequencer schreibt die Aktion Snippet mit LOG RVs alle Runtime Values in das UniPlot-Log. Siehe Überblick Logging.

Wie drucke oder exportiere ich Berichte per Skript?

auto_PrintDocument() druckt das ganze Dokument, auto_PrintPage() die mit auto_LoadTemplate() erzeugte Seite auf dem aktiven Drucker. DocPrintPDF(hDoc, ssFile) schreibt eine PDF-Datei. Im Sequencer verwenden Sie die Aktion PDF Export oder Bilder Export. Siehe auch Der PDF-Export bricht mit einem Ghostscript- oder PostScript-Treiberfehler ab („Invalid Post script driver“, „Incorrect PDF setting“, „/undefined in .setpdfwrite“). Was brauche ich?.

Wie berechne ich Formelkanäle in einem Skript?

auto_CalculateNCFormula(ssNCFile, oFormula) fügt einer NC-Datei einen berechneten Kanal hinzu, zum Beispiel der Datei, die auto_ImportData() zurückgibt. Der Kanal lässt sich danach wie ein gemessener Kanal laden. Siehe Formelinterpreter 1 - Einführung. Siehe auch auto_CalculateNCFormula bricht das Script ab, wenn ein Kanal der Formel nicht existiert.

Wie erhalte ich den Bericht, sobald der Versuch beendet ist?

Lassen Sie den Prüfstand eine Batch-Datei aufrufen, die UniPlot mit der neuen Datendatei als Runtime Value startet, zum Beispiel /rv "DATAPATH = D:\Data\Run42.csv". Die Sequenz lädt die Datei, tauscht die Daten im Bericht aus, exportiert das PDF und endet mit der Aktion Snippet mit SHUTDOWN. Siehe auch Wie starte ich eine Sequenzer-Sequenz von der Kommandozeile und übergebe ihr Werte?.

Wie füge ich einem Sequencer-Ablauf einen eigenen Schritt hinzu?

Mit der Aktion Script Ausführung. Sie führt eine UniScript-Datei aus, die mit Seq_GetRuntimeValue() und Seq_SetRuntimeValue() Runtime Values liest und setzt und mit Seq_GetSlotPath() die Datendateien der Slots ermittelt. Aktionen lassen sich zwischen Sequenzen kopieren und einfügen.

Support-Fragen

Fehlermeldungen, Einstellungen und andere praktische Probleme zu diesem Thema werden in der FAQ beantwortet: Berichte, Sequenzer und Stapelverarbeitung und UniScript und Automatisierung.