ASYS-Oberfläche mit Übergabeparametern öffnen
| Zugehörige Informationen | |||
| Installation von ASYS | |||
Übergabeparameter beim Programmstart
Das Programm (die Asys7.exe) kann mit Übergabeparametern gestartet werden. Hierzu müssen Sie eine Betriebssystemkonsole zur Eingabe von Betriebssystemkommandos öffnen (cmd.exe) oder eine Textdatei aufrufen, die entsprechende Kommandos enthält und deren Dateityp (i.d.R. *.bat) mit dem Konsolenprogramm verarbeitet wird.
Wird der Benutzeroberfläche beim Programmstart eine Reihe von nachfolgend beschriebenen Parametern übergeben, wird automatisch eine Hauptdatenkategoriemaske mit einem eindeutig bestimmten Datenobjekt geöffnet. Als Parameter sind zu übergeben:
| Parameter | Beispiel | Erläuterung |
|---|---|---|
| -maske= | -maske=Notifizierungsbogen | Angabe des internen eindeutigen Namens der zu öffnenden Maske1). |
| -ID= | -ID=„Notifizierungsnummer:DE 1350/ 169952;Gueltig Von:01.01.2019“2) | Angabe des logischen Schlüssels des in der zu öffnenden Maske anzuzeigenden Datenobjekts. Für jede Einzelangabe des Schlüssels ist der Fachmodelname anzugeben, gefolgt von einem ':' und dem Schlüsselwert. Besteht der logische Schlüssel aus mehreren Einzelangaben, sind diese durch ';' zu trennen. Das bei den meisten Hauptdatenkategorien zum logischen Schlüssel gehörende 'Gueltig Von' ist optional. Wenn dieses übergeben wird, wird es als 'gültig am' interpretiert (Gueltig Von < = [DATUM] und Gueltig Bis >= [DATUM] oder null). Wird es nicht übergeben, wird nach dem aktuell gültigen Datensatz gesucht (Gueltig Bis is null). |
| -nm= | nm=itu | Name des Nutzers, für den die Benutzeroberfläche geöffnet wird. |
| -in= | -in=MiijX5kc7pwj6W+wCVcvjtq9Gxw= | verschlüsseltes Passwort des Nutzers, wie es in der Datenbank abgelegt ist3). |
Falls Parameter hinter dem '='-Zeichen Leerzeichen aufweisen, so sind die Parameterwerte in doppelte Hochkommata zu setzten (s. z.B. den Parameter -ID=).
Der Aufruf hat mit einem vollständigen Set der o.g. Parameter zu erfolgen. Fehlt einer der Parameter oder ist der Parameter ohne Inhalt, startet die Oberfläche mit dem Login-Dialog. Die Parameter werden im weiteren Verlauf ignoriert.
Sind alle Parameter vorhanden, so wird das Programm zunächst ohne Login-Dialog gestartet. Schlägt die Anmeldung mit den übergebenen Informationen zu Nutzer und Passwort fehl, öffnet sich der Login-Dialog. Die Parameter werden im weiteren Verlauf ignoriert.
Ist ein Login mit den übergebenen Daten möglich, wird die Oberfläche normal gestartet. Es wird geprüft, ob der übergebene Maskenname existiert und ob es sich um eine Hauptdatenkategorie handelt. Ist eine dieser Bedingungen nicht erfüllt, erscheint eine Problemmeldung, dass die Maske nicht geöffnet werden konnte. Hat der Nutzer in der Maske nicht das Leserecht, erscheint eine Problemmeldung, dass der Nutzer nicht die nötigen Rechte hat, um die Maske zu öffnen. In beiden Fällen werden die als Parameter übergebene Werte für -maske und -ID in den Problemmeldungen angezeigt. Nach Quittierung der Problemmeldung wird keine weitere Aktion ausgeführt.
Anschließend wird die Suche ausgelöst und die Ansichtsmaske mit dem ersten Eintrag der Trefferliste geöffnet. Kann kein Treffer gefunden werden, erscheint eine Problemmeldung.
Sofern der Aufruf der Asys7.exe über die Eingabeaufforderung erfolgt, die z.B. beim Ausführen einer Batch-Datei (.bat) verwendet wird, werden Texte und insbesondere Umlaute anders kodiert als in Windows. Um die für Windows passende Kodierung zu wählen muss in der Batchdatei der Befehl chcp 1252 vor dem Aufruf von Asys7.exe ausgeführt werden.
chcp 1252
Asys7.exe -maske=[INTERNER MASKENNAME] -ID=[LKEY]:[VALUE] -nm=[LOGINNAME] -in=[PW]
Auch wenn das Passwort nicht im Klartext, sondern in der in der Datenbank verschlüsselten Form übergeben wird, stellt dieser Aufrufmechanismus eine potentielle Sicherheitslücke dar! Die Kombination aus Nutzername (-nm) und verschlüsseltem Passwort (-in) lässt sich in kopierter Form zum Aufruf von ASYS mit anderen Masken und Daten unter Ausnutzung der Rechte des Nutzers missbrauchen. Die Ablage eines derartigen Programmaufrufs in einer Kommandozeilendatei (i.d.R. *.bat) sollte daher nur mit äußertem Bedacht vorgenommen werden!