TaskStateUtil - Global

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.

Tabela 1. Atributos relacionados

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.

TaskStateUtil - TaskStateUtil(tarefa GlideRecord)

Cria um objeto TaskStateUtil.

Tabela 2. Parâmetros

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

var stateUtil = new TaskStateUtil(current);

TaskStateUtil – ATTR_DEFAULT_WORK

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

Tabela 3. 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 fechamento padrão.

Tabela 4. 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 5. Campo

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

TaskStateUtil – SYSTEM_DEFAULT_CLOSE

O valor do estado de fechamento padrão é Encerrado e Concluído na Tabela de tarefas.

Tabela 6. Campo

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

TaskStateUtil – SYSTEM_DEFAULT_WORK

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

Tabela 7. 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 8. 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 – 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 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

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

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 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. 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 inativo.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. 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 (estado da cadeia de caracteres)

Retorna o status ativo do estado especificado.

Tabela 15. Parâmetros

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

Tabela 16. 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ócio mark closed 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ócio deve ter permissão para ser executada ou não.

TaskStateUtil - runTaskCloser

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

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

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

TaskStateUtil - runTaskReopener

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

Tabela 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

Tipo	Descrição
Booliano	Se a regra de negócio 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 23. Parâmetros

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

Tabela 24. Retorna

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