TaskStateUtil - Global

A API TaskStateUtil está na inclusão de script do utilitário de gerenciamento de estado da tarefa e é usada para trabalhar com atributos de estado da tabela de tipo de tarefa.

Esta API é usada principalmente pela regra de negócio Gestão de estado ativo da 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.

A API TaskStateUtil pode ser chamada por 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 resolved_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.

Tabela 1. Atributos relacionados

Atributo	Definição
close_states	Lista delimitada por ponto e vírgula de valores de estado inativos, usada para identificar se a tarefa deve ser definida como ativa ou inativa. Este é um atributo necessário para usar a funcionalidade TaskStateUtil.
default_close_state	Atributo opcional para definir o valor do estado de fechamento padrão se você quiser definir regras de negócios que fecham automaticamente uma tarefa. O padrão é 3, normalmente Encerrado concluído se o atributo não estiver definido.
default_work_state	Atributo opcional para definir o valor do estado de trabalho padrão se você quiser definir regras de negócios que definem automaticamente uma tarefa como trabalho. O padrão é 2, normalmente Trabalho em andamento se o atributo não estiver definido.

TaskStateUtil - ATTR_DEFAULT_WORK

O nome do atributo que identifica o estado de trabalho padrão.

Tabela 2. Campo

Nome	Tipo	Descrição
ATTR_DEFAULT_WORK	Cadeia de caracteres	Identifica o estado de trabalho padrão. Valor: default_work_state

TaskStateUtil - ATTR_DEFAULT_CLOSE

O nome do atributo que identifica o estado de encerramento padrão.

Tabela 3. Campo

Nome	Tipo	Descrição
ATTR_DEFAULT_CLOSE	Cadeia de caracteres	Identifica o estado de fechamento padrão. Valor: default_close_state

TaskStateUtil - ATTR_INACTIVE_STATES

O nome do atributo que identifica estados inativos.

Tabela 4. Campo

Nome	Tipo	Descrição
ATTR_INACTIVE_STATES	Cadeia de caracteres	Identifica estados inativos. Valor: close_states

TaskStateUtil - getDefaultCloseState

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.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Número	Valor do estado que representa o estado encerrado.

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

TaskStateUtil – getDefaultWorkState()

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.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Número	O valor do estado que representa o estado de trabalho.

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

TaskStateUtil - getInactiveStates

Retorna uma lista dos valores de estado inativos.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Matriz	Matriz de valores de estado que estão inativos.

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

TaskStateUtil - isStateInactive(cadeia de caracteres estado)

Retorna o status ativo do estado especificado.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Estado	Cadeia de caracteres	O valor do estado a ser verificado.

Tabela 12. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o estado for inativo.

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

TaskStateUtil - runMarkClosed

Decide se a regra de negócios mark closed deve ser executada ou não.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Booliano	Se a regra de negócios deve ter permissão para ser executada ou não.

TaskStateUtil - runTaskCloser

Decide se a regra de negócios task closer deve ser executada ou não.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

Tipo	Descrição
Booliano	Determina se a regra de negócios deve ter permissão para ser executada ou não.

TaskStateUtil - runTaskReopener

Decide se a regra de negócios task reopener deve ser executada ou não.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
Booliano	Se a regra de negócios deve ter permissão para ser executada ou não.

TaskStateUtil - setDefaultWorkState(cadeia de caracteres defaultWorkState)

Permite que o usuário especifique seu próprio estado de trabalho padrão.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
defaultWorkState	Cadeia de caracteres	O valor a ser usado para o estado de trabalho padrão.

Tabela 20. Retorna

Tipo	Descrição
TaskStateUtil	Uma autorreferência para permitir o encadeamento de métodos.

TaskStateUtil -SYSTEM_DEFAULT_CLOSE

O valor do estado de encerramento padrão é Encerrado concluído na tabela de tarefas.

Tabela 21. Campo

Nome	Tipo	Descrição
SISTEMA_DEFAULT_CLOSE	Inteiro	O valor do estado de encerramento padrão é Encerrado concluído na tabela de tarefas. Valor: 3

TaskStateUtil -SYSTEM_DEFAULT_WORK

O valor do estado de trabalho padrão é Trabalho em andamento na tabela de tarefas.

Tabela 22. Campo

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

TaskStateUtil -SYSTEM_INACTIVE_STATES

Os valores dos estados inativos padrão: Encerrado concluído, Encerrado incompleto, Encerrado ignorado na tabela de tarefas.

Tabela 23. Campo

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

TaskStateUtil - TaskStateUtil(tarefa GlideRecord)

Cria um objeto TaskStateUtil.

Tabela 24. Parâmetros

Nome	Tipo	Descrição
tarefa	GlideRecord	Deve ser um GlideRecord de uma tabela de tarefas.

var stateUtil = new TaskStateUtil(current);