openDataSheet(objectId, readOnly)

openDataSheet(objectId, readOnly) öffnet das Datenblatt (Data Sheet) eines Objekts nur-lesend oder editierbar. Ein direkter Bridge-Schreibaufruf auf dem Rich-Client-Handle aus dashlet.getRichClientApi() (siehe getRichClientApi() für die vollständige Handle-Oberfläche): die Methode ruft das osjxOpenDataSheet-Mitglied der window.osClient-Bridge synchron auf — ohne Options-Objekt und ohne Normalisierung. Das normalisierte, host-unabhängige Äquivalent ist die portablen Fassade-Methode openIndexData(options), die im Rich Client auf denselben Bridge-Aufruf abgebildet ist.

1. Signatur

openDataSheet(objectId: number, readOnly: boolean): void;

2. Parameter

Name Typ Beschreibung

objectId

number

Die Objekt-ID (osId).

readOnly

boolean

true = nur-lesend, false = editierbar.

3. Verhalten

  • Synchron (die Bridge ist ein synchroner COM-/JS-Aufruf): die Methode schreibt direkt auf die Bridge und wirft bei Fehler synchron — kein Promise, keine Host-Antwort zum Abwarten.

  • Sie ruft das Bridge-Mitglied osjxOpenDataSheet mit exakt den Positional-Argumenten [objectId, readOnly] auf (roh, ohne Normalisierung).

  • Sie liefert nichts (void); der Bridge-Aufruf hat keinen Rückgabewert.

  • Throw-safe: ein fehlendes Bridge-Mitglied (auch eine reduzierte OpenBrowser-Bridge-Oberfläche zum Aufrufzeitpunkt) wirft die beschreibende TypeError; ein ausnahmswerfender Bridge-Aufruf wirft die beschreibende Error (siehe Fehler).

  • Die Bridge wird pro Aufruf (verzögert) gelesen: der Handle liest window.osClient zum Aufrufzeitpunkt, nicht einen Erstellungszeitpunkt-Schnappschuss — ein später injizierter oder ausgetauschter Bridge-Zustand ist sofort sichtbar.

  • Kontrast: Die portablen Fassade-Methode openIndexData(options) macht im Rich Client dasselbe — denselben osjxOpenDataSheet-Aufruf — mit Options-Objekt und Normalisierung (mode: 'view' = nur-lesend, mode: 'edit' = editierbar).

4. Beispiele

rich.openDataSheet(1024, true);

5. Fehler

  • Error('dashlet destroyed') — das Dashlet wurde vor dem Aufruf zerstört (Accessor wie Handle-Methoden).

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

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

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

  • Error: Dashlet: rich-client bridge call "osjxOpenDataSheet" failed: … — der Bridge-Aufruf selbst hat eine Ausnahme geworfen (das … trägt die geworfene Detailmeldung).