Befehlszeilenargumente des Windows-Clients¶
Sie können Zeta Test Management ("zetatest.exe" oder "zetatest-core.exe" direkt) mit Befehlszeilenargumenten aufrufen.
Dies ist z. B. dann sinnvoll, wenn Sie automatisiert in Skripten Zeta Test Management aufrufen wollen, oder wenn Sie sonstige Standardwerte ändern wollen. Ein anderer Anwendungsfall ist beim Deployment von Zeta Test Management, wenn Sie Verknüpfungen zur Programmdatei gleich parametrisieren möchten und dort beispielsweise einen Pfad zum Projekt mitgeben möchten, oder die Server-URL fest definieren möchten.
Verfügbare Befehlszeilenschalter¶
Folgende Befehlszeilenschalter können Sie verwenden.
- -language="<Sprachkürzel>"— Die Sprache der Benutzeroberfläche, siehe unten.
- -backendserverurl="<URL>" — Die URL zum zentralen Backend-Server in Ihrem Netzwerk. Wird idealerweise im Client-Setup bei einer Netzwerkinstallation angegeben.
- -backendserverapikey="<API-Schlüssel>" — Der API-Schlüssel für die Verbindung zum zentralen Backend-Server in Ihrem Netzwerk. Wird idealerweise im Client-Setup bei einer Netzwerkinstallation angegeben.
- -username="<Name>" — Benutzername mit dem angemeldet wird.
- -password="<Kennwort>" — Das Kennwort mit dem der Benutzer angemeldet wird.
- -licensekey="<Lizenzschlüssel>" — Gibt den Lizenzschlüssel für Zeta Test Management per Befehlszeile an. Alternativ können Sie den Lizenzschlüssel auch per Anwendungs-Konfigurationsdatei in der "appSettings"-Sektion mit dem Schlüssel "licenseKey" angeben.
Als letzter Parameter steht, optional, der Pfad zum Projekt.
Hinweis
Die Werte für die Befehlszeilenparameter "backendserverurl", "backendserverapikey" und "licensekey" können Sie alternativ auch in der Registry unter einem dieser beiden Ordner ablegen:
- "HKEY_CURRENT_USER\Software\Zeta Test Management"
- "HKEY_LOCAL_MACHINE\Software\Zeta Test Management"
Sprache der Benutzeroberfläche¶
Die Benutzeroberfläche von Zeta Test Management können Sie sich in den Sprachen Deutsch und Englisch anzeigen lassen.
Zeta Test Management verwendet standardmäßig automatisch die für die aktuelle Spracheinstellung des Betriebssystems passende Sprache.
Möchten Sie diese automatische Auswahl explizit ändern (z. B. weil Sie in Großbritannien an einem englischen Betriebssystem arbeiten, es aber bevorzugen, die Benutzeroberfläche von Zeta Test Management in Deutsch anzuzeigen), so können Sie dies über den nachfolgenden Befehlszeilenschalter ändern:
-language=<Sprachkürzel>
Die folgenden Sprachkürzel, jeweils eine 2-Buchstaben-Kombination, werden unterstützt (analog zu den Sprachen):
- DE: Deutsch
- EN: Englisch
Also könnte beispielsweise ein gültiger Aufruf von Zeta Test Management mit der Sprache Englisch sein:
"C:\Program Files\Zeta Test Management\Applications\zetatest.exe" -language=en
Umgebungsvariablen für verwaltete Installationen¶
Windows-Client und ServerScheduler können die folgenden Werte aus der Umgebung ihres Prozesses lesen. Ein ausdrücklich angegebener Befehlszeilenwert hat Vorrang; anschließend folgen die Umgebungsvariable und die bisherige Konfiguration beziehungsweise gespeicherten Einstellungen. Leere oder ausschließlich aus Leerzeichen bestehende Umgebungsvariablen werden ignoriert. Ein ausdrücklich leerer Befehlszeilenwert unterdrückt den Environment-Fallback für diesen Wert.
| Umgebungsvariable | Entsprechender Befehlszeilenwert |
|---|---|
ZTM_BACKEND_SERVER_URL |
-backendserverurl |
ZTM_BACKEND_SERVER_API_KEY |
-backendserverapikey |
ZTM_LICENSE_KEY |
-licensekey |
ZTM_LANGUAGE |
-language (de oder en) |
ZTM_USER_STORAGE_PATH |
-alternativeCurrentUserStorageBaseFolderPath |
Die Werte werden unverändert gelesen und nicht in die Prozess-Befehlszeile eingefügt. Für ZTM_USER_STORAGE_PATH einen vollständigen Pfad verwenden. Die Backend-URL und der API-Schlüssel müssen zum selben Server gehören. Für ServerScheduler gelten nur die Werte, die seine jeweilige Aufgabe auch verwendet; die Variable führt selbst keine Aufgabe aus.
Beispiel für einen einzelnen PowerShell-Prozess:
$env:ZTM_BACKEND_SERVER_URL = 'https://backend.example.org/'
$env:ZTM_LANGUAGE = 'de'
& 'C:\Program Files\Zeta Test Management\Applications\zetatest.exe'
API- und Lizenzschlüssel über die geschützte Installations- oder Dienstkonfiguration setzen, nicht als Klartext in Skripte, Handbücher oder Shell-Verlauf schreiben. Eine Umgebungsvariable ist kein verschlüsselter Geheimnisspeicher. Nach Änderungen an Benutzer-/Systemvariablen die Anwendung beziehungsweise den Dienst aus einer aktualisierten Umgebung neu starten. Bestehende Verknüpfungen mit expliziten Argumenten bleiben vorrangig.
Projektpfad, Anmeldekennwort, Benutzername, Portable-Modus sowie Wartungs-/Importaktionen werden nicht automatisch aus Umgebungsvariablen übernommen.
Lokaler Web-Server¶
Der eigenständige Web-Server unterstützt zusätzlich ZTM_WEB_PORT. Der vorhandene Aufruf --port 18772 hat Vorrang. Zulässig sind Ports von 1024 bis 65535; bei fehlendem oder ungültigem Wert gilt 17238. Die Bindung bleibt ausschließlich lokal (localhost). Ein automatisch vom Windows-Client gestarteter Server verwendet weiterhin den vom Client explizit übergebenen Port.
Diese Variablen ersetzen nicht die Web-Server-Einstellungen in appsettings.json beziehungsweise Config.json; es wird dadurch keine allgemeine Environment-Abbildung aller Web-Einstellungen eingeführt.