openObject(objectId)

Öffnet das Objekt im Rich Client in seiner natürlichen Ansicht (ein Dokument öffnet als Dokument, ein Ordner als Ordner). Eine der Rich-Client-Handle-Methoden, verfügbar über getRichClientApi() — im Gegensatz zur portablen Fassade openObject ist das hier ein direkter, synchroner Bridge-Write: kein Dispatch-Kern, keine Validierung, die rohe Zahl direkt an die Bridge.

1. Signatur

openObject(objectId: number): void;

2. Parameter

Name Typ Beschreibung

objectId

number

Die Objekt-ID (osid) zu öffnen — unverändert an die Bridge übergeben.

3. Verhalten

  • Synchron: Die Bridge ist ein synchroner COM-/JS-Aufruf — openObject(objectId) ruft osjxOpenObject(objectId) sofort auf und liefert void; es gibt kein Promise, das abzuwarten wäre.

  • Direkter Bridge-Write: Die rohe objectId-Zahl geht direkt an das Bridge-Mitglied osjxOpenObject — ohne Validierung und ohne Normalisierung. Anmerkung: Die Fassade openObject validiert und normalisiert die ID (leere oder nicht-numerische IDs werden beschreibend abgelehnt); der Handle übergibt die rohe Zahl direkt an die Bridge.

  • Throw-safe: Ein fehlendes Bridge-Mitglied (auch eine reduzierte Bridge zum Aufrufzeitpunkt) wirft die beschreibende TypeError; ein werfender Bridge-Aufruf wird in die beschreibende Error umgewandelt — nie ein unkontrolliertes Throw des Host-Proxy, auf jeder Clientversion (siehe Fehler).

  • Verzögertes Lesen pro Aufruf: Der Handle liest window.osClient pro Aufruf (kein Snapshot zur Handle-Erstellung) — ein später injizierter oder ausgetauschter Bridge-Zustand wird sofort sichtbar.

4. Beispiele

rich.openObject(1024);

5. Fehler

  • Error('dashlet destroyed') — das Dashlet wurde vor dem Aufruf zerstört.

  • TypeError: Dashlet.getRichClientApi(): the environment is not resolved yet - await the dashlet.init promise first — der Handle wurde angefordert, bevor die Umgebung aufgelöst war (Accessor-Fehler).

  • TypeError: Dashlet.getRichClientApi(): the rich client API handle is only available in the richClient environment (current: …) — der Handle wurde in der falschen Umgebung angefordert (Accessor-Fehler; der aktuelle Wert wird genannt).

  • TypeError: Dashlet: the rich-client bridge does not expose "osjxOpenObject" (bridge method missing) — das Bridge-Mitglied fehlt (z. B. reduzierte Bridge zum Aufrufzeitpunkt).

  • Error: Dashlet: rich-client bridge call "osjxOpenObject" failed: … — der Bridge-Aufruf selbst hat eine Ausnahme geworfen (das Detail nennt den Bridge-Fehler).