====== Einsatz des EntityStatusSetter in Jobs ======

Der **EntitySatusSetter** kann eingesetzt werden, um Nachrichten/Dokumente je nach Verarbeitungschritt mit bestimmten **Stati** zu versehen. Diese Stati können von Jobsteps wie **[[prozessdefinition:jobs:jobsteps:allgemein:EntitySelector|EntitySelector]]**, **[[prozessdefinition:jobs:jobsteps:allgemein:MessageSelector|MessageSelector]]** und **[[prozessdefinition:jobs:jobsteps:allgemein:MessageCollector|MessageCollector]]** herangezogen werden, um eine bestimme Auswahl an Nachrichten zu treffen oder diese einzugrenzen.

===== Konventionelle Verwendung des EntityStatusSetters =====

In der Regel wird der EntityStatusSetter bei Jobs verwendet, die das Setzten eines bestimmten Status nach einer bestimmten Aufgabe erfordern. Dabei wird der **EntityStatusSetter** direkt nach dem **EntityTransformer** angewendet. Alle verbuchten Nachrichen bekommen den Status **Processed**.
Hierdurch wird die erneute Verarbeitung der Message mit dem Status **Processed** durch den Job verhindert, da der **EntitySelector** mit der Option **StateLimit_less = Processed** versehen ist, welche nur die Auswahl von Nachrichten/Dokumenten mit **kleineren** Stati erlaubt.

===== Verwendung des EntityStatusSetters mit MultiEntityTransformer ===== 
Werden in einem Job **[[prozessdefinition:jobs:jobsteps:allgemein:MultiEntityTransformer|MultiEntityTransformer]]** verwendet, darf der **EntityStatusSetter** nicht direkt **hinter dem MultiEntityTransformer platziert** werden. Dies kann problematisch sein, wenn durch den MultiEntityTransformer mehrere Dokumente zu einem Dokument verdichtet werden. Der Status wird dabei nur einem Dokument (dem ersten) übergeben. Für solch ein Szenario muss der **EntityStatusSetter** direkt mit dem **EntitySelector** verbunden werden.