---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CMDBDuplicateTemplateUtil - Global

# CMDBDuplicateTemplateUtil - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

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](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

## CMDBDuplicateTemplateUtils - CMDBDuplicateTemplateUtils() {#ariaid-title2}

Cria uma instância da classe CMDBDuplicateTemplateUtils.
{#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum(a) |   |   |
[Tabela 1. Parâmetros]

{#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb}  
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) {#ariaid-title3}

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 está 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 está marcada como ignorada.
* O modelo especificado não existe. Todas as tarefas são marcadas como com falha.
* A atualização de GlideRecord para a coluna de modelo na tarefa falha. A tarefa está marcada como falha.
{#CDupTempU-addTasksToTemplate_S_A__ul_b45_fmh_yxb}
{#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb__entry__3}

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

{#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb} {#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb__entry__2}

| 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": [ { "message": "String", "messageType: "String", "taskId": "String" } ] |
| falha.mensagem | Mensagem que descreve por que a tarefa não foi associada ao modelo. Tipo de dados: cadeia de caracteres |
| falhou.messageType | Motivo da falha. Tipo de dados: cadeia de caracteres |
| fail.taskId | Sys_id de uma tarefa que não foi associada ao modelo. 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": [ { "message": "String", "messageType: "String", "taskId": "String" } ] |
| mensagem.ignorada | Mensagem que descreve por que a tarefa foi ignorada. Tipo de dados: cadeia de caracteres |
| ignorado.tipo de mensagem | Motivo para a tarefa ser ignorada. Tipo de dados: cadeia de caracteres |
| ignorado.taskId | Sys_id de uma tarefa que o método ignorou associada ao modelo. Tipo de dados: cadeia de caracteres |
| êxito | Lista de tarefas que foram associadas com sucesso ao modelo. Tipo de dados: matriz de objetos "success": [ { "message": "String", "messageType: "String", "taskId": "String" } ] |
| sucesso.message | 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 |
| sucesso.taskId | Sys_id de uma tarefa que foi associada ao modelo. Tipo de dados: cadeia de caracteres |
| resumo | Breve descrição de quaisquer erros gerais de processamento ocorridos, por exemplo, se o modelo especificado não existir. Tipo de dados: cadeia de caracteres |
[Tabela 3. Retorna]

{#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb}  
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(Matriz taskIds) {#ariaid-title4}

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 está marcada como ignorada.
* O estado da tarefa é "trabalho em andamento" ou a tarefa não foi encontrada. A tarefa está marcada como ignorada.
* A atualização de GlideRecord para a coluna de modelo na tarefa falha. A tarefa está marcada como falha.
{#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb__entry__3}

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

{#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb} {#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb__entry__2}

| 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 |
[Tabela 5. Retorna]

{#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb}  
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