openLocation()

Öffnet die Lage des Objekts — die Ordner- oder Register-Ansicht, in der das Objekt liegt. Eine der sieben portablen Fassade-Methoden des Dashlet-Handles — siehe call für die zeichenkettenbasierte Oberfläche, die denselben Dispatch-Kern teilt.

1. Signatur

openLocation(options: OpenLocationOptions): Promise<void>;

2. Parameter

Name Typ Beschreibung

inNewTab

boolean

In einem neuen Tab öffnen (Webclient; von der Rich-Client-Bridge wird ignoriert — dort gibt es kein Äquivalent).

objectId

string oder number

Die Objekt-ID (osId).

objectTypeId

string oder number (optional)

Die Objekttyp-ID. Wird vom Rich Client verwendet, um den Haupttyp für den Dispatch abzuleiten (unten); im Webclient ist es ein Performance-Hinweis.

parentId

string oder number (optional)

Disambiguisiert Objekte mit mehreren Lagen (nur Webclient; die Bridge hat kein Äquivalent).

parentTypeId

string oder number (optional)

Die Objekttyp-ID des Elternelements (nur Webclient; die Bridge hat kein Äquivalent).

3. Verhalten pro Umgebung

Umgebung Verhalten

webclient

Postet openLocation mit dem fünfwertigen plain-Array-Params-Slot [inNewTab, objectId, objectTypeId, parentId, parentTypeId] (korreliert — die Host-Antwort wird abgewartet). Löst sich undefined auf (void).

rich client

Der Haupttyp wird aus der Objekttyp-ID als Number(objectTypeId) >>> 16 abgeleitet (0 = Ordner, 99 = Register, sonst Dokument). Haupttyp 0 (Ordner) öffnet das Objekt selbst über osjxOpenObject(objectId) (Ordner öffnen als Objekte); jeder andere Haupttyp — einschließlich einer fehlenden objectTypeId (dokumentiertes Best-Effort-Verfahren) — öffnet die Lage über osjxOpenLocation(objectId). Löst sich undefined auf. inNewTab, parentId und parentTypeId haben kein Bridge-Äquivalent und werden nicht gesendet.

standalone (oder noch im Erkennungsmodus ohne Wire)

Es gibt keinen Host-Antwortsweg — der Aufruf wird (begrenzt) mit dem TimeoutError abgelehnt, damit Aufrufer einen Fallback darstellen können, statt aufzuhängen.

4. Beispiele

await dashlet.openLocation({ inNewTab: false, objectId: '1024', objectTypeId: 262145 });

5. Fehler

  • TypeError — eine ungültige (fehlende/leere/nicht-numerische) objectId im Rich Client: Die ID wird in die numerische Bridge-Form umgewandelt, und leere oder nicht-numerische IDs werden beschreibend abgelehnt, statt stillschweigend Objekt 0 zu öffnen.

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

  • TimeoutError — begrenztes Fehlen einer Antwort im Standalone, oder ein Host, der innerhalb von timeoutMs nicht geantwortet hat.

  • Das Host-{ error }-Payload — wenn der Host einen Fehler bei einem Webclient-Methodenaufruf meldet.