UniversalTaskUtils - com escopo, global

A inclusão de script UniversalTaskUtils fornece métodos para gerenciar tarefas universais.

Com a aplicação Tarefa universal ServiceNow, os agentes podem criar tarefas para os funcionários. Por exemplo, os agentes podem solicitar informações adicionais ou solicitar uma ação para resolver um tíquete ou solicitação primária. As tarefas universais estão disponíveis para qualquer tipo de tíquete que estenda a tabela Tarefa [task].

Usando esta inclusão de script, você pode mudar o estado das tarefas universais ativas para "Concluído" ou "Cancelado", obter todas as tarefas universais ativas para uma tarefa primária especificada, verificar se uma tarefa universal primária tem secundárias e aplicar modelos a uma tarefa universal registro. Você pode usar esses métodos em scripts e nos construtores de condição Visable no formulário Configuração de guia para gerenciar os dados que aparecem na guia Tarefa universal. Para obter informações adicionais, consulte Adicionar uma guia de tarefa na página Tíquete padrão.

Você pode usar esta inclusão de script em aplicações com escopo e globais. A aplicação Tarefa universal (sn_uni_task) deve ser instalada na instância associada para ter acesso a esta inclusão de script. Você sempre deve especificar o namespace sn_uni_task ao chamar métodos nesta API.

Para obter informações adicionais sobre a aplicação Tarefa universal, consulte Tarefa universal.

UniversalTaskUtils - applyTemplate(cadeia de caracteres templateSysId, GlideRecord uniTaskGr)

Aplica o modelo de tarefa universal especificado ao registro de tarefa universal especificado.

Antes de usar este método, deve haver modelos de tarefa universal configurados em sua instância. Para obter detalhes, consulte Modelos de tarefa universal.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
templateSysId	Cadeia de caracteres	Sys_id do modelo de tarefa universal a ser aplicado ao registro de tarefa universal especificado. Tabela: modelo de tarefa universal [sn_uni_task_template]
uniTaskGr	GlideRecord	GlideRecord do registro de tarefa universal ao qual o modelo será aplicado.

Tabela 2. Retornos

Tipo	Descrição
Nenhum(a)	Todos os erros são gravados no log do sistema.

Este exemplo de código mostra uma função que adquire e aplica o modelo de feedback.

(function executeRule(current, previous /*null when async*/) {
  var templateGr = new GlideRecord('sn_uni_task_template');
  templateGr.get('name','Feedback Template');
  var templateSysId = templateGr.getValue('sys_id');
  new sn_uni_task.UniversalTaskUtils().applyTemplate (templateSysId,current);
})(current, previous);

UniversalTaskUtils - getActiveChildTasks(cadeia de caracteres parentSysId)

Retorna os registros de tarefa secundária ativos, na forma de um GlideRecord, para o tíquete primário especificado.

Você pode usar a API GlideRecord, com escopo ou global, dependendo do escopo da aplicação de chamada, para acessar os dados retornados, como usar o método getRowCount() para contar tarefas ativas.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
parentSysId	Cadeia de caracteres	Sys_id do tíquete primário cujos tíquetes secundários ativos serão retornados.

Tabela 4. Retornos

Tipo	Descrição
GlideRecord	GlideRecord que contém todos os registros de tarefa secundária ativos para a tarefa primária especificada.

O exemplo a seguir mostra uma função que obtém todas as tarefas secundárias ativas para o sys_id atual e usa getRowCount() para obter o número de tarefas secundárias ativas.

(function executeRule(current, previous /*null when async*/) {
  var gr_ActiveTasks = new sn_uni_task.UniversalTaskUtils().getActiveChildTasks(current.sys_id);
  var count = gr_ActiveTasks.getRowCount();
})(current, previous);

UniversalTaskUtils - hasTasksToShow (GlideRecord atual)

Verifica se o tíquete primário especificado tem tarefas universais que estão no estado trabalho em andamento ou concluído.

Você pode usar este método para determinar se a guia Tarefa universal deve ser mostrada a um solicitante em uma configuração de tíquete padrão somente se houver tarefas em andamento ou concluídas.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
atual	GlideRecord	GlideRecord do tíquete primário a ser verificado.

Tabela 6. Retornos

Tipo	Descrição
sys_id	Se as tarefas universais estiverem associadas ao tíquete primário, o sys_id do tíquete primário; caso contrário, nulo. Tipo de dados: cadeia de caracteres

O exemplo a seguir mostra uma função que chama este método para verificar se há tarefas universais.

(function executeRule(current, previous /*null when async*/) {
  var sysId = new sn_uni_task.UniversalTaskUtils().hasTasksToShow(current);           
})(current, previous);

UniversalTaskUtils - markActiveChildTasksCancelled(cadeia de caracteres parentSysId)

Altera o estado de todas as tarefas universais ativas no tíquete primário especificado para "Cancelado".

Tabela 7. Parâmetros

Nome	Tipo	Descrição
parentSysId	Cadeia de caracteres	Sys_id do tíquete primário cujo estado das tarefas universais secundárias ativas deve ser alterado para "Cancelado".

Tabela 8. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo de código mostra como usar este método para atualizar os estados de todas as tarefas universais associadas à tarefa primária especificada para cancelado.

(function executeRule(current, previous /*null when async*/) {
  new sn_uni_task.UniversalTaskUtils().markActiveChildTasksCancelled(current.sys_id);
})(current, previous);

UniversalTaskUtils - markActiveChildTasksCompleted(cadeia de caracteres parentSysId)

Altera o estado de todas as tarefas universais secundárias ativas associadas ao tíquete primário especificado para "Concluído".

Tabela 9. Parâmetros

Nome	Tipo	Descrição
parentSysId	Cadeia de caracteres	Sys_id do tíquete primário cujo estado das tarefas universais secundárias ativas deve ser alterado para "Concluído".

Tabela 10. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo de código mostra como usar este método para atualizar os estados de todas as tarefas universais associadas à tarefa primária especificada para concluído.

(function executeRule(current, previous /*null when async*/) {
  new sn_uni_task.UniversalTaskUtils().markActiveChildTasksCompleted(current.sys_id);
})(current, previous);