CMDBTransformUtil - Global
A inclusão de script CMDBTransformUtil 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 scripts de mapa de transformação onBefore. Você não pode usar esta classe em outros scripts. Para obter informações adicionais sobre como a estrutura do IRE opera, consulte Reconciliação e identificação no CMDB.
CMDBTransformUtil - CMDBTransformUtil()
Cria um objeto CMDBTransformUtil.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
var cmdbUtil = new CMDBTransformUtil();
CMDBTransformUtil – getError()
Retorna todos os erros gerados pela chamada de método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() anterior.
Use este método em scripts de mapa de transformação onBefore para obter erros. Use o método hasError() para detectar primeiro quaisquer erros do método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced().
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
| Tipo | Descrição |
|---|---|
| Cadeia de caracteres | Mensagem de erro de IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced(). |
// 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 da chamada de método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() anterior.
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 no formato 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 de nome-valor. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedItems | Nenhum valor é retornado no momento. |
| <String>.additionalCommittedRelations | Nenhum valor é retornado no momento. |
| <String>.itens | Descrição dos ICs criados ou atualizados. Tipo de dados: objeto |
| <String>.items.additionalRelatedItems | 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 parciais. Essas informações não são retornadas no momento. Tipo de dados: matriz de objetos |
| <String>.items.additionalRelatedItems.className | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: cadeia de caracteres |
| <String>.itens.adicionaisRelatedItems.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>.itens.adicionaisItensRelacionados.InputIndices.mainIndex | Valor de índice da matriz items do corpo da solicitação que corresponde ao IC primário do item relacionado adicional. Tipo de dados: número |
| <String>.itens.adicionaisRelatedItems.inputIndices.subIndex | Valor de índice da matriz items.lookup do corpo da solicitação que corresponde ao item relacionado adicional. Tipo de dados: número |
| <String>.itens.adicionaisItensRelacionados.operação | Tipo de operação. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.additionalRelatedItems.sysId | 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 |
| <String>.itens.Indicesduplicados | Lista de índices de ICs que são duplicatas do item atual. Tipo de dados: matriz |
| <String>.items.errorCount | Número de erros. Tipo de dados: número |
| <String>.itens.erros | Lista de erros encontrados ao processar este IC. Tipo de dados: matriz de objetos |
| <String>.itens.erros.erro | Tipo de erro encontrado ao processar o IC. Tipo de dados: cadeia de caracteres |
| <String>.itens.erros.mensagem | Mensagem de erro associada ao erro. Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas | Lista de tentativas feitas para identificar os ICs. Tipo de dados: matriz de objetos |
| <String>.itens.identificaçãoTentativas.tentativaResultado | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas.atributos | Lista de atributos de entrada do 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: |
| <String>.items.identificationAttempts.hybridEntryCiAttributes | Nenhum valor é retornado no momento. |
| <String>.itens.identificaçãoTentativas.identificadorNome | Regra de identificador usada para esta tentativa de identificação de IC. Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas.pesquisaNaTabela | Nome da tabela pesquisada durante o processo de identificação. Tipo de dados: cadeia de caracteres |
| <String>.items.identifierEntrySysId | Sys_id da regra do identificador usada para identificar o IC. Tipo de dados: cadeia de caracteres Tabela: entrada de identificador [cmdb_identifier_entry] |
| <String>.itens.info | Lista que contém informações adicionais sobre o processamento do item. Tipo de dados: matriz de objetos |
| <String>.itens.info.código | Tipo de reclassificação que foi ignorado. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.itens.informações.mensagem | 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>.itens.InputIndices | Valores de índice para ICs da matriz items do corpo da solicitação que correspondem a este IC. Tipo de dados: matriz |
| <String>.itens.atributosmascarados | Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido pelas Regras de reconciliação. Tipo de dados: matriz |
| <String>.itens.itens.relacionados | Lista que fornece informações sobre os itens relacionados processados. Tipo de dados: matriz de objetos |
| <String>.items.relatedItems.className | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.itens.itens.relacionados.erros | Lista de erros ocorridos durante o processamento. Tipo de dados: matriz de objetos |
| <String>.items.relatedItems.errorCount | Número de erros detectados durante o processamento. Tipo de dados: número |
| <String>.itens.itens.relacionados.IndicesDeEntrada | Índices dos itens relacionados correspondentes. Tipo de dados: matriz ou números |
| <String>.itens.relatedItems.inputIndices.mainIndex | Valor inteiro da matriz items do corpo da solicitação que corresponde ao IC primário do item relacionado. Tipo de dados: número |
| <String>.itens.itens.relacionados.InputIndices.subIndex | Valor inteiro da matriz items.lookup do corpo da solicitação que corresponde ao item relacionado. Tipo de dados: número |
| <String>.itens.itens.relacionados.operação | Tipo de operação. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.relatedSysIds | Lista dos valores de sys_id para itens relacionados (itens de pesquisa de tabela) da matriz items.lookup do corpo da solicitação. Valores notáveis - nulo: nenhum sys_id foi identificado para este item relacionado. Tipo de dados: matriz |
| <String>.itens.sys_id | Sys_id do IC que foi atualizado ou criado. Tipo de dados: cadeia de caracteres |
| <String>.relações | 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 |
| <String>.relations.errorCount | Número de erros. Tipo de dados: número |
| <String>.relations.inputIndices | Índices das relações de entrada correspondentes. Tipo de dados: matriz |
| <String>.relacionamento.operação | Tipo de operação realizada. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.relations.sysId | 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.
Você pode modificar a carga útil e usar o método setPayload() para armazenar a carga atualizada. Depois que a carga for modificada e armazenada, use IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() para processar a carga.
| Nome | Tipo | Descrição |
|---|---|---|
| Fonte | 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 do 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 no formato JSON que é uma lista de resultados dos itens de configuração na cadeia de caracteres de entrada. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedItems | 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 |
| <String>.additionalCommittedItems.className | Sys_class_name deste IC adicional. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedItems.errorCount | Número de erros encontrados ao processar este IC adicional. Tipo de dados: número |
| <String>.additionalCommittedItems.errors | Matriz de objetos que descreve os erros encontrados ao processar este IC adicional. Tipo de dados: matriz |
| <String>.additionalCommittedItems.errors.error | 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 |
| <String>.additionalCommittedItems.identificationAttempts | Matriz de objetos em que cada objeto descreve uma tentativa feita para identificar este IC adicional. Tipo de dados: matriz de objetos |
| <String>.additionalCommittedItems.identificationAttempts.attemptResult | Resultado desta tentativa de identificação de IC adicional. Tipo de dados: cadeia de caracteres Valores possíveis:
|
| <String>.additionalCommittedItems.identificationAttempts.attributes | 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: |
| <String>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes | Matriz de atributos de entrada do identificador de IC usada 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: |
| <String>.additionalCommittedItems.identificationAttempts.identifierName | 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 |
| <String>.additionalCommittedItems.identifierEntrySysId | Sys_id da regra do identificador usada para identificar este IC adicional. Valores notáveis - Desconhecido: falha na identificação deste IC adicional. Consulte errors para obter detalhes. |
| <String>.additionalCommittedItems.inputIndices | Valores de índice para ICs da matriz items do corpo da solicitação que correspondem a este IC adicional. Tipo de dados: matriz de números |
| <String>.additionalCommittedItems.marcadores | Valores de marcador para uso interno. Tipo de dados: matriz |
| <String>.additionalCommittedItems.mergedPayloads | Valores de Sys_id para cargas parciais da tabela Cargas Parciais IRE do CMDB [cmdb_ire_partial_payloads] que foram mesclados durante o processamento deste IC adicional. Tipo de dados: matriz |
| <String>.additionalCommittedItems.operation | Operação realizada para este IC adicional. Tipo de dados: cadeia de caracteres Valores possíveis:
|
| <String>.additionalCommittedItems.sysId | 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 errors para obter detalhes. |
| <String>.additionalCommittedItems.avisos | Descrição dos avisos encontrados durante o processamento deste IC adicional. Tipo de dados: matriz de objetos |
| <String>.additionalCommittedItems.warnings.error | Tipo de aviso encontrado ao processar este IC adicional. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedItems.warnings.message | Mensagem de aviso encontrada ao processar este IC adicional. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedRelations | Descrição de um IC de relacionamento dependente que não foi incluído na lista relations do corpo da solicitação a ser inserida ou atualizada. Tipo de dados: matriz de objetos |
| <String>.additionalCommittedRelations.className | 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. |
| <String>.additionalCommittedRelations.errorCount | Número de erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: número |
| <String>.additionalCommittedRelations.errors | Descrição dos erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: matriz de objetos |
| <String>.additionalCommittedRelations.errors.error | Tipo de erro encontrado ao processar o IC de relacionamento dependente adicional. Tipo de dados: cadeia de caracteres |
| <String>.additionalCommittedRelations.errors.message | 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 na matriz relations do corpo da solicitação que correspondem a este IC de relacionamento dependente adicional. Tipo de dados: matriz |
| <String>.additionalCommittedRelations.marcadores | Valores de marcador para uso interno. Tipo de dados: matriz |
| <String>.additionalCommittedRelations.mergedPayloadIds | Valores de Sys_id para cargas parciais da tabela Cargas Parciais 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 |
| <String>.additionalCommittedRelations.operation | Operação que foi realizada para o IC de relacionamento dependente adicional. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.temErro | Sinalizador que indica se algum item ou relação tem erros. Tipo de dados: booliano |
| <String>.temAviso | Sinalizador que indica se algum item ou relação tem avisos. Tipo de dados: booliano |
| <String>.itens | Descrição dos ICs criados ou atualizados. Tipo de dados: matriz de objetos |
| <String>.items.additionalRelatedItems | 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 parciais. Tipo de dados: matriz de objetos |
| <String>.items.additionalRelatedItems.className | Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: cadeia de caracteres |
| <String>.itens.adicionaisRelatedItems.inputIndices | Valores de índice para ICs da matriz items do corpo da solicitação que correspondem a este item relacionado. Tipo de dados: matriz de números |
| <String>.items.additionalRelatedItems.mergedPayloadIds | Lista de sys_ids das cargas parciais que foram mescladas no item relacionado. Tipo de dados: matriz Tabela: cargas parciais de IRE do CMDB [cmdb_ire_partial_payloads] |
| <String>.itens.adicionaisItensRelacionados.operação | Tipo de operação. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.additionalRelatedItems.sysId | 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 |
| <String>.itens.Indicesduplicados | Lista de índices de ICs que são duplicatas do item atual. Tipo de dados: matriz |
| <String>.items.errorCount | Número de erros encontrados ao processar o item. Tipo de dados: número |
| <String>.itens.erros | Lista de erros encontrados ao processar este IC. Tipo de dados: matriz de objetos |
| <String>.itens.erros.erro | Tipo de erro encontrado ao processar o IC. Tipo de dados: cadeia de caracteres |
| <String>.itens.erros.mensagem | Mensagem de erro associada ao erro. Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas | Lista de tentativas feitas para identificar os ICs. Tipo de dados: matriz de objetos |
| <String>.itens.identificaçãoTentativas.tentativaResultado | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas.atributos | Lista de atributos de entrada do 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: |
| <String>itens.identificationAttempts.hybridEntryCiAttributes | Lista de atributos de entrada do 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: |
| <String>.itens.identificaçãoTentativas.identificadorNome | Regra de identificador usada para esta tentativa de identificação de IC. Tipo de dados: cadeia de caracteres |
| <String>.itens.identificaçãoTentativas.pesquisaNaTabela | Nome da tabela pesquisada durante o processo de identificação. Tipo de dados: cadeia de caracteres |
| <String>.items.identifierEntrySysId | Sys_id da regra do identificador usada para identificar o IC. Tipo de dados: cadeia de caracteres Tabela: entrada de 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>.itens.info.código | Tipo de reclassificação que foi ignorado. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.itens.informações.mensagem | 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>.itens.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.atributosmascarados | Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido pelas 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 |
| <String>.items.partialSysIds | Se o item tiver erros e tiver sido salvo como uma carga útil parcial, este parâmetro conterá o sys_id do registro de carga útil parcial. Tipo de dados: cadeia de caracteres |
| <String>.itens.itens.relacionados | Lista de objetos JSON que descrevem um IC relacionado (IC de pesquisa de tabela) da matriz items.lookup do corpo da solicitação. Tipo de dados: matriz de objetos |
| <String>.items.relatedItems.className | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.itens.itens.relacionados.erros | Lista de erros ocorridos durante o processamento do item relacionado. Tipo de dados: matriz de objetos |
| <String>.itens.itens.relacionados.erros.erro | Tipo de erro encontrado ao processar o item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.itens.itens.relacionados.erros.mensagem | Mensagem de erro associada ao erro. Tipo de dados: cadeia de caracteres |
| <String>.items.relatedItems.errorCount | 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>.itens.itens.relacionados.IndicesDeEntrada | Í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>.itens.relatedItems.inputIndices.mainIndex | Valor de índice da matriz items do corpo da solicitação que corresponde ao IC primário do item relacionado. Tipo de dados: número |
| <String>.itens.itens.relacionados.InputIndices.subIndex | Valor de índice da matriz items.lookup do corpo da solicitação que corresponde ao item relacionado. Tipo de dados: número |
| <String>.items.relatedItems.mergedPayloadIds | Lista de sys_ids das cargas parciais que foram mescladas no IC durante o processamento. Tipo de dados: matriz |
| <String>.itens.itens.relacionados.operação | Operação que ocorreu. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.relatedItems.partialSysIds | Se o item relacionado tiver erros e tiver sido salvo como uma carga útil 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 |
| <String>.items.relatedItems.sysId | Sys_id do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.items.relatedItems.warningCount | Número de avisos encontrados ao processar os itens relacionados. Tipo de dados: número |
| <String>.itens.itens.relacionados.avisos | Descrição de avisos encontrados durante o processamento dos itens relacionados. Tipo de dados: matriz de objetos |
| <String>.itens.itens.relacionados.avisos.erro | Tipo de aviso encontrado durante o processamento do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.itens.itens.relacionados.avisos.mensagem | Mensagem associada ao aviso. Tipo de dados: cadeia de caracteres |
| <String>.items.relatedSysIds | Lista dos valores de sys_id dos ICs usados durante a identificação baseada em pesquisa de itens relacionados. Tipo de dados: cadeia de caracteres |
| <String>.itens.sys_id | Sys_id do IC que foi atualizado ou criado. Tipo de dados: cadeia de caracteres |
| <String>.relações | Descrição de um IC de relacionamento dependente da matriz relations do corpo da solicitação. 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 |
| <String>.relations.errorCount | Número de erros encontrados ao processar o IC de relacionamento dependente. Tipo de dados: número |
| <String>.relacionamento.erros | Lista que descreve os erros encontrados durante o processamento deste IC de relacionamento dependente. Tipo de dados: matriz de objetos |
| <String>.relacionamento.erros.erro | Tipo de erro encontrado ao processar o IC de relacionamento dependente. Tipo de dados: cadeia de caracteres |
| <String>.relações.erros.mensagem | 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 na matriz relations do corpo da solicitação que correspondem a este IC de relacionamento dependente. Tipo de dados: matriz |
| <String>.relacionamento.operação | Tipo de operação realizada. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.relations.partialSysIds | Se a relação tiver erros e tiver sido salva como uma carga útil parcial, este valor será o sys_id do registro na tabela Cargas úteis parciais do IRE do CMDB [cmdb_ire_partial_payloads]. Tipo de dados: cadeia de caracteres |
| <String>.relations.sysId | Sys_id do IC de relacionamento dependente. Tipo de dados: cadeia de caracteres |
| <String>.resumo | Lista de propriedades JSON que fornecem estatísticas sobre quantos itens foram inseridos, atualizados e semelhantes por classe. Tipo de dados: matriz |
| <String>.resumo.<class_name> | Estatísticas para uma classe específica. Tipo de dados: objeto |
| <String>.resumo.<class_name> .additionalInsertedItemCount | Número de itens inseridos devido ao processamento de cargas parciais. Tipo de dados: número |
| <String>.resumo.<class_name> .contagemdeerros | Número de erros encontrados ao processar itens. Tipo de dados: número |
| <String>.resumo.<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>.resumo.<class_name> .insertedItemCount | Número de itens criados. Tipo de dados: número |
| <String>.resumo.<class_name> .partialItemCount | Número de itens salvos na tabela Carga Parcial [cmdb_ire_partial_payloads]. Tipo de dados: número |
| <String>.resumo.<class_name> .skippedItemCount | Número de itens que foram ignorados. Tipo de dados: número |
| <String>.resumo.<class_name> .unchangedItemCount | Número de itens que tinham entradas, mas não foram modificados. Tipo de dados: número |
| <String>.resumo.<class_name> .updateItemCount | Número de itens atualizados. Tipo de dados: número |
| <String>.resumo.<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, em que você pode atualizar a carga e definir a nova carga antes de chamar o método cmdbUtil.identifyAndReconcileEnhanced() 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 na chamada de método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() anterior.
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 método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() chamado anteriormente. 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 - identificaAndReconcile(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 contar com a 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 para importação.
Para impedir que a transformação adicione ou atualize o registro uma segunda vez, defina ignore = true.
| Nome | Tipo | Descrição |
|---|---|---|
| Fonte | 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 do 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 o método identificaAndReconcile() para processar a linha atual da carga útil 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 - identificaAndReconcileEnhanced(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 método CMDBTransformUtil.identifyAndReconcile(), este método também é compatível com:
- Manipulação de cargas parciais
- Manipulação de confirmações parciais
- Como remover itens duplicados em uma carga útil
- 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 Identificação e Reconciliação (IRE).
| Nome | Tipo | Descrição |
|---|---|---|
| Fonte | 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 do 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 o método identifyAndReconcileEnhanced() 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 em log o número de itens de configuração (IC) inseridos, atualizados, ignorados ou com 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(cadeia de caracteres source)
Define a fonte de dados a ser usada quando o método IdentifiqueAndReconcile() ou IdentifiqueAndReconcileEnhanced() for chamado.
Use este método em scripts de mapa de transformação onBefore. Se este método não for chamado, o valor padrão ImportSet.
| Nome | Tipo | Descrição |
|---|---|---|
| Fonte | 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.