Kommandozeile

<< Click to Display Table of Contents >>

Navigation:  Anwendungen (Apps) erstellen und ändern - Berechtigung Designer > Features und Funktionen >

Kommandozeile

Optional kann DataNAUT über die Kommandozeile gestartet und zusätzlich entweder teilweise oder vollständig automatisiert ausgeführt werden. Mittels verschiedener optionaler Parameter und Steueroptionen, lassen sich Einstellungen vornehmen, um die Prozesse und Ergebnisse an die eigenen Bedürfnisse anzupassen.

 

Aufruf mittels Kommandozeilenparametern

Der Aufruf ist über die manuelle Eingabe, CMD-, und BAT-Dateien oder aus externen Anwendungen heraus möglich. Dabei können auch mehrere Aufrufe, beispielsweise in Batch-Dateien, kombiniert werden.

 

Programmdatei

Kommandozeile

Erklärung

DataNAUT.exe

-prm=Application -pri=8837837F -pav[ORT]="Berlin" -aur

Mit dieser Befehlszeile startet DataNAUT die Applikation mit der ID "8837837F". Als Datenparameter wird für "ORT" der Wert "Berlin" übergeben. In diesem Beispiel wird das Projekt geladen und automatisch ausgeführt, nach Fertigstellung wird DataNAUT jedoch nicht automatisch beendet.

DataNAUT.exe

--PrimaryId=66DE32AA --AutoRun=1 --PartitionNumber=34

Mit dieser Befehlszeile startet DataNAUT die Applikation mit der ID "66DE32AA". --AutoRun=1 aktiviert das automatische Starten der Prozesse. Mit --PartitionNumber=34 wird der Steuerparameter "34" für die Prozessschritte der Applikation übergeben.

DataNAUT.exe

-pri=85BD68DE --AutoClose=1 -aut=1

Mit dieser Befehlszeile startet DataNAUT die Applikation mit der ID "85BD68DE". --AutoClose=1 aktiviert das Schließen der Dialoge, nachdem alle Prozesse abgeschlossen sind. Mit -aut=1 wird das automatische Starten der Prozesse aktiviert.

 

 

Syntax der Kommandozeilenparameter

Kommandozeilenparameter können in Kurzform mit Präfix "-" (Minuszeichen) gefolgt von einer meistens 3 Zeichen langen Kennung abgekürzt werden. In der Langform besteht der Präfix aus 2 Minuszeichen "--". Die Kennung muss in der Langform immer vollständig ausgeschrieben werden.

 

Zwischen Kennung und Wert ist ein "=" (Gleichheitszeichen) zu setzen, der Wert mit direkt dem Leerzeichen folgen. Alternativ kann ein @ (AT-Zeichen) verwendet werden. In diesem Fall wird der nächste auf der Kommandozeile übergeben Wert verwendet, auch wenn Leerzeichen dazwischen sind. Diese Option wird in einigen externen Anwendungen benötigt, wenn der Datenwert aus der externen Anwendung in einem gesonderten Feld der Anwendung definiert werden muss, um dann (mit Leerzeichen getrennt) an die Kommandozeile angehängt zu werden.

 

Unbekannte Parameter werden von DataNAUT vollständig ignoriert. Groß- und Kleinschreibung wird nicht beachtet. Sollen Werte übergeben werden die Leerzeichen enthalten, so müssen die Werte vorne und hinten in Anführungszeichen (") gesetzt werden.

 

Kurzform

Kommandozeilenparameter

Langform

Kommandozeilenparameter

-dbf

-dbf=Log.txt

--DebugFileName

--DebugFileName=Log.txt

-dbf

-dbf="DN Log.txt"

--DebugFileName

--DebugFileName="DN Log.txt"

-dia

-dia=0

--Dialogs

--Dialogs=0

-dia

-dia=1

--Dialogs

--Dialogs=1

 

 

GUIDs

GUIDs werden von DataNAUT als eindeutige Schlüssel für die Identifikation von Objekten verwendet. GUIDs können ohne Klammern und abgekürzt übergeben werden, solange die Eindeutigkeit gewahrt bleibt. Dabei dürfen nur Zeichen von hinten abgeschnitten werden und es können beide Klammern entfallen. Eine Kodierung/Dekodierung der GUIDs, z.B. nach BASE64, wird nicht unterstützt.

 

Textersetzungsklasse

Bei der Auswertung von Variablen der Kommandozeile, kann die Textersetzungsklasse umfassend eingesetzt werden, um Parameterwerte an die Applikation zu übergeben.

 

Verarbeitungsreihenfolge

Steuer- und Datenparameter können über die Kommandozeile oder durch XML-Dateien übergeben werden, bei korrekter Anwendung der Dateien werden alle Parameter so verarbeitet, als wenn Sie über die Kommandozeile angegeben sind.

 

Die Reihenfolge unterschiedlicher Parameter auf der Kommandozeile ist bei der Übergabe unerheblich. Wird ein gleicher Parameter mehrfach in der Datei oder auf der Kommandozeile angegeben, wird die letzte gelesene Einstellung verwendet. Die Verarbeitungsreihenfolge der Parameter im Hinblick auf gemischten Betrieb, also sowohl über Kommandozeile als auch per XML-Dateien, wird nach der unten angegeben Hierarchie abgearbeitet.

 

Steuerparameter zur Identifikation von XML-Datei(en) und ggf. der Datenbereiche müssen obligatorisch über die Kommandozeile übergeben werden.

 

Priorität

Anwendungsfall

Hinweis

1

Parameter aus einer XML-Parameter-Datei

Wird sowohl auf der Kommandozeile als auch in einer XML Kommando-Datei auf eine XML Parameter-Datei verwiesen, wird die Parameter-Datei über die Angabe aus der Kommandozeile geladen und die Angabe in der Kommando-Datei ignoriert.

2

Parameter der Kommandozeile

Parameter der Kommandozeile überschreiben Einstellungen der XML-Dateien.

 

 

Generischer Dateibereich

Der generische Dateibereich richtet sich nach dem DataNAUT-Anwendungsnamen, der Version sowie einigen Einstellungen des Computers. Durch Eingabe von "%APPDATA%" im Explorer kann zu diesem Bereich navigiert werden.