openObject()

Öffnet das Objekt in seiner natürlichen Ansicht (ein Dokument öffnet als Dokument, ein Ordner öffnet als Ordner). Eine der sieben portablen Fassade-Methoden des Dashlet-Handles — siehe call für die zeichenkettenbasierte Oberfläche, die denselben Dispatch-Kern teilt.

1. Signatur

openObject(objectId: string | number): Promise<boolean | undefined>;

2. Parameter

Name Typ Beschreibung

objectId

string oder number

Die zu öffnende Objekt-ID (osId).

3. Verhalten pro Umgebung

Umgebung Verhalten

webclient

Der Webclient hat keine openObject-Methode — der Aufruf wird implementiert, indem openIndexData mit [false, 'view', objectId] gepostet wird (öffnet die Indexdaten nur-lesend). Löst sich mit dem booleschen Host-Ergebnis auf.

rich client

osjxOpenObject(objectId) — eine numerische Objekt-ID. Löst sich undefined auf.

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.openObject('1024');

Das zeichenkettenbasierte Äquivalent (derselbe Dispatch-Kern) ist dashlet.call('openObject', [1024]) — die positionale Array-Form, die die einzige Objekt-ID trägt.

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. Auch ein plain Objekt wird abgelehnt: die Fassade nimmt die ID selbst, und call() nimmt [objectId] (ein Array), kein Wrapper-Objekt.

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