---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# TaskStateUtil - Global

# TaskStateUtil - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

A inclusão de script TaskStateUtil fornece métodos para trabalhar com atributos de estado da tabela do tipo tarefa.

Esta inclusão de script é usada principalmente pela regra de negócio Gestão de estados ativos de tarefa para definir o campo ativo com base nas mudanças de estado. As configurações são definidas no elemento de dicionário task.state, geralmente usando substituições de dicionário, já que os valores de estado variam de acordo com a tabela.

Você pode chamar a inclusão de script TaskStateUtil em qualquer script de servidor para determinar estados inativos, trabalho padrão ou estados de fechamento padrão para uma tabela.

Os atributos necessários são definidos na tabela translated_task para que todos os tipos de tarefa planejada sejam compatíveis. Eventualmente, adicionaremos os atributos a outros tipos de tarefa e, eventualmente, à tabela de tarefas base. Você está livre para fazer isso se quiser aproveitar este recurso agora.  
Esses atributos podem ser definidos no elemento de dicionário task.state ou em uma substituição de dicionário para tabelas de tarefas estendidas.{#c_TaskStateUtil__table_hv2_51h_1s__entry__2}

| Atributo | Definição |
|-|-|
| close_states | Lista delimitada por ponto e vírgula de valores de estado que estão inativos, usada para identificar se a tarefa deve ser definida como ativa ou inativa. |
| default_close_state | Opcional. Atributo para definir o valor do estado de fechamento padrão se você quiser definir regras de negócio que fecham automaticamente uma tarefa. Padrão: 3, normalmente Encerrado e Concluído se o atributo não estiver definido. |
| default_work_state | Opcional. Atributo para definir o valor do estado de trabalho padrão se você quiser definir regras de negócio que definem automaticamente uma tarefa como trabalho. Padrão: 2, normalmente Trabalho em andamento se o atributo não estiver definido. |
[Tabela 1. Atributos relacionados]

{#c_TaskStateUtil__table_hv2_51h_1s}

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

Cria um objeto TaskStateUtil.
{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tarefa | GlideRecord | Deve ser um GlideRecord de uma tabela de tarefas. |
[Tabela 2. Parâmetros]

{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s}  

    var stateUtil = new TaskStateUtil(current);

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

O nome do atributo que identifica o estado de trabalho padrão.
{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ATTR_DEFAULT_WORK | Cadeia de caracteres | Identifica o estado de trabalho padrão. Valor: default_work_state |
[Tabela 3. Campo]

{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs}

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

O nome do atributo que identifica o estado de fechamento padrão.
{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ATTR_DEFAULT_CLOSE | Cadeia de caracteres | Identifica o estado de fechamento padrão. Valor: default_close_state |
[Tabela 4. Campo]

{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs}

## TaskStateUtil - ATTR_INACTIVE_STATES {#ariaid-title5}

O nome do atributo que identifica estados inativos.
{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ATTR_INACTIVE_STATES | Cadeia de caracteres | Identifica estados inativos. Valor: close_states |
[Tabela 5. Campo]

{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs}

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

O valor do estado de fechamento padrão é Encerrado e Concluído na Tabela de tarefas.
{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| SISTEMA_DEFAULT_CLOSE | Inteiro | O valor do estado de fechamento padrão é Encerrado concluído na tabela de tarefas. Valor: 3 |
[Tabela 6. Campo]

{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs}

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

O valor do estado de trabalho padrão é Trabalho em andamento na Tabela de tarefas.
{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| SISTEMA_DEFAULT_WORK | Inteiro | O valor do estado de trabalho padrão é Trabalho em andamento na Tabela de tarefas. Valor: 2 |
[Tabela 7. Campo]

{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs}

## TaskStateUtil - SYSTEM_INACTIVE_STATES {#ariaid-title8}

Os valores dos estados inativos padrão: Encerrado concluído, Encerrado incompleto, Encerrado ignorado na Tabela de tarefas.
{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| SISTEMA_INATIVO_ESTADOS | Matriz de inteiros | Valores dos estados inativos padrão: Encerrado concluído, Encerrado incompleto, Encerrado ignorado na Tabela de tarefas. Valor: 3, 4, 7 |
[Tabela 8. Campo]

{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs}

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

Retorna o valor do estado fechado padrão.
O valor do estado fechado padrão será 3 se o atributo default_close_state não tiver sido especificado.
{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 9. Parâmetros]

{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s} {#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s__entry__2}

| Tipo | Descrição |
|-|-|
| Número | Valor do estado que representa o estado fechado. |
[Tabela 10. Retorna]

{#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}

Retorna o valor do estado de trabalho padrão.
O valor do estado de trabalho padrão será 2 se o atributo default_work_state não tiver sido especificado.
{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 11. Parâmetros]

{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s} {#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s__entry__2}

| Tipo | Descrição |
|-|-|
| Número | O valor do estado que representa o estado de trabalho. |
[Tabela 12. Retorna]

{#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}

Retorna uma lista dos valores de estado inativo.
{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 13. Parâmetros]

{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s} {#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Matriz de valores de estado que estão inativos. |
[Tabela 14. Retorna]

{#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s}  

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

## TaskStateUtil - isStateInactive (estado da cadeia de caracteres) {#ariaid-title12}

Retorna o status ativo do estado especificado.
{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Estado | Cadeia de caracteres | O valor do estado a ser verificado. |
[Tabela 15. Parâmetros]

{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s} {#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o estado for inativo. |
[Tabela 16. Retorna]

{#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}

Decide se a regra de negócio mark closed deve ser executada ou não.
{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 17. Parâmetros]

{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s} {#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Se a regra de negócio deve ter permissão para ser executada ou não. |
[Tabela 18. Retorna]

{#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s}

## TaskStateUtil - runTaskCloser {#ariaid-title14}

Decide se a regra de negócio task closer deve ser executada ou não.
{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 19. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Determina se a regra de negócio deve ter permissão para ser executada ou não. |
[Tabela 20. Retorna]

{#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs}

## TaskStateUtil - runTaskReopener {#ariaid-title15}

Decide se a regra de negócio task reopener deve ser executada ou não.
{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 21. Parâmetros]

{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s} {#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Se a regra de negócio deve ter permissão para ser executada ou não. |
[Tabela 22. Retorna]

{#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s}

## TaskStateUtil -- setDefaultWorkState(cadeia de caracteres defaultWorkState) {#ariaid-title16}

Permite que o usuário especifique seu próprio estado de trabalho padrão.
{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| estadoDeTrabalho padrão | Cadeia de caracteres | O valor a ser usado para o estado de trabalho padrão. |
[Tabela 23. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| TaskStateUtil | Uma autorreferência para permitir o encadeamento de métodos. |
[Tabela 24. Retorna]

{#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s}