openLocation(objectId)

Öffnet die Lage (die Ordner- oder Register-Ansicht, in der das Objekt liegt) im Rich Client. Eine der Rich-Client-Handle-Methoden, verfügbar über getRichClientApi() — im Gegensatz zur portablen Fassade openLocation ist das hier ein direkter, synchroner Bridge-Write: kein Dispatch-Kern, keine mainType-Logik, die rohe Zahl direkt an die Bridge.

1. Signatur

openLocation(objectId: number): void;

2. Parameter

Name Typ Beschreibung

objectId

number

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

3. Verhalten

  • Synchron: Die Bridge ist ein synchroner COM-/JS-Aufruf — openLocation(objectId) ruft osjxOpenLocation(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 osjxOpenLocation — ohne Validierung und ohne Normalisierung.

  • 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.

  • Kontrast zur Fassade: Die Fassade openLocation wendet im Rich Client die dokumentierte mainType-Best-Effort-Regel an (Haupttyp 0 = Ordner öffnet das Objekt über osjxOpenObject; alles andere — einschließlich fehlender objectTypeId — über osjxOpenLocation); der Handle ruft osjxOpenLocation direkt auf — ohne mainType-Logik, unabhängig vom Objekttyp.

4. Beispiele

rich.openLocation(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 "osjxOpenLocation" (bridge method missing) — das Bridge-Mitglied fehlt (z. B. reduzierte Bridge zum Aufrufzeitpunkt).

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