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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AufgabenstatusUtil -- Global

# AufgabenstatusUtil -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die AufgabenstatusUtil Die Skripteinbindung stellt Methoden für die Arbeit mit Tabellenstatusattributen vom Aufgabentyp bereit.

Diese Skripteinbindung wird hauptsächlich von der Business-Regel „Verwaltung des aktiven Status" für Aufgaben verwendet, um das Feld „aktiv" basierend auf Statusänderungen festzulegen. Konfigurationen werden im Wörterbuchelement „Task.State" definiert, wobei normalerweise Wörterbuchüberschreibungen verwendet werden, da Statuswerte je nach Tabelle variieren.

Sie können anrufen AufgabenstatusUtil Skripteinbindung in jedes Serverskript, um inaktive status, standardarbeitsstatus oder standardmäßige abschlussstatus für eine Tabelle zu bestimmen.

Die erforderlichen Attribute sind in der Tabelle planned_Task definiert, sodass alle geplanten Aufgabentypen unterstützt werden. Wir fügen die Attribute schließlich anderen Aufgabentypen und schließlich der Basisaufgabentabelle hinzu. Sie können dies tun, wenn Sie diese Funktion jetzt nutzen möchten.  
Diese Attribute können im Wörterbuchelement „Task.State" oder einer Wörterbuchüberschreibung für erweiterte Aufgabentabellen definiert werden.{#c_TaskStateUtil__table_hv2_51h_1s__entry__2}

| Attribut | Definition |
|-|-|
| close_states | Durch Semikolon getrennte Liste von Statuswerten, die inaktiv sind, wird verwendet, um zu identifizieren, ob die Aufgabe auf „aktiv" oder „inaktiv" festgelegt werden soll. |
| default_close_state | Optional. Attribut zum Definieren des Statuswerts des standardmäßigen Abschlussstatus, 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 standardmäßigen Arbeitsstatus, wenn Sie Business-Regeln definieren möchten, die eine Aufgabe automatisch für die Arbeit festlegen. Standard: 2, normalerweise in Bearbeitung, wenn das Attribut nicht definiert ist. |
[Tabelle : 1. Zugehörige Attribute]

{#c_TaskStateUtil__table_hv2_51h_1s}

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

Erstellt ein TaskStateUtil-Objekt.
{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Aufgabe | 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 Standardarbeitsstatus identifiziert.
{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_DEFAULT_WORK | Zeichenfolge | Gibt den standardmäßigen Arbeitsstatus 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 Abschlussstatus identifiziert.
{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_DEFAULT_CLOSE | Zeichenfolge | Gibt den standardmäßigen Abschlussstatus 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 identifiziert.
{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ATTR_INACTIVE_STATES | Zeichenfolge | Identifiziert inaktive status. Wert: CLOSE_states |
[Tabelle : 5. Feld]

{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs}

## TASKSTATEUTIL -- SYSTEM_DEFAULT_CLOSE {#ariaid-title6}

Der Wert des standardmäßigen Abschlussstatus ist „Abgeschlossen" in der Aufgabentabelle.
{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_DEFAULT_CLOSE | Ganzzahl | Der Wert des standardmäßigen Abschlussstatus ist „Abgeschlossen" in der Aufgabentabelle. Wert: 3 |
[Tabelle : 6. Feld]

{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs}

## TASKSTATEUTIL: SYSTEM_DEFAULT_WORK {#ariaid-title7}

Der Wert des Standardstatus „Arbeit" ist in der Aufgabentabelle „in Bearbeitung".
{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_DEFAULT_WORK | Ganzzahl | Der Wert des Standardstatus „Arbeit" ist in der Aufgabentabelle „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äßigen inaktiven status: „Abgeschlossen", „unvollständig geschlossen", „als übersprungen geschlossen" in der Aufgabentabelle.
{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SYSTEM_INACTIVE_STATES | Ganzzahl-Array | Werte der standardmäßigen inaktiven status: „Abgeschlossen", „unvollständig geschlossen", „als übersprungen geschlossen" 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 Status „Geschlossen" zurück.
Der standardmäßige Wert für den Status „Geschlossen" 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 |
|-|-|
| Nummer | Statuswert, der den Status „Geschlossen" darstellt. |
[Tabelle : 10. Rückgaben]

{#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 Arbeitsstatus zurück.
Der Standardwert für den Arbeitsstatus 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 |
|-|-|
| Nummer | Der Statuswert, der den Arbeitsstatus darstellt. |
[Tabelle : 12. Rückgaben]

{#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. Rückgaben]

{#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s}  

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

## TaskStateUtil -- isStateInactive(Zeichenfolgenstatus) {#ariaid-title12}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Staat | 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 | „Wahr", wenn der Status „Inaktiv" ist. |
[Tabelle : 16. Rückgaben]

{#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 mark closedBusiness-Regel muss ausgeführt werden 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 | Gibt an, ob die Business-Regel ausgeführt werden soll oder nicht. |
[Tabelle : 18. Rückgaben]

{#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s}

## TaskStateUtil: RunTaskCloser {#ariaid-title14}

Entscheidet, ob task closerBusiness-Regel muss ausgeführt werden 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-Regel ausgeführt werden darf oder nicht. |
[Tabelle : 20. Rückgaben]

{#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs}

## TaskStateUtil: RunTaskReopener {#ariaid-title15}

Entscheidet, ob task reopenerBusiness-Regel muss ausgeführt werden 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 | Gibt an, ob die Business-Regel ausgeführt werden soll oder nicht. |
[Tabelle : 22. Rückgaben]

{#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s}

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

Ermöglicht dem Anwender, seinen eigenen Standardarbeitsstatus anzugeben.
{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| DefaultWorkState | Zeichenfolge | Der Wert, der für den standardmäßigen Arbeitsstatus verwendet werden soll. |
[Tabelle : 23. Parameter]

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

| Typ | Beschreibung |
|-|-|
| AufgabenstatusUtil | Eine Selbstreferenz, um die Methodenverkettung zu ermöglichen. |
[Tabelle : 24. Rückgaben]

{#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s}

