Altova UModel 2024 Professional Edition

Dieser Abschnitt enthält Informationen zu den Objekten der UModel COM API. Die Objekte sind allgemein beschrieben, da die API mit praktisch jeder Sprache, die den Aufruf eines COM-Objekts unterstützt, verwendet werden kann. Sprachspezifische Beispiele finden Sie unter:

 

C#-Beispielprojekt

Java-Beispielprojekt

JScript-Beispiele

 

Die API besteht aus zwei Hauptabschnitten, in denen die in der jeweiligen API verwendeten Schnittstellen und Enumerationstypen beschrieben sind. Die Enumerationswerte enthalten sowohl den String-Namen als auch einen numerischen Wert. Wenn Ihre Skripting-Umgebung Enumerationen nicht unterstützt, verwenden Sie stattdessen die numerischen Werte.

 

In .NET gibt es für jede Schnittstelle der MapForce COM Automation Interface eine .NET-Klasse mit demselben Namen. Auch COM-Typen werden in den entsprechenden .NET-Typ konvertiert. So wird etwa ein Typ wie Long aus der COM API in .NET als System.Int32 angezeigt.

 

Beachten Sie in Java die folgenden Syntaxvarianten:

 

Klassen und Klassennamen Für jede Schnittstelle des MapForce Automation Interface gibt es eine Java-Klasse mit dem Namen der Schnittstelle.

Methodennamen Die Methodennamen im Java Interface sind dieselben wie die in den COM Interfaces, beginnen aber aufgrund der Java-Namenskonventionen mit einem Kleinbuchstaben. Zum Aufrufen von COM-Eigenschaften können Java-Methoden verwendet werden, deren Eigenschaftsname das Präfix get und set erhalten. Wenn eine Eigenschaft keinen Schreibzugriff ermöglicht, steht keine Setter-Methode zur Verfügung. So stehen z.B. für die Eigenschaft Name des Document Interface stehen die Java-Methoden getName und setName zur Verfügung.

Enumerationen Für jede im Automation Interface definierte Enumeration ist eine Java-Enumeration desselben Namens und mit denselben Werten definiert.

Events und Event Handler Für jedes Interface im Automation Interface, das Events unterstützt, steht ein Java-Interface desselben Namens plus 'Event' zur Verfügung. Um das Überladen von Einzel-Events zu vereinfachen, gibt es eine Java-Klasse mit Standardimplementierungen für alle Events. Der Name dieser Java-Klasse ist der Name des Event Interface plus 'DefaultHandler'. Beispiel:

 

Application // Java class to access the application

ApplicationEvents // Events interface for the application

ApplicationEventsDefaultHandler // Default handler for "ApplicationEvents"

 

 

UModel API-Fehler

Die UModel API kann die unten aufgelisteten Fehlercodes zurückgeben.

 

1000

Das application-Objekt ist nicht mehr gültig.

1001

Es wurde ein ungültiger Parameter oder eine ungültige Adresse für den Rückgabeparameter definiert.

1002

Die UModel API steht in der aktuellen Version nicht zur Verfügung.

1003

Modelltransformationen werden in der aktuellen Edition nicht unterstützt

1050

Makro nicht gefunden

1051

Ungültige (verschachtelte) Makroausführung

1100

Fehler beim Speichern der Datei. Wahrscheinlich war der Dateiname ungültig.

1101

Ungültiger (doppelter) Aufruf von BeginModification.

1102

EndModification wurde ohne BeginModification aufgerufen

1200

Fehler beim Löschen der Datei an der URL.

1201

Fehler beim Erstellen des Verzeichnisses an der URL.

 

Die UMLData-Schnittstellen haben spezifische Fehler, siehe UMLData-Schnittstellen.

© 2017-2023 Altova GmbH