Schaltfläche

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}

Docusnap-Editor-Schaltflaeche

�

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

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

�

Docusnap-Konvention-Tipp

Die in diesem Kapitel gezeigten Beispiele sollen einen grundlegenden Eindruck in die Möglichkeiten der Erweiterung von Docusnap durch die Verwendung externer Anwendungen oder VB-Skripte geben. Durch diese beiden Optionen lassen sich nahezu alle denkbaren Anpassungen vornehmen. Sollte eine geplante Anpassung die Möglichkeiten eines VB-Skriptes überschreiten, so besteht grundsätzlich auch die Möglichkeit, eine eigens entwickelte Anwendung mit entsprechenden Parametern aufzurufen, um den gewünschten Zweck zu erreichen. Weiterführende Informationen zu den Möglichkeiten, die VB-Skripte bieten, finden sich in zahlreichen Büchern und natürlich im Internet.

��