refreshObjectInLists(objectId)

Aktualisiert das Objekt in offenen Ergebnislisten im Rich Client. Eine der Rich-Client-Handle-Methoden, verfügbar über getRichClientApi() — im Gegensatz zur portablen Fassade refreshHitListObjects ist das hier ein direkter, synchroner Bridge-Write: kein Dispatch-Kern, keine Validierung, die rohe Zahl direkt an die Bridge.

1. Signatur

refreshObjectInLists(objectId: number): void;

2. Parameter

Name Typ Beschreibung

objectId

number

Die Objekt-ID (osid) — unverändert an die Bridge übergeben.

3. Verhalten

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

  • Direkter Bridge-Write: Die rohe objectId-Zahl geht direkt an das Bridge-Mitglied osjxRefreshObjectInLists — ohne Validierung und ohne Normalisierung.

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

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

Kontrast zur Fassade. Der Handle aktualisiert genau ein Objekt pro Aufruf. Die Fassade refreshHitListObjects(ids) iteriert dagegen über jede id in Reihenfolge, versucht alle (kein Fail-fast) und lehnt — wenn ein Bridge-Aufruf geworfen hat — mit einem einzigen beschreibenden Aggregationsfehler ab, der die erste fehlerhafte id benennt (refreshHitListObjects: osjxRefreshObjectInLists failed for id "…" (N of M refreshes failed): …).

4. Beispiele

rich.refreshObjectInLists(1024);

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 "osjxRefreshObjectInLists" (bridge method missing) — das Bridge-Mitglied fehlt (z. B. reduzierte Bridge zum Aufrufzeitpunkt).

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