getSelectedObjects()

Die ausgewählten Objekte im Host, in beiden Clients identisch normalisiert. Eine der sieben portablen Fassade-Methoden des Dashlet-Handles — siehe call für die zeichenkettenbasierte Oberfläche, die denselben Dispatch-Kern teilt.

1. Signatur

getSelectedObjects(): Promise<SelectedObjectRef[]>;

Jedes Ergebnis-Element ist ein SelectedObjectRef ({ objectId, objectTypeId } — Typdetails: SelectedEntry).

2. Parameter

Keine.

3. Verhalten pro Umgebung

Umgebung Verhalten

webclient

Postet getSelectedObjects mit leeren Parametern (korreliert). Löst das Array des Hosts direkt auf — die IDs können je nach Host als Strings oder Zahlen eintreffen.

rich client

osjxGetSelectedObjects() liefert eine rohe Bridge-Zeichenkette ("osid,objectTypeId;…", "" wenn nichts ausgewählt ist), die geparst und normalisiert wird: eine leere Auswahl löst [] auf; Phantom-Tupel (osid 0) und fehlerhafte Tupel (osid null) werden verworfen (Parität mit dem Init-Pfad); Dokumenten ohne Typ tragen die -1-Typ-Markierung.

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

const selected = await dashlet.getSelectedObjects();
// z. B. [{ objectId: 1024, objectTypeId: 262145 }, …]

5. Fehler

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