VBScript-AddOn

enaio® editor 11.0 »

Das VBScript-AddOn ermöglicht, VB-Skripte auszuführen, um beispielsweise die Indexierung von Feldern mit VB-Skripten zu bearbeiten.

enaio® webclient unterstützt das VBScript-AddOn nicht.

VB-Skripte werden auf Anfrage von OPTIMAL SYSTEMS GmbH geliefert oder können mit dem VB-Editor erstellt werden. Das AddOn muss über das Modul 'VBX', der VB-Editor über das Modul 'VBE' lizenziert werden. Für den VB-Editor benötigt ein Benutzer das in enaio® administrator erteilte Recht 'enaio® editor starten'.

Wählen Sie über das Eigenschaftsfenster eines Textfelds in der Zeile Katalog den Eintrag AddOn, wird die Registerkarte AddOn angelegt.

Über den Dateiauswahldialog wählen Sie die Datei axaddvbs.dll aus dem Installationsverzeichnis von enaio® editor und den Administrationskomponenten.

In das Konfigurationsfeld tragen Sie den Pfad zum Script ein:

EXTRA00=e:\os\vbscripts\scriptbezeichnung.vbs

Ist das VBScript-AddOn einem Indexdatenfeld zugeordnet, erhält das Feld eine Katalog-Schaltfläche. Mit einem Klick der linken Maustaste wird das verbundene Script gestartet, mit einem Klick der rechten Maustaste wird der VB-Editor gestartet.

Das AddOn kann auf Masken, die schreibgeschützt geöffnet wurden, nur ausgeführt werden, wenn Sie als letzten Eintrag im Konfigurationsfeld CANLOCK=0 angeben.

Der VB-Editor

Im VB-Editor können Skripte erstellt werden oder vorhandene Skripte importiert werden. Skripte, die nicht von OPTIMAL SYSTEMS GmbH geliefert wurden, müssen Sie im VB-Editor erstellen oder importieren und speichern. Sie werden beim Speichern verschlüsselt und können nur verschlüsselt vom AddOn ausgeführt werden. Skripte können durch ein Passwort geschützt werden und eine zusätzliche Lizenzierung erfordern. Passwörter dürfen nur aus ANSI Zeichen bestehen.

Der VB-Editor wird aus einem Client mit einem Klick der rechten Maustaste auf die eingerichtete Katalog-Schaltfläche geöffnet.

Im VB-Editor steht über die Bibliothek oxactive.dll die Variable 'oxhelp' und die Konstante 'OSFile' für den Zugriff auf die Indexdatenfelder zur Verfügung. Die Möglichkeiten der Script-Steuerung werden dadurch erheblich erweitert.

Die Konstante 'OSFile' ermöglicht den Zugriff auf eine Übergabedatei.

Diese Datei hat folgende Struktur:

[DATA]
Objekt= Name des mit dem AddOn verbundenen Objekts (Schrank').
Flags= beliebige Flags, die mit dem Editor gesetzt werden können.
Index= ein DB-Index
Feld00 bis FeldXX= Namen und Feldinhalte der verbundenen Dialogfelder
EXTRA00 bis EXTRAXX= Extra-Einträge aus AddOn-Definitionen.

Die Variable 'oxhelp' stellt die folgenden Funktionen zur Verfügung:

GetProfString(Sektion, Schlüssel, Defaultrückgabestring, Rückgabestring, Dateiname')

Diese Funktion entspricht der WindowsAPI-Funktion 'GetPrivateProfileString'.

Beispiel:
dim b, a
set b = CreateObject("oxactive.COxHelp.1"')
b.GetProfString "Sektion", "Schlüssel", "", a, "d:\\temp\\test.cfg"

WriteProfString(Sektion, Schlüssel, Wert, Dateiname))

Diese Funktion entspricht der WindowsAPI-Funktion 'WritePrivateProfileString'.

WinExec(Datei, Parameter))

Mit dieser Funktion führen Sie eine Windows-Anwendung aus.

ExtractString(string, Feldname, Feldwert))

Diese Funktion dient zum Trennen der Feldnamen und Feldwerte aus der Übergabedatei für das AddOn.

Beispiel:
ExtractString("Hauptbaugruppe|Brandschutz", a, b)
danach ist a = 'Hauptbaugruppe' und b = 'Brandschutz'

 

Das folgende Beispiel-Script liest Werte aus der Übergabedatei, zeigt die Werte an und trägt sie in die Empfängeradresse des geöffneten E-Mail Dialogs ein:

oxhelp.GetProfString "DATA", "Objekt", "", objekt, OSFile
oxhelp.GetProfString "DATA", "feld00", "", feld0, OSFile
oxhelp.ExtractString feld0, feldname, feldwert
dim string
string = "OBJEKT: " + objekt + "  Feld: " + feldname + "  Feldinhalt: " + feldwert
MsgBox(string)
oxhelp.WinExec "mailto:" + feldwert, ""