Referenz für Programmierer
XMLSpy 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 XMLSpy zunutze machen kann. Dadurch können Sie von anderen Applikationen aus die fertigen Funktionen von XMLSpy nutzen.
Die programmierbaren Objekte von XMLSpy stehen den Automation Clients über die Applikations-API von XMLSpy, eine COM API, zur Verfügung. Die Applikations-API XMLSpy 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).
Ausführungsumgebungen
Die Applikations-API kann von den folgenden Umgebungen aus aufgerufen werden:
Im Folgenden finden Sie eine Beschreibung der einzelnen Umgebungen.
Skript-Editor: Anpassen von XMLSpy und Ändern der Funktionalität
Sie können Ihre Installation von XMLSpy 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 XMLSpy 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 XMLSpy
Sie haben in XMLSpy die Möglichkeit Ihre eigenen Plug-Ins zu schreiben und in XMLSpy zu integrieren. Dazu können Sie die spezielle XMLSpy Schnittstelle für Plug-ins verwenden. Eine Beschreibung zum Erstellen von Plug-ins finden Sie im Abschnitt XMLSpy 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 XMLSpy IDE Plugins.
Externe Programme
Außerdem können Sie XMLSpy mittels externer Skripts bedienen. So könnten Sie z.B. ein Skript schreiben, um XMLSpy zu einem bestimmten Zeitpunkt zu öffnen, dann eine XML-Datei in XMLSpy 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 XMLSpy verwenden zu können, muss zuerst eine Instanz von XMLSpy 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 XMLSpy über seine COM Registrierung gestartet. Anschließend wird das mit der XMLSpy-Instanz verknüpfteApplication Objekt zurückgegeben. Je nach COM-Einstellungen kann ein mit einer bereits laufenden XMLSpy-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 XMLSpy ActiveX Control. Diese Funktion steht nur zur Verfügung, wenn das XMLSpy 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 XMLSpy Referenz für Programmierer besteht aus den folgenden Abschnitten:
•Skript-Editor: eine Benutzerreferenz für die Skripting-Umgebung in XMLSpy
•IDE Plug-ins: eine Anleitung zum Erstellen von Plug-ins für XMLSpy
•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.