Criar uma regra de identificação para uma tabela não pertencente ao CMDB

Para usar os recursos do Mecanismo de Identificação e Reconciliação (IRE) com tabelas compatíveis não pertencentes ao CMDB, primeiro você deve criar regras de identificação que identifiquem exclusivamente os registros da tabela. Cada tabela não pertencente ao CMDB pode ser associada a apenas uma regra de identificação.

Antes de Iniciar

Função necessária: itil tem acesso de leitura, itil_admin (além de itil) tem acesso total

Por Que e Quando Desempenhar Esta Tarefa

Cada regra de identificação consiste em um só identificador para a tabela, uma ou mais entradas de identificador e uma ou mais entradas relacionadas.

Revise os seguintes tópicos antes de criar regras de identificação:

• Regras de identificação
• Diretrizes gerais para usar a Identificação do CMDB

Ao criar entradas de identificador, você pode configurar os campos Pesquisar na tabela e Atributos de critério no formulário de Entrada do identificador para implementar uma das seguintes opções:

Entrada de identificador regular

Permite selecionar atributos da tabela de identificadores associada.

Entrada de identificador de pesquisa

Permite selecionar atributos de qualquer tabela relacionada (tabela de pesquisa), exceto a tabela atualmente selecionada.

Entrada de identificador híbrido

Permite selecionar atributos da tabela atualmente selecionada e de outra tabela (de pesquisa).

Para tabelas não pertencentes ao CMDB, somente regras de identificação independentes são compatíveis.

Procedimento

1. Navegar até Tudo > Identificação/Reconciliação > Identificadores de IC.
2. Na exibição da lista de Identificadores, clique em Novo.
3. Preencha o formulário do identificador.

   Campo	Descrição
   Nome	Nome do identificador do IC.
   Aplica-se a	Tabelas compatível não pertencente ao CMDB.
   Independente	Deve ser verificado para indicar que o identificador pode identificar um registro independentemente de outros.

4. Clique em Enviar.
5. Na exibição de lista de Identificadores, localize e abra o identificador que você acabou de criar.
6. No formulário Identificador, selecione a guia Entradas do identificador e clique em Novo.
7. Preencha o formulário Entrada do identificador.

   Campo	Descrição
   Identificador	Defina previamente com o nome da tabela do identificador associado.
   Pesquisar na tabela	Defina previamente com o rótulo da tabela do identificador associado. Para criar: Uma entrada de identificador regular: defina como a tabela de identificadores e selecione os atributos de critério dessa mesma tabela. Uma entrada de identificador de pesquisa: defina como outra tabela (de pesquisa) e selecione os Atributos de critério dessa tabela de pesquisa. Uma entrada de identificador híbrido: defina como outra tabela (de pesquisa) e execute as etapas a seguir. Selecione Atributos de critério na tabela de pesquisa. Adicione Atributos de critério de IC de entrada híbrido da tabela atual usando scripts em segundo plano, depois de salvar a regra. Para obter mais detalhes, confira a seção "O que fazer em seguida" no final desta tarefa. Uma tabela de pesquisa deve ter uma referência à tabela do identificador associado.
   Atributos de critério	Definição de atributos que identificam o registro de modo exclusivo. Os atributos podem pertencer à classe atual ou a uma classe primária. Nota: É possível adicionar campos de referência como um atributo de critério. No entanto, esses campos podem nem sempre ser eficazes: Campos de referência armazenam sys_ids que apontam para um registro em outra tabela e, portanto, são considerados um atributo de critério fraco (em termos de exclusividade) para a tabela atual. O sistema detecta e substitui valores inválidos em um campo de referência por "Desconhecido". Por exemplo, um valor Model ID inválido é substituído pelo valor "Desconhecido". Além disso, se vários ICs tiverem o mesmo campo de referência definido como "Desconhecido", esses ICs se tornarão ICs duplicados.
   Prioridade	Prioridade de aplicação da entrada do identificador. Regras com números de prioridade mais baixa recebem prioridade mais alta. Entradas do identificador de prioridades idênticas são aplicadas aleatoriamente. Você pode manter lacunas entre os números de prioridade, para que possa atribuir os números de prioridade não utilizados a novas entradas sem modificar a ordem de prioridade existente.
   Ativo	Especifica se a entrada do identificador está ativa. Pelo menos uma entrada de identificador em uma regra de identificação deve estar ativa para que a regra seja aplicada.
   Forçar correspondência de contagem exata	Para identificação de pesquisa, corresponda a um registro apenas na correspondência exata de contagem de registros de pesquisa. Quando aplicados, todos os itens de pesquisa de um registro na carga útil devem ter registros correspondentes na tabela de pesquisa que faz referência ao mesmo registro: Corresponde somente aos registros que têm todos os itens de pesquisa da carga útil de entrada que faz referência ao registro na tabela. Se houver várias correspondências, seleciona o registro criado mais antigo como a correspondência final. Quando não for aplicado, um item de pesquisa de um registro na carga útil correspondente a um registro da tabela de pesquisa é suficiente para considerar uma correspondência: Corresponde a qualquer registro que tenha pelo menos um dos itens de pesquisa da carga útil de entrada que faz referência ao registro na tabela. Se houver várias correspondências, seleciona os registros com o número máximo de itens de pesquisa da carga útil de entrada que faz referência ao registro na tabela. Se ainda houver várias correspondências, seleciona o registro criado mais antigo como a correspondência final.
   Permitir atributo nulo	Quando selecionado, se pelo menos um atributo de critério não for nulo, tente corresponder a uma entrada de identificador mesmo se houver atributos de critério nulos. Caso contrário, todos os atributos de critério devem ter valores para tentar corresponder a uma entrada de identificador.
   Permitir fallback para regras pai	Permite que as regras de identificação da tabela primária do registro sejam utilizadas caso não seja encontrada uma correspondência para esta regra de identificação. Aplica-se somente a regras de identificação dependentes.
   Condição opcional	Um filtro para restringir o conjunto de registros em que será pesquisado um registro correspondente. Disponível somente se a propriedade do sistema glide.identification_engine.enable_identifier_optional_condition estiver definida como true (ela é false por padrão). No sistema de base, as entradas do identificador de várias classes são pré-configuradas com condições de opções avançadas. Todas essas condições pré-configuradas em entradas de identificador regulares serão aplicadas automaticamente quando você definir esta propriedade como true. Portanto, para evitar comportamento inesperado, revise essas condições predefinidas nas entradas do identificador regular antes de definir esta propriedade como true. Para obter mais detalhes sobre esta propriedade, confira Propriedades de Identificação e Reconciliação.

   Nota:

   Se os atributos de critério tiverem apenas dois atributos e sys_class_name for um deles (por exemplo [name, sys_class_name], [ip_address, sys_class_name]), o outro atributo não poderá ser NULO, mesmo se a opçao Permitir atributo nulo estiver habilitada. Esta restrição deve-se ao fato de sys_class_name ser considerado um atributo de correspondência do sistema especial.
8. Clique em Enviar.
9. No formulário Identificador, selecione a guia Entradas relacionadas e clique em Novo.
10. Preencha o formulário Entrada relacionada.

    Tabela 1. Formulário Entrada relacionada

    Campo	Descrição
    Identificador	Defina previamente com o identificador ao qual esta entrada relacionada está associada.
    Ativo	Caixa de seleção que especifica que a entrada relacionada está ativa.
    Tabela relacionada	Uma tabela relacionada (de pesquisa) que faz referência ao registro que está sendo correspondido.
    Campo referenciado	Um campo referenciado na tabela relacionada com uma referência à tabela de identificadores associada.
    Atributos de critério	O conjunto de atributos para identificar exclusivamente o item relacionado. Os atributos podem pertencer à classe atual ou a uma classe primária. Nota: É possível adicionar campos de referência como um atributo de critério. No entanto, esses campos podem nem sempre ser eficazes: Campos de referência armazenam sys_ids que apontam para um registro em outra tabela e, portanto, são considerados um atributo de critério fraco (em termos de exclusividade) para a tabela atual. O sistema detecta e substitui valores inválidos em um campo de referência por "Desconhecido". Por exemplo, um valor Model ID inválido é substituído pelo valor "Desconhecido". Além disso, se vários ICs tiverem o mesmo campo de referência definido como "Desconhecido", esses ICs se tornarão ICs duplicados. Clique no ícone de cadeado para exibir, adicionar ou remover atributos da regra de identificação.
    Permitir atributo nulo	Se pelo menos um atributo de critério na tabela relacionada não for nulo, permita a tentativa de correspondência com uma entrada de identificador, mesmo se houver atributos de critério que sejam nulos.
    Prioridade	Prioridade da entrada relacionada para a tabela Relacionada especificada. Regras com números de prioridade mais baixa recebem prioridade mais alta enquanto correspondem a um item relacionado a uma tabela relacionada específica. Entradas relacionadas para a tabela relacionada especificada com prioridades idênticas são aplicadas aleatoriamente. Você pode manter lacunas entre os números de prioridade, para que possa atribuir os números de prioridade não utilizados a novas entradas sem modificar a ordem de prioridade existente.
    Condição opcional	Filtre as condições para restringir o conjunto de registros que serão pesquisados para um item relacionado correspondente.

11. Clique em Enviar.

O que Fazer Depois

Para adicionar atributos de critério a um campo Atributos de critério de entrada híbrida em uma entrada de identificador híbrido, em vez de usar o formulário de Entrada do identificador, você deve usar scripts em segundo plano. Depois de salvar a regra de identificação, navegue até Definições do sistema > Scripts - Segundo Planoe insira um script que adicione os atributos e clique em Executar script.

Script de exemplo:

var gr = new GlideRecord('cmdb_identifier_entry');
// get the identifier entry you want to update
gr.get('<identifier_entry_sys_id>');
// set the attributes you want in the hybrid rule in a comma separated list
// for example: 'name,serial_number'
gr. hybrid_entry_ci_criterion_attributes='<column_name_1>,<column_name_2>,<etc.>';
gr.update();

Este processo requer a função de administrador.