ActiveUpdate-Homepage :: Dokumentation :: Plugin-Dokumentation :: Funktionsweise von PlugIns

Wenn Sie selbst PlugIns für ActiveUpdate programmieren wollen, ist dieser Abschnitt interessant für Sie.

Ablaufschema

Wenn ein PlugIn aufgerufen wird, passiert folgendes:

  1. Die Datei exchange.exe im PlugIns-Verzeichnis wird erstellt (mehr zum Inhalt weiter unten)
  2. Das PlugIn wird gestartet, wie eine normale Perl-Datei von der Kommandozeile
  3. Das PlugIn liest die Datei exchange.dat aus (wir empfehlen, den Pfad der Datei automatisch mit FindBin oder Cwd ermitteln zu lassen, PlugIn und exchange.dat liegen ja im gleichen Verzeichnis)
  4. Alles, was das PlugIn an die Standardausgabe sendet, wird von ActiveUpdate aufgenommen und hinterher in die Template-Datei geschrieben.

Die exchange.dat

Jetzt fehlt nur noch eine Beschreibung der exchange.dat.

Diese Datei ist nach dem Name/Wert-Schema aufgebaut. In jeder Zeile ein Bezeichner, dahinter, durch einen Trennstring abgegrenzt, der Wert.

Die einzelnen Zeilen folgen dieser Syntax:

Bezeichner/()/Wert

Kommen wir nun zu den einzelnen Bezeichnern, zunächst zu den festgelegten:

Bezeichner Bedeutung des zugehörigen Wertes
Arguments Die an das PlugIn übergebenen Argumente
ACUP4HTTP URL des ActiveUpdate-Scripts
PLACCESS Name des PlugIns, über den in den Template-Dateien auf das PlugIn zugegriffen wird
UserIP IP des Benutzers

Danach folgen noch sämtliche Datenfeldnamen (ausgenommen die, die in der ddf.dat definiert werden) als Bezeichner, als Werte dann die jeweiligen Datenfeld-Inhalte des aktuellen Datensatzes.