IdentificationEngine - Com escopo

. IdentificationEngine A API usa a estrutura de Identificação e reconciliação para minimizar a criação de itens de configuração (ICs) duplicados e para reconciliar atributos de IC aceitando somente informações de fontes de dados autorizadas ao atualizar o. Configuration Management Database (CMDB).

Ao usar esta classe em uma aplicação com escopo, use sn_cmdb identificador do namespace.

IdentificationEngine - createOrUpdateCI (origem de cadeia de caracteres, entrada de cadeia de caracteres)

Insere ou atualiza itens de configuração (IC) e não Configuration Management Database (CMDB) ICs (classes que não se estendem de cmdb_ci) no CMDB com base em regras de identificação e reconciliação. Use esta API em vez de atualizar o. CMDB diretamente.

Para obter informações adicionais sobre ingestão de tabela não CMDB, consulte IRE support for non-CMDB tables.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
entrada	Cadeia de caracteres	Necessário. Carga de entrada. Uma cadeia de caracteres formatada JSON de itens de configuração para adicionar ou atualizar. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] }
input.items	Matriz de objetivos	Itens a serem adicionados ou atualizados. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_ci_linux_server ou cmdb_ci_win_server.
input.items.display_values	Objeto	Campos de referência a serem criados ou atualizados para este item relacionado como pares nome-valor, em que o nome é o nome do campo e o valor é o valor de exibição referenciado. Se você quiser usar o sys_id em vez do valor de exibição para campos de referência, passe as informações no input.items.lookup.valuesneste parâmetro. Os nomes dos campos de referência dependem dos campos selecionados pelo usuário, como: "display_values": { "model_id": "String", "location": "String" }
input.items.internal_id	Cadeia de caracteres	Identificador de item exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup	Matriz de objetivos	Identifica o item de nível superior que contém a pesquisa (identificação baseada em pesquisa). Esses registros são usados para identificar o item de configuração com base em uma tabela de pesquisa que tem uma referência de volta a cmdb_ci. Por exemplo: "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.lookup.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_serial_number ou cmdb_ci_network_adapter.
input.items.lookup.internal_id	Cadeia de caracteres	Identificador de item exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup.sys_object_source_info	Objeto	Identificador de IC exclusivo para uma origem específica. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.lookup.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.lookup.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.lookup.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva do item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.lookup.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.lookup.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
input.items.related	Matriz	Referência ao item de nível superior que contém a lista relacionada. As regras na entrada relacionada [cmdb_related_entry] definem que tipo de registros podem estar nesta matriz. Esses registros são usados para adicionar itens com base em uma tabela relacionada que tem uma referência ao IC que está sendo identificado. A tabela relacionada pode ou não estender cmdb_ci. Esses registros não são usados para identificar o item de configuração. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.related.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_software_instance ou cmdb_key_value.
input.items.related.internal_id	Cadeia de caracteres	Identificador de item exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.related.sys_object_source_info	Objeto	Identificador de IC exclusivo para uma origem específica. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.related.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.related.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.related.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva do item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.related.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.related.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
input.items.settings	Objeto	Parâmetros que definem os tipos de atualizações permitidos. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }
input.items.settings.skipReclassificationRestrictionRules	Booliano	Sinalizador que indica se o IRE não deve executar a regra de restrição de reclassificação que corresponde à classe do item de carga. Valores válidos: Verdadeiro: Ignore a execução da regra. Falso: Execute a regra. Padrão: falso
input.items.settings.updateWithoutDowngrade	Booliano	Sinalizador que indica se a atualização e o downgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o downgrade não é permitido. Falso: A atualização e o downgrade do item são permitidos. Padrão: falso
input.items.settings.updateWithoutUpgrade	Booliano	Sinalizador que indica se atualização e upgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o upgrade não é permitido. Falso: A atualização e o upgrade de item são permitidos. Padrão: falso
input.items.settings.updateWithoutSwitch	Booliano	Sinalizador que indica se o item pode ser atualizado e a classe alternada. Valores válidos: Verdadeiro: Atualize o item, mas a mudança de classe não é permitida. Falso: A atualização de item e a troca de classe são permitidas. Padrão: falso
input.items.sys_object_source_info	Objeto	Identificador de IC exclusivo para uma origem específica. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva do item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
Items.referenceItems	Matriz de objetivos	Lista que definem referências entre itens na carga de entrada. Os valores de cada item de referência são preenchidos antes de identificar um IC usando as regras de IRE definidas em uma classe. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]
Items.referenciadoItems.referenciado	Cadeia de caracteres	. internal_iddefinido para o item que está sendo referenciado por outro item.
Items.referenceItems.referencedBy	Cadeia de caracteres	. internal_iddefinido para o item que faz referência a outro item.
Campo.referenceItems.referenceField	Cadeia de caracteres	Nome do campo de referência na classe/tabela do referencedByitem.
input.relations	Matriz de objetivos	Lista que especifica relacionamentos entre itens na carga de entrada. Um objeto nesta matriz pode usar um dos dois formatos. O objeto pode definir um relacionamento entre dois itens de nível superior (somente) usando parente. childpares nome-valor, com valores que representam índices de item da carga itemsmatriz. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] O objeto pode definir um relacionamento entre dois itens quaisquer, incluindo itens de nível superior, relacionados ou de pesquisa, usando parent_ide. child_idpares de chave/valor, com valores representando internal_idvalores definidos para esses itens. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]
input.relations.child	Número	Índice inteiro do objeto de IC no itemsmatriz que representa o secundário no relacionamento (items, items.related ou items.lookup.)
input.relations.child_id	Cadeia de caracteres	. internal_iddo item secundário na relação (items, items.related ou items.lookup.)
input.relations.parent	Número	Índice inteiro do item primário no itemsmatriz (items, items.related ou items.lookup.)
input.relations.parent_id	Cadeia de caracteres	. internal_iddo item primário na relação (items, items.related ou items.lookup.)
input.relations.sys_rel_source_info	Objeto	Informações de origem da descoberta para o relacionamento. Para relacionamentos sem dependência, essas informações são salvas na tabela Fontes de relacionamento [sys_rel_source] (não persistidas para IdentifyCIEnhanced() ou IdentifyCI() .) Tipo de dados: Objeto "sys_rel_source_info": { "source_name": "String", "source_feed": "String" }
input.relations.sys_rel_source_info.source_name	Cadeia de caracteres	Nome da origem da descoberta. Padrão: Origem da descoberta passada no parâmetro de método da API.
input.relations.sys_rel_source_info.source_feed	Cadeia de caracteres	Qualquer cadeia de caracteres que seja uma subdescoberta/verificação na origem da descoberta. Padrão: "DESCONHECIDO" é armazenado na coluna source_feed ao criar um registro na tabela sys_rel_source.
tipo.de.relações.entrada	Cadeia de caracteres	Tipo de relacionamento que existe entre os itens primário e secundário. Este deve ser um valor de campo de nome da tabela Tipo de relacionamento de IC [cmdb_rel_type].
origem	Cadeia de caracteres	Identifica a fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela cmdb_ci.

Tabela 2. Retornos

Tipo	Descrição
<String>	Cadeia de caracteres formatada JSON que é uma lista de resultados para os 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
<String>.ItemsCommittedAdditionalCommittedItems	Nenhum valor é retornado no momento.
<String>.Relações adicionais	Nenhum valor é retornado no momento.
<String>.Itens	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" }
Items.Items.Relacionadosadicionais <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 parciais. No momento, essas informações não são retornadas. Tipo de dados: Matriz de objetos "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "operation": "String", "sysId": "String" } ]
Items.Items.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.<String>.Items.Operation	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.Relacionadosadicionais.SYSID.Items.Items.<String>	Sys_id dos itens relacionados adicionais. Tipo de dados: Cadeia de caracteres
<String>.itens.classname	Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres
Items.DuplicateIndices <String>	Lista de índices de ICs duplicados do item atual. Tipo de dados: Matriz
<String>.Itens.Contagem de erros	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 "errors": [ { "error": "String", "message": "String" } ]
<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>.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" } ]
<String>.items.IdentificationAttempts.attemptResult	Resultados da tentativa de identificar o IC. Valores possíveis: Identificação CORRESPONDENTE: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondia 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 foi encontrado na tabela de regras de identificador que correspondesse aos atributos especificados. IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regras de identificador não foram fornecidos, portanto, a regra não foi aplicada. Tipo de dados: Cadeia de caracteres
Atributos.Itens.IdentificaçãoAttents.<String>	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 atributos dependem dos dados do corpo da solicitação e do identificador em uso, como: "attributes": [ "serial_number": "String", "serial_number_type": "String", ]
<String>.Items.IdentificationAttents.hybridEntryCiAttributes	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
SysId.Items.IdentyfierEntryId <String>	Sys_id da regra de identificador usada para identificar o IC. Tipo de dados: Cadeia de caracteres Tabela: 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: SKIPED_CLASS_SWITCH SKIPED_CLASS_DOWNGRADE SKIPED_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 correspondente. 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 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 mascarados	Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido pelo Regras de reconciliação . Tipo de dados: Matriz
Items.RelatedItems.Related <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
Erros.Itens.RelatedItems.<String>	Lista de erros que ocorreram durante o processamento. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
<String>.Itens.RelatedItems.Contagem de erros	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.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
<String>.Items.RelatedSysIds	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>.relações	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
<String>.relations.Contagem de erros	Número de erros. Tipo de dados: Número
<String>.relations.inputIndices	Índices das relações de entrada correspondentes. Tipo de dados: Matriz
<String>.Relações.Operação	Tipo de operação realizada. Valores possíveis: INSERIR ATUALIZAR NO_CHANGE Tipo de dados: Cadeia de caracteres
SYSID.<String>.relations.SYSID	Sys_id do IC de relacionamento dependente. Tipo de dados: Cadeia de caracteres

A seguir mostra como reclassificar um item de configuração.

var payload = {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "short_description": "Linux server description",
        "name": "Linux Server 1"
      }
    }
  ]
};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "operation": "NO_CHANGE",
      "sysId": "440577800f321010150efc91ff767e94",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        }
      ],
      "info": [
        {
          "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule",
          "code": "SKIPPED_CLASS_SWITCH",
          "ruleSysId": "b3d4b3800f321010150efc91ff767eab"
        }
      ],
      "errorCount": 0,
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": []
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

A seguir mostra como atualizar um item de configuração.

var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}]}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "sysId": "d56ab6eadbd510102f67dfea5e96194e",
      "relatedSysIds": [
        "dd6af62adb1910102f67dfea5e96197f",
        "996af62adb1910102f67dfea5e961980"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "dd6af62adb1910102f67dfea5e96197f",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "996af62adb1910102f67dfea5e961980",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "sysId": "116af62adb1910102f67dfea5e961981",
      "relatedSysIds": [
        "6d6af62adb1910102f67dfea5e961984"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "6d6af62adb1910102f67dfea5e961984",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "className": "cmdb_software_instance"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "key"
          ],
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961985",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961989",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

Identifique um IC dependente.

var payload = 
              {items: [ 
                    {className:'cmdb_ci_web_server', 
                     values: {name:'apache linux den 200', 
                              running_process_command: 'xyz',  
                              running_process_key_parameters: 'abc', 
                              tcp_port:'3452'}}, 
                    {className:'cmdb_ci_linux_server', 
                     values: {name:'lnux100', ram:'2048'}}],
               relations:[{parent: 0, child: 1, type: 'Runs on::Runs'}]
              };

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_web_server",
      "operation": "INSERT",
      "sysId": "b9bb766adb1910102f67dfea5e961962",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_linux_server",
      "operation": "INSERT",
      "sysId": "a5bb766adb1910102f67dfea5e96195b",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "fdbb766adb1910102f67dfea5e961964",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

Identifique um IC independente com identificação baseada em pesquisa.

var payload = {items: [
           {className:'cmdb_ci_netgear', 
               values: {name:'ny8500-nbxs08',
                        ports:'1200'}, 
               lookup: [{className:'cmdb_serial_number',
                            values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}},
                        {className:'cmdb_serial_number',
                            values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_netgear",
      "operation": "INSERT",
      "sysId": "787c7e6adb1910102f67dfea5e96196e",
      "relatedSysIds": [
        "f47c7e6adb1910102f67dfea5e961977",
        "3c7c7e6adb1910102f67dfea5e961977"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "f47c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "3c7c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

IdentificationEngine - createOrUpdateCIEnhanced (origem de cadeia de caracteres, entrada de cadeia de caracteres, opções de objeto)

Insere ou atualiza itens de configuração (IC) e não Configuration Management Database (CMDB) ICs (classes que não se estendem de cmdb_ci) no CMDB com base em regras de identificação e reconciliação. Use esta API em vez de atualizar o. CMDB diretamente.

Além de fornecer a funcionalidade do CriateOrUpdateCI() este método também é compatível com:

• Lidando com cargas parciais
• Lidando com confirmações parciais
• Removendo itens duplicados em uma carga
• Gerando resumos de saída

Para obter informações adicionais sobre IRE e explicações mais detalhadas dos dados usados por este método, consulte Identificação e reconciliação (IRE) .

Para obter informações adicionais sobre ingestão de tabela não CMDB, consulte IRE support for non-CMDB tables.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
entrada	Cadeia de caracteres	Necessário. Carga de entrada. Uma cadeia de caracteres formatada JSON de itens de configuração para adicionar ou atualizar. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] }
input.items	Matriz de objetivos	Itens a serem adicionados ou atualizados. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_ci_linux_server ou cmdb_ci_win_server.
input.items.display_values	Objeto	Campos de referência a serem criados ou atualizados para este item relacionado como pares nome-valor, em que o nome é o nome do campo e o valor é o valor de exibição referenciado. Se você quiser usar o sys_id em vez do valor de exibição para campos de referência, passe as informações no input.items.lookup.valuesneste parâmetro. Os nomes dos campos de referência dependem dos campos selecionados pelo usuário, como: "display_values": { "model_id": "String", "location": "String" }
input.items.internal_id	Cadeia de caracteres	Identificador de item exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup	Matriz de objetivos	Identifica o item de nível superior que contém a pesquisa (identificação baseada em pesquisa). Esses registros são usados para identificar o item de configuração com base em uma tabela de pesquisa que tem uma referência de volta a cmdb_ci. Por exemplo: "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.lookup.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_serial_number ou cmdb_ci_network_adapter.
input.items.lookup.internal_id	Cadeia de caracteres	Identificador de item de pesquisa exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup.sys_object_source_info	Objeto	Define um identificador de IC exclusivo para uma fonte de dados específica. Origens diferentes podem ter pares de nome-valor diferentes para o mesmo IC. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.lookup.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.lookup.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.lookup.sys_object_source_info.source_native_key	Cadeia de caracteres	ID de chave exclusivo para o item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.lookup.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data/hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.lookup.values	Objeto	Informações de campo para o IC como pares nome-valor, em que o nome é o nome do campo. Ao atualizar campos de referência, o valor deve ser o sys_id referenciado. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "serial_number": "String", "serial_number_type": "String", "valid": "String", "ip_address": "String", "mac_address": "String" }
input.items.related	Matriz de objetivos	Referência ao item de nível superior que contém a lista relacionada. As regras na entrada relacionada [cmdb_related_entry] definem que tipo de registros podem estar nesta matriz. Esses registros são usados para adicionar itens com base em uma tabela relacionada que tem uma referência ao IC que está sendo identificado. A tabela relacionada pode ou não estender cmdb_ci. Esses registros não são usados para identificar o item de configuração. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.related.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_software_instance ou cmdb_key_value.
input.items.related.internal_id	Cadeia de caracteres	Identificador exclusivo para este item relacionado nesta carga. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.related.sys_object_source_info	Objeto	Objeto que compõe um identificador de IC exclusivo para uma fonte de dados especificada. Origens diferentes podem ter pares de nome-valor diferentes para o mesmo IC. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.related.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.related.sys_object_source_info.source_name	Cadeia de caracteres	Identifica a fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.related.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva da origem do item relacionado. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.related.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.related.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
input.items.settings	Objeto	Parâmetros que definem os tipos de atualizações permitidos. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }
input.items.settings.skipReclassificationRestrictionRules	Booliano	Sinalizador que indica se o IRE não deve executar a regra de restrição de reclassificação que corresponde à classe do item de carga. Valores válidos: Verdadeiro: Ignore a execução da regra. Falso: Execute a regra. Padrão: falso
input.items.settings.updateWithoutDowngrade	Booliano	Sinalizador que indica se a atualização e o downgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o downgrade não é permitido. Falso: A atualização e o downgrade do item são permitidos. Padrão: falso
input.items.settings.updateWithoutSwitch	Booliano	Sinalizador que indica se o item pode ser atualizado e a classe alternada. Valores válidos: Verdadeiro: Atualize o item, mas a mudança de classe não é permitida. Falso: A atualização de item e a troca de classe são permitidas. Padrão: falso
input.items.settings.updateWithoutUpgrade	Booliano	Sinalizador que indica se atualização e upgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o upgrade não é permitido. Falso: A atualização e o upgrade de item são permitidos. Padrão: falso
input.items.sys_object_source_info	Objeto	Identificador de IC exclusivo para uma origem específica. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva do item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
Items.referenceItems	Matriz de objetivos	Lista que definem referências entre itens na carga de entrada. Os valores de cada item de referência são preenchidos antes de identificar um IC usando as regras de IRE definidas em uma classe. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]
Items.referenciadoItems.referenciado	Cadeia de caracteres	. internal_iddefinido para o item que está sendo referenciado por outro item.
Items.referenceItems.referencedBy	Cadeia de caracteres	. internal_iddefinido para o item que faz referência a outro item.
Campo.referenceItems.referenceField	Cadeia de caracteres	Nome do campo de referência na classe/tabela do referencedByitem.
input.relations	Matriz de objetivos	Lista que especifica relacionamentos entre itens na carga de entrada. Um objeto nesta matriz pode usar um dos dois formatos. O objeto pode definir um relacionamento entre dois itens de nível superior (somente) usando parente. childpares nome-valor, com valores que representam índices de item da carga itemsmatriz. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] O objeto pode definir um relacionamento entre dois itens quaisquer, incluindo itens de nível superior, relacionados ou de pesquisa, usando parent_ide. child_idpares de chave/valor, com valores representando internal_idvalores definidos para esses itens. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]
input.relations.child	Número	Índice inteiro do objeto de IC no itemsmatriz que representa o secundário no relacionamento (items, items.related ou items.lookup.)
input.relations.child_id	Cadeia de caracteres	. internal_iddo item secundário na relação (items, items.related ou items.lookup.)
input.relations.parent	Número	Índice inteiro do item primário no itemsmatriz (items, items.related ou items.lookup.)
input.relations.parent_id	Cadeia de caracteres	. internal_iddo item primário na relação (items, items.related ou items.lookup.)
input.relations.sys_rel_source_info	Objeto	Informações de origem da descoberta para o relacionamento. Para relacionamentos sem dependência, essas informações são salvas na tabela Fontes de relacionamento [sys_rel_source] (não persistidas para IdentifyCIEnhanced() ou IdentifyCI() .) Tipo de dados: Objeto "sys_rel_source_info": { "source_name": "String", "source_feed": "String" }
input.relations.sys_rel_source_info.source_name	Cadeia de caracteres	Nome da origem da descoberta. Padrão: Origem da descoberta passada no parâmetro de método da API.
input.relations.sys_rel_source_info.source_feed	Cadeia de caracteres	Qualquer cadeia de caracteres que seja uma subdescoberta/verificação na origem da descoberta. Padrão: "DESCONHECIDO" é armazenado na coluna source_feed ao criar um registro na tabela sys_rel_source.
tipo.de.relações.entrada	Cadeia de caracteres	Tipo de relacionamento que existe entre os itens primário e secundário. Este deve ser um valor de campo de nome da tabela Tipo de relacionamento de IC [cmdb_rel_type].
opções	Objeto	Ou nulo deve ser passado. Opções para habilitar ou desabilitar recursos. Nota: Por padrão ou se partial_payloadsestá definido como verdadeiro, ambos partial_commitse. deduplicate_payloadsestão habilitados, mesmo que estejam definidos como falso, pois esses recursos são essenciais para a funcionalidade de cargas parciais. "options": { "deduplicate_payloads": Boolean, "generate_summary": Boolean, "partial_commits": Boolean, "partial_payloads": Boolean, "skip_updating_last_scan_to_now": Boolean, "skip_updating_source_last_discovered_to_now": Boolean }
options.deduplicate_payloads	Booliano	Sinalizador que indica se os itens duplicados são mesclados ou considerados erros. Valores válidos: Verdadeiro: Mesclar itens duplicados. Falso: Considere itens duplicados como erros. Padrão: verdadeiro
generate_summary	Booliano	Sinalizador que indica se os resultados retornados contêm informações resumidas. Para obter detalhes das informações resumidas retornadas, consulte <String>.summaryna tabela retornar resultados. Valores válidos: Verdadeiro: Incluir informações resumidas. Falso: Não inclua informações resumidas. Padrão: falso
partial_commits	Booliano	Sinalizador que indica se o suporte de confirmação parcial está habilitado. Para obter informações adicionais sobre confirmações parciais, consulte Recursos de IRE aprimorados . Valores válidos: Verdadeiro: Confirmação parcial habilitada. Falso: Confirmação parcial desabilitada. Padrão: verdadeiro
options.partial_payloads	Booliano	Sinalizador que indica se o suporte de carga parcial está habilitado. Para obter informações adicionais sobre cargas parciais, consulte Recursos de IRE aprimorados e. Crie uma regra de fonte de dados IRE . Valores válidos: Verdadeiro: Carga parcial habilitada. Falso: Carga parcial desabilitada. Padrão: verdadeiro
options.skip_updating_last_scan_to_now	Booliano	Sinalizador que indica se a atualização do campo last_scan de sys_object_source deve ser ignorada. Valores válidos: Verdadeiro: Se source_recency_timestampo parâmetro não foi passado sys_object_source_info, não atualize o campo last_scan time do sys_object_source. Falso: Atualize o campo last_scan de sys_object_source. Padrão: Usa o valor na propriedade do sistema glide.identification_engine.skip_updating_last_scan_to_now.
options.skip_updating_source_last_discovered_to_now	Booliano	Sinalizador que indica se a atualização dos campos discovery_source e last_discovered deve ser ignorada na tabela de item de configuração [cmdb_ci]. Valores válidos: Verdadeiro: Se last_discovered não for fornecido nos valores do item de carga, não atualize os campos discovery_source e last_discovered. Falso: Atualize os campos discovery_source e last_discovered. Padrão: Usa o valor na propriedade do sistema glide.identification_engine.skip_updating_source_last_discovered_to_now.
origem	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].

Tabela 4. Retornos

Parâmetro	Descrição
<String>	Cadeia de caracteres formatada JSON que é uma lista de resultados para os 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} }
<String>.ItemsCommittedAdditionalCommittedItems	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" } ]
<String>.additionalCommittedItems.classname	Sys_class_name deste IC adicional. Tipo de dados: Cadeia de caracteres
<String>.ItemsCommittedAdditionalCommittedItems.ErrorCount	Número de erros encontrados ao processar este IC adicional. Tipo de dados: Número
<String>.Items.additionalCommittedItems.Erros	Matriz de objetos que descreve erros encontrados ao processar este IC adicional. Tipo de dados: Matriz "errors": [ { "error": "String", "message": "String" } ]
Erros.additionalCommittedItems.Errors.<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
Items.IdentificationalCommittedItems.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] } ]
<String>.additionalCommittedItems.IdentificationAttempts.attemptResult	Resultado desta tentativa de identificação de IC adicional. Tipo de dados: Cadeia de caracteres Valores possíveis: Identificação CORRESPONDENTE: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondia 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 foi encontrado na tabela de regras de identificador que correspondesse aos atributos especificados. IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regras de identificador não foram fornecidos, portanto, a regra não foi aplicada.
Atributos.additionalCommittedItems.IdentificationAttributes.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 atributos dependem dos dados do corpo da solicitação e do identificador em uso, como: "attributes": [ "serial_number": "String", "serial_number_type": "String", ]
<String>.additionalCommittedItems.IdentificationAttempts.hybridEntryCiAttributes	Matriz de 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 atributos dependem dos dados do corpo da solicitação e do identificador em uso, como: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]
<String>.additionalCommittedItems.IdentificationAttents.IdentificationName	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.IdentifierEntryId	Sys_id da regra de 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 do corpo da solicitação itemsMatriz que corresponde a este IC adicional. Tipo de dados: Matriz de números "inputIndices": [ { Number } ]
ItemsCommittedItems.additionalCommittedItems.<String>	Valores do marcador para uso interno. Tipo de dados: Matriz "markers": []
<String>.additionalCommittedItems.mergedPayloads	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" ]
Items.additionalCommittedItems.Operation <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).
Items.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 errors para obter detalhes.
<String>.additionalCommittedItems.warnings	Descrição dos avisos encontrados ao processar este IC adicional. Tipo de dados: Matriz de objetos "warnings": [ { "error": "String", "message": "String" } ]
<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>.Relações adicionais	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" } ]
<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.Contagem de erros	Número de erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: Número
<String>.Erros.RelacionadosCommittedRelacionadosadicionais	Descrição dos erros encontrados ao processar este IC de relacionamento dependente adicional. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
Erro.additionalCommittedRelations.Errors.<String>	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 dependentes no corpo da solicitação relationsMatriz que corresponde a este IC de relacionamento dependente adicional. Tipo de dados: Matriz "inputIndices": [ Number ]
Marcadores.additionalCommittedRelations.markers <String>	Valores do marcador para uso interno. Tipo de dados: Matriz "markers": []
<String>.additionalCommittedRelations.mergedPayloadIds	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" ]
<String>.Relacionamentos adicionais.CommittedRelacionados	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 [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
<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	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" } ]
Items.Items.Relacionadosadicionais <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 parciais. Tipo de dados: Matriz de objetos "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ]
Items.Items.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.Items.MergedPayloadIds.AditionalRelatedItems.MergedPayloadIds <String>	Lista de sys_ids das cargas parciais que foram mescladas no item relacionado. Tipo de dados: Matriz Tabela: Cargas parciais IRE do cmdb [cmdb_ire_partial_payloads]
Items.Items.Relacionadosadicionais.<String>.Items.Operation	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.Relacionadosadicionais.SYSID.Items.Items.<String>	Sys_id do IC que foi atualizado ou criado. Tipo de dados: Cadeia de caracteres
<String>.itens.classname	Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres
Items.DuplicateIndices <String>	Lista de índices de ICs duplicados do item atual. Tipo de dados: Matriz
<String>.Itens.Contagem de erros	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 "errors": [ { "error": "String", "message": "String" } ]
<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>.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" } ]
<String>.items.IdentificationAttempts.attemptResult	Resultados da tentativa de identificar o IC. Valores possíveis: Identificação CORRESPONDENTE: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondia 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 foi encontrado na tabela de regras de identificador que correspondesse aos atributos especificados. IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regras de identificador não foram fornecidos, portanto, a regra não foi aplicada. Tipo de dados: Cadeia de caracteres
Atributos.Itens.IdentificaçãoAttents.<String>	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 atributos dependem dos dados do corpo da solicitação e do identificador em uso, como: "attributes": [ "serial_number": "String", "serial_number_type": "String", ]
<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 tipos de atributos 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
SysId.Items.IdentyfierEntryId <String>	Sys_id da regra de identificador usada para identificar o IC. Tipo de dados: Cadeia de caracteres Tabela: Entrada do identificador [cmdb_identifier_entry]
<String>.items.incompleteSysIds	Se o item tiver erros e foi salvo como uma carga incompleta, este parâmetro conterá o sys_id do registro na tabela Cargas incompletas do IRE do 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: SKIPED_CLASS_DOWNGRADE SKIPED_CLASS_SWITCH SKIPED_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 correspondente. 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 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 mascarados	Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido pelo 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 mudou 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
<String>.Items.PartialSysIds	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.Related <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
Erros.Itens.RelatedItems.<String>	Lista de erros que ocorreram durante o processamento do item relacionado. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
Erros.Itens.RelatedItems.Erros.RelatedItems.<String>	Tipo de erro encontrado ao processar o item relacionado. Tipo de dados: Cadeia de caracteres
Mensagem.Itens.RelatedItems.Erros.<String>	Mensagem de erro associada ao erro. Tipo de dados: Cadeia de caracteres
<String>.Itens.RelatedItems.Contagem de erros	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 de IRE do 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.Operação <String>	Operação que ocorreu. Valores possíveis: INSERIR: O 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 mudou para uma classe mais genérica (classe ancestral). UPDATE_WITH_SWITCH: O IC relacionado foi atualizado e a classe mudou 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
Itens.RelatedItems.PartialSysIds <String>	Se o item relacionado tiver erros e tiver sido salvo como uma carga parcial, isso conterá uma lista de 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
<String>.Itens.RelatedItems.WarningCount	Número de avisos encontrados ao processar os itens relacionados. Tipo de dados: Número
Items.RelatedItems.warnings <String>	Descrição dos avisos encontrados ao processar os itens relacionados. Tipo de dados: Matriz de objetos "warnings": [ { "error": "String", "message": "String" } ]
<String>.itens.RelatedItems.warnings.error	Tipo de aviso encontrado ao processar o item relacionado. Tipo de dados: Cadeia de caracteres
<String>.itens.relatedItems.warnings.message	Mensagem associada ao aviso. Tipo de dados: Cadeia de caracteres
<String>.Items.RelatedSysIds	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>.relações	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
<String>.relations.Contagem de erros	Número de erros encontrados ao processar o IC de relacionamento dependente. Tipo de dados: Número
<String>.Relações.Erros	Lista que descreve os erros encontrados ao processar este IC de relacionamento dependente. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
<String>.Relações.Erros.Erros.Erro	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 de IRE do cmdb [ire_incomplete_payloads]. Tipo de dados: Cadeia de caracteres
<String>.relations.inputIndices	Índices para os objetos de IC de relacionamento dependentes no corpo da solicitação relationsMatriz que corresponde a este IC de relacionamento dependente. Tipo de dados: Matriz
<String>.Relações.Operação	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
<String>.relations.PartialSysIds	Se a relação tiver erros e tiver sido salva como uma carga parcial, este 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.<String>.relations.SYSID	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 de 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 mostra como importar várias entradas de IC.

var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}], 
  "settings" : {
        "skipReclassificationRestrictionRules" : "false",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var input = JSON.stringify((payload));
var output = sn_cmdb.IdentificationEngine.createOrUpdateCIEnhanced('ServiceNow', input, {});

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{

"items": [
{
  "className": "cmdb_ci_win_server",
  "operation": "NO_CHANGE",
  "sysId": "65d873d2b3a0001028f6eae2c6a8dc2a",
  "relatedSysIds": [
    "a1d873d2b3a0001028f6eae2c6a8dc32",
    "a1d873d2b3a0001028f6eae2c6a8dc33"
],

"relatedItems": [
{
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc32",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 0
  }]
},
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc33",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 1
  }]
}],

"additionalRelatedItems": [],
"identificationAttempts": [],
"errorCount": 0,
"inputIndices": [0]
},
{
"className": "cmdb_ci_spkg",
"operation": "NO_CHANGE",
"sysId": "c764e971b320001028f6eae2c6a8dc44",

"relatedSysIds": [
  "8b64e971b320001028f6eae2c6a8dc47"
],
"relatedItems": [
  {
  "className": "cmdb_software_instance",
  "sysId": "8b64e971b320001028f6eae2c6a8dc47",
  "markers": [],
  "inputIndices": [
    {
      "mainIndex": 1,
      "subIndex": 0
    }]
  }],

"additionalRelatedItems": [],
"identifierEntrySysId": "a52a87c03746220006b216a543990e8c",
"identificationAttempts": [
  {
    "attributes": [
      "key"
     ],
    "identifierName": "Software",
    "attemptResult": "MATCHED",
    "searchOnTable": "cmdb_ci_spkg",
    "hybridEntryCiAttributes": []
  }],

"errorCount": 0,
"inputIndices": [1]
},

{
"className": "cmdb_ci_app_server_tomcat",
"operation": "INSERT",
"sysId": "6f29f3d2b3a0001028f6eae2c6a8dcc6",
"identifierEntrySysId": "Unknown",
"identificationAttempts": [
{
  "attributes": [
    "install_directory",
    "running_process_key_parameters",
    "sys_class_name"
  ],
"identifierName": "Tomcat",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_app_server_tomcat",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "cl_port",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "SKIPPED",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "running_process_command",
  "running_process_key_parameters",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
}
],

"errorCount": 0,
"inputIndices": [2]
}
],
"additionalCommittedItems": [],
"relations": [
{
  "className": "cmdb_rel_ci",
  "operation": "INSERT",
  "sysId": "6729f3d2b3a0001028f6eae2c6a8dcc9",
  "errorCount": 0,
  "inputIndices": [0]
}],
"additionalCommittedRelations": []
}

IdentificationEngine - identifyCI(cadeia de caracteres jsonString)

Determina a operação (inserir/atualizar) a ser executada com a carga especificada sem confirmar a operação no banco de dados.

Isso funciona exatamente como CriateOrUpdateCI() , mas não confirma o resultado.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
JsonString	Cadeia de caracteres	Uma cadeia de caracteres formatada JSON de itens de configuração a serem adicionados ou atualizados. Cada cadeia de caracteres de entrada está no formato "Itens: []], relações:[]]", em que cada item nas listas de itens e relações contém pares nome-valor. Os possíveis pares nome-valor na lista de itens são: Nome da classe: Sys_class_name do IC a ser criado ou atualizado. Pesquisa: Lista de registros com cada item com pares nome-valor, como a lista de itens. : Informações do campo para o IC como pares nome-valor, em que o nome é o nome do campo. Os possíveis pares nome-valor na lista de relações são: Secundário: Índice do item secundário na relação de dependência Primário: Índice do item primário na relação de dependência Tipo: Tipo de relacionamento. Este é um dos valores do campo de nome da tabela cmdb_rel_type.

Tabela 6. Retornos

Tipo

Descrição

Cadeia de caracteres

Uma cadeia de caracteres formatada JSON que é uma lista de resultados. 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. Os possíveis pares nome-valor na lista de itens são: Nome da classe: Sys_class_name para o IC que foi atualizado ou criado. DuplicateIndices: Lista de índices de itens duplicados do item atual. Erros: Lista de erros no formato de (erro, cadeia de caracteres da mensagem) IdentificationAttents: Lista de tentativas. AttemtResult: Um de IGNORADO, NO_MATCH, MATCHED, MULTI_MATCH. Atributos: Atributos da entrada do identificador usados durante a identificação. IdentiferName: Identificador de IC ao qual esta entrada de identificador pertence. SearchOnTable: Tabela pesquisada durante o processo de identificação. IdentifierEntrySysId: Sys_id da entrada do identificador usada durante a correspondência. Operação: Operação a ser executada, que é uma das seguintes: DELETE INSERIR ATUALIZAR UPDATE_WITH_DOWNGRADE UPDATE_WITH_SWITCH UPDATE_WITH_UPGRADE RelatedSysIds: Lista de valores sys_id de ICs usados durante a identificação baseada em pesquisa. SYSID: Sys_id do IC que foi atualizado ou criado. Os possíveis pares nome-valor na lista de relações são: Nome da classe: O nome da classe do IC de relacionamento e é sempre cmdb_rel_ci Operação: Tipo de operação: INSERIR, ATUALIZAR, NO_CHANGE SYSID: Sys_id do IC de relacionamento inserido ou atualizado

A seguir mostra como reclassificar um item de configuração.

var payload = {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "short_description": "Linux server description",
        "name": "Linux Server 1"
      }
    }
  ]
};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.identifyCI(input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "operation": "NO_CHANGE",
      "sysId": "440577800f321010150efc91ff767e94",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        }
      ],
      "info": [
        {
          "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule",
          "code": "SKIPPED_CLASS_SWITCH",
          "ruleSysId": "b3d4b3800f321010150efc91ff767eab"
        }
      ],
      "errorCount": 0,
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": []
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

IdentificationEngine - identifyCIEnhanced (origem de cadeia de caracteres, entrada de cadeia de caracteres, opções de objeto)

Determina o. Configuration Management Database (CMDB) operação (inserir/atualizar) a ser executada com a carga especificada (corpo da solicitação), sem confirmar as operações no banco de dados.

Use este método para simular o envio de uma carga.

Este método é semelhante ao IdentificationEngine - identifyCI(cadeia de caracteres jsonString), no entanto, ele também oferece suporte às seguintes funcionalidades:

• Cargas parciais
  • No caso de um item ter um aviso ou erro, indica se uma operação de item é INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
  • Retorna os sys_ids de cargas parciais que foram mescladas com cargas parciais existentes.
• Compatível com o recurso de desduplicação de carga.
• Gera um resumo.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
entrada	Cadeia de caracteres	Necessário. Carga de entrada. Uma cadeia de caracteres formatada JSON de itens de configuração para adicionar ou atualizar. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] }
input.items	Matriz de objetivos	Itens a serem adicionados ou atualizados. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_ci_linux_server ou cmdb_ci_win_server.
input.items.display_values	Objeto	Campos de referência a serem criados ou atualizados para este item relacionado como pares nome-valor, em que o nome é o nome do campo e o valor é o valor de exibição referenciado. Se você quiser usar o sys_id em vez do valor de exibição para campos de referência, passe as informações no input.items.lookup.valuesneste parâmetro. Os nomes dos campos de referência dependem dos campos selecionados pelo usuário, como: "display_values": { "model_id": "String", "location": "String" }
input.items.internal_id	Cadeia de caracteres	Identificador de item exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup	Matriz de objetivos	Identifica o item de nível superior que contém a pesquisa (identificação baseada em pesquisa). Esses registros são usados para identificar o item de configuração com base em uma tabela de pesquisa que tem uma referência de volta a cmdb_ci. Por exemplo: "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.lookup.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_serial_number ou cmdb_ci_network_adapter.
input.items.lookup.internal_id	Cadeia de caracteres	Identificador de item de pesquisa exclusivo para a carga associada. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.lookup.sys_object_source_info	Objeto	Define um identificador de IC exclusivo para uma fonte de dados específica. Origens diferentes podem ter pares de nome-valor diferentes para o mesmo IC. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.lookup.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.lookup.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.lookup.sys_object_source_info.source_native_key	Cadeia de caracteres	ID de chave exclusivo para o item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.lookup.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data/hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.lookup.values	Objeto	Informações de campo para o IC como pares nome-valor, em que o nome é o nome do campo. Ao atualizar campos de referência, o valor deve ser o sys_id referenciado. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "serial_number": "String", "serial_number_type": "String", "valid": "String", "ip_address": "String", "mac_address": "String" }
input.items.related	Matriz de objetivos	Referência ao item de nível superior que contém a lista relacionada. As regras na entrada relacionada [cmdb_related_entry] definem que tipo de registros podem estar nesta matriz. Esses registros são usados para adicionar itens com base em uma tabela relacionada que tem uma referência ao IC que está sendo identificado. A tabela relacionada pode ou não estender cmdb_ci. Esses registros não são usados para identificar o item de configuração. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]
input.items.related.className	Cadeia de caracteres	Necessário. Nome da classe/tabela, sys_class_name, do item de configuração (IC) a ser criado ou atualizado. Este valor pode ser qualquer CMDB classe/tabela, como cmdb_software_instance ou cmdb_key_value.
input.items.related.internal_id	Cadeia de caracteres	Identificador exclusivo para este item relacionado nesta carga. Pode ser qualquer valor, mas deve ser exclusivo na carga.
input.items.related.sys_object_source_info	Objeto	Objeto que compõe um identificador de IC exclusivo para uma fonte de dados especificada. Origens diferentes podem ter pares de nome-valor diferentes para o mesmo IC. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.related.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.related.sys_object_source_info.source_name	Cadeia de caracteres	Identifica a fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.related.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva da origem do item relacionado. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.related.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.related.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
input.items.settings	Objeto	Parâmetros que definem os tipos de atualizações permitidos. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }
input.items.settings.skipReclassificationRestrictionRules	Booliano	Sinalizador que indica se o IRE não deve executar a regra de restrição de reclassificação que corresponde à classe do item de carga. Valores válidos: Verdadeiro: Ignore a execução da regra. Falso: Execute a regra. Padrão: falso
input.items.settings.updateWithoutDowngrade	Booliano	Sinalizador que indica se a atualização e o downgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o downgrade não é permitido. Falso: A atualização e o downgrade do item são permitidos. Padrão: falso
input.items.settings.updateWithoutSwitch	Booliano	Sinalizador que indica se o item pode ser atualizado e a classe alternada. Valores válidos: Verdadeiro: Atualize o item, mas a mudança de classe não é permitida. Falso: A atualização de item e a troca de classe são permitidas. Padrão: falso
input.items.settings.updateWithoutUpgrade	Booliano	Sinalizador que indica se atualização e upgrade são permitidos para este item. Valores válidos: Verdadeiro: Atualize o item, mas o upgrade não é permitido. Falso: A atualização e o upgrade de item são permitidos. Padrão: falso
input.items.sys_object_source_info	Objeto	Identificador de IC exclusivo para uma origem específica. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }
input.items.sys_object_source_info.source_feed	Cadeia de caracteres	Se a origem puder ter vários feeds, use este campo para fornecer o nome do feed que envia este item. A fonte de dados gera este nome de feed. Pode ser qualquer cadeia de caracteres que identifique exclusivamente o feed de origem.
input.items.sys_object_source_info.source_name	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].
input.items.sys_object_source_info.source_native_key	Cadeia de caracteres	ID/chave exclusiva do item da origem. A fonte de dados gera esta chave. Pode ser qualquer cadeia de caracteres exclusiva do item.
input.items.sys_object_source_info.source_recency_timestamp	Cadeia de caracteres	Data e hora UTC em que o item foi verificado. Formato: AAAA-MM-DD hh:mm:ss
input.items.values	Objeto	Campos a serem criados ou atualizados para este item relacionado como pares de nome/valor, em que o nome é o nome do campo. Para um campo de referência, o valor deve ser o sys_id referenciado. Se você quiser usar o valor de exibição em vez do sys_id para campos de referência, passe essas informações em um display_valuesobjeto em vez de no valuesobjeto. Os nomes e tipos de campo dependem dos campos selecionados pelo usuário, como: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }
Items.referenceItems	Matriz de objetivos	Lista que definem referências entre itens na carga de entrada. Os valores de cada item de referência são preenchidos antes de identificar um IC usando as regras de IRE definidas em uma classe. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]
Items.referenciadoItems.referenciado	Cadeia de caracteres	. internal_iddefinido para o item que está sendo referenciado por outro item.
Items.referenceItems.referencedBy	Cadeia de caracteres	. internal_iddefinido para o item que faz referência a outro item.
Campo.referenceItems.referenceField	Cadeia de caracteres	Nome do campo de referência na classe/tabela do referencedByitem.
input.relations	Matriz de objetivos	Lista que especifica relacionamentos entre itens na carga de entrada. Um objeto nesta matriz pode usar um dos dois formatos. O objeto pode definir um relacionamento entre dois itens de nível superior (somente) usando parente. childpares nome-valor, com valores que representam índices de item da carga itemsmatriz. "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] O objeto pode definir um relacionamento entre dois itens quaisquer, incluindo itens de nível superior, relacionados ou de pesquisa, usando parent_ide. child_idpares de chave/valor, com valores representando internal_idvalores definidos para esses itens. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]
input.relations.child	Número	Índice inteiro do objeto de IC no itemsmatriz que representa o secundário no relacionamento (items, items.related ou items.lookup.)
input.relations.child_id	Cadeia de caracteres	. internal_iddo item secundário na relação (items, items.related ou items.lookup.)
input.relations.parent	Número	Índice inteiro do item primário no itemsmatriz (items, items.related ou items.lookup.)
input.relations.parent_id	Cadeia de caracteres	. internal_iddo item primário na relação (items, items.related ou items.lookup.)
input.relations.sys_rel_source_info	Objeto	Informações de origem da descoberta para o relacionamento. Para relacionamentos sem dependência, essas informações são salvas na tabela Fontes de relacionamento [sys_rel_source] (não persistidas para IdentifyCIEnhanced() ou IdentifyCI() .) Tipo de dados: Objeto "sys_rel_source_info": { "source_name": "String", "source_feed": "String" }
input.relations.sys_rel_source_info.source_name	Cadeia de caracteres	Nome da origem da descoberta. Padrão: Origem da descoberta passada no parâmetro de método da API.
input.relations.sys_rel_source_info.source_feed	Cadeia de caracteres	Qualquer cadeia de caracteres que seja uma subdescoberta/verificação na origem da descoberta. Padrão: "DESCONHECIDO" é armazenado na coluna source_feed ao criar um registro na tabela sys_rel_source.
tipo.de.relações.entrada	Cadeia de caracteres	Tipo de relacionamento que existe entre os itens primário e secundário. Este deve ser um valor de campo de nome da tabela Tipo de relacionamento de IC [cmdb_rel_type].
opções	Objeto	Ou nulo deve ser passado. Opções para habilitar ou desabilitar recursos. Nota: Por padrão ou se partial_payloadsestá definido como verdadeiro, ambos partial_commitse. deduplicate_payloadsestão habilitados, mesmo que estejam definidos como falso, pois esses recursos são essenciais para a funcionalidade de cargas parciais. "options": { "deduplicate_payloads": Boolean, "generate_summary": Boolean, "partial_commits": Boolean, "partial_payloads": Boolean, "skip_updating_last_scan_to_now": Boolean, "skip_updating_source_last_discovered_to_now": Boolean }
options.deduplicate_payloads	Booliano	Sinalizador que indica se os itens duplicados são mesclados ou considerados erros. Valores válidos: Verdadeiro: Mesclar itens duplicados. Falso: Considere itens duplicados como erros. Padrão: verdadeiro
generate_summary	Booliano	Sinalizador que indica se os resultados retornados contêm informações resumidas. Para obter detalhes das informações resumidas retornadas, consulte <String>.summaryna tabela retornar resultados. Valores válidos: Verdadeiro: Incluir informações resumidas. Falso: Não inclua informações resumidas. Padrão: falso
partial_commits	Booliano	Sinalizador que indica se o suporte de confirmação parcial está habilitado. Para obter informações adicionais sobre confirmações parciais, consulte Recursos de IRE aprimorados . Valores válidos: Verdadeiro: Confirmação parcial habilitada. Falso: Confirmação parcial desabilitada. Padrão: verdadeiro
options.partial_payloads	Booliano	Sinalizador que indica se o suporte de carga parcial está habilitado. Para obter informações adicionais sobre cargas parciais, consulte Recursos de IRE aprimorados e. Crie uma regra de fonte de dados IRE . Valores válidos: Verdadeiro: Carga parcial habilitada. Falso: Carga parcial desabilitada. Padrão: verdadeiro
options.skip_updating_last_scan_to_now	Booliano	Sinalizador que indica se a atualização do campo last_scan de sys_object_source deve ser ignorada. Valores válidos: Verdadeiro: Se source_recency_timestampo parâmetro não foi passado sys_object_source_info, não atualize o campo last_scan time do sys_object_source. Falso: Atualize o campo last_scan de sys_object_source. Padrão: Usa o valor na propriedade do sistema glide.identification_engine.skip_updating_last_scan_to_now.
options.skip_updating_source_last_discovered_to_now	Booliano	Sinalizador que indica se a atualização dos campos discovery_source e last_discovered deve ser ignorada na tabela de item de configuração [cmdb_ci]. Valores válidos: Verdadeiro: Se last_discovered não for fornecido nos valores do item de carga, não atualize os campos discovery_source e last_discovered. Falso: Atualize os campos discovery_source e last_discovered. Padrão: Usa o valor na propriedade do sistema glide.identification_engine.skip_updating_source_last_discovered_to_now.
origem	Cadeia de caracteres	Fonte de dados das informações de IC. Este valor deve ser um dos valores de escolha definidos para o campo discovery_source da tabela de item de configuração [cmdb_ci].

Tabela 8. Retornos

Tipo	Descrição
<String>	Cadeia de caracteres formatada JSON que é uma lista de resultados para os 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} }
<String>.ItemsCommittedAdditionalCommittedItems	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" } ]
<String>.Relações adicionais	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" } ]
<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	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", "info": [Array], "inputIndices": [Array], "maskedAttributes": [Array], "operation": "String", "relatedSysIds": [Array], "sysId": "String" } ]
Items.Items.Relacionadosadicionais <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 parciais. Tipo de dados: Matriz de objetos "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "mergedPayloadIds": [Array], "operation": "String", "sysId": "String" } ]
Items.Items.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.Items.MergedPayloadIds.AditionalRelatedItems.MergedPayloadIds <String>	Lista de sys_ids das cargas parciais que foram mescladas no item relacionado. Tipo de dados: Matriz Tabela: Cargas parciais IRE do cmdb [cmdb_ire_partial_payloads]
Items.Items.Relacionadosadicionais.<String>.Items.Operation	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.Relacionadosadicionais.SYSID.Items.Items.<String>	Sys_id do IC que foi atualizado ou criado. Tipo de dados: Cadeia de caracteres
<String>.itens.classname	Nome da classe/tabela (sys_class_name) do IC que foi criado ou atualizado. Tipo de dados: Cadeia de caracteres
Items.DuplicateIndices <String>	Lista de índices de ICs duplicados do item atual. Tipo de dados: Matriz
<String>.Itens.Contagem de erros	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 "errors": [ { "error": "String", "message": "String" } ]
<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 encontrada ao processar o IC. 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" } ]
<String>.items.IdentificationAttempts.attemptResult	Resultados da tentativa de identificar o IC. Valores possíveis: Identificação CORRESPONDENTE: Bem-sucedida. Um IC exclusivo foi encontrado na tabela de regras de identificador que correspondia 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 foi encontrado na tabela de regras de identificador que correspondesse aos atributos especificados. IGNORADO: Identificação não tentada. Os atributos necessários para esta pesquisa de tabela de regras de identificador não foram fornecidos, portanto, a regra não foi aplicada. Tipo de dados: Cadeia de caracteres
Atributos.Itens.IdentificaçãoAttents.<String>	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 atributos dependem dos dados do corpo da solicitação e do identificador em uso, como: "attributes": [ "serial_number": "String", "serial_number_type": "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
SysId.Items.IdentyfierEntryId <String>	Sys_id da regra de identificador usada para identificar o IC. Tipo de dados: Cadeia de caracteres Tabela: Entrada do identificador [cmdb_identifier_entry]
<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: SKIPED_CLASS_SWITCH SKIPED_CLASS_DOWNGRADE SKIPED_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 correspondente. 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 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 mascarados	Lista de atributos cuja atualização por uma fonte de dados não autorizada foi ignorada conforme definido pelo 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 mudou 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
Items.RelatedItems.Related <String>	Informações sobre os itens relacionados processados. Tipo de dados: Matriz de objetos "relatedItems": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "mergePayloadIds": [Array], "operation": "String", "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
<String>.Itens.RelatedItems.Contagem de erros	Número de erros detectados ao processar os itens relacionados. Tipo de dados: Número
Erros.Itens.RelatedItems.<String>	Lista de erros que ocorreram durante o processamento do item relacionado. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
Erros.Itens.RelatedItems.Erros.RelatedItems.<String>	Tipo de erro encontrado ao processar o item relacionado. Tipo de dados: Cadeia de caracteres
Mensagem.Itens.RelatedItems.Erros.<String>	Mensagem de erro encontrada ao processar o item relacionado. 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.Operação <String>	Operação que ocorreu. Valores possíveis: INSERIR: O 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 mudou para uma classe mais genérica (classe ancestral). UPDATE_WITH_SWITCH: O IC relacionado foi atualizado e a classe mudou 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.SYSID.Items.RelatedItems.<String>	Sys_id do item relacionado. Tipo de dados: Cadeia de caracteres
<String>.Itens.RelatedItems.WarningCount	Número de avisos encontrados ao processar os itens relacionados. Tipo de dados: Número
Items.RelatedItems.warnings <String>	Descrição dos avisos encontrados ao processar os itens relacionados. Tipo de dados: Matriz de objetos "warnings": [ { "error": "String", "message": "String" } ]
<String>.Items.RelatedSysIds	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>.relações	Informações sobre as relações processadas. Tipo de dados: Matriz de objetos "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "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
<String>.relations.Contagem de erros	Número de erros encontrados ao processar o IC de relacionamento dependente. Tipo de dados: Número
<String>.Relações.Erros	Lista que descreve os erros encontrados ao processar este IC de relacionamento dependente. Tipo de dados: Matriz de objetos "errors": [ { "error": "String", "message": "String" } ]
<String>.relations.inputIndices	Índices para os objetos de IC de relacionamento dependentes no corpo da solicitação relationsMatriz que corresponde a este IC de relacionamento dependente. Tipo de dados: Matriz
<String>.Relações.Operação	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
SYSID.<String>.relations.SYSID	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 de 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

var payload = {
"items": [
{
"className": "cmdb_ci_win_server",
"values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],
 
    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },
 
  "related": [
    {
     "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }},
  {
    "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
    "className": "cmdb_software_instance",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229"
  }}
],
  "settings" : {
        "skipReclassificationRestrictionRules" : "false",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }},
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },
 
  "internal_id": "tomcat_id"
  }],
 
"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],
 
"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};
 
var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.identifyCIEnhanced('ServiceNow', input, {});

gs.info(JSON.stringify(JSON.parse(output), null, 2));

Saída:

{
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "relatedSysIds": [
        null,
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "mac_address",
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "relatedSysIds": [
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "warnings": [
            {
              "error": "MISSING_MATCHING_ATTRIBUTES",
              "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_software_instance]. Add these input values in payload item '{\"className\":\"cmdb_software_instance\",\"values\":{},\"internal_id\":\"f7273cccec30101056cd4bb46eb4db5d\",\"sys_object_source_info\":{\"source_feed\":\"SN Discovery Feed 1\",\"source_name\":\"ServiceNow\",\"source_native_key\":\"Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-10 17:57:48\"}}'"
            }
          ],
          "operation": "INSERT_AS_PARTIAL",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "sysId": "Unknown",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 1
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "key"
          ],
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedRelations": []
}  

IdentificationEngine - runIdentificationAudit (GlideRecord Now_GR)

Executa uma auditoria de identificação em relação ao item de configuração (IC) especificado para detectar duplicatas.

Se forem encontradas duplicatas, serão criadas tarefas de duplicação. Use este método somente em tipos de IC com regras de identificação independentes.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	IC no qual executar a auditoria para detectar duplicatas. O IC deve ter regras de identificação independentes.

Tabela 10. Retornos

Tipo	Descrição
vazio

O exemplo a seguir mostra como verificar se há duplicatas em um registro na tabela Servidores Linux [cmdb_ci_linux_server].

var sysId = '<cbdb_ci_sys_id>';
var gr = new GlideRecord('cmdb_ci_linux_server');
gr.get(sysId);
sn_cmdb.IdentificationEngine.runIdentificationAudit(gr);