CMDBTransformUtil - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 27 min. de leitura
  • . 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.

    Tabela 1. Parâmetros
    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.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    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.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)
    Tabela 5. Retornos
    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

    "items": { 
      "additionalRelatedItems": [Array],
      "className": "String",
      "duplicateIndices": [Array],
      "errorCount": Number,
      "errors": [Array],
      "identificationAttempts": [Array],
      "identifierEntrySysId": "String",
      "info": [Array],
      "inputIndices": [Array],
      "maskedAttributes": [Array],
      "operation": "String",
      "relatedItems": [Array],
      "relatedSysIds": [Array],
      "sysId": "String"
    }
    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

    "additionalRelatedItems": [ 
      {
        "className": "String", 
        "inputIndices": [Array], 
        "operation": "String",
        "sysId": "String"
      }
    ]
    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

    "inputIndices": [
      { 
       "mainIndex": Number, 
       "subIndex": Number 
      }
    ]
    <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:

    • INSERIR: O novo IC foi inserido no banco de dados.
    • NO_CHANGE: Nenhuma mudança de IC foi feita.
    • ATUALIZAÇÃO: O IC existente foi atualizado.

    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    <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": [
      { 
        "attemptResult": "String", 
        "attributes": [Array],
        "hybridEntryCiAttributes": [Array],
        "identifierName": "String",
        "searchOnTable": "String" 
      }
    ]
    IdentificationAttempts.attempts.attemptResult <String> Resultados da tentativa de identificar o IC.

    Valores possíveis:

    • Identificação CORRESPONDIDA: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondeu exatamente aos atributos especificados.
    • MULTI_MATCH: Falha na identificação com um erro. ICs duplicados foram encontrados na tabela de regras de identificador ao corresponder com os atributos especificados.
    • NO_MATCH: Falha na identificação. Nenhum IC encontrado na tabela de regras de identificador que correspondeu aos atributos especificados.
    • IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regra de identificador não foram fornecidos, portanto, a regra não foi aplicada.

    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:

    "attributes": [
      "serial_number": "String",
      "serial_number_type": "String",
    ]
    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

    "info": [
      {
        "code": "String",
        "message": "String",
        "ruleSysId": "String"
      }
    ]
    <String>.items.info.code Tipo de reclassificação ignorado.
    Valores possíveis:
    • IGNORADO_CLASS_SWITCH
    • IGNORADO_CLASS_DOWNGRADE
    • IGNORADO_CLASS_UPGRADE

    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

    "relatedItems": [
      { 
        "className": "String",
        "errors": [Array],
        "errorCount": Number, 
        "inputIndices": [Array],
        "operation": "String",
        "sysId": "String"
      }
    ]
    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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

    "inputIndices": [
      { 
       "mainIndex": Number, 
       "subIndex": Number 
      }
    ]
    <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:

    • INSERIR: O novo IC foi inserido no banco de dados.
    • NO_CHANGE: Nenhuma mudança de IC foi feita.
    • ATUALIZAÇÃO: O IC existente foi atualizado.

    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

    "relations":[
      { 
        "className": "String",
        "errorCount": Number,
        "inputIndices": [Array],
        "operation": "String",
        "sysId": "String" 
      }
    ]
    <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:

    • INSERT
    • UPDATE
    • NO_CHANGE

    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.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 7. Retorna
    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.

    Tabela 8. Parâmetros
    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.
    Tabela 9. Retornos
    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

    { 
      "additionalCommittedItems": [Array],  
      "additionalCommittedRelations": [Array], 
      "hasError": Boolean, 
      "hasWarning": Boolean,
      "items": [Array],  
      "relations": [Array], 
      "summary": {Object} 
    }
    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

    "additionalCommittedItems": [
      {
        "className": "String",
        "errorCount": Number,
        "operation": "String",
        "identificationAttempts": [Array],
        "inputIndices": [Array],
        "markers": [Array],
        "mergedPayloads": [Array],
        "sysId": "String"
      }
    ]
    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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
    "identificationAttempts": [
      {
        "attemptResult": "String",
        "attributes": [Array],
        "hybridEntryCiAttributes": [Array],
        "identiferName": "String",
        "searchOnTable": [Array]
      }
    ]
    AdditionalCommittedItems.IdentificationAttempts.attemptResult <String> Resultado desta tentativa de identificação de IC adicional.

    Tipo de dados: Cadeia de caracteres

    Valores possíveis:
    • Identificação CORRESPONDIDA: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondeu exatamente aos atributos especificados.
    • MULTI_MATCH: Falha na identificação com um erro. ICs duplicados foram encontrados na tabela de regras de identificador ao corresponder com os atributos especificados.
    • NO_MATCH: Falha na identificação. Nenhum IC encontrado na tabela de regras de identificador que correspondeu aos atributos especificados.
    • IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regra de identificador não foram fornecidos, portanto, a regra não foi aplicada.
    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:

    "attributes": [
      "serial_number": "String",
      "serial_number_type": "String",
    ]
    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:

    "hybridEntryCiAttributes": [
      "name": "String",
      "serial_number": "String"
    ]
    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

    "inputIndices": [
      {
        Number
      }
    ]
    ItemsCommittedItems.additionalCommittedItems.markers <String> Valores do marcador para uso interno.

    Tipo de dados: Matriz

    "markers": []
    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

    "mergedPayloadIds": [
      "String"
    ]
    ItemsCommittedItems.adicionais <String> Operação realizada para este IC adicional.

    Tipo de dados: Cadeia de caracteres

    Valores possíveis:
    • EXCLUIR: Um IC existente é removido da tabela de destino.
    • INSERIR: O IC adicional é inserido na tabela de destino como um novo registro.
    • NO_CHANGE: Nenhuma operação é realizada para o IC adicional.
    • ATUALIZAÇÃO: Um IC existente na tabela de destino é atualizado.
    • UPDATE_WITH_DOWNGRADE: Um IC existente na tabela de destino é atualizado e sua classe é alterada para uma classe mais genérica (classe ancestral).
    • UPDATE_WITH_SWITCH: Um IC existente na tabela de destino é atualizado e sua classe é alterada para outra classe que não é uma classe ancestral ou descendente.
    • UPDATE_WITH_UPGRADE: Um IC existente na tabela de destino é atualizado e sua classe é alterada para uma classe mais especializada (classe descendente).
    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

    "warnings": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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",
        "inputIndices": [Array],
        "markers": [Array],
        "mergedPayloadIds": [Array],
        "operation": "String"
      }
    ]
    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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

    "inputIndices": [
      Number
    ]
    RelacionadosCommitedRelacionadosadicionais.marcadores <String> Valores do marcador para uso interno.

    Tipo de dados: Matriz

    "markers": []
    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

    "mergedPayloadIds": [
      "String"
    ]
    RelacionaçõesCommitedadicionais.Operação <String> Operação que foi realizada para o IC de relacionamento dependente adicional.
    Valores possíveis:
    • INSERIR: O IC de relacionamento dependente é inserido na tabela de destino como um novo registro.
    • INSERT_AS_INCOMPLETE: O IC de relacionamento dependente tinha erros e foi inserido na tabela Cargas Incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL: O IC de relacionamento dependente tinha erros e foi inserido na tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE: Nenhuma operação é realizada para o IC de relacionamento dependente.
    • ATUALIZAÇÃO: Um IC de relacionamento dependente existente na tabela de destino é atualizado.

    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

    "items": [
      {  
        "additionalRelatedItems": [Array],
        "className": "String",
        "duplicateIndices": [Array],
        "errorCount": Number, 
        "errors": [Array], 
        "identificationAttempts": [Array], 
        "identifierEntrySysId": "String",  
        "incompleteSysIds": "String",
        "info": [Array],
        "inputIndices": [Array], 
        "maskedAttributes": [Array],
        "operation": "String", 
        "partialSysIds": "String", 
        "relatedItems": [Array], 
        "relatedSysIds": [Array], 
        "sysId": "String" 
      }
    ]
    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

    "additionalRelatedItems": [ 
      {
        "className": "String", 
        "inputIndices": [Array],
        "mergedPayloadIds": [Array], 
        "operation": "String",
        "sysId": "String"
      }
    ]
    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:

    • INSERIR: O novo IC foi inserido no banco de dados.
    • NO_CHANGE: Nenhuma mudança de IC foi feita.
    • ATUALIZAÇÃO: O IC existente foi atualizado.

    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    <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": [
      { 
        "attemptResult": "String", 
        "attributes": [Array],
        "hybridEntryCiAttributes": [Array],
        "identifierName": "String",
        "searchOnTable": "String" 
      }
    ]
    IdentificationAttempts.attempts.attemptResult <String> Resultados da tentativa de identificar o IC.

    Valores possíveis:

    • Identificação CORRESPONDIDA: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondeu exatamente aos atributos especificados.
    • MULTI_MATCH: Falha na identificação com um erro. ICs duplicados foram encontrados na tabela de regras de identificador ao corresponder com os atributos especificados.
    • NO_MATCH: Falha na identificação. Nenhum IC encontrado na tabela de regras de identificador que correspondeu aos atributos especificados.
    • IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regra de identificador não foram fornecidos, portanto, a regra não foi aplicada.

    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:

    "attributes": [
      "serial_number": "String",
      "serial_number_type": "String",
    ]
    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:

    "hybridEntryCiAttributes": [
      "name": "String",
      "serial_number": "String"
    ]
    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

    "info": [
      {
        "code": "String",
        "message": "String",
        "ruleSysId": "String"
      }
    ]
    <String>.items.info.code Tipo de reclassificação ignorado.
    Valores possíveis:
    • IGNORADO_CLASS_DOWNGRADE
    • IGNORADO_CLASS_SWITCH
    • IGNORADO_CLASS_UPGRADE

    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:

    • INSERIR: O novo IC foi inserido no banco de dados.
    • INSERT_AS_INCOMPLETE: O item foi salvo na tabela cmdb_ire_incomplete_payloads.
    • INSERT_AS_PARTIAL: O item foi salvo na tabela cmdb_ire_partial_payloads.
    • ATUALIZAÇÃO: O IC existente foi atualizado.
    • UPDATE_WITH_DOWNGRADE: O IC foi atualizado e a classe foi alterada para uma classe mais genérica (classe ancestral).
    • UPDATE_WITH_SWITCH: O IC foi atualizado e a classe mudou para uma classe que não é ancestral ou descendente.
    • UPDATE_WITH_UPDRADE: O IC foi atualizado e a classe mudou para uma classe mais especializada (classe descendente).

    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

    "relatedItems": [
      { 
        "className": "String",
        "errors": [Array],
        "errorCount": Number, 
        "incompleteSysIds": [Array],
        "inputIndices": [Array],
        "mergePayloadIds": [Array],
        "operation": "String",
        "partialSysIds": [Array], 
        "sysId": "String",
        "warningCount": Number,
        "warnings": [Array]
      }
    ]
    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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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

    "inputIndices": [
      { 
       "mainIndex": Number, 
       "subIndex": Number 
      }
    ]
    <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:

    • INSERIR: Um novo IC relacionado foi inserido no banco de dados.
    • INSERT_AS_INCOMPLETE: O item foi salvo na tabela cmdb_ire_incomplete_payloads.
    • INSERT_AS_PARTIAL: O item foi salvo na tabela cmdb_ire_partial_payloads.
    • NO_CHANGE: Nenhuma mudança de IC relacionada foi feita.
    • ATUALIZAÇÃO: O IC relacionado existente foi atualizado.
    • UPDATE_WITH_DOWNGRADE: O IC relacionado foi atualizado e a classe foi alterada para uma classe mais genérica (classe ancestral).
    • UPDATE_WITH_SWITCH: O IC relacionado foi atualizado e a classe foi alterada para uma classe que não é ancestral ou descendente.
    • UPDATE_WITH_UPDRADE: O IC relacionado foi atualizado e a classe mudou para uma classe mais especializada (classe descendente).

    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

    "warnings": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    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

    "relations": [ 
      { 
        "className": "String",
        "errorCount": Number,
        "errors": [Array],
        "incompleteSysIds": "String",
        "inputIndices": [Array],
        "operation": "String",
        "partialSysIds": "String",
        "sysId": "String" 
      }
    ]
    <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

    "errors": [
      {
        "error": "String",
        "message": "String"
      }
    ]
    <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:

    • INSERIR: O IC de relacionamento dependente foi inserido na tabela de destino como um novo registro.
    • INSERT_AS_INCOMPLETE: O IC de relacionamento dependente tinha erros e foi inserido na tabela Cargas Incompletas do IRE do CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL: O IC de relacionamento dependente tinha erros e foi inserido na tabela Cargas parciais do IRE do CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE: Nenhuma operação foi realizada.
    • ATUALIZAÇÃO: Um IC de relacionamento dependente existente na tabela de destino foi atualizado.

    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

    <class_name>: {
     "additionalInsertedItemCount": Number, 
     "errorCount": Number,
     "incompleteItemCount": Number,
     "insertedItemCount": Number,
     "partialItemCount": Number,
     "skippedItemCount": Number,
     "unchangedItemCount": Number,
     "updatedItemCount": Number,
     "warningCount": Number 
    }
    <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.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 11. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se ocorreu um erro no chamado anteriormente IdentifyAndReconcile() ou IdentifyAndReconcileEnhanced() método.
    Valores possíveis:
    • Verdadeiro: Ocorreu um erro
    • Falso: Nenhum erro ocorreu
    // 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 .

    Tabela 12. Parâmetros
    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.
    Tabela 13. Retornos
    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) .

    Tabela 14. Parâmetros
    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.
    Tabela 15. Retornos
    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.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    log Objeto Objeto de log disponível em scripts de mapa de transformação.
    Tabela 17. Retornos
    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 .

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    origem Cadeia de caracteres Fonte de dados para o registro do item de configuração de origem.
    Tabela 19. Retornos
    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.