DuplicateTemplate - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 26 min. de leitura

    • . DuplicateTemplate A API fornece métodos para que os usuários interajam com modelos de desduplicação aplicando um conjunto de validações para cada método.

    A correção de tarefa de desduplicação pode ser mais demorada do que o desejável quando tratada individualmente. Os modelos de duplicação permitem agrupar um conjunto de tarefas duplicadas e executá-las juntas. Use DuplicateTemplate API para criar e consumir modelos de desduplicação. Esta API é executada no sn_cmdb namespace e requer a função cmdb_dedup_admin para acessar.

    Quando uma instância detecta itens de configuração (ICs) duplicados durante a identificação e reconciliação, ela agrupa cada conjunto de ICs duplicados em uma tarefa de desduplicação para revisão e correção. As tarefas de desduplicação fornecem detalhes sobre a duplicação, incluindo uma lista de todos os ICs duplicados. Para obter informações, consulte Duplicate CIs remediation.

    Consulte também: IdentificationEngine - Com escopo

    Ciclo de vida do modelo
    1. Use CreateTemplate() método para criar um modelo no estado de rascunho.
      Você pode usar os seguintes métodos para recuperar ou atualizar o modelo:
    2. Use PublicTemplate() método para mover o modelo do estado rascunho para o estado publicado.
      Nota:
      Use UnPublishTemplate() método para retornar um modelo publicado ao estado de rascunho e atualizar o modelo.
    3. Opcional. Use CMDBDuplicateTemplateUtil inclusão de script para adicionar ou remover tarefas.
    4. Use RunTemplate() método para executar o modelo.

      Para cancelar uma tarefa em execução, use RequestCancelation() método.

    5. Se o modelo não for mais necessário, você poderá descontinuar o modelo usando RetireTemplate() método.
    Correção de uma única tarefa usando um modelo
    Para corrigir uma única tarefa sem executar o modelo, você pode visualizar e corrigir tarefas de desduplicação.
    1. Use PreviewTemplate() método para visualizar a correção de uma tarefa única com um modelo.
    2. Use RemediateTask() método para corrigir a tarefa de desduplicação com um modelo.

    DuplicateTemplate - canAddTasksToTemplate(Array taskIds, cadeia de caracteres templatId)

    Verifica se a lista de tarefas fornecida pode ser adicionada a um modelo.

    Use este método para determinar se as tarefas são adequadas para adicionar ao modelo. Por exemplo, o modelo especificado pode ser criado para o Servidor de aplicações Tomcat, mas as tarefas de desduplicação especificadas são criadas para o Servidor Linux. Essas tarefas não têm uma classe de modelo correspondente, portanto, não podem ser adicionadas ao modelo.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    taskIds Matriz Matriz de sys_ids das tarefas de desduplicação a serem adicionadas ao modelo.
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 2. Retornos
    Tipo Descrição
    Objeto Objeto de resultado que contém quais tarefas podem ser adicionadas, ignoradas ou com falha.
    {
  "success": [
    "<task_id_1>",
    "<task_id_2>",
    "<task_id_3>"
  ],
  "failed": [
    "<task_id_4>"
  ],
  "skipped": [
    "<task_id_5>"
  ]
}
    Falha(s) Ocorreu um erro ao verificar se a tarefa é compatível com o modelo. Consulte também Detecting duplicate CIs.
    ignorado As tarefas são incompatíveis porque não têm uma classe de modelo correspondente, portanto, a tarefa foi ignorada.
    êxito A tarefa corresponde à classe do modelo e pode ser adicionada ao modelo.

    O exemplo a seguir mostra como verificar se há tarefas que podem ser adicionadas ao modelo.

    var taskIds = [];
taskIds.push(<task_id_1>);
taskIds.push(<task_id_2>);
taskIds.push(<task_id_3>);

var result = sn_cmdb.DuplicateTemplate.canAddTasksToTemplate(taskIds, <template_id>);

gs.info('Success:' + result.success);
gs.info('Failed:' + result.failed);
gs.info('Skipped:' + result.skipped);

    Saída:

    Success: <task_id_1>
Failed: <task_id_2>
Skipped: <task_id_3>

    DuplicateTemplate - createTemplate(modelo de objeto)

    Cria um modelo de desduplicação no estado de rascunho.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    modelo Objeto O objeto de modelo com diferentes opções para criar o modelo. 
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    template.allow_null_​attribute_update Booliano Opcional. Sinalizador que indica se os atributos de IC principais são atualizados com valores nulos de ICs duplicados ao resolver conflitos de atributo para ICs em uma tarefa de desduplicação.
    Valores válidos:
    • Verdadeiro: Os atributos de IC principais são atualizados com valores nulos de ICs duplicados.
    • Falso: Os atributos de IC principais não são atualizados com valores nulos de ICs duplicados.

    Padrão: Falso
    template.allow_master_ci_​null_update Booliano Opcional. Só inclui atualizações de ICs duplicados se o valor de IC principal for nulo.

    Sinalizador que indica se incluir somente atualizações de ICs duplicados se o valor de IC principal for nulo.

    Valores válidos:
    • Verdadeiro: Incluir atualizações de ICs duplicados somente se o valor de IC principal for nulo.
    • Falso: Inclui atualizações de todos os ICs duplicados.

    Padrão: Falso
    template.description Cadeia de caracteres Opcional. Descrição para armazenar mais informações sobre o modelo.
    template.duplicate_​ci_action Cadeia de caracteres Opcional. Especifica se o IC duplicado deve ser excluído ou atualizado com valores personalizados exclusivos.
    Opções possíveis:
    • excluir
    • atualização (requer especificação duplicate_ci_updates)
    template.duplicate_​ci_updates Matriz Opcional, a menos que seja a configuração para duplicate_ci_action. atualização . Matriz de objetos que especificam como os valores de IC duplicados são atualizados.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    template.duplicate_​ci_updates.element Cadeia de caracteres O nome do dicionário do sistema de um campo de referência.
    template.duplicate_​ci_updates.element_label Cadeia de caracteres O rótulo que o campo de referência exibe.
    template.duplicate_​ci_updates.value Cadeia de caracteres Valor de um campo de referência, ou seja, o conteúdo do campo de referência.
    template.duplicate_​ci_updates.display Cadeia de caracteres Valor de exibição de um campo de referência.
    ​opção template.master_ci_ Cadeia de caracteres Opcional. Especifica como o IC principal é selecionado para uma tarefa de desduplicação ao aplicar este modelo.
    Opções possíveis:
    • condicional (deve especificar master_ci_condition)
    • MOST_related_items - Atributos a serem mesclados do IC com os itens mais relacionados ao IC principal.
    • MOST_relations - Atributos a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.
    • Newest_created - Atributos separados a serem mesclados do IC atualizado mais recentemente para o IC principal.
    • Oldest_created - Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.
    modelo.master_ci_ condição Cadeia de caracteres Opcional (obrigatório se o valor de master_ci_option. condicional ). Consulta codificada para especificar como o IC principal é selecionado. Se vários ICs ou nenhum ICs corresponder à consulta, o método selecionará o IC atualizado mais recentemente como o IC principal. A consulta codificada é avaliada para a tabela de modelo. Esta tabela é identificada em tablepropriedade.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.merge_relations Cadeia de caracteres Opcional. Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum
    template.merge_relations Cadeia de caracteres Opcional. Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum
    ​condição template.merge_relations_ Cadeia de caracteres Opcional (obrigatório se o valor de merge_relations. condicional ). Consulta codificada para especificar se todos ou nenhum dos relacionamentos de ICs duplicados são mesclados. A consulta é avaliada no IC principal selecionado para a tarefa de desduplicação. Se a consulta retornar verdadeiro, todos os relacionamentos serão mesclados. Se falso, nenhum relacionamento será mesclado.

    A consulta codificada é avaliada para a tabela de modelo. Esta tabela é identificada em tablepropriedade.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.merge_related_items Cadeia de caracteres Opcional. Especifica quais tabelas relacionadas para ICs duplicados em uma tarefa de desduplicação são mescladas ao IC principal ao aplicar este modelo. Consulte também Remediate a de-duplication task (manual).
    Opções possíveis:
    • All_available - Inclui as tabelas relacionadas ao padrão e todas as tabelas relacionadas que fazem referência a ICs duplicados para a tarefa de desduplicação corrigida por meio do modelo.
    • condicional
    • Padrão - Inclui entradas relacionadas fornecidas pelo módulo Itens relacionados padrão do remediador de IC duplicado.
    • nenhum
    ​condição template.merge_related_items_ Matriz Opcional. Lista de entradas relacionadas com uma consulta codificada para cada entrada relacionada. Cada consulta é avaliada no IC principal selecionado para a tarefa. Se a consulta retornar verdadeiro, as entradas relacionadas serão mescladas durante a correção de uma tarefa de desduplicação. Se falso, as entradas relacionadas não serão mescladas.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.most_relations_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.
    most_related_items_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC com os itens mais relacionados ao IC principal.
    template.name Cadeia de caracteres Nome do modelo.
    modelo.newest_updated_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC atualizado mais recentemente para o IC principal.
    modelo.oldest_created_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.
    template.table Cadeia de caracteres Tabela para a qual o modelo é criado.
    template.task_conditions Cadeia de caracteres Opcional. Consulta codificada a ser avaliada quando o modelo for executado. Esta consulta é avaliada na tabela Reconciliar dados de tarefa duplicados [reconciliar_duplicate_task_data]. Todas as tarefas retornadas desta consulta são consideradas durante a avaliação do modelo.
    Nota:
    Mesmo que uma tarefa seja retornada como parte da consulta, isso não garante que a execução do modelo processe a tarefa. Outros fatores podem fazer com que a tarefa seja ignorada durante o processamento do modelo.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    Tabela 4. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id do modelo criado na tabela Reconciliar modelos duplicados [reconciliar_duplicate_template].

    O exemplo a seguir mostra como criar um modelo de desduplicação.

    var template = {
  "name": "Test Windows Template",
  "table": "cmdb_ci_win_server",
  "description": "This is a Windows server template",
  "master_ci_option": "oldest_created",
  "master_ci_condition": "",
  "allow_null_attribute_update": false,
  "allow_master_ci_null_update": false,
  "oldest_created_merge_attributes": "serial_number,os_version",
  "merge_relations": "all",
  "merge_relations_condition": "",
  "merge_related_items": "conditional",
  "merge_related_items_condition": [
    {
      "related_entry": "change_request.cmdb_ci",
      "condition": "ramCONTAINS1024"
    },
    {
      "related_entry": "incident.cmdb_ci",
      "condition": "os_versionCONTAINSWindows"
    }
  ],
  "duplicate_ci_action": "delete",
  "duplicate_ci_updates":   [{
    "element": "ram",
    "element_label": "RAM (MB)",
    "value": "1024",
    "display": "1024"
  }],
  "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ"
};

var templateId = sn_cmdb.DuplicateTemplate.createTemplate(template);

gs.info(templateId);

    Saída:

    8dfcd36e042b2510f877c1665753a485

    DuplicateTemplate - getTemplate(cadeia de caracteres templateId)

    Obtém o objeto de modelo.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 6. Retornos
    Tipo Descrição
    Objeto O objeto de modelo com diferentes opções para criar o modelo.
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    <Object>.allow_null_ attribute_update Sinalizador que indica se os atributos de IC principais são atualizados com valores nulos de ICs duplicados ao resolver conflitos de atributo para ICs em uma tarefa de desduplicação.
    Valores válidos:
    • Verdadeiro: Os atributos de IC principais são atualizados com valores nulos de ICs duplicados.
    • Falso: Os atributos de IC principais não são atualizados com valores nulos de ICs duplicados.

    Tipo de dados: Booliano
    <Object>.allow_master_ci_ null_update Só inclui atualizações de ICs duplicados se o valor de IC principal for nulo.
    Valores válidos:
    • Verdadeiro: Incluir atualizações de ICs duplicados somente se o valor de IC principal for nulo.
    • Falso: Inclui atualizações de todos os ICs duplicados.

    Tipo de dados: Booliano
    <Object>.description Descrição para armazenar mais informações sobre o modelo.

    Tipo de dados: Cadeia de caracteres
    <Object>.duplicate_ ci_action Especifica se o IC duplicado deve ser excluído ou atualizado com valores personalizados exclusivos.
    Opções possíveis:
    • excluir
    • atualização (requer especificação duplicate_ci_updates)

    Tipo de dados: Cadeia de caracteres
    <Object>.duplicate_ ci_updates Matriz de objetos que especificam como os valores de IC duplicados são atualizados.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]

    Tipo de dados: Objeto
    <Object>.DuplicateCIUpdates.Element O nome do dicionário do sistema de um campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.element_label O rótulo que o campo de referência exibe.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.value Valor de um campo de referência, ou seja, o conteúdo do campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.display Valor de exibição de um campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>opção .master_ci_ Especifica como o IC principal é selecionado para uma tarefa de desduplicação ao aplicar este modelo.
    Opções possíveis:
    • condicional (deve especificar master_ci_condition)
    • MOST_related_items - Atributos a serem mesclados do IC com os itens mais relacionados ao IC principal.
    • MOST_relations - Atributos a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.
    • Newest_created - Atributos separados a serem mesclados do IC atualizado mais recentemente para o IC principal.
    • Oldest_created - Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.merge_relations Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum

    Tipo de dados: Cadeia de caracteres
    <Object>.merge_related_items Especifica quais tabelas relacionadas para ICs duplicados em uma tarefa de desduplicação são mescladas ao IC principal ao aplicar este modelo. Consulte também Remediate a de-duplication task (manual).
    Opções possíveis:
    • All_available - Inclui as tabelas relacionadas ao padrão e todas as tabelas relacionadas que fazem referência a ICs duplicados para a tarefa de desduplicação corrigida por meio do modelo.
    • condicional
    • Padrão - Inclui entradas relacionadas fornecidas pelo módulo Itens relacionados padrão do remediador de IC duplicado.
    • nenhum

    Tipo de dados: Cadeia de caracteres
    <Object>condição .merge_related_items_ Lista de entradas relacionadas com uma consulta codificada para cada entrada relacionada. Cada consulta é avaliada no IC principal selecionado para a tarefa. Se a consulta retornar verdadeiro, as entradas relacionadas serão mescladas durante a correção de uma tarefa de desduplicação. Se falso, as entradas relacionadas não serão mescladas.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .

    Tipo de dados: Matriz
    <Object>.most_relations_ merge_attributes Atributos separados por vírgulas a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.most_related_items_ merge_attributes Atributos separados por vírgulas a serem mesclados do IC com os itens mais relacionados ao IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.name Nome do modelo.

    Tipo de dados: Cadeia de caracteres
    <Object>.newest_updated_ merge_attributes Atributos separados por vírgulas a serem mesclados do IC atualizado mais recentemente para o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.oldest_created_ merge_attributes Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.table Tabela para a qual o modelo é criado.

    Tipo de dados: Cadeia de caracteres
    <Object>.task_condition_table Local das condições de tarefa da tabela, ou seja, a tabela Reconciliar dados de tarefa duplicados [reconciliar_duplicate_task_data]. O valor nunca muda e a tabela é destinada somente para uso interno.

    Tipo de dados: Cadeia de caracteres
    <Object>.task_conditions Consulta codificada a ser avaliada quando o modelo for executado. Esta consulta é avaliada na tabela Reconciliar dados de tarefa duplicados [reconciliar_duplicate_task_data]. Todas as tarefas retornadas desta consulta são consideradas durante a avaliação do modelo.
    Nota:
    Mesmo que uma tarefa seja retornada como parte da consulta, isso não garante que a execução do modelo processe a tarefa. Outros fatores podem fazer com que a tarefa seja ignorada durante o processamento do modelo.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .

    Tipo de dados: Cadeia de caracteres

    O exemplo a seguir mostra como recuperar um modelo.

    var template = sn_cmdb.DuplicateTemplate.getTemplate('<template_id>');
gs.info(JSON.stringify(template));

    Saída:

    {
  "most_relations_merge_attributes": "",
  "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ",
  "duplicate_ci_updates": "org.mozilla.javascript.NativeArray@5d3b19ef",
  "description": "This is a Windows server template",
  "master_ci_option": "oldest_created",
  "merge_related_items": "conditional",
  "duplicate_ci_action": "delete",
  "newest_updated_merge_attributes": "",
  "merge_related_items_condition": [
    {
      "condition": "os_versionCONTAINSWindows",
      "related_entry": "incident.cmdb_ci"
    },
    {
      "condition": "ramCONTAINS1024",
      "related_entry": "change_request.cmdb_ci"
    }
  ],
  "most_related_items_merge_attributes": "",
  "merge_relations": "all",
  "task_condition_table": "reconcile_duplicate_task_data",
  "name": "Test Windows Template",
  "allow_null_attribute_update": false,
  "table": "cmdb_ci_win_server",
  "allow_master_ci_null_update": false,
  "oldest_created_merge_attributes": "serial_number,os_version"
}

    DuplicateTemplate - previewTemplate(cadeia de caracteres templateId, cadeia de caracteres taskId)

    Gera uma visualização de como diferentes opções de modelo foram aplicadas à tarefa de desduplicação e como ela deve ser corrigida.

    Este método valida todos os atributos necessários antes de gerar a visualização da tarefa usando o modelo. Os modelos podem ser criados ou atualizados sem especificar os atributos necessários. Os atributos necessários devem ser fornecidos para visualizar qualquer tarefa de desduplicação.

    Os seguintes atributos são necessários:
    • duplicate_ci_action
    • master_ci_option
    • merge_related_items
    • merge_relations
    • nome
    • tabela
    Nota:
    Embora este método valide todos os atributos, não há nenhum requisito para que o modelo esteja no estado Publicado para uma visualização.

    Use RemediateTask() método para corrigir tarefas de desduplicação.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    taskId Cadeia de caracteres Sys_id da tarefa de desduplicação listada na tabela Corrigir tarefa duplicada [reconcile_duplicate_task].
    Tabela 8. Retornos
    Tipo Descrição
    Objeto Objeto de visualização com valores que mostram como as tarefas de desduplicação podem ser corrigidas usando o modelo.
    {
  "allClassCIMap": {Object},
  "duplicateCIAction": "String",
  "duplicateCIUpdates": [Array],
  "masterCI": "String",
  "mergeRelations": Boolean,
  "relatedTablesMerged": [Array],  
  "resolvedFieldCIMap": [Array],
  "taskId": "String",
  "tooManyDuplicates": Boolean
}
    <Object>.AllClassCIMap Lista de sys_ids dos ICs em uma tarefa de desduplicação , Agrupado por classe de IC. Por exemplo, cmdb_ci_computer.
    "allClassCIMap": {
  "<ci_class_name>": [
    "<ci_sys_id_1>",
    "<ci_sys_id_2>"
  ]
}

    Tipo de dados: Objeto
    <Object>.DuplicateCIAction Especifica se o IC duplicado deve ser excluído ou atualizado com valores personalizados exclusivos.
    Opções possíveis:
    • excluir
    • atualização (requer especificação duplicate_ci_updates)

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates Matriz de objetos que especificam como os valores de IC duplicados são atualizados.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]

    Tipo de dados: Matriz
    <Object>.DuplicateCIUpdates.Element O nome do dicionário do sistema de um campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.element_label O rótulo que o campo de referência exibe.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.value Valor de um campo de referência, ou seja, o conteúdo do campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>.DuplicateCIUpdates.display Valor de exibição de um campo de referência.

    Tipo de dados: Cadeia de caracteres
    <Object>.MasterCI Sys_id do IC que foi selecionado como o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.MergeRelations Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum

    Tipo de dados: Cadeia de caracteres
    <Object>.RelatedTablesMerged Especifica quais tabelas relacionadas para ICs duplicados em uma tarefa de desduplicação são mescladas ao IC principal ao aplicar este modelo. Consulte também Remediate a de-duplication task (manual).
    Opções possíveis:
    • All_available - Inclui as tabelas relacionadas ao padrão e todas as tabelas relacionadas que fazem referência a ICs duplicados para a tarefa de desduplicação corrigida por meio do modelo.
    • condicional
    • Padrão - Inclui entradas relacionadas fornecidas pelo módulo Itens relacionados padrão do remediador de IC duplicado.
    • nenhum

    Tipo de dados: Matriz
    <Object>.ResolveFieldCIMap Matriz de elementos a serem mesclados de ICs duplicados para o IC principal.
    "resolvedFieldCIMap": [
  {
    "element": "String",
    "sys_id": "String"
  }
]

    Tipo de dados: Matriz
    <Object>.ResolveFieldCIMap. ​elemento Nome do elemento a ser mesclado de um IC duplicado para o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.ResolveFieldCIMap. ​sys_id Sys_id do elemento a ser mesclado de um IC duplicado para o IC principal.

    Tipo de dados: Cadeia de caracteres
    <Object>.TaskId Sys_id da tarefa de desduplicação listada na tabela Corrigir tarefa duplicada [reconcile_duplicate_task].

    Tipo de dados: Cadeia de caracteres
    <Object>.TooManyDuplicatas Sinalizador que indica se a tarefa tem mais do que o número máximo de ICs. O limite é determinado comparando o valor da propriedade do sistema glide.duplicate_ci_ remediator.max.cis (valor padrão 1000 ICs).
    Valores válidos:
    • Verdadeiro: O número de ICs da tarefa excede o número máximo de ICs.
    • Falso: O número de ICs da tarefa não excede o número máximo de ICs.

    Tipo de dados: Booliano

    O exemplo a seguir mostra como obter uma visualização da correção de desduplicação para um modelo especificado.

    var preview = sn_cmdb.DuplicateTemplate.previewTemplate("<template_id>", "<task_id>");
gs.info(JSON.stringify(preview));

    Saída:

    {
  "taskId": "<task_id>",
  "masterCI": "<ci_sys_id_1>",
  "allClassCIMap": {
    "cmdb_ci_computer": [
      "<ci_sys_id_1>",
      "<ci_sys_id_2>"
    ]
  },
  "resolvedFieldCIMap": [
    {
      "element": "ram",
      "sys_id": "<ci_sys_id_2>"
    },
    {
      "element": "os_version",
      "sys_id": "<ci_sys_id_2>"
    }
  ],
  "mergeRelations": true,
  "relatedTablesMerged": [
    "incident.cmdb_ci",
    "change_request.cmdb_ci"
  ],
  "duplicateCIAction": "delete",
  "duplicateCIUpdates": [],
  "tooManyDuplicates": false
}

    DuplicateTemplate - publichTemplate(cadeia de caracteres templateId)

    Publica um modelo. Quando bem-sucedido, o modelo passa do estado de rascunho para publicado.

    Este método valida todos os atributos necessários antes de publicar o modelo. Você pode criar ou atualizar modelos sem especificar os atributos necessários, mas os atributos devem ser fornecidos antes de publicar um modelo.

    Os seguintes atributos são necessários:
    • duplicate_ci_action
    • master_ci_option
    • merge_related_items
    • merge_relations
    • nome
    • tabela

    No estado Publicado, você pode executar o modelo usando RunTemplate() método.

    Consulte também:
    Tabela 9. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 10. Retornos
    Tipo Descrição
    Booliano

    Sinalizador que indica se o modelo foi publicado.

    Valores válidos:
    • Verdadeiro: O modelo foi publicado.
    • Falso: O modelo não foi publicado.

    O exemplo a seguir mostra como publicar um modelo e exibir resultados.

    var isPublished = sn_cmdb.DuplicateTemplate.publishTemplate('<template_id>');
gs.info(isPublished);

    Saída:

    true

    DuplicateTemplate - remediateTask(cadeia de caracteres templateId, cadeia de caracteres taskId)

    Corrige uma tarefa de desduplicação usando o modelo.

    Se o modelo não estiver no estado Publicado, o modelo não poderá ser executado e o método lançará uma exceção.

    Use PreviewTemplate() método para visualizar como as tarefas de desduplicação devem ser corrigidas.

    Consulte também.
    Tabela 11. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    taskId Cadeia de caracteres Sys_id da tarefa de desduplicação listada na tabela Corrigir tarefa duplicada [reconcile_duplicate_task].
    Tabela 12. Retornos
    Tipo Descrição
    Cadeia de caracteres Se bem-sucedido, o ID de resolução de mesclagem para a correção da tarefa de desduplicação. Esta resolução de mesclagem identifica o sys_id de um registro na tabela Correção de IC duplicado [cmdb_duplicate_ci_remediation]. Se não for bem-sucedido, o modelo pode não estar no estado Publicado.

    O exemplo a seguir mostra como corrigir uma tarefa de desduplicação.

    var mergeResolutionId = sn_cmdb.DuplicateTemplate.remediateTask("<template_id>", "<task_id>");
gs.info(mergeResolutionId);

    Saída:

    <merge_resolution_id>

    DuplicateTemplate - requestCancellation(cadeia de caracteres templateRunId)

    Cancela uma execução de modelo existente.

    Uma solicitação de cancelamento só pode ser feita para uma execução de modelo se ela estiver no estado rascunho, pronto ou em execução.

    Após uma solicitação de cancelamento de execução de modelo, o estado de execução do modelo muda para a fase intermediária Cancelar solicitado.

    Executar este método não cancela automaticamente as execuções de modelo no estado Pronto ou Rascunho. O estado de execução do modelo não muda para Cancelado até que todas as tarefas em execução sejam concluídas. Nesse ponto, todas as tarefas restantes em fases para correção mudam de cancelamento solicitado para cancelado.

    Consulte também:
    Tabela 13. Parâmetros
    Nome Tipo Descrição
    TemplateRunId Cadeia de caracteres Sys_id da execução de modelo listada na tabela Execução de modelo de desduplicação [reconcile_duplicate_template_run].
    Tabela 14. Retornos
    Tipo Descrição
    Cadeia de caracteres

    Sinalizador que indica se a solicitação de cancelamento foi bem-sucedida.

    Valores válidos:
    • Verdadeiro: A solicitação de cancelamento foi bem-sucedida.
    • Falso: A solicitação de cancelamento não foi bem-sucedida.

    O exemplo a seguir mostra como cancelar uma execução de modelo e exibir se a operação foi bem-sucedida.

    var isCancelled = sn_cmdb.DuplicateTemplate.requestCancellation("487c67e2046b2510f877c1665753a4cc");
gs.info(isCancelled);

    Saída:

    true

    DuplicateTemplate - retireTemplate(cadeia de caracteres templateId)

    Retira um modelo.

    Use este método para mover um modelo para o estado Descontinuar se ele não for mais necessário.

    O modelo não pode ser descontinuado e o método gera uma exceção sob as seguintes condições:
    • O modelo está no estado Publicado.
    • O modelo está em execução ou programado para execução.
    Consulte também:
    Tabela 15. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 16. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se o modelo foi descontinuado.
    Valores válidos:
    • Verdadeiro: O modelo foi descontinuado.
    • Falso: O modelo não pôde ser descontinuado porque estava em execução, programado para ser executado ou no estado Publicado

    O exemplo a seguir mostra como desativar um modelo e exibir resultados.

    var isRetired = sn_cmdb.DuplicateTemplate.retireTemplate(<template_id>);
gs.info(isRetired);

    Saída:

    true

    DuplicateTemplate - runTemplate(cadeia de caracteres templateId)

    Programa uma execução de correção para um modelo de desduplicação no estado Publicado. Um modelo pode ser executado várias vezes, mas você só pode programar uma execução por vez.

    Se o modelo não estiver no estado Publicado, ele não poderá ser executado e o método lançará uma exceção. Use PublicTemplate() método para mover o modelo do estado rascunho para o estado publicado.

    Para cancelar uma tarefa em execução, use RequestCancelation() método.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 18. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id do modelo que foi executado listado na tabela Execução de modelo de desduplicação [reconcile_duplicate_template_run]. Se não for bem-sucedido, o modelo pode não estar no estado Publicado.

    O exemplo a seguir mostra como programar uma execução para um modelo de desduplicação publicado.

    var template = sn_cmdb.DuplicateTemplate.runTemplate('<template_id>');
gs.info(JSON.stringify(template));

    Saída:

    487c67e2046b2510f877c1665753a4cc

    DuplicateTemplate - unPublishTemplate(cadeia de caracteres templateId)

    Cancela a publicação de um modelo.

    Este método move o modelo do estado publicado para o estado de rascunho, o que permite atualizar o modelo. O modelo não poderá ser publicado se estiver em execução ou programado para ser executado.

    Consulte também:
    Tabela 19. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    Tabela 20. Retornos
    Tipo Descrição
    Booliano

    Sinalizador que indica se o modelo foi publicado com sucesso.

    Valores válidos:
    • Verdadeiro: A publicação do modelo foi cancelada com sucesso.
    • Falso: A publicação do modelo não foi cancelada com sucesso. O modelo pode estar em execução ou programado para ser executado.

    O exemplo a seguir mostra como cancelar a publicação de um modelo e exibir os resultados.

    var isUnPublished = sn_cmdb.DuplicateTemplate.unPublishTemplate(<template_id>);
gs.info(isUnPublished);

    Saída:

    true

    DuplicateTemplate - updateTemplate(cadeia de caracteres templateId, modelo de objeto)

    Atualiza um modelo de desduplicação no estado de rascunho.

    Consulte também:
    Tabela 21. Parâmetros
    Nome Tipo Descrição
    templateId Cadeia de caracteres Sys_id do modelo listado na tabela Reconciliar modelo duplicado [reconciliar_duplicate_template].
    modelo Objeto O objeto de modelo com diferentes opções para criar o modelo. 
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    template.allow_null_​attribute_update Booliano Opcional. Sinalizador que indica se os atributos de IC principais são atualizados com valores nulos de ICs duplicados ao resolver conflitos de atributo para ICs em uma tarefa de desduplicação.
    Valores válidos:
    • Verdadeiro: Os atributos de IC principais são atualizados com valores nulos de ICs duplicados.
    • Falso: Os atributos de IC principais não são atualizados com valores nulos de ICs duplicados.

    Padrão: Falso
    template.allow_master_ci_​null_update Booliano Opcional. Só inclui atualizações de ICs duplicados se o valor de IC principal for nulo.

    Sinalizador que indica se incluir somente atualizações de ICs duplicados se o valor de IC principal for nulo.

    Valores válidos:
    • Verdadeiro: Incluir atualizações de ICs duplicados somente se o valor de IC principal for nulo.
    • Falso: Inclui atualizações de todos os ICs duplicados.

    Padrão: Falso
    template.description Cadeia de caracteres Opcional. Descrição para armazenar mais informações sobre o modelo.
    template.duplicate_​ci_action Cadeia de caracteres Opcional. Especifica se o IC duplicado deve ser excluído ou atualizado com valores personalizados exclusivos.
    Opções possíveis:
    • excluir
    • atualização (requer especificação duplicate_ci_updates)
    template.duplicate_​ci_updates Matriz Opcional, a menos que seja a configuração para duplicate_ci_action. atualização . Matriz de objetos que especificam como os valores de IC duplicados são atualizados.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    template.duplicate_​ci_updates.element Cadeia de caracteres O nome do dicionário do sistema de um campo de referência.
    template.duplicate_​ci_updates.element_label Cadeia de caracteres O rótulo que o campo de referência exibe.
    template.duplicate_​ci_updates.value Cadeia de caracteres Valor de um campo de referência, ou seja, o conteúdo do campo de referência.
    template.duplicate_​ci_updates.display Cadeia de caracteres Valor de exibição de um campo de referência.
    ​opção template.master_ci_ Cadeia de caracteres Opcional. Especifica como o IC principal é selecionado para uma tarefa de desduplicação ao aplicar este modelo.
    Opções possíveis:
    • condicional (deve especificar master_ci_condition)
    • MOST_related_items - Atributos a serem mesclados do IC com os itens mais relacionados ao IC principal.
    • MOST_relations - Atributos a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.
    • Newest_created - Atributos separados a serem mesclados do IC atualizado mais recentemente para o IC principal.
    • Oldest_created - Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.
    modelo.master_ci_ condição Cadeia de caracteres Opcional (obrigatório se o valor de master_ci_option. condicional ). Consulta codificada para especificar como o IC principal é selecionado. Se vários ICs ou nenhum ICs corresponder à consulta, o método selecionará o IC atualizado mais recentemente como o IC principal. A consulta codificada é avaliada para a tabela de modelo. Esta tabela é identificada em tablepropriedade.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.merge_relations Cadeia de caracteres Opcional. Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum
    template.merge_relations Cadeia de caracteres Opcional. Especifica como os relacionamentos para ICs duplicados em uma tarefa de desduplicação são mesclados ao aplicar este modelo.
    Opções possíveis:
    • tudo
    • condicional
    • nenhum
    ​condição template.merge_relations_ Cadeia de caracteres Opcional (obrigatório se o valor de merge_relations. condicional ). Consulta codificada para especificar se todos ou nenhum dos relacionamentos de ICs duplicados são mesclados. A consulta é avaliada no IC principal selecionado para a tarefa de desduplicação. Se a consulta retornar verdadeiro, todos os relacionamentos serão mesclados. Se falso, nenhum relacionamento será mesclado.

    A consulta codificada é avaliada para a tabela de modelo. Esta tabela é identificada em tablepropriedade.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.merge_related_items Cadeia de caracteres Opcional. Especifica quais tabelas relacionadas para ICs duplicados em uma tarefa de desduplicação são mescladas ao IC principal ao aplicar este modelo. Consulte também Remediate a de-duplication task (manual).
    Opções possíveis:
    • All_available - Inclui as tabelas relacionadas ao padrão e todas as tabelas relacionadas que fazem referência a ICs duplicados para a tarefa de desduplicação corrigida por meio do modelo.
    • condicional
    • Padrão - Inclui entradas relacionadas fornecidas pelo módulo Itens relacionados padrão do remediador de IC duplicado.
    • nenhum
    ​condição template.merge_related_items_ Matriz Opcional. Lista de entradas relacionadas com uma consulta codificada para cada entrada relacionada. Cada consulta é avaliada no IC principal selecionado para a tarefa. Se a consulta retornar verdadeiro, as entradas relacionadas serão mescladas durante a correção de uma tarefa de desduplicação. Se falso, as entradas relacionadas não serão mescladas.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    template.most_relations_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC com a maioria dos relacionamentos com o IC principal.
    most_related_items_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC com os itens mais relacionados ao IC principal.
    template.name Cadeia de caracteres Nome do modelo.
    modelo.newest_updated_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC atualizado mais recentemente para o IC principal.
    modelo.oldest_created_​merge_attributes Cadeia de caracteres Opcional. Atributos separados por vírgulas a serem mesclados do IC criado mais antigo para o IC principal.
    template.table Cadeia de caracteres Tabela para a qual o modelo é criado.
    template.task_conditions Cadeia de caracteres Opcional. Consulta codificada a ser avaliada quando o modelo for executado. Esta consulta é avaliada na tabela Reconciliar dados de tarefa duplicados [reconciliar_duplicate_task_data]. Todas as tarefas retornadas desta consulta são consideradas durante a avaliação do modelo.
    Nota:
    Mesmo que uma tarefa seja retornada como parte da consulta, isso não garante que a execução do modelo processe a tarefa. Outros fatores podem fazer com que a tarefa seja ignorada durante o processamento do modelo.

    Para obter detalhes, consulte Cadeias de caracteres de consulta codificadas .
    Tabela 22. Retornos
    Tipo Descrição
    Booliano

    Sinalizador que indica se o modelo foi atualizado.

    Valores válidos:
    • Verdadeiro: O modelo foi atualizado.
    • Falso: O modelo foi atualizado. O modelo pode não estar no estado de rascunho (não publicado).

    O exemplo a seguir mostra como atualizar várias propriedades de um modelo de desduplicação existente.

    var template = {
  "name": "Test Windows Template",
  "table": "cmdb_ci_win_server",
  "description": "This is a windows server template",
  "master_ci_option": "newest_updated",
  "master_ci_condition": "",
  "allow_null_attribute_update": false,
  "allow_master_ci_null_update": false,
  "oldest_created_merge_attributes": "",
  "newest_updated_merge_attributes": "ram,cpu_count",
  "most_relations_merge_attributes": "",
  "most_related_items_merge_attributes": "",
  "merge_relations": "all",
  "merge_relations_condition": "",
  "merge_related_items": "conditional",
  "merge_related_items_condition": [
    {
      "related_entry": "change_request.cmdb_ci",
      "condition": "ramCONTAINS1024"
    },
    {
      "related_entry": "incident.cmdb_ci",
      "condition": "os_versionCONTAINSWindows"
    }
  ],
  "duplicate_ci_action": "delete",
  "duplicate_ci_updates": "",
  "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ"
};

sn_cmdb.DuplicateTemplate.updateTemplate(<template_id>, template);

    Saída:

    true