CMDBTransformUtil - Global
A classe 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 de Identificação e Reconciliação funciona, consulte Identificação e Reconciliaçã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 pela chamada de método identifyAndReconcile() ou identifyAndReconcileEnhanced().
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 identifyAndReconcile() ou identifyAndReconcileEnhanced().
| 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 da chamada de método identifyAndReconcile() ou identifyAndReconcileEnhanced() anterior.
Use este método em scripts de mapa de transformação onBefore.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum |
| 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 | Lista de objetos que descrevem os ICs criados ou atualizados. Tipo de dados: matriz |
| <String>.items.adicionaisItensRelacionados | Lista de objetos JSON que fornece informações sobre pesquisa adicional e itens relacionados que foram processados, mas não fornecidos como parte da carga útil de entrada. Esses itens são de cargas úteis parciais. Essas informações não são retornadas no momento. Tipo de dados: matriz |
| <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>.items.adicionaisItensRelacionados.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.adicionaisItensRelacionados.índicesdeentrada.índiceprincipal | Valor de índice da matriz do corpo da solicitação items que corresponde ao primário do IC do item relacionado adicional. Tipo de dados: número |
| <String>.items.adicionaisItensRelacionados.índicesdeentrada.subíndice | Valor de índice da matriz do corpo da solicitação items.lookup que corresponde ao item relacionado adicional. Tipo de dados: número |
| <String>.items.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>.items.índicesduplicados | Lista de índices de ICs que são duplicatas do item atual. Tipo de dados: matriz |
| <String>.items.contagemdeerros | Número de erros. Tipo de dados: número |
| <String>.items.erros | Matriz de objetos em que cada objeto descreve um erro encontrado ao processar este IC. Tipo de dados: matriz |
| <String>.items.erros.erro | Tipo de erro encontrado ao processar o IC. Tipo de dados: cadeia de caracteres |
| <String>.items.erros.mensagem | Mensagem de erro associada ao erro. Tipo de dados: cadeia de caracteres |
| <String>.items.identificationAttempts | Lista de tentativas feitas para identificar os ICs. Tipo de dados: matriz |
| <String>.items.identificationAttempts.attemptResult | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.identificationAttempts.attributes | 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 os 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>.items.identificationAttempts.identifierName | Regra do 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 |
| <String>.items.identifierEntrySysId | Sys_id da regra do identificador usada para identificar o IC. Localizado na tabela Entrada do identificador [cmdb_identifier_entry]. Tipo de dados: cadeia de caracteres |
| <String>.items.info | Lista de objetos que contêm informações adicionais sobre o processamento do item. Tipo de dados: matriz |
| <String>.items.info.code | Tipo de reclassificação que foi ignorado. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.info.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>.items.índicesdeentrada | Valores de índice para ICs da matriz do corpo da solicitação items que correspondem a este IC. Tipo de dados: matriz |
| <String>.items.maskedAttributes | 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>.items.relatedItems | Lista de objetos JSON que fornece informações sobre os itens relacionados processados. Tipo de dados: matriz |
| <String>.items.relatedItems.className | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.items.Itens.relacionados.erros | Lista de erros que ocorreram durante o processamento. Tipo de dados: matriz |
| <String>.items.relatedItems.errorCount | Número de erros detectados durante o processamento. Tipo de dados: número |
| <String>.items.Itens.relacionados.IndicesDeEntrada | Índices dos itens relacionados correspondentes. Tipo de dados: matriz ou números |
| <String>.items.relatedItems.inputIndices.mainIndex | Valor inteiro da matriz do corpo da solicitação items que corresponde ao primário do IC do item relacionado. Tipo de dados: número |
| <String>.items.relatedItems.inputIndices.subIndex | Valor inteiro da matriz do corpo da solicitação items.lookup que corresponde ao item relacionado. Tipo de dados: número |
| <String>.items.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 do corpo da solicitação items.lookup. 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 | Lista de objetos JSON que fornece informações sobre as relações processadas. Tipo de dados: matriz |
| <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>.relations.operation | 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 e usar o método setPayload() para armazenar a carga atualizada. Depois que a carga útil for modificada e armazenada, use identifyAndReconcile() ou identifyAndReconcileEnhanced() para processar a carga útil.
| 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 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 útil atual, mas não estavam presentes na carga útil de entrada atual. Tipo de dados: matriz |
| <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 |
| <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 | 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 os 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 os 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 | Matriz de valores de índice para ICs da matriz do corpo da solicitação items que correspondem a este IC adicional. Tipo de dados: matriz |
| <String>.adicionaisItensConfirmados.marcadores | Matriz de valores de marcador para uso interno. Tipo de dados: matriz |
| <String>.additionalCommittedItems.mergedPayloads | Matriz de valores de sys_id para cargas úteis parciais da tabela Cargas úteis parciais do CMDB IRE [cmdb_ire_partial_payloads] que foram mescladas 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>.adicionaisItensConfirmados.avisos | Matriz de objetos que descreve um aviso encontrado ao processar este IC adicional. Tipo de dados: matriz |
| <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 | Matriz de objetos que descreve um IC de relacionamento dependente que não foi incluído na lista de corpo da solicitação relations para inserir ou atualizar. Tipo de dados: matriz |
| <String>.additionalCommittedRelations.className | O sys_class_name deste IC de relacionamento dependente adicional. Tipo de dados: cadeia de caracteres Somente o valor compatível: cmdb_rel_ci: a tabela 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 | Matriz de objetos que descreve os erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: matriz |
| <String>.additionalCommittedRelations.errors.error | Tipo de erro encontrado ao processar o IC de relacionamento dependente adicional. Tipo de dados: cadeia de caracteres |
| <String>.relaçóescomprometidaadicionais.mensagem.erros | A mensagem de erro encontrada ao processar este IC de relacionamento dependente adicional. Tipo de dados: cadeia de caracteres |
| <String>.relaçóescomprometidaadicionais.índicesdeentrada | Valores de índice para objetos de IC de relacionamento dependente na matriz do corpo da solicitação relations que correspondem a este IC de relacionamento dependente adicional. Tipo de dados: matriz |
| <String>.adicionaisRelaçõesConfirmadas.marcadores | Valores de marcador para uso interno. Tipo de dados: matriz |
| <String>.additionalCommittedRelations.mergedPayloadIds | Valores de Sys_id para cargas úteis parciais da tabela Cargas úteis parciais do CMDB IRE [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>.relaçãocomprometidaadicional.operação | Operação que foi realizada para o IC de relacionamento dependente adicional. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.hasError | 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 |
| <String>.itens | Matriz de objetos que descreve os ICs criados ou atualizados. Tipo de dados: matriz |
| <String>.items.adicionaisItensRelacionados | Lista de objetos JSON que fornecem informações sobre pesquisa adicional e itens relacionados que foram processados, mas não fornecidos como parte da carga útil de entrada. Esses itens são de cargas úteis parciais. Tipo de dados: matriz |
| <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>.items.adicionaisItensRelacionados.InputIndices | Valores de índice para ICs da matriz do corpo da solicitação items que correspondem a este item relacionado. Tipo de dados: matriz de números |
| <String>.items.additionalRelatedItems.mergedPayloadIds | Lista de sys_ids das cargas úteis parciais que foram mescladas no item relacionado. Localizado na tabela Cargas úteis parciais do CMDB IRE [cmdb_ire_partial_payloads]. Tipo de dados: matriz |
| <String>.items.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>.items.índicesduplicados | Lista de índices de ICs que são duplicatas do item atual. Tipo de dados: matriz |
| <String>.items.contagemdeerros | Número de erros encontrados ao processar o item. Tipo de dados: número |
| <String>.items.erros | Matriz de objetos em que cada objeto descreve um erro encontrado ao processar este IC. Tipo de dados: matriz |
| <String>.items.erros.erro | Tipo de erro encontrado ao processar o IC. Tipo de dados: cadeia de caracteres |
| <String>.items.erros.mensagem | Mensagem de erro associada ao erro. Tipo de dados: cadeia de caracteres |
| <String>.items.identificationAttempts | Lista de tentativas feitas para identificar os ICs. Tipo de dados: matriz |
| <String>.items.identificationAttempts.attemptResult | Resultados da tentativa de identificar o IC. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.identificationAttempts.attributes | 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 os tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| <String>items.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 os tipos de atributo dependem dos dados do corpo da solicitação e do identificador em uso, como: |
| <String>.items.identificationAttempts.identifierName | Regra do 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 |
| <String>.items.identifierEntrySysId | Sys_id da regra do identificador usada para identificar o IC. Localizado na tabela Entrada do identificador [cmdb_identifier_entry]. Tipo de dados: cadeia de caracteres |
| <String>.items.SysIds incompletos | 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 | Lista de objetos que contém informações adicionais sobre o processamento do item. Tipo de dados: matriz |
| <String>.items.info.code | Tipo de reclassificação que foi ignorado. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.info.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>.items.índicesdeentrada | Í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>.items.maskedAttributes | 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>.items.operação | Operação que ocorreu. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.IDsSistemaparciais | 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>.items.relatedItems | Lista de objetos JSON que descreve um IC relacionado (IC de pesquisa de tabela) da matriz do corpo da solicitação items.lookup. Tipo de dados: matriz |
| <String>.items.relatedItems.className | Nome da classe/tabela (sys_class_name) do item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.items.Itens.relacionados.erros | Lista de erros que ocorreram durante o processamento do item relacionado. Tipo de dados: matriz |
| <String>.items.relatedItems.errors.error | Tipo de erro encontrado ao processar o item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.items.Itens.relacionados.mensagem.erros | 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, esse 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.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>.items.relatedItems.inputIndices.mainIndex | Valor de índice da matriz do corpo da solicitação items que corresponde ao IC primário do item relacionado. Tipo de dados: número |
| <String>.items.relatedItems.inputIndices.subIndex | Valor de índice da matriz do corpo da solicitação items.lookup que corresponde ao item relacionado. Tipo de dados: número |
| <String>.items.relatedItems.mergedPayloadIds | Lista de sys_ids das cargas úteis parciais que foram mescladas no IC durante o processamento. Tipo de dados: matriz |
| <String>.items.Itens.relacionados.operação | Operação que ocorreu. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.items.relatedItems.parcialSysIds | Se o item relacionado tiver erros e tiver sido salvo como uma carga útil parcial, ele conterá uma lista dos sys_ids dos registros associados na tabela Cargas úteis parciais do CMDB IRE [cmdb_ire_partial_payloads]. Tipo de dados: matriz |
| <String>.items.relatedItems.sysId | O 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>.items.Itens.relacionados.avisos | Matriz de objetos que descreve um aviso encontrado ao processar os itens relacionados. Tipo de dados: matriz |
| <String>.items.relatedItems.warnings.error | Tipo de aviso encontrado ao processar o item relacionado. Tipo de dados: cadeia de caracteres |
| <String>.items.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>.items.sys_id | Sys_id do IC que foi atualizado ou criado. Tipo de dados: cadeia de caracteres |
| <String>.relations | Lista de objetos JSON que descrevem um IC de relacionamento dependente da matriz do corpo da solicitação relations. Tipo de dados: matriz |
| <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>.relations.errors | Matriz de objetos que descreve os erros encontrados ao processar este IC de relacionamento dependente. Tipo de dados: matriz |
| <String>.relations.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, esse 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 dos objetos de IC de relacionamento dependente na matriz do corpo da solicitação relations que correspondem a este IC de relacionamento dependente. Tipo de dados: matriz |
| <String>.relations.operation | Tipo de operação realizada. Valores possíveis:
Tipo de dados: cadeia de caracteres |
| <String>.relations.parcialSysIds | Se a relação tiver erros e tiver sido salva como uma carga útil parcial, esse 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>.summary | Lista de propriedades JSON que fornecem estatísticas sobre quantos itens foram inseridos, atualizados e outros, por classe. Tipo de dados: matriz |
| <String>.summary.<class_name> | Estatísticas para uma classe específica. Tipo de dados: objeto |
| <String>.summary.<class_name> .additionalInsertedItemCount | Número de itens inseridos devido ao processamento de cargas úteis 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 que foram 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, 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 identifyAndReconcile() ou identifyAndReconcileEnhanced().
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 identifyAndReconcile() ou identifyAndReconcileEnhanced(). 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 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 Import Sets.
Para impedir que a transformação adicione ou atualize o registro uma segunda vez, defina ignore = true.
| 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 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 identifyAndReconcile() 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 - 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 método CMDBTransformUtil.identifyAndReconcile(), este método também oferece suporte a:
- Manipulando cargas úteis parciais
- Manipulando confirmações parciais
- Removendo 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 |
|---|---|---|
| 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 do mapa de transformação atual. |
| log | Objeto | Objeto de log disponível em scripts de mapa de transformação. |
| Tipo | Descrição |
|---|---|
| Nenhum |
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 do objeto)
Registra em log o número de itens de configuração (IC) inseridos, atualizados, ignorados ou que tinham 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 identifyAndReconcile() ou identifyAndReconcileEnhanced() é 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 |
|---|---|---|
| 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.