Referenz für Programmierer
Authentic Desktop ist ein Automation Server, d.h. es stellt anderen Applikationen, so genannten Automation Clients, programmierbare Objekte zur Verfügung. Ein Automation Client hat folglich direkten Zugriff auf die vom Automation Server bereitgestellten Objekte und Funktionalitäten, sodass sich der Automation Client von Authentic Desktop die XML-Validierungsfunktionalität von Authentic Desktop zunutze machen kann. Entwickler können ihre Applikationen dadurch durch die bereitgestellten Funktionalitäten von Authentic Desktop verbessern.
Die programmierbaren Objekte von Authentic Desktop stehen den Automation Clients über die Applikations-API von Authentic Desktop, eine COM API, zur Verfügung. Das Objektmodell der API und eine vollständige Beschreibung aller verfügbaren Objekte finden Sie hier.
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 <% AUTH-DESK%>
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 zur Erstellung von Plug-ins finden Sie im Abschnitt Authentic Desktop IDE Plug-ins.
An die meisten Methoden, die von einem IDE Plug-in, das von der Applikation aufgerufen wird, implementiert werden müssen, wird ein Applikationsobjekt übergeben. Häufig werden zur Implementierung eines IDE Plug-in die Programmiersprachen C# und C++ verwendet. Nähere Informationen finden Sie im Abschnitt <% AUTH-DESK%> 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, anschließend eine XML-Datein 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 in der Dokumentation dazu.
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 in der API-Dokumentation im Abschnitt Programmiersprachen.
Authentic Desktop wird im Prinzip über seine COM Registrierung gestartet. Anschließend wird das mit der Authentic Desktop-Instanz verknüpfte Application-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 die 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 Funktionalität zurückgibt. Das Manager Control liefert ein Application-Objekt, das Document Control ein Document-Objekt und das Platzhalterobjekt gibt, wenn es die Projektstruktur enthält, das Project-Objekt zurück. Die von diesen Objekten unterstützten Methoden sind genau die gleichen, wie im Abschnitt "Interfaces" der 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: bietet eine Übersicht über die Authentic Desktop API; Sie gelangen über diesen Link zur API-Dokumentation.
•ActiveX Integration: Anleitung und Referenz zur Integration der Benutzeroberfläche und Funktionalitäten von Authentic Desktop mit Hilfe eines ActiveX Control.