refreshHitListObjects()

Aktualisiert die angegebenen Objekte in offenen Trefferlisten. Eine der sieben portablen Fassade-Methoden des Dashlet-Handles — siehe call für die zeichenkettenbasierte Oberfläche, die denselben Dispatch-Kern teilt.

1. Signatur

refreshHitListObjects(ids: Array<string | number>): Promise<boolean | undefined>;

2. Parameter

Name Typ Beschreibung

ids

Array von string oder number

Die Objekt-IDs (osIds), die in den offenen Trefferlisten aktualisiert werden sollen.

3. Verhalten pro Umgebung

Umgebung Verhalten

webclient

Der Params-Slot ist [ids] — das ids-Array als einziges Argument (live-verifiziertes rohes Wire: ["refreshHitListObjects", [["123","456"]], {msgId}]). Ein flacher Slot würde jede id als eigenes Argument dispatchen, worauf der Host false antwortet. Korreliert — löst sich mit dem booleschen Host-Ergebnis auf.

rich client

Ein osjxRefreshObjectInLists(id)-Aufruf pro id, in Reihenfolge, und alle werden versucht (kein Fail-fast). Wenn ein Bridge-Aufruf eine Ausnahme wirft, lehnt das Promise mit einem beschreibenden Aggregationsfehler ab, der die erste fehlerhafte id und die Fehl-/Gesamt-Zählung benennt (refreshHitListObjects: osjxRefreshObjectInLists failed for id "…" (N of M refreshes failed): …); wenn jede id erfolgreich war, löst es sich undefined auf.

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 ok = await dashlet.refreshHitListObjects(['1024', '1025']);

5. Fehler

  • TypeError — ein Nicht-Array-Argument über call(): die Normalisierung verlangt ein ids-Array und lehnt jede andere Form beschreibend ab.

  • Der Aggregations-Error — nur Rich Client: mindestens eine id-weise Bridge-Aktualisierung fehlgeschlagen; die Meldung benennt die erste fehlerhafte id und die Anzahl der Fehlschläge aus der Gesamtzahl.

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