openResultList(json)

Öffnet die Ergebnisliste (Trefferliste) im Rich Client aus einer rohen JSON-Zeichenkette. Eine der Rich-Client-Handle-Methoden, verfügbar über getRichClientApi() — im Gegensatz zur portablen Fassade openHitListByIds (dem Fassade-Äquivalent) ist das hier ein direkter, synchroner Bridge-Write: kein Dispatch-Kern, keine Validierung, keine Normalisierung — die JSON-Zeichenkette geht unverändert an die Bridge.

1. Signatur

openResultList(json: string): void;

2. Parameter

Name Typ Beschreibung

json

string

Die rohe JSON-Zeichenkette der Ergebnisliste, z. B. {"title":"…","hits":[{"id":"…","type":"…"}]} — wird unverändert als einzelnes Argument an die Bridge übergeben. Dokumentierte Form: genau ein Argument (die JSON-Zeichenkette). Die Legacy-Zwei-Parameter-Form (title, json) wird von modernen Clients abgelehnt (Fehlercode 0x8002000E auf v11.10+/v12.0) — die Fassade openHitListByIds postet daher ebenfalls die Einzel-JSON-Zeichenkette.

3. Verhalten

  • Synchron: Die Bridge ist ein synchroner COM-/JS-Aufruf — openResultList(json) ruft osjxOpenResultList(json) sofort auf und liefert void; es gibt kein Promise, das abzuwarten wäre.

  • Einzelnes Argument: Genau ein Argument — die JSON-Zeichenkette — geht an das Bridge-Mitglied osjxOpenResultList; die Bridge liefert void.

  • Throw-safe: Ein fehlendes Bridge-Mitglied (auch eine reduzierte Bridge zum Aufrufzeitpunkt) wirft die beschreibende TypeError; ein werfender Bridge-Aufruf wird in die beschreibende Error umgewandelt — nie ein unkontrolliertes Throw des Host-Proxy, auf jeder Clientversion (siehe Fehler).

  • Keine Normalisierung: Der Handle validiert oder normalisiert nichts — der Aufrufer liefert die JSON-Zeichenkette selbst. Die Fassade openHitListByIds (das Fassade-Äquivalent) baut sie dagegen: eine einzige JSON-Zeichenkette der Form { title, hits: [{ id, type }] } mit Zeichenketten-id/type-Formen und einem nicht-leeren Titel (ein leerer/weggelassener Titel wird mit dem festen Standard 'Result list' ersetzt).

  • Verzögertes Lesen pro Aufruf: Der Handle liest window.osClient pro Aufruf (kein Snapshot zur Handle-Erstellung) — ein später injizierter oder ausgetauschter Bridge-Zustand wird sofort sichtbar.

4. Beispiele

rich.openResultList(JSON.stringify({ title: 'Suite hits', hits: [{ id: '1024', type: '262145' }] }));

5. Fehler

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

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

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

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

  • Error: Dashlet: rich-client bridge call "osjxOpenResultList" failed: … — der Bridge-Aufruf selbst hat eine Ausnahme geworfen (das Detail nennt den Bridge-Fehler).