Der Zugriff auf die EC&T-Daten geschieht vermittels dreier ActiveX Steuerelemente in EasyCTX.ocx, die über die bisherige Plugin-Schnittstelle (ECTFace.dll) Daten des EC&T-Hauptprogramms zur Verfügung stellen.

Der Ablauf erfolgt so, dass das ActiveX-Plugin nach der Aktivierung zunächst mit dem Aufruf dessen Init()-Methode ein Handle für das Dokument-Steuerelement bekommt, mit dem dieses wiederum auf die Dokumentdaten zugreift (intern entspricht das Handle einem Zeiger auf das aktuelle CDocument des Programms, das in ECTIFace.dll verankert ist). Bei HTML-Plugins wird das Handle in der URL mitgegeben.

Das Dokument Objekt entspricht, wie gesagt, dem geöffneten Dokument des Hauptprogramms. Über dieses Objekt können die einzelnen Buchungen über das Buchung-Objekt zugegriffen werden. Mit dem Objekt Einstellungen kann auf die Einträge der Einstellungsdatei (EasyCT.ini) im Programmverzeichnis zugegriffen werden. (Eintragungen in der Finanzamt-Sektion müssen mit einem vorangestellten 'f' im Schlüsselnamen zugegriffen werden, um einen Namenskonflikt mit den pers. Einstellungen zu vermeiden, z.B. 'fname' statt 'name'.)

Da es sich bei EasyCT.ocx um einen sog. In-Process-Server handelt, sollte das Threading-Model des zu erstellenden Plugins entsprechend eingestellt sein (z.B. 'single-threaded').

Init-Event im Plugin

Das 'Init'-Event muss als Aufruf ohne Rückgabewert mit einem einzelnen 32-bit-Parameter implementiert werden. Für die einzelnen Programmiersprachen sieht das in etwa so aus:

Visual Basic: Sub Init(ByVal dokID)

C++: void Init(long dokID)

Delphi: procedure Init(dokID: Integer); safecall;

Damit das entwickelte Plugin von EC&T auch erkannt wird, müssen einige Registrierungs-Einträge unter folgendem Schlüssel angelegt werden:

HKEY_LOCAL_MACHINE\Software\Tools\EasyCash\Plugins\{MeinPluginName}

Destroy-Event im Plugin

Das 'Destroy'-Event kann optional implementiert werden und wird von EC&T ab v1.60 unterstützt. Destroy wird direkt vor dem Deaktivieren des Plugins gefeuert. Hier können Aktionen ausgeführt werden wie das Schließen von Datenbanken oder das Freigeben von anderen Ressourcen. Bei JavaScript/HTML-Plugins gibt es leider keine Möglichkeit, einen Destroy-Event abzufangen. Wie das Init-Event wird das Destroy-Event ohne Rückgabewert mit einem einzelnen 32-bit-Parameter deklariert. Für die einzelnen Programmiersprachen sieht das in etwa so aus:

Visual Basic: Sub Destroy(ByVal dokID)

C++: void Destroy(long dokID)

Delphi: procedure Destroy(dokID: Integer); safecall;

Dokument-Objekt

Eigenschaften:

Buchung-Objekt

Hinweis: Die Eigenschaften AbschreibungGenauigkeit, Betrieb und Bestandskonto sind erst ab v1.49 verfügbar. Um zu prüfen, ob das aktuelle EC&T installiert ist und die Methoden auch zur Verfügung stehen kann die Methode HoleDokumentVersion() benutzt werden. Wenn diese 10 oder höher zurück gibt, sind die Eigenschaften verfügbar.

Eigenschaften:

Einstellung-Objekt

Methoden:

Im Folgenden sind die möglichen Schlüssel-IDs aufgelistet, mit denen auf Einstellungen zugegriffen werden kann:

'Allgemein'-Sektion:

• monatliche_voranmeldung
• taeglich_buchen
• BuchungsdatumBelassen
• ErzeugeLaufendeBuchungsnummernFuerEinnahmen
• ErzeugeLaufendeBuchungsnummernFuerAusgaben
• JahresfeldAktiviert
• tausender_mwst_saetze
• AbschreibungGenauigkeit
• JahreswechselAbfrage

• umstvoranmeldung_h
• umstvoranmeldung_h2
• umstvoranmeldung_v
• formular_nicht_mitdrucken
• Bildschirmschrift
• Bildschirmschriftgroesse
• Druckerschrift
• Druckerschriftgroesse

• ##Text
• ##Ausg
• ##MWSt
• ##AfAJ
• ##Rech

'Persoenliche_Daten'-Sektion:

• name
• vorname
• unternehmensart1
• unternehmensart2
• strasse
• plz
• ort
• land
• vat1
• vat2
• vat3

• fname
• fname2
• fstrasse
• fplz
• fort
• fsteuernummer

Die virtuellen Konten in den Ini-Datei-Sektionen 'EinnahmenRechnungsposten' und 'AusgabenRechnungsposten' können jeweils mit einer zweistelligen Nummer mit vorangestelltem 'e' oder 'a' angesprochen werden.

Ab v1.35 besteht die Möglichkeit, auf die einzelnen Sektionen der easyct.ini direkt zu zu greifen, indem man die Sektion in eckigen Klammern im Schlüsselnamen voranstellt, z.B. "[sektion]key".

Formular-Objekt

Methoden:

Hinweis für MFC-Programmierer: Um die ActiveX-Objekte im Plugin nutzen zu können, muss AfxEnableControlContainer() in der InitInstance() aufgerufen werden. Ich empfehle für das client window einen CDialog zu kreieren und Gebrauch von der ResizableLib auf codeproject.com zu machen (auch wenn Microsoft Dialoge in ActiveXen nicht empfiehlt). Ein Beispiel eines mit der MFC programmierten Plugins kann man in diesem Suversion-Repository finden: svn://easyct.no-ip.org/ECTImportx (Benötigt wird ein Subversion client, z.B. den von http://tortoisesvn.net/downloads)