CMDBDuplicateTemplateUtil — Global

A inclusão de script CMDBDuplicateTemplateUtil fornece métodos para adicionar e remover tarefas de desduplicação de/para um modelo de desduplicação.

Para obter mais informações sobre desduplicação de ICs, tarefas de desduplicação e modelos de desduplicação, consulte Duplicate CIs remediation.

CMDBDuplicateTemplateUtils - CMDBDuplicateTemplateUtils()

Cria uma instância da classe CMDBDuplicateTemplateUtils.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

O exemplo de código a seguir mostra como chamar este método para criar um objeto CMDBDuplicateTemplateUtils.

var dupTemp = new CMDBDuplicateTemplateUtils();

CMDBDuplicateTemplateUtils - addTasksToTemplate(cadeia de caracteres templateId, matriz taskIds)

Adiciona uma ou mais tarefas de desduplicação a um modelo de desduplicação especificado.

Este método substitui todos os valores de modelo existentes, mas registra os valores anteriores de cada modelo nos logs do sistema.

A lista a seguir descreve cenários em que uma tarefa não é adicionada a um modelo e é marcada como ignorada ou com falha:

• O modelo especificado não está no estado publicado. Todas as tarefas são marcadas como ignoradas.
• O modelo especificado está em execução. Todas as tarefas são marcadas como ignoradas.
• A tarefa não está no estado aberto. A tarefa é marcada como ignorada.
• A tarefa não é compatível com o modelo especificado. Por exemplo, o modelo especificado pode ser criado para o servidor de aplicações Tomcat, mas a tarefa de desduplicação especificada é criada para o servidor Linux. A tarefa é marcada como ignorada.
• O modelo especificado não existe. Todas as tarefas são marcadas como com falha.
• A atualização do GlideRecord para a coluna de modelo na tarefa falha. A tarefa é marcada como falha.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
templateId	Cadeia de caracteres	Sys_id do modelo de desduplicação a ser associado à tarefa de desduplicação.
taskIds	Matriz	Lista de sys_ids das tarefas de desduplicação a serem associadas ao modelo especificado.

Tabela 3. Retorna

Tipo	Descrição
Objeto	Objeto de resultado que contém o status de todas as tarefas que tentaram ser associadas ao modelo especificado. Tipo de dados: objeto { "failed": [Array], "skipped": [Array], "success": [Array], "summary": "String" }
falha	Lista de tarefas que não foram associadas ao modelo. Tipo de dados: matriz de objetos "failed": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
falha.taskId	Sys_id de uma tarefa que falhou ao ser associada ao modelo. Tipo de dados: cadeia de caracteres
falha.mensagem	Mensagem que descreve por que a tarefa não foi associada ao modelo. Tipo de dados: cadeia de caracteres
falha.messageType	Motivo da falha. Tipo de dados: cadeia de caracteres
ignorado	Lista de tarefas que não falharam, mas não foram associadas ao modelo (ignoradas). Tipo de dados: matriz de objetos "skipped": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
ignorado.taskId	Sys_id de uma tarefa que o método ignorou associada ao modelo. Tipo de dados: cadeia de caracteres
mensagem.ignorada	Mensagem que descreve por que a tarefa foi ignorada. Tipo de dados: cadeia de caracteres
ignorado.messageType	Motivo para a tarefa ser ignorada. Tipo de dados: cadeia de caracteres
êxito	Lista de tarefas que foram associadas com sucesso ao modelo. Tipo de dados: matriz de objetos "success": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
sucesso.taskId	Sys_id de uma tarefa que foi associada ao modelo. Tipo de dados: cadeia de caracteres
sucesso.mensagem	Não está em uso no momento. Tipo de dados: cadeia de caracteres
sucesso.messageType	Não está em uso no momento. Tipo de dados: cadeia de caracteres
resumo	Breve descrição de todos os erros gerais de processamento ocorridos, por exemplo, se o modelo especificado não existir. Tipo de dados: cadeia de caracteres

O exemplo de código a seguir mostra como chamar este método para adicionar tarefas de desduplicação a um modelo de desduplicação.

// Add tasks to template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().addTasksToTemplate("6b43105c37301000deeabfc8bcbe5db2", taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);
gs.info(Summary: ' + result.summary);

Saída:

Success: [
    {
      "taskId": "f785a2c3d7012201de92a5f75e610398",
      "message": "",
      "messageType": ""
    }
  ]
Failed: [
    {
      "taskId": "96d2d25113152200eef2dd828144b0a4",
      "message": "Failed to add task 96d2d25113152200eef2dd828144b0a4 to template 6b43105c37301000deeabfc8bcbe5db2 because there were update errors.",
      "messageType": "update_failed"
    }
  ]
Skipped: [
    {
      "taskId": "635dd3dbc128ce0100655f1ec66ed41d",
      "message": "Cannot add de-duplication task(s) to template 6b43105c37301000deeabfc8bcbe5db2 because the template is not published. Publish the template before adding tasks.",
      "messageType": "unpublished_template"
    }
  ]
Summary:

CMDBDuplicateTemplateUtils - removeTemplateFromTask(TaskIds de matriz)

Limpa o valor do modelo de desduplicação nos registros de tarefa de desduplicação especificados. Ao limpar este valor, a associação entre um modelo e a tarefa é removida.

A lista a seguir descreve cenários em que o valor do modelo não é removido do registro da tarefa e é marcado como ignorado ou com falha:

• O modelo de desduplicação associado à tarefa está em execução. A tarefa é marcada como ignorada.
• O estado da tarefa é "trabalho em andamento" ou a tarefa não foi encontrada. A tarefa é marcada como ignorada.
• A atualização do GlideRecord para a coluna de modelo na tarefa falha. A tarefa é marcada como falha.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
taskIds	Matriz	Lista de sys_ids dos registros de tarefa de desduplicação dos quais o valor do modelo de desduplicação será limpo.

Tabela 5. Retorna

Tipo	Descrição
Objeto	Objeto de resultado que contém a contagem de tarefas para as quais a remoção do valor do modelo foi bem-sucedida, ignorada ou falhou. { "failed": Number, "success": Number, "skipped": Number }
falha	Número de tarefas que falharam ao remover o valor do modelo de desduplicação. Tipo de dados: número
êxito	Número de tarefas que removeram com sucesso o valor do modelo de desduplicação. Tipo de dados: número
ignorado	Número de tarefas que o método ignorou ao remover o valor do modelo de desduplicação. Tipo de dados: número

O exemplo de código a seguir mostra como chamar este método para remover valores de modelo de desduplicação de registros de tarefa de desduplicação.

// Remove tasks from template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().removeTemplateFromTasks(taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);

Saída:

Success: 2
Failed: 0
Skipped: 1