getSelectedObjects()

Die ausgewählten Objekte, wie die Rich-Client-Bridge sie liefert: die rohe Bridge-Zeichenkette, ohne jegliches Parsen oder Normalisierung. Das ist der rohe Lesevorgang des Bridge-Mitglieds osjxGetSelectedObjects auf dem getRichClientApi()-Handle — NICHT die normalisierte Fassade-Methode getSelectedObjects(), die genau diese Zeichenkette parst und die normalisierte Form liefert.

1. Signatur

getSelectedObjects(): string | null;

2. Parameter

Keine.

3. Verhalten

Die Methode liest das Bridge-Mitglied osjxGetSelectedObjects pro Aufruf (verzögert — ein später injizierter oder ausgetauschter Bridge-Zustand ist sofort sichtbar, kein Schnappschuss aus der Handle-Erstellung) und liefert sein Ergebnis:

  • die rohe Auswahl-Zeichenkette "osid,objectTypeId;…" — ein osid,objectTypeId-Tupel pro ausgewähltem Objekt, getrennt durch ; (rohe IDs — z. B. tragen typeless Dokumente die rohen Rich-Client-Typ-IDs 13107200 / 19660800);

  • '' (die leere Zeichenkette), wenn nichts ausgewählt ist — ein echter Wert, nicht null;

  • null, wenn der Wert unlesbar ist: das Bridge-Mitglied fehlt (oder ist keine Funktion), der Bridge-Aufruf wirft, oder das Ergebnis ist kein String.

Die Methode parst nichts: sie liefert die Zeichenkette unverändert. Für die normalisierte SelectedEntry[]-Form dient parseRichClientSelectionString — oder die Fassade getSelectedObjects().

4. Beispiele

const rich = dashlet.getRichClientApi();
const raw = rich.getSelectedObjects();
// '1024,262145;2048,262145' — etwas ausgewählt (rohe Bridge-Zeichenkette)
// ''                        — nichts ausgewählt (echter Wert, nicht null)
// null                      — unlesbar (fehlendes Mitglied / werfender Aufruf)

if (raw === null) {
    // die Bridge konnte nicht antworten (fehlendes Mitglied, werfender Aufruf)
} else if (raw === '') {
    // leere Auswahl — die Bridge hat mit einer leeren Zeichenkette geantwortet
} else {
    const entries = parseRichClientSelectionString(raw); // SelectedEntry[]
}

Für die normalisierte Form siehe parseRichClientSelectionString und die Fassade getSelectedObjects().

5. Fehler

Der Lesevorgang selbst wirft nie: ein fehlendes Mitglied, ein werfender Bridge-Aufruf oder ein nicht-String-Ergebnis liefern allesamt null (siehe Verhalten).

Accessor und Handle werfen dagegen:

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

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

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