ReconciliadorDeResumo - Global

Use esta inclusão de script como uma classe base para criar seu próprio reconciliador do Discovery.

Esta é uma classe base abstrata para reconciliar dados recém-descobertos em um XMLMemoryTable com uma lista relacionada no banco de dados. O Reconciliador de Resumo implementa a lógica comum e os métodos de ajuda para reconciliar listas relacionadas de um item do CMDB específico com as informações descobertas presentes em uma instância de MemoryTable.

A maior parte dessa lógica é muito direta, mas um pouco pode não ser: a resolução de referências a registros reconciliados anteriormente. Este recurso funciona coletando informações ao reconciliar uma lista relacionada e, em seguida, passando essas informações para o reconciliador de outra lista relacionada. Por exemplo, enquanto as partições de comutador estão sendo reconciliadas, as informações são coletadas (em uma instância de mapa) que mapeia um número de interface de uma partição para o sys_id do registro da partição na tabela de partição. Mais tarde, quando as portas do switch estiverem sendo reconciliadas, uma referência à partição do switch que contém a porta do switch poderá ser resolvida usando este mapa.

ResumoReconciliador - getReconciliationField()

Determina se os dados recém-descobertos são diferentes dos dados já existentes no banco de dados do item atual.

Este método só é invocado para itens que foram redescobertos.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os dados foram alterados.

ResumoReconciliador - getReconciliationKey()

Obtém o valor da cadeia de caracteres do campo a ser usado como chave para pesquisar um registro nos dados recém-descobertos.

Este valor será usado para tentar encontrar um registro nos dados descobertos, usando a coluna retornada pelo método getReconciliationKey().

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor a ser usado como chave nos dados descobertos.

ResumoReconciliador - hasChanged()

Retorna verdadeiro se os dados recém-descobertos forem diferentes dos dados já existentes no banco de dados para este item.

Este método só é invocado para itens que foram redescobertos.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os dados descobertos forem diferentes dos dados já existentes no banco de dados.

ResumoReconciliador - markAbsent()

Marca os ICs como ausentes definindo o status da instalação como "Ausente"; outras tabelas são marcadas pela definição do campo (presumivelmente presente) "ausente" como verdadeiro.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
vazio

ResumoReconciliador - markPresent()

Marca os ICs como presentes definindo o status de instalação como "Instalado"; outras tabelas são marcadas pela definição do campo (presumivelmente presente) "ausente" como falso.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
vazio

ResumoReconciliador - process()

Reconcilia os dados recém-descobertos com os dados já presentes no banco de dados e resolve referências a dados reconciliados anteriormente.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
vazio

ResumoReconciliador - readDatabaseFields()

Lê o registro da tabela de memória atual de dados recém-descobertos e verifica sua validade.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os dados forem válidos.

ResumoReconciliador - readDiscovered()

Lê o registro da tabela de memória atual de dados recém-descobertos e verifica sua validade.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 16. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os dados forem válidos.

ResumoReconciliador - resolveReferenceFields()

Lê os campos no registro do banco de dados atual para os campos do membro da instância.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 18. Retorna

Tipo	Descrição
vazio

ResumoReconciliador - setDatabaseFields()

Define os campos do banco de dados do registro atual para os valores das informações recém-descobertas.

Este método é invocado para novos registros de banco de dados e para registros de banco de dados existentes quando os dados descobertos são alterados.

Método obrigatório, deve ser substituído em todas as subclasses de concreto.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

Tipo	Descrição
vazio

Reconciliador de Resumo - setup()

Substituição opcional para subclasses de concreto que exigem configuração especial.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

Tipo	Descrição
vazio

ResumoReconciliador - rastrear(cadeia de caracteres sys_id)

Método opcional para substituir subclasses de concreto que precisam resolver campos de referência.

Este método é invocado depois que os dados descobertos válidos são lidos. Geralmente, as implementações usarão alguns desses dados descobertos como uma chave em um mapa (transmitido para a classe de reconciliador de concreto quando foi instanciado) que retornará o sys_id do registro do banco de dados que contém as informações referenciadas. No entanto, as implementações não são necessárias para usar essa abordagem.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
sys_id	Cadeia de caracteres	O sys_id do registro do banco de dados atual.

Tabela 24. Retorna

Tipo	Descrição
vazio