Schaltfläche
3 Minuten Lesezeit
Funktionsweise und Eigenschaften
Schaltflächen können eingesetzt werden, um zusätzliche benutzerdefinierte Funktionalitäten direkt auf den Eingabemasken von Docusnap zu implementieren. Dabei können entweder externe Anwendungen mit entsprechenden Parametern gestartet oder VB-Skripte ausgeführt werden. In beiden Fällen stehen die Daten des aktuellen Datensatzes zur Verfügung und können in den entsprechenden Programmaufruf oder das Skript eingebunden werden. Um die gewünschten Daten zu laden, müssen die entsprechenden Spaltennamen in der Datenbank in geschwungenen Klammern eingegeben werden, also im Format {FELDNAME}
Die folgende Tabelle zeigt die, zusätzlich zu den allgemeingültigen Eigenschaften, verfügbaren Einstellmöglichkeiten bei Schaltflächen.
| Spezifische Eigenschaften von Schaltflächen | |
|---|---|
| ActionMode | Diese Eigenschaft legt den Typ der auszuführenden Aktion fest. Zur Auswahl stehen dabei Application oder Script. Bei Auswahl von Application wird bei einem Klick auf die Schaltfläche die in der Eigenschaft Application angegebene Anwendung gestartet, die zusätzlich durch die Eigenschaft AppArguments parametrisiert werden kann. Bei Auswahl von Script kann ein VB-Skript ausgeführt werden, das durch die Eigenschaft Script definiert wird. Die jeweils andere Variante wird automatisch von Docusnap ignoriert. Vorgenommene Einstellungen für die deaktivierte Variante werden nicht berücksichtigt. |
| Application | Hierdurch wird die zu startende Anwendung repräsentiert, wenn auf die Schaltfläche geklickt wird. Voraussetzung hierfür ist, dass bei der Eigenschaft ActionMode als Option Application ausgewählt wurde. Angegeben werden kann entweder der Name einer Anwendung, wie beispielsweise explorer.exe, oder der vollständige Pfad zu einer ausführbaren Datei auf der lokalen Festplatte oder auf einer Freigabe. |
| AppArguments | Mithilfe dieser Eigenschaft können zusätzliche Argumente definiert werden, welche der auszuführenden Anwendung bei einem Klick auf die Schaltfläche als Parameter übergeben werden. Dabei können, äquivalent zur Windows-Kommandozeile, auch mehrere Parameter eingetragen werden. Auch die Verwendung von Daten aus dem aktuellen Datensatz ist durch Angabe des jeweiligen Feldnamens in geschwungenen Klammern möglich. |
| Script | Durch diese Eigenschaft ist es möglich, ein VB-Skript zu hinterlegen, das bei einem Klick auf die Schaltfläche ausgeführt wird. Auch dabei stehen die Daten aus dem aktuellen Datensatz uneingeschränkt zur Verfügung und können durch Angabe des jeweiligen Feldnamens in geschwungenen Klammern in das Skript eingebunden werden. |
Anwendungsbeispiele
Aufruf der Administratorfreigabe
Für eine Eingabemaske auf Ebene eines Windows-Rechners kann mit Hilfe folgender Konfiguration die Administratorfreigabe C$ des jeweils aktuellen Rechners durch einen Klick auf die Schaltfläche geöffnet werden.
| Eigenschaft | Wert |
|---|---|
| ActionMode | Application |
| Application | explorer.exe |
| AppArguments | \\{Hostname}\C$ |
Starten einer Remote-Desktopverbindung
Folgende Konfiguration ermöglicht den Start einer Remote-Desktopverbindung mit dem aktuellen Rechner von einer Eingabemaske auf Geräteebene.
| Eigenschaft | Wert |
|---|---|
| ActionMode | Application |
| Application | mstsc.exe |
| AppArguments | /v {Hostname} |
Einfaches VB-Skript-Beispiel
Folgendes einfaches Beispielskript auf Geräteebene überprüft mittels einer Ping-Anfrage, ob der aktuell ausgewählte Rechner online oder nicht erreichbar ist.
| Eigenschaft | Wert |
|---|---|
| ActionMode | Script |
| Script | Dim Win Win=“select*from Win32_PingStatus where address=’{Hostname}’” Dim Level Level = “winmgmts:{impersonationLevel=impersonate}” Set objPing = GetObject(Level).ExecQuery(Win) For Each objStatus in objPing If IsNull(objStatus.StatusCode) Or objStatus.StatusCode<>0 Then WScript.Echo “Rechner {Hostname} nicht erreichbar.” - Else - WScript.Echo “Rechner {Hostname} ist online.” - End If - Next |