VTSCommand Hilfsprogramm

Das VTSCommand Hilfsprogramm ist ein Command-Line-Dienstprogramm zum Exportieren und Speichern von Testergebnissen aus dem Wiener Testsystem (WTS) als .xstp-Archivdateien. Zusätzlich zur Archivierung bietet das Tool folgende Funktionen:

• Ergebnisbereinigung: Löscht optional alle archivierten Testergebnisse.

• Personenbereinigung: Löscht optional Personensätze aus dem WTS, wenn alle zugehörigen Testergebnisse erfolgreich archiviert wurden, wenn keine Testergebnisse vorhanden sind oder wenn nur nicht abgeschlossene Testergebnisse vorhanden sind.

• Zertifikatsverwaltung: Ermöglicht das Ersetzen des Zertifikats des Dienstes durch ein anderes X.509-Zertifikat, das vom WTS verwendet werden soll.

Voraussetzungen

Damit das Tool funktioniert, muss das Universal Plugin konfiguriert sein und auf Port 9010 laufen. Weitere Informationen zur Konfiguration des Universal-Plugins finden Sie in der Universal-Plugin Dokumentation.

Benutzername und Passwort in der Konfiguration des Universal-Plugins müssen leer bleiben, damit das VTSCommand-Tool eine Verbindung herstellen kann.

"Urls": "https://localhost:9010",
"UniversalPlugin": {
  "Enabled": "true",
  "DefaultTestBattery": "",
  "CertificateSearchKind": "FindBySubjectName",
  "CertificateSearchValue": "SchuhfriedSelfSignedCertificate",
  "UsernameToVisService": "",
  "PasswordToVisService": ""
},

Dateipfad

Das Tool befindet sich standardmäßig im Ordner C:\Programme\SCHUHFRIED GmbH\Wiener Testsystem 8 Client\AdminClient\VTSCommand.exe

Hinweis: Dies ist der Standard-Installationspfad. Wenn das Wiener Testsystem an einem anderen Ort installiert wurde, kann der tatsächliche Pfad entsprechend abweichen.

Parameter

Die folgenden Parameter definieren die spezifischen Aktionen, die das Tool ausführen soll.

-a

-m MandantName

-p Path

%ProgramData%\Schuhfried\Archive

-e 

-d

-w

-u

-x minutes

-o days

-y

-h

-c

-k

-v

-f

-q

-n

Verwendung von VTSCommand zur Archivierung

Das VTSCommand-Tool unterstützt sowohl die manuelle Archivierung als auch die automatisierte Archivierung und lässt sich so flexibel in Ihre Arbeitsabläufe integrieren. Für den automatisierten Einsatz kann das Tool durch externe Scheduler wie den Windows Task Scheduler ausgelöst werden, wodurch eine tägliche oder periodische Ausführung für eine kontinuierliche Archivierung möglich ist.

Archivierungsoptionen

Sie können das Tool so konfigurieren, dass

• Testergebnisse archiviert und im System belassen werden oder

• Testergebnisse archiviert und nach der Archivierung aus dem System gelöscht werden.

Zusätzlich zur Archivierung unterstützt das Tool:

• Löschen von Personen ohne Testergebnisse (z. B. angelegt, aber nie verwendet)

• Löschen von Personen mit unvollständigen Tests (z. B. nie gestartete oder abgebrochene Tests)

• Exportieren von Personen in eine .csv-Datei

Für den gesamten Archivierungsprozess steht eine Anonymisierungsoption zur Verfügung, mit der sensible personenbezogene Daten bei Bedarf sowohl in archivierten Daten als auch in Exporten anonymisiert werden können.

Umfang und Aufbewahrung der Archivierung

Sie können eine Aufbewahrungsfrist festlegen, um zu steuern, welche Testergebnisse archiviert oder gelöscht werden. Es werden nur Testergebnisse verarbeitet, die älter als die festgelegte Anzahl von Tagen sind; neuere bleiben im System erhalten.

Beispiel Befehle zur Archivierung

Der folgende Befehl exportiert Testergebnisse des Mandanten W12345_001. Dateien mit der Erweiterung .xstp werden im Standard-Archivierungsordner erstellt: %ProgramData%\Schuhfried\Archive

VTSCommand.exe -m W12345_001 -a

Der folgende Befehl exportiert und löscht alle Testergebnisse und die dazugehörigen Personen, sofern diese keine anderen unvollendeten oder geplanten Tests haben.

VTSCommand.exe -m W12345_001 -a -d

Der folgende Befehl löscht alle exportierten Testergebnisse und die dazugehörigen Personen, sofern diese keine anderen unvollendeten oder geplanten Tests haben. Personen in der Datenbank mit unvollendeten Tests oder noch keinen Testergebnissen werden ebenfalls gelöscht.

VTSCommand.exe -m W12345_001 -a -d -w -u

Der folgende Befehl exportiert und löscht alle Testergebnisse, die älter als 60 Tage sind. Die entsprechenden Personen werden ebenfalls gelöscht, sofern sie keine anderen unvollendeten oder geplanten Tests haben. Wenn der Export länger als 8 Stunden dauert, wird er automatisch gestoppt.

VTSCommand.exe -m W12345_001 -a -d -o 60 -x 480

Verwendung von VTSCommand zur Konfiguration eines X.509 Certificate 

Mit dem VTSCommand Tool kann (neu) konfiguriert werden, welches X.509 Zertifikat vom WTS für folgende Zwecke verwendet wird:

• Hosting von TLS-Diensten (VIS & WTS)

• Verschlüsselung generierter Ergebnisberichte

Es gibt zwei Möglichkeiten, das X.509-Zertifikat für VIS und WTS (neu) zu konfigurieren:

1. Durch Verweis auf ein vorhandenes Zertifikat, das im persönlichen Zertifikatsspeicher des lokalen Computers installiert ist

2. Durch Angabe des Pfads und des Passworts zu einer *.pfx-Datei, die das Zertifikat und den privaten Schlüssel enthält (das Zertifikat wird dann im persönlichen Zertifikatsspeicher des lokalen Computers installiert)

Hinweis: Das VTSCommand Hilfsprogramm muss mit Administratorrechten ausgeführt werden, da der Vorgang sonst fehlschlägt.

Beispiel Befehle zur Zertifikatkonfiguration

Der folgende Befehl sucht ein Zertifikat anhand seines Fingerabdrucks im Speicher Computer/Meine Zertifikate und konfiguriert es für die Verwendung durch VIS und WTS.

VTSCommand.exe -c -k FindByThumbPrint -v 2e6ded878a02917790863e9436dc8878a4140a50 

Der folgende Befehl installiert ein Zertifikat aus der angegebenen *.pfx-Datei im Zertifikatsspeicher des Computers/in Ihrem Zertifikatsspeicher und konfiguriert es für die Verwendung durch VIS und WTS. Die Benutzeranfrage (Ja/Nein) in der Konsole wird übersprungen.

VTSCommand.exe -c -n -f c:\users\admin\desktop\mycert.pfx -q mypassword1234