std.CPRenditionChanged

Dieser Job signalisiert dem Server, dass sich eine Eigenschaft der Rendition eines DMS-Objekts geändert hat. Wird typischerweise vom Rendition-Service aufgerufen, sobald dieser eine Rendition oder einen ihrer Aspekte neu erzeugt, aktualisiert oder verworfen hat.

Der Job liefert keine Daten zurück, sondern stösst serverseitig — abhängig vom übergebenen Reason — Folgeaktionen an:

  • Aktualisierung des Indexierungs-Status in osftslog (Spalte flag2, siehe Wertebereich flag2).

  • Anlage einer Folgenachricht in oscpmqueue — typisch eine Nachricht in der Queue FULLTEXTDOC, damit der Volltext-Indexer das Objekt mit dem aktualisierten Inhalt neu verarbeitet.

  • Aktualisierung der Seitenzahl in den Objektmetadaten (bei Reason = PAGECOUNT).

Der vollständige CP-Lebenszyklus ist unter Capture- und Processing-Messages (CP) beschrieben.

Der Job ist in der offiziellen enaio®-Standard-Engine-Übersicht (std) nicht gelistet.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

ObjectID

INT

Ja

Numerische ID des DMS-Objekts, dessen Rendition sich geändert hat.

ObjectType

INT

Ja

Objekttyp-ID des DMS-Objekts.

Reason

STRING

Ja

Art der Rendition-Änderung. Bekannte Werte siehe Werte für Reason.

ServiceName

STRING

Ja

Identifier der meldenden Service-Instanz (typisch: os-rendition-cache). Wird zur Nachverfolgung und Identifikation in Folgenachrichten verwendet — der Server prüft den Wert nicht gegen den aufrufenden Verbindungskontext.

Flags

INT

Ja

Reserviert; stets 0 übergeben.

[OutputUnicode]

INT

Nein

1 — String-Felder der Ausgabe als UTF-16. Für diesen Job ohne praktische Wirkung, da keine String-Ausgaben erzeugt werden.

1.1. Werte für Reason

Wert Bedeutung

TEXT

Der extrahierbare Volltext-Inhalt des Objekts hat sich geändert (neue OCR-Extraktion oder Text-Layer aus PDF/Office-Dokument). Stösst eine Re-Indexierung über eine neue FULLTEXTDOC-Nachricht an.

PAGECOUNT

Die Seitenanzahl der Rendition wurde (neu) bestimmt — entweder weil das Dokument erstmals konvertiert wurde oder weil die Konvertierung zu einer abweichenden Seitenzahl geführt hat. Aktualisiert primär die gespeicherte Seitenzahl; eine Re-Indexierung wird nur ausgelöst, wenn die Indexierung von der Seitenzahl abhängt.

SLIDE

Eine Slide-Repräsentation (Vorschaubild bzw. seitenbasierte Bilder zur schnellen Anzeige) wurde neu erzeugt oder geändert. Betrifft primär den Anzeige-Cache und löst typischerweise keine Re-Indexierung aus.

2. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode.

3. Hinweise

  • In der Wirkung asynchron: der Aufruf kehrt sofort nach Anlegen der Statusänderungen und Nachrichten zurück. Die eigentliche Re-Indexierung erfolgt später, wenn der Volltext-Indexer die neue Nachricht abholt.

  • Keine aufruferseitige Duplikatsprüfung: mehrere Aufrufe mit identischem (ObjectID, Reason) legen jeweils eine neue Nachricht in oscpmqueue an. Die implizite Zusammenführung erfolgt erst beim Pickup — siehe Zusammenführen redundanter Nachrichten.

  • Der Job ist für interne Service-Kontexte (technischer User) gedacht und führt keine inhaltliche Berechtigungsprüfung durch.

4. Verwandte Jobs