Installer #

Das Installer-Objekt ermöglicht die Erstellung von Plugins, die über den Plugin-Manager in EULANDA installiert werden können. Plugins werden als .cninst-Dateien (komprimiertes ZIP-Format) verteilt und können SQL-Prozeduren, VBScript, Berichte, Registry-Einträge, Bildschirmmasken und Binärdateien enthalten.

Set installer = Client.CreateDialog("Eulanda.InstallerDlg", "")

Methoden #

Methode	Beschreibung
`BuildPackage(Path)`	Erstellt eine `.cninst`-Datei aus der angegebenen Steuerdatei
`NewUID`	Gibt eine neue eindeutige GUID zurück

Plugin-Konzept #

Ein Plugin besteht aus einer einzelnen .cninst-Datei, die folgende Elemente enthält:

eulanda.xml – die XML-Steuerdatei mit allen Modulinformationen
Zusätzliche Dateien (SQL, VBScript, Berichte, Binärdateien)

Identifikation #

Jedes Modul, jede Option und jeder Hersteller wird über eine eindeutige GUID identifiziert. Diese dient dem Plugin-Manager zur Erkennung bereits installierter Plugins für Updates und Deinstallation.

Steuerdatei #

Die Steuerdatei ist eine INI-ähnliche Textdatei mit folgenden Abschnitten:

[MODUL] #

Eigenschaft	Beschreibung
`VERSION`	Versionsnummer des Plugins (z.B. `1.02`)
`UID`	Eindeutige Modul-GUID
`LANGUAGES`	Unterstützte Sprachen, durch Semikolon getrennt (z.B. `DE;IT`)
`NAME.{LANG}`	Lokalisierter Modulname
`OPTION.COUNT`	Anzahl der Optionen im Plugin
`REQUIRED.COUNT`	Anzahl benötigter Voraussetzungen
`READMEAUTOSTART`	README vor Installation anzeigen (`0` oder `1`)
`ONINSTALL`	VBScript-Dateiname für Pre-Install-Check

[VENDOR] #

Eigenschaft	Beschreibung
`UID`	Registrierte Hersteller-GUID
`VENDORID`	Kurze Herstellerkennung
`NAME`	Firmenname
`EMAIL`	E-Mail-Adresse
`URL`	Homepage

[OPTION.{N}] #

Eigenschaft	Beschreibung
`UID`	Eindeutige Options-GUID
`REQUIRED`	`1` = Pflichtoption (erste Option muss Pflicht sein)
`DEFAULT`	`1` = im Plugin-Manager vorausgewählt
`NAME.{LANG}`	Lokalisierter Optionsname
`INSTALL.COUNT`	Anzahl der Installationsschritte
`INSTALL.{N}`	Dateiname des Installationsschritts
`UNINSTALL.COUNT`	Anzahl der Deinstallationsschritte
`UNINSTALL.{N}`	Dateiname des Deinstallationsschritts

Schritttypen #

Dateierweiterung	Beschreibung
`.cnreg`	SQL-Registry Merge-Modul
`.delcnreg`	Textdatei mit zu löschenden Registry-Pfaden
`.sql`	SQL-Befehle (darf kein `GO` enthalten)
`.vbs`	VBScript-Datei
`.bat`	Batch-Datei
`.imp`	XML-Importdatei

Beispiele #

Plugin erstellen #

Dim installer
Set installer = Client.CreateDialog("Eulanda.InstallerDlg", "")
installer.BuildPackage "C:\TEST\BesuchsJournal.txt"
Set installer = Nothing

Neue GUID erzeugen #

Dim installer
Set installer = Client.CreateDialog("Eulanda.InstallerDlg", "")
MsgBox installer.NewUID
Set installer = Nothing

Pre-Install-Check #

Über die Eigenschaft Abort kann ein VBScript die Installation verhindern:

' In der ONINSTALL-Datei
If Client.CheckLicence(42) = 0 Then
  Installer.Abort = 1
  MsgBox "Die benötigte Lizenz ist nicht vorhanden."
End If