Einführung

In dieser Dokumentation finden Sie ausführliche Informationen zur Connector-DLL, mit der Sie von verschiedenen selbst erstellten Applikationen auf die Daten der Classic Line zugreifen können. Der hier beschriebene Connector dient als Bindeglied zwischen Ihrer Applikation und der Classic Line. Dabei hat die Applikation lesenden und schreibenden Zugriff auf die Classic Line. Die Zugriffsfunktionalitäten sind in einer COM-Klasse zusammengefasst und nicht, wie bei dem zur Classic Line gehörenden ODBC-Treiber, in einem Datenbanktreiber realisiert, über den der Zugriff beispielsweise über DAO (Data Access Object) oder ADO (ActiveX Data Object) erfolgt. Im Übrigen bietet der erwähnte ODBC-Treiber nur eingeschränkte Funktionalitäten; so kann nur lesend auf die Daten der Classic Line zugegriffen werden. Der Connector dagegen bietet einen lesenden und schreibenden Zugriff.

Ihre Applikation (egal, ob Excel-Tabelle, .NET- oder Delphi-Anwendung) greift über den Connector auf die Daten der Classic Line zu, meldet sich wie gewohnt als Classic Line Client an und hat damit den Zugriff auf die Daten der Classic Line. Datenanfragen der Applikation  werden so umgesetzt, dass der Datenbankdienst sie versteht und die geforderten Datensätze zur Verfügung stellen kann.

Systemvoraussetzung

Um die Connector-DLL auf Ihrem Arbeitsplatz nutzen zu können, muss auf diesem PC ein Classic Line Client installiert sein, damit die notwendigen Classic Line DLLs vorhanden sind. Zurzeit werden die Versionen 3.3.x - 3.5.x und 3.4.1 der Classic Line mit der Datenversion 131000, 132000 und 200000 unterstützt.
Auf Ihrem PC sollte darüber hinaus eine geeignete Entwicklungsumgebung für Ihre Applikation installiert sein. Wenn Sie beispielsweise mit einer Excel-Tabelle auf die Classic Line Daten zugreifen möchten, so sollte das Programm "Microsoft Excel" ab der Version 2000 SP5 installiert sein.

Installation

Kopieren Sie die gelieferten Dateien in ein beliebiges Verzeichnis auf Ihrer lokalen Festplatte und registrieren Sie die Connector-DLL "bzClassicLineSchnittstelle.dll" durch Aufrufen der beigefügten Batchdatei "registrieren.bat".
Im gleichen Verzeichnis, in dem Sie die Connector-DLL einkopiert haben, muss ebenfalls die XML-Dateibeschreibung "bzCLSchnittstelle.xml" abgelegt sein. In dieser Datei sind alle Informationen zu den Tabellen der Classic Line abgelegt, auf die Sie über den Connector zugreifen können.
Ihre Lizenzdatei "bizzlic.ini" kopieren Sie in das EXE-Verzeichnis Ihrer Classic Line Installation.

Dateiname	Beschreibung	Zielverzeichnis
bzCLassicLineSchnittstelle.DLL	Connector	Beliebig
bzCLSchnittstelle.XML	Dateibeschreibungen	wie Connector
Registrieren.bat	Batchdatei zum Registrieren der Connector-DLL	wie Connector
UnRegistrieren.bat	Batchdatei zu Deregistrieren der Connector-DLL	wie Connector
bzLic.INI	Lizenzdatei	EXE-Verzeichnis der Classic Line

Wenn Sie ein Update des Connectors einspielen müssen, so sollten Sie zunächst die Registrierung für die vorhanden DLL mit der Batchdatei "unregistrieren.bat" rückgängig machen, dann die neue DLL einkopieren und anschließend die neue DLL wie oben beschrieben erneut registrieren.

Achtung Sie sollten keinesfalls die registrierte DLL umbenennen oder löschen, ohne dass Sie vorher die Registrierung rückgängig gemacht haben, da es ansonsten zu einem nicht vorhersehbaren Verhalten Ihrer Applikation kommen kann.
Wenn Sie die Beispieldateien einsehen möchten, so können Sie diese in ein beliebiges Verzeichnis auf Ihrer Festplatte kopieren. Dies muss nicht das Verzeichnis sein, in das Sie den Connector einkopiert und registriert haben. Auch Ihre Anwendungsprogramme können Sie in einem beliebigen ande-ren Verzeichnis ablegen.

Wichtiger Hinweis - unbedingt lesen!

Setzen Sie den Connector nur ein, wenn Sie wissen, wie die Tabellen und Dateien der Classic Line aufgebaut sind. Vor allem schreibende Zugriffe sollten Sie nur durchführen, wenn Ihnen klar ist, welche Daten Sie verändern dürfen und welche nicht! Testen Sie Ihre erstellte Applikation ausführlich in einer lokalen Testumgebung der Classic Line mit einem Testmandanten. Erst wenn Sie sicher sind, dass keine Fehler vorliegen, können Sie Ihre Applikation mit den realen Mandantendaten einsetzen.
Die Firma bizz consult übernimmt keine Haftung für zerstörte oder verloren gegangene Daten!
Beim Einsatz der Connector-DLL sollten Sie den Aufbau der verschiedenen Datentabellen und die Zusammenhänge zwischen den Tabellen kennen. Diese Informationen sind nicht Bestandteil dieser Dokumentation!