CMDBTransformUtil - Global
. CMDBTransformUtil A inclusão de script usa a estrutura de identificação e reconciliação (IRE) para minimizar a criação de itens de configuração (IC) duplicados.
A estrutura de IRE também reconcilia atributos de IC aceitando somente informações de fontes autorizadas ao atualizar o. CMDB em Antes scripts de mapa de transformação. Você não pode usar esta classe em outros scripts. Para obter informações adicionais sobre como a estrutura IRE funciona, consulte Reconciliação e identificação do CMDB .
CMDBTransformUtil - CMDBTransformUtil()
Cria um objeto CMDBTransformUtil.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
var cmdbUtil = new CMDBTransformUtil();
CMDBTransformUtil - getError()
Retorna todos os erros gerados pelo anterior IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() chamada de método.
Use este método em scripts de mapa de transformação onBefore para obter erros. Use HasError() método para detectar primeiro quaisquer erros do IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() método.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
| Tipo | Descrição |
|---|---|
| Cadeia de caracteres | Mensagem de erro de IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() . |
// Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(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());
}
Equivalente com escopo
Não há equivalente com escopo para este método.
CMDBTransformUtil - getOutputPayload()
Retorna a carga JSON do anterior IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() chamada de método.
Use este método em scripts de mapa de transformação onBefore.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum(a) |
| Tipo | Descrição |
|---|---|
| <String> | Cadeia de caracteres formatada JSON que é uma lista de resultados dos itens de configuração na cadeia de caracteres de entrada. Cada cadeia de caracteres de resultado está no formato "itens: []], relações:[]]", em que cada item nas listas de itens e relações contém pares nome-valor. Tipo de dados: Cadeia de caracteres |
| ItemsCommittedAditionalCommittedItems <String> | Nenhum valor é retornado no momento. |
| RelacionaçõesCommitedadicionais <String> | Nenhum valor é retornado no momento. |
| Itens.<String> | Descrição dos ICs criados ou atualizados. Tipo de dados: Objeto |
| ItemsRelacionadosadicionais.ItemsRelacionadosadicionais <String> | Lista de informações sobre pesquisa adicional e itens relacionados que foram processados, mas não fornecidos como parte da carga de entrada. Esses itens são de cargas úteis parciais. Essas informações não são retornadas no momento. Tipo de dados: Matriz de objetos |
| Items.itens.additionalRelatedItems.classname <String> | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres |
| <String>.items.additionalRelatedItems.inputIndices | Índice do item de entrada correspondente. Para itens de nível superior, é uma lista de números inteiros. Para itens relacionados ou de pesquisa, é a lista de objetos JSON. Tipo de dados: Matriz de números ou Matriz de objetos |
| <String>.items.additionalRelatedItems.inputIndices.mainIndex | Valor de índice do corpo da solicitação itemsMatriz que corresponde ao IC primário do item relacionado adicional. Tipo de dados: Número |
| <String>.items.additionalRelatedItems.inputIndices.subIndex | Valor de índice do corpo da solicitação items.lookupmatriz que corresponde ao item relacionado adicional. Tipo de dados: Número |
| Items.Items.Relacionadosadicionais.Operação <String> | Tipo de operação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Items.Items.SYSID Relacionadosadicionais.Items.Items.Items.AditionalRelacionados <String> | Sys_id dos itens relacionados adicionais. Tipo de dados: Cadeia de caracteres |
| <String>.items.classname | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres |
| Itens.duplicadosIndices <String> | Lista de índices de ICs duplicados do item atual. Tipo de dados: Matriz |
| Items.ErrorCount <String> | Número de erros. Tipo de dados: Número |
| Itens.Erros.Itens.<String> | Lista de erros encontrados ao processar este IC. Tipo de dados: Matriz de objetos |
| <String>.itens.errors.error | Tipo de erro encontrado ao processar o IC. Tipo de dados: Cadeia de caracteres |
| <String>.itens.errors.message | Mensagem de erro associada ao erro. Tipo de dados: Cadeia de caracteres |
| <String>.items.IdentificationAttents | Lista de tentativas feitas para identificar os ICs. Tipo de dados: Matriz de objetos |
| IdentificationAttempts.attempts.attemptResult <String> | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Atributos.IdentificationAttempts.Attributes.IdentificationAttributes <String> | Lista de atributos de entrada de identificador de IC que foram usados durante o processo de identificação. Tipo de dados: Matriz Os nomes e tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| Atributos.IdentificationAttempts.hybridEntryCiEntryCiAttributes <String> | Nenhum valor é retornado no momento. |
| IdentificationAttempts.IdentificationAttents.IdentificationName <String> | Regra de identificador usada para esta tentativa de identificação de IC. Tipo de dados: Cadeia de caracteres |
| <String>.items.identificationAttempts.searchOnTable | Nome da tabela pesquisada durante o processo de identificação. Tipo de dados: Cadeia de caracteres |
| IdSysEntryEntysid.IdentifierEntryId.IdentifierId <String> | Sys_id para a regra de identificador usada para identificar o IC. Tipo de dados: Cadeia de caracteres Entrada do identificador [cmdb_identifier_entry] |
| <String>.items.info | Lista que contém informações adicionais sobre o processamento do item. Tipo de dados: Matriz de objetos |
| <String>.items.info.code | Tipo de reclassificação ignorado. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <String>.items.info.message | Mensagem que fornece informações adicionais sobre o motivo para ignorar a reclassificação. Tipo de dados: Cadeia de caracteres |
| <String>.items.info.ruleSysId | Sys_id da regra de restrição de reclassificação que foi correspondida. Aplicável somente quando o IRE ignora a reclassificação devido à regra de restrição de reclassificação. Este valor ficará vazio se a reclassificação for ignorada devido a uma carga útil ou sinalizador global. Tipo de dados: Cadeia de caracteres |
| <String>.items.inputIndices | Valores de índice para ICs do corpo da solicitação itemsMatriz que corresponde a este IC. Tipo de dados: Matriz |
| <String>.itens.atributos masked | Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido por Regras de reconciliação . Tipo de dados: Matriz |
| Items.RelatedItems.RelatedItems <String> | Lista que fornece informações sobre os itens relacionados processados. Tipo de dados: Matriz de objetos |
| Items.RelatedItems.Classname <String> | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.Erros.RelatedItems <String> | Lista de erros que ocorreram durante o processamento. Tipo de dados: Matriz de objetos |
| Items.RelatedItems.ErrorCount <String> | Número de erros detectados durante o processamento. Tipo de dados: Número |
| <String>.items.relatedItems.inputIndices | Índices dos itens relacionados correspondentes. Tipo de dados: Matriz ou números |
| <String>.items.relatedItems.inputIndices.mainIndex | Valor inteiro do corpo da solicitação itemsMatriz que corresponde ao IC primário do item relacionado. Tipo de dados: Número |
| <String>.items.relatedItems.inputIndices.subIndex | Valor inteiro do corpo da solicitação items.lookupmatriz que corresponde ao item relacionado. Tipo de dados: Número |
| Items.RelatedItems.Operation <String> | Tipo de operação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| SysIds.RelatedSysIds <String> | Lista de valores sys_id para itens relacionados (itens de pesquisa de tabela) do corpo da solicitação items.lookupmatriz. Valores notáveis - nulo: Nenhum sys_id foi identificado para este item relacionado. Tipo de dados: Matriz |
| <String>.items.sys_id | Sys_id do IC que foi atualizado ou criado. Tipo de dados: Cadeia de caracteres |
| <String>.relations | Informações sobre as relações processadas. Tipo de dados: Matriz de objetos |
| <String>.relations.classname | Sys_class_name deste IC de relacionamento dependente. Somente valor compatível: cmdb_rel_ci: Tabela de relacionamento de IC. Tipo de dados: Cadeia de caracteres |
| Relations.ErrorCount.<String> | Número de erros. Tipo de dados: Número |
| <String>.relations.inputIndices | Índices das relações de entrada correspondentes. Tipo de dados: Matriz |
| Relations.Operation.<String> | Tipo de operação realizada. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| SYSID.relations.SYSID <String> | Sys_id do IC de relacionamento dependente. Tipo de dados: Cadeia de caracteres |
// Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(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());
}
Equivalente com escopo
Não há equivalente com escopo para este método.
CMDBTransformUtil - getOutputRecordSysId()
Retorna o sys_id do item de configuração (IC) que foi inserido ou atualizado.
Use este método em scripts de mapa de transformação onBefore.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
| Tipo | Descrição |
|---|---|
| Cadeia de caracteres | Sys_id do IC que foi inserido ou atualizado. |
// Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(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());
}
Equivalente com escopo
Não há equivalente com escopo para este método.
CMDBTransformUtil - getPayload (origem do objeto, mapa do objeto, log do objeto)
Retorna a carga JSON gerada a partir da entrada especificada.
Em seguida, você pode modificar a carga e usar o. SetPayload() método para armazenar a carga atualizada. Depois que a carga for modificada e armazenada, use IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() para processar a carga.
| Nome | Tipo | Descrição |
|---|---|---|
| origem | Objeto | Objeto global disponível em scripts de mapa de transformação que contém o registro de entrada. |
| mapa | Objeto | Objeto de mapa disponível em scripts de mapa de transformação que contém o registro de mapa de transformação atual. |
| log | Objeto | Objeto de log disponível em scripts de mapa de transformação. |
| Parâmetro | Descrição |
|---|---|
| <String> | Cadeia de caracteres formatada JSON que é uma lista de resultados dos itens de configuração na cadeia de caracteres de entrada. Tipo de dados: Cadeia de caracteres |
| ItemsCommittedAditionalCommittedItems <String> | Lista de ICs que foram confirmados durante o processamento de IRE da carga atual, mas não estavam presentes na carga de entrada atual. Tipo de dados: Matriz de objetos |
| ItemsCommittedItems.Classname.additionalCommittedItems.Classname <String> | Sys_class_name deste IC adicional. Tipo de dados: Cadeia de caracteres |
| ItemsCommittedItems.Erros adicionais <String> | Número de erros encontrados ao processar este IC adicional. Tipo de dados: Número |
| ItemsCommittedItems.additionalCommittedItems.Errors <String> | Matriz de objetos que descreve erros encontrados durante o processamento deste IC adicional. Tipo de dados: Matriz |
| ItemsCommittedItems.errors.additionalCommittedItems.error <String> | Tipo de erro encontrado ao processar o IC adicional. Tipo de dados: Cadeia de caracteres |
| <String>.additionalCommittedItems.errors.message | Mensagem de erro encontrada ao processar o IC adicional. Tipo de dados: Cadeia de caracteres |
| ItemsAtivoAçãoAmistoCommittedItems.IdentificationAttents <String> | Matriz de objetos em que cada objeto descreve uma tentativa feita para identificar este IC adicional. Tipo de dados: Matriz de objetos |
| AdditionalCommittedItems.IdentificationAttempts.attemptResult <String> | Resultado desta tentativa de identificação de IC adicional. Tipo de dados: Cadeia de caracteres Valores possíveis:
|
| Atributos.IdentificaçãoAmistedItems.IdentificationAttributes <String> | Atributos de entrada do identificador de IC usados durante esta tentativa de identificação de IC adicional. Tipo de dados: Matriz Os nomes e tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| ItemDeDeCommittedItems.IdentificationAttempts.hybridEntryCiAttributes <String> | Matriz de atributos de entrada de identificador de IC usados durante esta tentativa de identificação de IC adicional. Tipo de dados: Matriz Os nomes e tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| ItemsAIdentificationAttents.IdentificationAttents.IdentificerName <String> | Regra de identificador usada para esta tentativa de identificação de IC adicional. Tipo de dados: Cadeia de caracteres |
| <String>.additionalCommittedItems.identificationAttempts.searchOnTable | Nome da tabela pesquisada para esta tentativa de identificação de IC adicional. Tipo de dados: Cadeia de caracteres |
| ItemsItemsEntyEntryEntryItemsId.additionalCommittedItems.identifierEntryEntryId <String> | Sys_id para a regra de identificador usada para identificar este IC adicional. Valores notáveis - Desconhecido: Falha na identificação deste IC adicional. Consulte errorspara obter detalhes. |
| <String>.additionalCommittedItems.inputIndices | Valores de índice para ICs do corpo da solicitação itemsMatriz que corresponde a este IC adicional. Tipo de dados: Matriz de números |
| ItemsCommittedItems.additionalCommittedItems.markers <String> | Valores do marcador para uso interno. Tipo de dados: Matriz |
| ItemsCommittedItems.mergedPayloads adicionais <String> | Valores sys_id para cargas parciais da tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads] que foram mescladas durante o processamento deste IC adicional. Tipo de dados: Matriz |
| ItemsCommittedItems.adicionais <String> | Operação realizada para este IC adicional. Tipo de dados: Cadeia de caracteres Valores possíveis:
|
| ItemsCommittedItems.SYSID.additionalCommittedItems.SYSID <String> | Sys_id encontrado para este IC adicional por meio de identificação. Tipo de dados: Cadeia de caracteres Valores notáveis - Desconhecido: Falha na identificação deste IC adicional. Consulte errorspara obter detalhes. |
| ItemsCommittedItems.additionalCommittedItems.warnings <String> | Descrição dos avisos encontrados durante o processamento deste IC adicional. Tipo de dados: Matriz de objetos |
| ItemsCommittedItems.warnings.error <String> | Tipo de aviso encontrado ao processar este IC adicional. Tipo de dados: Cadeia de caracteres |
| ItemsCommittedItems.warnings.message <String> | Mensagem de aviso encontrada durante o processamento deste IC adicional. Tipo de dados: Cadeia de caracteres |
| RelacionaçõesCommitedadicionais <String> | Descrição de um IC de relacionamento dependente que não foi incluído no corpo da solicitação relationslista a ser inserida ou atualizada. Tipo de dados: Matriz de objetos |
| AdditionalCommittedRelations.Classname <String> | O sys_class_name deste IC de relacionamento dependente adicional. Tipo de dados: Cadeia de caracteres Somente valor compatível: cmdb_rel_ci: A tabela de relacionamento de IC. |
| RelacionaçõesCommitedadicionais.Contagem de erros <String> | Número de erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: Número |
| RelacionadosCommittedRelacionadosadicionais.Erros <String> | Descrição dos erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: Matriz de objetos |
| RelacionadosCommittedRelacionamentos.Erros.AditionalCommittedRelacionamentos.Errors <String> | Tipo de erro encontrado ao processar o IC de relacionamento dependente adicional. Tipo de dados: Cadeia de caracteres |
| Relacionamentos.additionalCommittedRelacionamentos.Erros.mensagem <String> | Mensagem de erro encontrada ao processar este IC de relacionamento dependente adicional. Tipo de dados: Cadeia de caracteres |
| <String>.additionalCommittedRelations.inputIndices | Valores de índice para objetos de IC de relacionamento dependente no corpo da solicitação relationsMatriz que corresponde a este IC de relacionamento dependente adicional. Tipo de dados: Matriz |
| RelacionadosCommitedRelacionadosadicionais.marcadores <String> | Valores do marcador para uso interno. Tipo de dados: Matriz |
| RelacionaçõesDeRelacionadosDeCompromisso.mergedPayloadIds <String> | Valores sys_id para cargas parciais da tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads] que foram mesclados para este IC.Que foram mesclados durante o processamento deste IC de relacionamento dependente adicional. Tipo de dados: Matriz |
| RelacionaçõesCommitedadicionais.Operação <String> | Operação que foi realizada para o IC de relacionamento dependente adicional. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Erro.hasErro <String> | Sinalizador que indica se algum item ou relação tem erros. Tipo de dados: Booliano |
| <String>.hasWarning | Sinalizador que indica se algum item ou relação tem avisos. Tipo de dados: Booliano |
| Itens.<String> | Descrição dos ICs criados ou atualizados. Tipo de dados: Matriz de objetos |
| ItemsRelacionadosadicionais.ItemsRelacionadosadicionais <String> | Informações sobre pesquisa adicional e itens relacionados que foram processados, mas não fornecidos como parte da carga de entrada. Esses itens são de cargas úteis parciais. Tipo de dados: Matriz de objetos |
| Items.itens.additionalRelatedItems.classname <String> | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres |
| <String>.items.additionalRelatedItems.inputIndices | Valores de índice para ICs do corpo da solicitação itemsmatriz que corresponde a este item relacionado. Tipo de dados: Matriz de números |
| Items.ItemsRelacionadosadicionais.mergedPayloadIds <String> | Lista de sys_ids das cargas parciais que foram mescladas no item relacionado. Tipo de dados: Matriz Tabela: Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads] |
| Items.Items.Relacionadosadicionais.Operação <String> | Tipo de operação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Items.Items.SYSID Relacionadosadicionais.Items.Items.Items.AditionalRelacionados <String> | Sys_id do IC que foi atualizado ou criado. Tipo de dados: Cadeia de caracteres |
| <String>.items.classname | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres |
| Itens.duplicadosIndices <String> | Lista de índices de ICs duplicados do item atual. Tipo de dados: Matriz |
| Items.ErrorCount <String> | Número de erros encontrados ao processar o item. Tipo de dados: Número |
| Itens.Erros.Itens.<String> | Lista de erros encontrados ao processar este IC. Tipo de dados: Matriz de objetos |
| <String>.itens.errors.error | Tipo de erro encontrado ao processar o IC. Tipo de dados: Cadeia de caracteres |
| <String>.itens.errors.message | Mensagem de erro associada ao erro. Tipo de dados: Cadeia de caracteres |
| <String>.items.IdentificationAttents | Lista de tentativas feitas para identificar os ICs. Tipo de dados: Matriz de objetos |
| IdentificationAttempts.attempts.attemptResult <String> | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Atributos.IdentificationAttempts.Attributes.IdentificationAttributes <String> | Lista de atributos de entrada de identificador de IC que foram usados durante o processo de identificação. Tipo de dados: Matriz Os nomes e tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| Atributos.IdentificationAttempts.hybridEntryCiEntryCiAttributes <String> | Lista de atributos de entrada de identificador de IC que foram usados durante o processo de identificação. Tipo de dados: Matriz Os nomes e tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| IdentificationAttempts.IdentificationAttents.IdentificationName <String> | Regra de identificador usada para esta tentativa de identificação de IC. Tipo de dados: Cadeia de caracteres |
| <String>.items.identificationAttempts.searchOnTable | Nome da tabela pesquisada durante o processo de identificação. Tipo de dados: Cadeia de caracteres |
| IdSysEntryEntysid.IdentifierEntryId.IdentifierId <String> | Sys_id para a regra de identificador usada para identificar o IC. Tipo de dados: Cadeia de caracteres Entrada do identificador [cmdb_identifier_entry] |
| <String>.items.incompleteSysIds | Se o item tiver erros e tiver sido salvo como uma carga incompleta, este parâmetro conterá o sys_id do registro na tabela Cargas incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads]. Tipo de dados: Cadeia de caracteres |
| <String>.items.info | Informações adicionais sobre o processamento do item. Tipo de dados: Matriz de objetos |
| <String>.items.info.code | Tipo de reclassificação ignorado. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <String>.items.info.message | Mensagem que fornece informações adicionais sobre o motivo para ignorar a reclassificação. Tipo de dados: Cadeia de caracteres |
| <String>.items.info.ruleSysId | Sys_id da regra de restrição de reclassificação que foi correspondida. Aplicável somente quando o IRE ignora a reclassificação devido à regra de restrição de reclassificação. Este valor ficará vazio se a reclassificação for ignorada devido a uma carga útil ou sinalizador global. Tipo de dados: Cadeia de caracteres |
| <String>.items.inputIndices | Índices do IC de entrada correspondente. Para itens de nível superior, é uma lista de números inteiros. Para ICs relacionados ou de pesquisa, é a lista de objetos JSON. Tipo de dados: Matriz de números |
| <String>.itens.atributos masked | Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido por Regras de reconciliação . Tipo de dados: Matriz |
| <String>.itens.operação | Operação que ocorreu. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| SysIds.partialSysIds <String> | Se o item tiver erros e tiver sido salvo como uma carga parcial, este parâmetro conterá o sys_id do registro de carga parcial. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.RelatedItems <String> | Lista de objetos JSON que descrevem um IC relacionado (IC de pesquisa de tabela) do corpo da solicitação items.lookupmatriz. Tipo de dados: Matriz de objetos |
| Items.RelatedItems.Classname <String> | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.Erros.RelatedItems <String> | Lista de erros que ocorreram durante o processamento do item relacionado. Tipo de dados: Matriz de objetos |
| Items.RelatedItems.Errors.ERROR <String> | Tipo de erro encontrado ao processar o item relacionado. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.Errors.message <String> | Mensagem de erro associada ao erro. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.ErrorCount <String> | Número de erros detectados ao processar os itens relacionados. Tipo de dados: Número |
| <String>.items.relatedItems.incompleteSysIds | Se a relação tiver erros e tiver sido salva como uma carga incompleta, este valor será o sys_id do registro na tabela Cargas Incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads]. Tipo de dados: Cadeia de caracteres |
| <String>.items.relatedItems.inputIndices | Índice do item de entrada correspondente. Para itens de nível superior, é uma lista de números inteiros. Para itens relacionados ou de pesquisa, é a lista de objetos JSON. Tipo de dados: Matriz de números ou Matriz de objetos |
| <String>.items.relatedItems.inputIndices.mainIndex | Valor de índice do corpo da solicitação itemsMatriz que corresponde ao IC primário do item relacionado. Tipo de dados: Número |
| <String>.items.relatedItems.inputIndices.subIndex | Valor de índice do corpo da solicitação items.lookupmatriz que corresponde ao item relacionado. Tipo de dados: Número |
| Items.RelatedItems.mergedPayloadIds <String> | Lista de sys_ids das cargas parciais que foram mescladas no IC durante o processamento. Tipo de dados: Matriz |
| Items.RelatedItems.Operation <String> | Operação que ocorreu. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.PartialSysIds <String> | Se o item relacionado tiver erros e tiver sido salvo como uma carga parcial, conterá uma lista dos sys_ids dos registros associados na tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads]. Tipo de dados: Matriz |
| Items.RelatedItems.SYSID.Items.RelatedItems <String> | Sys_id do item relacionado. Tipo de dados: Cadeia de caracteres |
| Items.RelatedItems.warningCount <String> | Número de avisos encontrados ao processar os itens relacionados. Tipo de dados: Número |
| Items.RelatedItems.warnings <String> | Descrição dos avisos encontrados durante o processamento dos itens relacionados. Tipo de dados: Matriz de objetos |
| Items.RelatedItems.warnings.error.RelatedItems.<String> | Tipo de aviso encontrado ao processar o item relacionado. Tipo de dados: Cadeia de caracteres |
| Items.relatedItems.warnings.message <String> | Mensagem associada ao aviso. Tipo de dados: Cadeia de caracteres |
| SysIds.RelatedSysIds <String> | Lista de valores sys_id dos ICs usados durante a identificação baseada em pesquisa de itens relacionados. Tipo de dados: Cadeia de caracteres |
| <String>.items.sys_id | Sys_id do IC que foi atualizado ou criado. Tipo de dados: Cadeia de caracteres |
| <String>.relations | Descrição de um IC de relacionamento dependente do corpo da solicitação relationsmatriz. Tipo de dados: Matriz de objetos |
| <String>.relations.classname | Sys_class_name deste IC de relacionamento dependente. Somente valor compatível: cmdb_rel_ci: Tabela de relacionamento de IC. Tipo de dados: Cadeia de caracteres |
| Relations.ErrorCount.<String> | Número de erros encontrados ao processar o IC de relacionamento dependente. Tipo de dados: Número |
| Relações.Erros.Relacionamento.<String> | Lista que descreve os erros encontrados durante o processamento deste IC de relacionamento dependente. Tipo de dados: Matriz de objetos |
| <String>.relations.errors.errors.error | Tipo de erro encontrado ao processar o IC de relacionamento dependente. Tipo de dados: Cadeia de caracteres |
| <String>.relations.errors.message | Mensagem de erro encontrada ao processar este IC de relacionamento dependente. Tipo de dados: Cadeia de caracteres |
| <String>.relations.incompleteSysIds | Se a relação tiver erros e tiver sido salva como uma carga incompleta, este valor será o sys_id do registro na tabela Cargas Incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads]. Tipo de dados: Cadeia de caracteres |
| <String>.relations.inputIndices | Índices para os objetos de IC de relacionamento dependente no corpo da solicitação relationsMatriz que corresponde a este IC de relacionamento dependente. Tipo de dados: Matriz |
| Relations.Operation.<String> | Tipo de operação realizada. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| SysIds.partialSysIds.partialsIds <String> | Se a relação tiver erros e tiver sido salva como uma carga parcial, esse valor será o sys_id do registro na tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads]. Tipo de dados: Cadeia de caracteres |
| SYSID.relations.SYSID <String> | Sys_id do IC de relacionamento dependente. Tipo de dados: Cadeia de caracteres |
| Resumo.<String> | Lista de propriedades JSON que fornecem estatísticas sobre quantos itens foram inseridos, atualizados e similares por classe. Tipo de dados: Matriz |
| <String>.Summary.<class_name> | Estatísticas de uma classe específica. Tipo de dados: Objeto |
| <String>.summary.<class_name>.additionalInsertedItemCount | Número de itens inseridos devido ao processamento de cargas parciais. Tipo de dados: Número |
| <String>.summary.<class_name>.errorCount | Número de erros encontrados ao processar itens. Tipo de dados: Número |
| <String>.summary.<class_name>.incompleteItemCount | Número de itens inseridos na tabela Cargas Incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads]. Tipo de dados: Número |
| <String>.summary.<class_name>.insertedItemCount | Número de itens criados. Tipo de dados: Número |
| <String>.summary.<class_name>.PartialItemCount | Número de itens salvos na tabela Carga parcial [cmdb_ire_partial_payloads]. Tipo de dados: Número |
| <String>.summary.<class_name>.skippedItemCount | Número de itens ignorados. Tipo de dados: Número |
| <String>.summary.<class_name>.unchangedItemCount | Número de itens que tinham entradas, mas não foram modificados. Tipo de dados: Número |
| <String>.summary.<class_name>.updatedItemCount | Número de itens atualizados. Tipo de dados: Número |
| <String>.summary.<class_name>.warningCount | Número de itens que geraram um aviso quando processados. Tipo de dados: Número |
Este exemplo de código mostra como obter a carga de um ImportSet, onde você pode atualizar a carga e definir a nova carga antes de chamar o. CmdbUtil.IdentifyAndReconcileEnhanced() método para processar a carga.
// Add this code to the onBefore transform map script
// Ability to modify the payload using get and set APIs
// Call cmdbUtil API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
var payload = cmdbUtil.getPayload(source, map, log);
// Modify the payload here
cmdbUtil.setPayload(payload);
cmdbUtil.identifyAndReconcileEnhanced(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());
}
CMDBTransformUtil - hasError()
Determina se ocorreu um erro no anterior IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() chamada de método.
Use este método em scripts de mapa de transformação onBefore.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
| Tipo | Descrição |
|---|---|
| Booliano | Sinalizador que indica se ocorreu um erro no chamado anteriormente IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() método. Valores possíveis:
|
// Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(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());
}
Equivalente com escopo
Não há equivalente com escopo para este método.
CMDBTransformUtil - identifyAndReconcile(origem do objeto, mapa do objeto, log do objeto)
Insere ou atualiza um item de configuração (IC) no Configuration Management Database (CMDB).
Use este método em scripts de mapa de transformação onBefore. Usar este método em vez de depender da transformação para inserir ou atualizar o registro do item de configuração reduz as entradas duplicadas no CMDB. Para obter informações adicionais, consulte Aplicar Identificação e reconciliação de IC a conjuntos de importação .
Para impedir que a transformação adicione ou atualize o registro uma segunda vez, defina verdadeiro .
| Nome | Tipo | Descrição |
|---|---|---|
| origem | Objeto | Objeto global disponível em scripts de mapa de transformação que contém o registro de entrada. |
| mapa | Objeto | Objeto de mapa disponível em scripts de mapa de transformação que contém o registro de mapa de transformação atual. |
| log | Objeto | Objeto de log disponível em scripts de mapa de transformação. |
| Tipo | Descrição |
|---|---|
| vazio |
Este exemplo de código mostra como chamar IdentifyAndReconcile() método para processar a linha atual da carga de entrada.
// Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcile(source, map, log);
ignore = true;
CMDBTransformUtil - identifyAndReconcileEnhanced (origem do objeto, mapa do objeto, log do objeto)
Insere ou atualiza um item de configuração (IC) no Configuration Management Database (CMDB).
Além de fornecer a funcionalidade do CMDBTransformUtil.IdentifyAndReconcile() este método também oferece suporte a:
- Lidar com cargas parciais
- Manipulando confirmações parciais
- Removendo itens duplicados em uma carga
- Gerando resumos de saída
Para obter informações adicionais sobre Identificação e reconciliação e explicações mais detalhadas dos dados usados por este método, consulte IRE (Identificação e reconciliação) .
| Nome | Tipo | Descrição |
|---|---|---|
| origem | Objeto | Objeto global disponível em scripts de mapa de transformação que contém o registro de entrada. |
| mapa | Objeto | Objeto de mapa disponível em scripts de mapa de transformação que contém o registro de mapa de transformação atual. |
| log | Objeto | Objeto de log disponível em scripts de mapa de transformação. |
| Tipo | Descrição |
|---|---|
| Nenhum(a) |
Este exemplo de código mostra como chamar IdentifyAndReconcileEnhanced() método para processar a carga passada.
// Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;
CMDBTransformUtil - logTransformStats(log de objeto)
Registra o número de itens de configuração (IC) inseridos, atualizados, ignorados ou que tiveram erros.
Use este método em scripts de mapa de transformação onComplete.
| Nome | Tipo | Descrição |
|---|---|---|
| log | Objeto | Objeto de log disponível em scripts de mapa de transformação. |
| Tipo | Descrição |
|---|---|
| vazio |
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.logTransformStats(log);
Equivalente com escopo
Não há equivalente com escopo para este método.
CMDBTransformUtil - setDataSource(origem de cadeia de caracteres)
Define a fonte de dados a ser usada quando IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() o método é chamado.
Use este método em Antes scripts de mapa de transformação. Se este método não for chamado, o valor padrão Conjunto de importação .
| Nome | Tipo | Descrição |
|---|---|---|
| origem | Cadeia de caracteres | Fonte de dados para o registro do item de configuração de origem. |
| Tipo | Descrição |
|---|---|
| vazio |
// Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(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());
}
Equivalente com escopo
Não há equivalente com escopo para este método.