UModel API Interfaces
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:
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.