UModel API-Schnittstellen
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.