Referenz für Programmierer
Authentic Desktop ist ein Automation Server, d.h. eine Applikation, die anderen Applikationen, so genannten Automation Clients, programmierbare Objekte zur Verfügung stellt. Ein Automation Client hat direkten Zugriff auf die vom Automation Server bereitgestellten Objekte und Funktionalitäten, sodass sich der Automation Client die Funktionalitäten von Authentic Desktop zunutze machen kann. Dadurch können Sie von anderen Applikationen aus die fertigen Funktionen von Authentic Desktop nutzen.
Die programmierbaren Objekte von Authentic Desktop stehen den Automation Clients über die Applikations-API von Authentic Desktop, eine COM API, zur Verfügung. Die Applikations-API Authentic Desktop wird in dieser Dokumentation in der Folge auch als Applikations-API bezeichnet. Das Objektmodell der API und eine vollständige Beschreibung aller verfügbaren Objekte finden Sie in dieser Dokumentation (siehe Abschnitt Applikations-API).
Die Applikations-API kann von den folgenden Umgebungen aus aufgerufen werden:
Im Folgenden finden Sie eine Beschreibung der einzelnen Umgebungen.
Skript-Editor: Anpassen von Authentic Desktop und Ändern der Funktionalität
Sie können Ihre Installation von Authentic Desktop anpassen, indem Sie sie ändern und Funktionalitäten dazu hinzufügen. Sie können auch Formulare für die Benutzereingabe erstellen und neue Menübefehle und Symbolleisten-Schaltflächen zur Benutzeroberfläche hinzufügen. Zu diesem Zweck werden Skripts geschrieben, die mit Objekten der Applikations-API interagieren. Zur effizienten Ausführung dieser Aufgaben steht in Authentic Desktop ein integrierter Skript-Editor zur Verfügung. Eine ausführliche Beschreibung der im Skript-Editor verfügbaren Funktionalitäten und eine Anleitung zur Verwendung der Scripting-Umgebung finden Sie im Abschnitt Skript-Editor dieser Dokumentation. Unterstützt werden die Programmiersprachen JScript und VBScript.
IDE Plug-ins: Erstellen von Plug-ins für Authentic Desktop
Sie haben in Authentic Desktop die Möglichkeit Ihre eigenen Plug-Ins zu schreiben und in Authentic Desktop zu integrieren. Dazu können Sie die spezielle Authentic Desktop Schnittstelle für Plug-ins verwenden. Eine Beschreibung zum Erstellen von Plug-ins finden Sie im Abschnitt Authentic Desktop IDE Plug-ins.
An die meisten Methoden, die von einem IDE Plug-in implementiert werden müssen und das von der Applikation aufgerufen wird, wird ein Applikationsobjekt übergeben. Häufig werden zur Implementierung eines IDE Plug-in die Programmiersprachen C# und C++ verwendet. Nähere Informationen dazu finden Sie im Abschnitt Authentic Desktop IDE Plug-ins.
Externe Programme
Außerdem können Sie Authentic Desktop mittels externer Skripts bedienen. So könnten Sie z.B. ein Skript schreiben, um Authentic Desktop zu einem bestimmten Zeitpunkt zu öffnen, dann eine XML-Datei in Authentic Desktop zu öffnen, die Datei zu validieren und auszudrucken. Externe Skripts würden sich zur Ausführung dieser Aufgaben wiederum der Applikations-API bedienen. Eine Beschreibung der Applikations-API finden Sie im Abschnitt Applikations-API.
Um die Applikations-API außerhalb von Authentic Desktop verwenden zu können, muss zuerst eine Instanz von Authentic Desktop gestartet werden. Wie dies erfolgt, hängt von der verwendeten Programmiersprache ab. Nähere Informationen zu den einzelnen Sprachen finden Sie unter Programmiersprachen.
Im Wesentlichen wird Authentic Desktop über seine COM Registrierung gestartet. Anschließend wird das mit der Authentic Desktop-Instanz verknüpfteApplication Objekt zurückgegeben. Je nach COM-Einstellungen kann ein mit einer bereits laufenden Authentic Desktop-Instanz verknüpftes Objekt zurückgegeben werden. Es kann jede Programmiersprache verwendet werden, die die Erstellung und den Aufruf von COM-Objekten unterstützt. Die am häufigsten dazu verwendeten Sprachen sind unten aufgelistet.
•JScript und VBScript Skript-Dateien haben eine einfache Syntax und dienen dazu COM-Objekte aufzurufen. Sie können direkt über eine DOS-Befehlszeile oder durch Doppelklick im Windows Explorer ausgeführt werden. Am besten eignen sich diese Sprachen für einfache Automationsaufgaben.
•C# ist eine umfangreiche Programmiersprache mit einer breiten Palette an Funktionalitäten. Der Zugriff auf COM-Objekte kann in C# automatisch über Wrapper erfolgen.
•C++ ermöglicht die direkte Steuerung des COM-Zugriffs. Allerdings muss dafür im Vergleich zu anderen Sprachen relativ viel Code geschrieben werden.
•Java: Im Lieferumfang von Altova-Produkten sind native Java-Klassen inkludiert, die als Wrapper für die Applikations-API verwendet werden und dadurch eine Java-Umgebung ermöglichen.
•Weitere nützliche Alternativen sind Visual Basic für Applikationen, Perl und Python.
ActiveX Integration
Ein Sonderfall ist der Aufruf der Applikations-API über das Authentic Desktop ActiveX Control. Diese Funktion steht nur zur Verfügung, wenn das Authentic Desktop Integration Package installiert ist. Jedes ActiveX Control hat eine Eigenschaft, die das entsprechende COM-Objekt für die zugrunde liegende Funktion zurückgibt. Das Manager Control liefert ein Application Object, das Document Control ein Document Object und das Platzhalterobjekt gibt, wenn es die Projektstruktur enthält, das Project Objekt zurück. Die von diesen Objekten unterstützten Methoden sind genau diegleichen, wie im Abschnitt "Schnittstellen" des Abschnitts Applikations-API beschrieben. Achten Sie darauf, keine Methoden zu verwenden, die keinen Sinn im Zusammenhang mit der ActiveX Control Integration ergeben. Nähere Informationen dazu finden Sie unter ActiveX Integration.
Informationen über die Referenz für Programmierer
Die Authentic Desktop Referenz für Programmierer besteht aus den folgenden Abschnitten:
•Skript-Editor: eine Benutzerreferenz für die Skripting-Umgebung in Authentic Desktop
•IDE Plug-ins: eine Anleitung zum Erstellen von Plug-ins für Authentic Desktop
•Applikations-API: eine Referenz für die Applikations-API
•ActiveX Integration: Anleitung und Referenz zur Integration der Benutzeroberfläche und Funktionalitäten von XMLSpy mit Hilfe eines ActiveX Control.