TaskStateUtil - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • . TaskStateUtil a inclusão de script 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ócios 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.

    Você pode ligar para TaskStateUtil inclusão de script 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 planned_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 de 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.
    default_close_state Opcional. Atributo para definir o valor de estado do estado de fechamento padrão se você quiser definir regras de negócio que encerram automaticamente uma tarefa.

    Padrão: 3, normalmente encerrado como concluído se o atributo não estiver definido.

    default_work_state Opcional. Atributo para definir o valor de estado do estado de trabalho padrão se você quiser definir regras de negócios que definem automaticamente uma tarefa para 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 Este 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 concluído na tabela Tarefa.

    Tabela 6. Campo
    Nome Tipo Descrição
    SYSTEM_DEFAULT_CLOSE Inteiro O valor do estado de fechamento padrão é Encerrado concluído na tabela Tarefa. Valor: 3

    TASKSTATEUTIL - SYSTEM_DEFAULT_WORK

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

    Tabela 7. Campo
    Nome Tipo Descrição
    SYSTEM_DEFAULT_WORK Inteiro O valor do estado de trabalho padrão é Trabalho em andamento na tabela Tarefa. 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
    SYSTEM_INACTIVE_STATES Matriz inteira Valores dos estados inativos padrão: Encerrado concluído, Encerrado incompleto, Encerrado ignorado na tabela Tarefa. Valor: 3, 4, 7

    TaskStateUtil - getDefaultCloseState

    Retorna o valor do estado Encerrado padrão.

    O valor do estado Encerrado 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 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 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 de 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 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. Retornos
    Tipo Descrição
    Booliano Verdadeiro se o estado estiver inativo.
    var stateUtil = new TaskStateUtil(current);
    var previousStateInactive = stateUtil.isStateInactive(previous.state);
    var currentStateInactive = stateUtil.isStateInactive(current.state);

    TaskStateUtil - runMarkClosed

    Decide se mark closeda regra de negócio 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 task closera regra de negócio 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 task reopenera regra de negócio 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
    DefaultWorkState Cadeia de caracteres O valor a ser usado para o estado de trabalho padrão.
    Tabela 24. Retornos
    Tipo Descrição
    TaskStateUtil Uma autorreferência para permitir o encadeamento de métodos.