Aplicação da identificação e reconciliação de ICs aos Conjuntos para importação

Você pode aplicar processos de Reconciliação e identificação no CMDB quando Conjuntos para importação são usados para importar ICs para o CMDB. A identificação de IC pode evitar ICs duplicados no CMDB, o que poderia ser causado pelos Conjuntos de importação.

O preenchimento de tabelas do CMDB usando Conjuntos para importação pode resultar inadvertidamente a gerar ICs duplicados quando vários registros importados são idênticos a um IC existente. Para minimizar esta duplicação, você pode aplicar os processos de Reconciliação e identificação no CMDB aos Conjuntos para importação ao importar novos registros para as tabelas do CMDB.

Script do mapa de transformação

No script do mapa de transformação onBefore para um conjunto para importação, adicione uma chamada à API CMDBTransformUtil, semelhante à amostra de código a seguir:

(function runTransformScript(source, map, log, target) {
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcile(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
        var errorMessage = cmdbUtil.getError();
        log.error(errorMessage);
} else {
        log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
        log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

})(source, map, log, target);

A frase de código ignore = true impede que Conjuntos para importação criem o mesmo registro novamente depois que ele é processado pelo mecanismo de identificação.

Processo

O mecanismo de identificação executa a identificação de cada registro de origem antes que ele seja inserido no CMDB. O mecanismo de identificação determina se o registro é uma duplicata de um IC existente e:

• Se não for duplicado: insere o registro na tabela de destino.
• Se duplicado: atualiza o IC existente no CMDB, com dados do registro de origem.

A API CMDBTransformUtil pré-processa os dados de origem e passa os valores de entrada para o mecanismo de identificação com o conjunto para importação sendo a fonte de dados por padrão. A API CMDBTransformUtil oferece suporte a um campo de destino que é um campo de referência da mesma maneira que os Conjuntos para importação. A API CMDBTransformUtil também oferece suporte a um script de origem, avaliando os scripts de origem para determinar o valor de destino que é passado para o mecanismo de identificação. Para obter mais informações, consulte Como criar um mapa de campo.

Especificar várias tabelas de destino para um conjunto para importação

Você pode configurar cada registro em um conjunto para importação com sua própria tabela de destino. Em seguida, em vez de inserir todos os registros transformados em uma única tabela de destino, os registros são inseridos nas diferentes tabelas de destino especificadas por registro. Por exemplo, talvez você precise inserir alguns registros do conjunto para importação para a classe Computador e outros registros para a classe Servidor.

Durante a importação de dados usando Conjuntos para importação, incorpore as seguintes etapas:

• No arquivo de fonte de dados, adicione uma coluna da tabela de destino. Use uma cadeia de caracteres como "MinhaTabela" para rotular o cabeçalho da coluna. Em cada linha de registro, insira a tabela de destino do registro, como um nome de classe CMDB válido, como "cmdb_ci_computer".
• Depois de mapear automaticamente os campos correspondentes no formulário Mapa de transformação da tabela, adicione um mapa de campo para a coluna da tabela de destino adicionada para estabelecer um relacionamento entre as classes e as tabelas de destino no CMDB.
  1. Na lista relacionada Mapa de campo no formulário Mapa de transformação da tabela, clique em Novo.
  2. Defina o campo de origem como o cabeçalho da coluna da tabela de destino que você adicionou ao arquivo de fonte de dados, como MinhaTabela.
  3. Defina o campo de Destino como Classe.
  4. Clique em Enviar.

Quando você configura um conjunto para importação com várias tabelas de destino, conforme descrito nas etapas acima, a tabela de destino especificada no formulário Mapa de transformação da tabela não é usada.

Restrições

As seguintes restrições se aplicam:

• Um conjunto para importação deve ser associado a um único mapa de transformação. Ao adicionar uma chamada à API CMDBTransformUtil, certifique-se de que ainda exista um só mapa de transformação para o conjunto para importação.
• A API CMDBTransformUtil não verifica se os campos obrigatórios têm valores quando usados com Conjuntos para importação. Independentemente de como enforce mandatory fields estiver definido no mapa de transformação, a importação de dados falhará se um campo obrigatório não tiver um valor.
• A Identificação e reconciliação de IC não podem ser aplicadas a Conjuntos para importação para ICs dependentes (ICs com regras de identificação dependente).

Tópicos relacionados

• Crie um mapa de transformação