:

    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}

    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
    ActionModeDiese 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.
    ApplicationHierdurch 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.
    AppArgumentsMithilfe 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.
    ScriptDurch 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.

    EigenschaftWert
    ActionModeApplication
    Applicationexplorer.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.

    EigenschaftWert
    ActionModeApplication
    Applicationmstsc.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.

    EigenschaftWert
    ActionModeScript
    ScriptDim 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