---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# TaskStateUtil : Global

# TaskStateUtil : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die TaskStateUtil -Skripteinbindung bietet Methoden zum Arbeiten mit Tabellenstatusattributen vom Typ „Aufgabe".

Diese Skripteinbindung wird hauptsächlich von der Geschäftsregel „Aufgaben-Aktivitätsstatusmanagement" verwendet, um das Feld „Aktiv" basierend auf Statusänderungen festzulegen. Konfigurationen werden im Dictionaryelement task.state definiert, wobei in der Regel Dictionaryüberschreibungen verwendet werden, da die Statuswerte von Tabelle zu Tabelle variieren.

Sie können die TaskStateUtil -Skripteinbindung in jedem Serverskript aufrufen, um inaktive Status, Standardarbeit oder Standardabschlussstatus für eine Tabelle zu bestimmen.

Die erforderlichen Attribute werden in der Tabelle „plane_task" definiert, sodass alle geplanten Aufgabentypen unterstützt werden. Wir werden die Attribute schließlich zu anderen Aufgabentypen und schließlich zur Basis-Aufgabentabelle hinzufügen. Sie können dies tun, wenn Sie diese Funktion jetzt nutzen möchten.  
Diese Attribute können für das Dictionaryelement task.state oder für das Überschreiben von Dictionaries für erweiterte Aufgabentabellen definiert werden.{#c_TaskStateUtil__table_hv2_51h_1s__entry__2}

| Attribut | Definition |
|-|-|
| close_states | Eine durch Semikolons getrennte Liste von Statuswerten, die inaktiv sind, die verwendet wird, um festzustellen, ob die Aufgabe auf aktiv oder inaktiv gesetzt werden soll. |
| default_close_state | Optional. Attribut zum Definieren des Statuswerts des standardmäßigen Schließstatus, wenn Sie Business-Regeln definieren möchten, die eine Aufgabe automatisch schließen. Standard: 3, normalerweise „Abgeschlossen", wenn das Attribut nicht definiert ist. |
| default_work_state | Optional. Attribut zum Definieren des Statuswerts des Standardarbeitsstatus, wenn Sie Business-Regeln definieren möchten, die eine Aufgabe automatisch für die Bearbeitung festlegen. Standard: 2, normalerweise „In Arbeit", wenn das Attribut nicht definiert ist. |
[Tabelle : 1. Zugehörige Attribute]

{#c_TaskStateUtil__table_hv2_51h_1s}

## TaskStateUtil -- TaskStateUtil(GlideRecord task) {#ariaid-title2}

Erstellt ein TaskStateUtil-Objekt.
{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| task | GlideRecord | Dies muss ein GlideRecord aus einer Aufgabentabelle sein. |
[Tabelle : 2. Parameter]

{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s}  

    var stateUtil = new TaskStateUtil(current);

## TaskStateUtil -- ATTR_DEFAULT_WORK {#ariaid-title3}

Der Name des Attributs, das den standardmäßigen Bearbeitungsstatus angibt.
{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_DEFAULT_WORK | Zeichenfolge | Gibt den standardmäßigen Bearbeitungsstatus an. Wert: default_work_state |
[Tabelle : 3. Feld]

{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs}

## TaskStateUtil -- ATTR_DEFAULT_CLOSE {#ariaid-title4}

Der Name des Attributs, das den standardmäßigen geschlossenen Status angibt.
{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_DEFAULT_CLOSE | Zeichenfolge | Gibt den standardmäßigen geschlossenen Status an. Wert: default_close_state |
[Tabelle : 4. Feld]

{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs}

## TaskStateUtil -- ATTR_INACTIVE_STATES {#ariaid-title5}

Der Name des Attributs, das inaktive Status kennzeichnet.
{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_INACTIVE_STATES | Zeichenfolge | Identifiziert inaktive Zustände. Wert: close_states |
[Tabelle : 5. Feld]

{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs}

## TaskStateUtil -- SYSTEM_DEFAULT_CLOSE {#ariaid-title6}

Der Wert für den standardmäßigen geschlossenen Status in der Aufgabentabelle ist „Geschlossen".
{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_DEFAULT_CLOSE | Ganzzahl | Der Wert für den standardmäßigen geschlossenen Status in der Aufgabentabelle ist „Geschlossen". Wert: 3 |
[Tabelle : 6. Feld]

{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs}

## TaskStateUtil -- SYSTEM_DEFAULT_WORK {#ariaid-title7}

Der Wert des standardmäßigen Bearbeitungsstatus in der Aufgabentabelle ist „In Bearbeitung".
{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_DEFAULT_WORK | Ganzzahl | Der Wert des standardmäßigen Bearbeitungsstatus in der Aufgabentabelle ist „In Bearbeitung". Wert: 2 |
[Tabelle : 7. Feld]

{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs}

## TaskStateUtil -- SYSTEM_INACTIVE_STATES {#ariaid-title8}

Die Werte der standardmäßig inaktiven Status: „Geschlossen", „Geschlossen -- unvollständig", „Geschlossen -- übersprungen" in der Aufgabentabelle.
{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_INACTIVE_STATES | Ganzzahliges Array | Werte der standardmäßig inaktiven Status: „Geschlossen", „Geschlossen -- unvollständig", „Geschlossen -- übersprungen" in der Aufgabentabelle. Wert: 3, 4, 7 |
[Tabelle : 8. Feld]

{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs}

## TaskStateUtil -- getDefaultCloseState {#ariaid-title9}

Gibt den Wert für den standardmäßigen geschlossenen Status zurück.
Der Standardwert für den geschlossenen Status ist 3, wenn das Attribut „default_close_state" nicht angegeben wurde.
{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s} {#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s__entry__2}

| Typ | Beschreibung |
|-|-|
| Zahl | Statuswert, der den geschlossenen Status darstellt. |
[Tabelle : 10. Ergebnisse]

{#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the close state
    var defaultCloseState =  stateUtil.getDefaultCloseState();
    current.state = defaultCloseState;

## TaskStateUtil -- getDefaultWorkState() {#ariaid-title10}

Gibt den Wert für den standardmäßigen Bearbeitungsstatus zurück.
Der Standardwert für den Bearbeitungsstatus ist 2, wenn das Attribut „default_work_state" nicht angegeben wurde.
{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s} {#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s__entry__2}

| Typ | Beschreibung |
|-|-|
| Zahl | Der Statuswert, der den Bearbeitungsstatus darstellt. |
[Tabelle : 12. Ergebnisse]

{#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the work state
    var defaultWorkState =  stateUtil.getDefaultWorkState();
    current.state = defaultWorkState;

## TaskStateUtil -- getInactiveStates {#ariaid-title11}

Gibt eine Liste der inaktiven Statuswerte zurück.
{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s} {#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Array von Statuswerten, die inaktiv sind. |
[Tabelle : 14. Ergebnisse]

{#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the inactive state values
    var inactiveStates = stateUtil.getInactiveStates();

## TaskStateUtil -- isStateInactive(String state) {#ariaid-title12}

Gibt den aktiven Status des angegebenen Status zurück.
{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| state | Zeichenfolge | Der zu überprüfende Statuswert. |
[Tabelle : 15. Parameter]

{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s} {#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „True", wenn der Status „Inaktiv" ist. |
[Tabelle : 16. Ergebnisse]

{#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s}  

    var stateUtil = new TaskStateUtil(current);
    var previousStateInactive = stateUtil.isStateInactive(previous.state);
    var currentStateInactive = stateUtil.isStateInactive(current.state);

## TaskStateUtil -- runMarkClosed {#ariaid-title13}

Entscheidet, ob die Geschäftsregel mark closed ausgeführt werden soll oder nicht.
{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 17. Parameter]

{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s} {#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Ob die Business Rule ausgeführt werden darf oder nicht. |
[Tabelle : 18. Ergebnisse]

{#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s}

## TaskStateUtil -- runTaskCloser {#ariaid-title14}

Entscheidet, ob die Geschäftsregel task closer ausgeführt werden soll oder nicht.
{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 19. Parameter]

{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs} {#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Bestimmt, ob die Business Rule ausgeführt werden darf oder nicht. |
[Tabelle : 20. Ergebnisse]

{#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs}

## TaskStateUtil -- runTaskReopener {#ariaid-title15}

Entscheidet, ob die Geschäftsregel task reopener ausgeführt werden soll oder nicht.
{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 21. Parameter]

{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s} {#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Ob die Business Rule ausgeführt werden darf oder nicht. |
[Tabelle : 22. Ergebnisse]

{#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s}

## TaskStateUtil -- setDefaultWorkState(String defaultWorkState) {#ariaid-title16}

Ermöglicht dem Benutzer, seinen eigenen standardmäßigen Bearbeitungsstatus anzugeben.
{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| defaultWorkState | Zeichenfolge | Der für den standardmäßigen Bearbeitungsstatus zu verwendende Wert. |
[Tabelle : 23. Parameter]

{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s} {#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s__entry__2}

| Typ | Beschreibung |
|-|-|
| TaskStateUtil | Eine Selbstreferenz, um die Verkettung von Methoden zu ermöglichen. |
[Tabelle : 24. Ergebnisse]

{#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s}