Transformações do RTE de scripts de modelo incluídos no app Componentes comuns de integração para CMDB

  • Versão de lançamento: Xanadu
  • Atualizado 30 de ago. de 2024
  • 22 min. de leitura
  • As transformações do Mecanismo de transformação robusta (RTE) são operações de modelo incluídas no app da Store Componentes comuns de integração para CMDB (sn_cmdb_int_util).

    As transformações do RTE baseadas em scripts a seguir estão disponíveis no app Componentes comuns de integração para CMDB.

    Operação da Pesquisa de CI

    Use para obter o valor de um campo em um item de configuração (IC) existente no CMDB pela chave nativa de origem.

    Detalhes
    Tabela Operação de consulta da pesquisa de IC do Mecanismo de transformação robusta [sn_cmdb_int_util_ci_lookup_operation]
    Campo de entrada source_sys_rte_eb_field
    A ordem de entrada é:
    1. Origem da descoberta
    2. Chave nativa de origem
    3. Campo de IC

    A operação consulta a tabela Origem [sys_object_source] em busca da origem da descoberta e a chave nativa de origem associada e, em seguida, retorna o valor Campo de IC do registro correspondente na tabela de destino e o ID do sistema de destino associado.

    Campo de saída target_sys_rte_eb_field

    A saída será o valor do nome do campo no IC correspondente à pesquisa de chave nativa de origem ou uma cadeia de caracteres vazia se não houver correspondência.

    A tabela Origem [sys_object_source] é consultada usando-se a origem da descoberta e a ordem da chave nativa de origem pela última verificação. A tabela itera pelos resultados da consulta e consulta a tabela de destino pelo ID do sistema de destino até que um IC válido seja encontrado. Depois que um IC válido for encontrado, a operação retornará o valor do Campo de IC no IC correspondente.

    Tabela 1. Exemplo
    Origem da descoberta Chave nativa de origem Campo de IC Resultado
    ServiceNow ServiceNow|||COMPUTER-NAME|||Computer-01 nome Computer-01

    Empresa de Limpeza

    Use para limpar o nome do fabricante do hardware e adicionar o registro à tabela Empresa [core_company] a fim de preencher uma referência, quando o fabricante não estiver vinculado a um modelo ou software (cpu_manufacturer).

    Detalhes
    Tabela Operações de limpar empresa da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_company_operation]
    Campo de entrada source_sys_rte_eb_field

    A entrada é o nome da empresa/do fabricante.

    Campo de saída target_sys_rte_eb_field

    A saída é o sys_id resultante e o nome da empresa em core_company, concatenados por um canal triplo (|||).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseCompany(input)

    Se não existir um registro correspondente, um novo registro será criado em core_company para que o retorno sempre inclua um sys_id e um nome (a menos que a entrada esteja vazia ou seja inválida). O nome é limpo e uma pesquisa difusa é feita por meio da inclusão do script CmdbIntegrationCompanyModelUtil antes que a API da plataforma MakeAndModelJS seja chamada.

    Tabela 2. Exemplo
    Entrada Resultado
    SERVICENOW 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow

    Limpar modelo de hardware

    Use para criar, limpar ou pesquisar um modelo de hardware para criar uma referência (model_id).

    Detalhes
    Tabela Operação de limpar modelo de hardware da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_hardware_model_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do fabricante
    2. Nome do modelo

    Se um dos valores for fornecido isoladamente, a operação processará somente o que for encontrado.

    Campo de saída target_sys_rte_eb_field

    A saída é o sys_id resultante e o nome da empresa em core_company, e o sys_id e o nome do modelo no cmdb_model - todos concatenados por um canal triplo (|||).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Para o fabricante ou modelo, se não existir um registro correspondente, um novo registro será criado para que o retorno sempre inclua sys_ids e nomes para ambos os registros (a menos que a entrada esteja vazia ou seja inválida).

    O nome do fabricante é processado como a transformação da Empresa de limpeza e, em seguida, o nome do fabricante e do modelo são enviados para a API da plataforma MakeAndModelJS.

    Tabela 3. Exemplo
    Nome do fabricante Nome do modelo Resultado
    ServiceNow Incorporated SERVICENOW 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb303710200044e0bfc8bcbe5d6d |||ServiceNow

    Limpar modelo de hardware com o número do modelo

    Use para criar, limpar ou pesquisar um modelo de hardware para criar uma referência (model_id).

    Detalhes
    Tabela Operação de limpar modelo de hardware com número de modelo da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_hardware_model_number_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do fabricante
    2. Nome do modelo
    3. Número do modelo
    4. Classe do IC
      Nota:
      O campo Classe de IC é opcional e, quando incluído, a API da plataforma MakeAndModelJS obtém o registro do modelo consultando a classe do modelo do produto na tabela Categoria do modelo [cmdb_model_category]. Caso contrário, a API obterá o registro do modelo somente da tabela Modelos de hardware [cmdb_hardware_product_model].

    Se um dos valores for fornecido isoladamente, a operação processará somente o que for encontrado.

    Campo de saída target_sys_rte_eb_field

    A saída é o sys_id resultante e o nome da empresa em core_company, e o sys_id e o nome do modelo no cmdb_model - todos concatenados por um canal triplo (|||).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationHardwareModelUtil().cleanseModelAndCompany(manufacturer_in, model_in)

    Para o fabricante ou modelo, se não existir um registro correspondente, um novo registro será criado para que o retorno sempre inclua sys_ids e nomes para ambos os registros (a menos que a entrada esteja vazia ou seja inválida).

    O nome do fabricante é processado como a transformação da Empresa de limpeza e, em seguida, o nome do fabricante, o nome do modelo e o número do modelo são enviados para a API da plataforma MakeAndModelJS.

    Tabela 4. Exemplo
    Nome do fabricante Nome do modelo Número do Modelo Resultado
    ServiceNow Incorporated SERVICENOW BC0AA8000C56 93d4ecfac0a8000b6294d71b733977fb|||ServiceNow|||ba29cb303710200044e0bfc8bcbe5d6d |||ServiceNow

    Limpar Endereço IP

    Use quando um campo fornecer um endereço IP.

    Detalhes
    Tabela Operação de limpar IP da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_ip_operation]
    Campos de entrada source_sys_rte_eb_field

    A entrada é o endereço IP a ser limpo.

    Campo de saída target_sys_rte_eb_field

    A saída é o endereço IP resultante, que pode estar em branco.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseIpAddress(input)

    O endereço IP é testado para estruturas IPv4 e IPv6 junto com algumas derivações conhecidas (um IPv4 com espaços em vez de pontos). Se for encontrado algum resultado, ele será formatado e retornado.

    Tabela 5. Exemplos
    Ip Resultados de IP
    192.160.89.1 192.160.89.1
    192.160.89.1,54.21.12.311 192.160.89.1
    192 160 89 1 54 21 12 311 192.160.89.1
    192-160-89-1 192.160.89.1
    2001:0db8:0000:0000:0000:ff00:0042:8329 2001:0db8:0000:0000:0000:ff00:0042:8329
    Lixo eletrônico
    175912537 10.124.54.89
    -1
    0

    Versão de IP de limpeza

    Use quando a origem de dados não fornecer uma versão de IP ou quando a versão de IP não for confiável.

    Detalhes
    Tabela Operação de limpar versão do IP da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_ip_version_operation]
    Campos de entrada source_sys_rte_eb_field

    A entrada é o endereço IP a ser limpo.

    Campo de saída target_sys_rte_eb_field

    A saída é a chave de pesquisa resultante cmdb_ci_ip_address.ip_version (4, 6 ou vazia).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationNetworkUtil().deriveIpVersion(input)

    O valor do endereço IP de entrada é verificado quanto à estrutura IPv4 ou IPv6 apropriada, caso contrário, o retorno estará vazio. Esta função não fornece limpeza de IP.

    Tabela 6. Exemplo
    Entrada Resultado
    192.160.89.1 4

    Limpar endereço MAC

    Use quando um campo fornecer um endereço MAC.

    Detalhes
    Tabela Operação de limpar MAC da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_mac_operation]
    Campos de entrada source_sys_rte_eb_field

    A entrada é o endereço MAC a ser limpo.

    Campo de saída target_sys_rte_eb_field

    A saída é o endereço MAC resultante, que pode estar em branco.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationNetworkUtil().cleanseMacAddress(input)

    O endereço MAC é testado quanto à estrutura apropriada junto com algumas derivações conhecidas (por exemplo, um endereço MAC com espaços em vez de dois pontos). Se for encontrado algum resultado, ele será formatado e retornado.

    Tabela 7. Exemplo
    Entrada Resultado
    00 0A 95 9D 68 16 00:0a:95:9d:68:16

    Sistema Operacional de Limpeza

    Use para extrair, limpar e formatar um nome de sistema operacional quando a origem fornecer um valor de sistema operacional.

    Detalhes
    Tabela Operação de limpar SO da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_os_operation]
    Campos de entrada source_sys_rte_eb_field

    A entrada é o nome do sistema operacional a ser limpo.

    Campo de saída target_sys_rte_eb_field

    A saída é o nome do sistema operacional resultante. O nome do sistema operacional resultante também é gravado no campo da lista cmdb_ci_computer.os.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationOsUtil().cleanseAndInsertOs(input)

    A maior parte da limpeza atual é centrada nos valores do sistema operacional da Microsoft, além da limpeza comum, como a correção de maiúsculas e minúsculas.

    Tabela 8. Exemplos
    Sistema operacional Resultados do sistema operacional
    Windows Server 2003 R2 Edição de 64 bits Service Pack 2 Windows Server 2003 R2
    Windows 2003 Windows 2003
    Windows Vista Edição de 64 bits Windows Vista
    Windows 2000 Professional Service Pack 4 Windows 2000 Professional
    Windows XP Service Pack 2 e 3 Windows XP
    Microsoft Windows Server 2003 R2 Edição de 64 bits Service Pack 2 Windows Server 2003 R2
    Microsoft Windows 2003 Windows 2003
    Microsoft Windows Vista Edição de 64 bits Windows Vista
    Microsoft Windows 2000 Professional Service Pack 4 Windows 2000 Professional
    Microsoft Windows XP Service Pack 2 e 3 Windows XP
    Linux Ubuntu Linux Ubuntu
    Linux Ubuntu Server Linux Ubuntu Server

    Limpar número de série

    Use para limpar e remover números de série inválidos.

    Detalhes
    Tabela Operação de limpar número de série da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_serial_number_operation]
    Campos de entrada source_sys_rte_eb_fields

    A entrada é o número de série a ser limpo.

    Campo de saída target_sys_rte_eb_field

    A saída é o número de série resultante.

    Tabela 9. Exemplos
    Número de Série Resultados do número de série
    ec2aa2da-5312-aa3e-804c-c35feabeda5f ec2aa2da-5312-aa3e-804c-c35feabeda5f
    1045–1209–6738–4668–7696–2783 1045–1209–6738–4668–7696–2783

    Limpar número de série com retorno de valor alternativo se inválido

    Use para limpar o número de série e verificar o tamanho do número de série limpo. Retorna o valor alternativo se o tamanho do número de série for inválido.

    Detalhes
    Tabela Número de série de limpeza da entidade do Mecanismo de transformação robusta com retorno de valor alternativo [

    [sn_cmdb_int_util_cle$anse_serial_number_with_alternate_value_return_if_invalid]

    Campos de entrada source_sys_rte_eb_fields

    Entradas: número de série, valor alternativo

    Campo de saída target_sys_rte_eb_field

    Saída: número de série limpo se o comprimento for válido, caso contrário, valor alternativo.

    Função de inclusão de script global.SerialNumberManager().isValid(input)

    A operação limpa o número de série e verifica se o tamanho do número de série limpo é maior ou igual ao valor especificado na propriedade do sistema sn_cmdb_int_util.minimum_valid_serial_number_length. O valor padrão da propriedade é definido como 7.

    Limpar número de IMEI com retorno de valor alternativo se for inválido

    Use para limpar o número IMEI e verificar o tamanho do número IMEI limpo. Retorna o valor alternativo se o tamanho do número IMEI for inválido.

    Detalhes
    Tabela Limpar IMEI com valor alternativo Retorna se for inválido [

    [sn_cmdb_int_util_cleanse_imei_with_alternate_value_return_if_invalid]

    Campos de entrada source_sys_rte_eb_fields

    Entradas: número IMEI, valor alternativo

    Campo de saída target_sys_rte_eb_field

    Saída: número IMEI se o comprimento for válido, caso contrário, valor alternativo.

    Função de inclusão de script Nenhum(a)

    A operação limpa o número IMEI e verifica se o tamanho do número IMEI limpo é igual ao valor especificado na propriedade do sistema sn_cmdb_int_util.valid_imei_number_length. O valor padrão da propriedade é definido como 15.

    Limpar modelo de software

    Use para limpar e criar um modelo de software. Além disso, para criar o fabricante e o modelo de software, se eles não existirem, e continuar com uma operação de divisão.

    Detalhes
    Tabela Operação de limpar modelo de software da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_cleanse_software_model_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do fabricante
    2. Nome do software
    3. Versão do software (não obrigatória)

    Se apenas o fabricante ou o nome for fornecido, somente esses valores serão processados e retornados.

    Campo de saída target_sys_rte_eb_field

    A saída é o sys_id resultante e o nome da empresa em core_company, o nome e a versão do software de limpeza, todos concatenados por um canal triplo (|||).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().cleanseSoftwareModel(company, model, version)

    Caso não exista um registro de fabricante correspondente, um novo registro será criado para que o retorno sempre inclua o sys_id e o nome do fabricante (se o fabricante não estiver vazio ou inválido).

    O nome do fabricante é processado da mesma forma que na transformação Empresa de Limpeza e, em seguida, o nome do fabricante é enviado para a API da plataforma MakeAndModelJS.

    O nome e a versão do software são limpos, formatados e retornados. A versão é removida do nome do software, se aplicável.

    Tabela 10. Exemplos
    Fabricante Nome do software Versão do software Resultados
    Dell Inc.
    NoManufacturer
    1.0.0.0
    Dell Inc. DataEngine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    GenuineIntel TestSoftware 1.0.0.1 7aad6d00c611228400f00e0f80b67d2d|||Intel|||TestSoftware|||1.0.0.1
    Dell Inc. TestSoftware 232 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||232
    Dell Inc. TestSoftware 123.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||123.0
    America Online TestSoftware 1.0.0.0 0c43d035c61122750000251553f6f8e8|||America Online|||TestSoftware|||1.0
    America Online TestSoftware 1.0.0.0 0c43d035c61122750000251553f6f8e8|||America Online|||TestSoftware|||1.0
    dell LowerCase 1.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||LowerCase|||1.0

    Dell Corporation.

    Incorporated, Corp.

    TestSoftware 1.0.0.0 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||TestSoftware|||1.0
    Microsoft

    Microsoft SQL

    Server 2016 Enterprise

    2.0.0 0e8b8e650a0a0b3b004f285ffbb1a4fc|||Microsoft|||Microsoft SQL Server 2016 Enterprise|||2.0
    Dell Computer DataEngine 1.0.17.2 b7e7d7d8c0a8016900a5d7f291acce5c|||Dell Inc.|||DataEngine|||1.0.17.2
    Adobe TestSoftware 1 b7e8b5c4c0a80169008b49e468920048|||Adobe Systems|||TestSoftware|||1.0

    Nome de instância de criação do software

    Use quando um nome de hardware, nome de software e versão de software forem fornecidos, para criar um novo nome de instância de software.
    Detalhes
    Tabela Operação de criar nome de instância de software da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_create_software_instance_name_operation]
    Campos de entrada source_sys_rte_eb_fields

    A ordem de entrada é:

    1. Nome do hardware
    2. Nome do software
    3. Versão do software (não obrigatória)
    Campo de saída target_sys_rte_eb_field

    A saída é o nome da instância de software.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationSoftwareModelUtil().createSoftwareInstanceName(hw_name_in, sw_name_in, sw_version_in)
    Tabela 11. Exemplos
    Nome do hardware Nome do software Versão do software Resultados
    computer1 microsoft 2.0.1 microsoft 2.0.1-computer1
    computer2 adobe adobe-computer2
    computer3 adobe 2.1 adobe 2.1-computer3
    hw2 sw3 301 sw3 301-hw2

    Derivar classe de IC do modelo

    Use ao processar um registro de computador e quando um modelo for fornecido, mas a classe do computador for ambígua. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela Operação de derivar classe da entidade do Mecanismo de transformação robusta a partir do modelo [sn_cmdb_int_util_derive_class_from_model_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do modelo
    2. Nome da classe atual
    Campo de saída target_sys_rte_eb_field

    A saída é o nome da classe resultante.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromModelInput(model_in, class_in)

    Não retorna um valor de uma classe que é superior na hierarquia de classes (uma classe primária) do que a classe de entrada fornecida. Por exemplo, não retorna cmdb_ci_computer se a entrada for cmdb_ci_server. Observa somente a hierarquia cmdb_ci_computer, passando por cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, filhos de cmdb_ci_server).

    No momento, procura indicadores de Server, Windows Server e Linux Server no modelo.

    Tabela 12. Exemplos
    Modelo Classe Resultados da classe
    window server cmdb_ci_computer cmdb_ci_win_server
    Microsoft server cmdb_ci_computer cmdb_ci_win_server
    linux server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft server cmdb_ci_server cmdb_ci_win_server
    linux server cmdb_ci_server cmdb_ci_linux_server
    Red Hat Server cmdb_ci_server cmdb_ci_linux_server
    Arch Server cmdb_ci_server cmdb_ci_linux_server
    Centos Server cmdb_ci_server cmdb_ci_linux_server
    Debian Server cmdb_ci_server cmdb_ci_linux_server
    Fedora Server cmdb_ci_server cmdb_ci_linux_server
    Suse Server cmdb_ci_server cmdb_ci_linux_server
    Oracle Server cmdb_ci_server cmdb_ci_linux_server
    Rhel Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu Server cmdb_ci_server cmdb_ci_linux_server
    Lixo Eletrônico
    cmdb_ci_server cmdb_ci_server
    Servidor de lixo eletrônico cmdb_ci_computer cmdb_ci_server
    Lixo Eletrônico cmdb_ci_computer cmdb_ci_computer

    Derivar classe de IC do identificador de classe nativo

    Use ao processar um registro de computador e quando um indicador de classe nativa for fornecido, mas a classe do computador for ambígua. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela Operação de derivar classe da entidade do Mecanismo de transformação robusta a partir do valor nativo [sn_cmdb_int_util_derive_class_from_native_value_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Identificador da classe nativa
    2. Nome da classe atual
    Campo de saída target_sys_rte_eb_field

    A saída é o nome da classe resultante.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromNativeValue(native_id_in, class_in)

    Não retorna um valor de uma classe que é superior na hierarquia de classes (uma classe primária) do que a classe de entrada fornecida. Por exemplo, não retorna cmdb_ci_computer se a entrada for cmdb_ci_server. Observa somente a hierarquia cmdb_ci_computer, passando por cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, filhos de cmdb_ci_server).

    No momento, procura indicadores de Server, Windows Server e Linux Server no indicador nativo.

    Tabela 13. Exemplos
    Classe nativa Classe Resultados da classe
    window server cmdb_ci_computer cmdb_ci_win_server
    Microsoft server cmdb_ci_computer cmdb_ci_win_server
    linux server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft server cmdb_ci_server cmdb_ci_win_server
    linux server cmdb_ci_server cmdb_ci_linux_server
    Red Hat Server cmdb_ci_server cmdb_ci_linux_server
    Arch Server cmdb_ci_server cmdb_ci_linux_server
    Centos Server cmdb_ci_server cmdb_ci_linux_server
    Debian Server cmdb_ci_server cmdb_ci_linux_server
    Fedora Server cmdb_ci_server cmdb_ci_linux_server
    Suse Server cmdb_ci_server cmdb_ci_linux_server
    Oracle Server cmdb_ci_server cmdb_ci_linux_server
    Rhel Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu Server cmdb_ci_server cmdb_ci_linux_server
    Lixo Eletrônico
    cmdb_ci_server cmdb_ci_server
    Servidor de lixo eletrônico cmdb_ci_computer cmdb_ci_server
    Lixo Eletrônico cmdb_ci_computer cmdb_ci_computer

    Derivar classe de IC do sistema operacional

    Use ao processar um registro de computador e quando um sistema operacional for fornecido, mas a classe do computador for ambígua. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela Operação de derivar classe da entidade do Mecanismo de transformação robusta a partir do SO [sn_cmdb_int_util_derive_class_from_os_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do sistema operacional
    2. Nome da classe atual
    Campo de saída target_sys_rte_eb_field

    A saída é o nome da classe resultante.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationClassUtil().deriveClassNameFromOsName(os_in, class_in)

    Não retorna um valor de uma classe que é superior na hierarquia de classes (uma classe primária) do que a classe de entrada fornecida. Por exemplo, não retorna cmdb_ci_computer se a entrada for cmdb_ci_server. Observa somente a hierarquia cmdb_ci_computer, passando por cmdb_ci_server (cmdb_ci_computer, cmdb_ci_server, filhos de cmdb_ci_server).

    No momento, procura indicadores de Server, Windows Server e Linux Server no nome do sistema operacional.

    Tabela 14. Exemplos
    Sistema operacional Classe Resultados da classe
    window server cmdb_ci_computer cmdb_ci_win_server
    Microsoft server cmdb_ci_computer cmdb_ci_win_server
    linux server cmdb_ci_computer cmdb_ci_linux_server
    Microsoft server cmdb_ci_server cmdb_ci_win_server
    linux server cmdb_ci_server cmdb_ci_linux_server
    Red Hat Server cmdb_ci_server cmdb_ci_linux_server
    Arch Server cmdb_ci_server cmdb_ci_linux_server
    Centos Server cmdb_ci_server cmdb_ci_linux_server
    Debian Server cmdb_ci_server cmdb_ci_linux_server
    Fedora Server cmdb_ci_server cmdb_ci_linux_server
    Suse Server cmdb_ci_server cmdb_ci_linux_server
    Oracle Server cmdb_ci_server cmdb_ci_linux_server
    Rhel Server cmdb_ci_server cmdb_ci_linux_server
    Ubuntu Server cmdb_ci_server cmdb_ci_linux_server
    Lixo Eletrônico
    cmdb_ci_server cmdb_ci_server
    Servidor de lixo eletrônico cmdb_ci_computer cmdb_ci_server
    Lixo Eletrônico cmdb_ci_computer cmdb_ci_computer

    Derivar modelo virtual do modelo de hardware

    Use ao processar um registro de computador que pode ser virtual, um modelo de hardware é fornecido e o status virtual é ambíguo. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela Operação de derivar virtual a partir do modelo da entidade do Mecanismo de transformação robusta [sn_cmdb_int_util_derive_virtual_from_model_operation]
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Nome do modelo de hardware
    2. O valor do sinalizador virtual atual
    Campo de saída target_sys_rte_eb_field

    A saída é o sinalizador virtual resultante (verdadeiro/falso). Se o sinalizador virtual atual for "verdadeiro", o resultado será verdadeiro. Caso contrário, o resultado será "verdadeiro" ou "falso".

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromModelName(model_in, is_virtual_in)

    Procura indicadores no nome do modelo de um dispositivo virtual (VMware).

    Tabela 15. Exemplos
    Modelo de hardware Sinalizador virtual Resultados do sinalizador virtual
    thinkpad verdadeiro verdadeiro
    thinkpad falso falso
    thinkpad falso
    vmware inc verdadeiro verdadeiro
    verdadeiro verdadeiro
    falso falso
    falso

    Derivar indicador virtual do indicador nativo

    Use ao processar um registro de computador que pode ser virtual e quando um indicador virtual é fornecido pela fonte e o status virtual é ambíguo. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela sn_cmdb_int_util_derive_virtual_from_native_value_operation
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. O indicador nativo
    2. O valor do sinalizador virtual atual
    Campo de saída target_sys_rte_eb_field

    A saída é o sinalizador virtual resultante (verdadeiro/falso). Se o sinalizador virtual atual for "verdadeiro", o resultado será verdadeiro. Caso contrário, o resultado será "verdadeiro" ou "falso".

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromNativeIdentifier(native_in, is_virtual_in)

    Testa o indicador nativo em relação a uma lista de valores comuns e procura um indicador booliano "verdadeiro".

    Tabela 16. Exemplos
    Valor virtual nativo Sinalizador virtual Resultados do sinalizador virtual
    virtual falso verdadeiro
    virtual verdadeiro
    virtual verdadeiro verdadeiro
    u falso verdadeiro
    u verdadeiro
    u verdadeiro verdadeiro
    sim falso verdadeiro
    sim verdadeiro
    sim verdadeiro verdadeiro
    verdadeiro falso verdadeiro
    verdadeiro verdadeiro
    verdadeiro verdadeiro verdadeiro
    t falso verdadeiro
    t verdadeiro
    t verdadeiro verdadeiro
    outro falso falso
    outro falso
    outro verdadeiro verdadeiro
    não virtual falso falso
    não virtual falso
    não virtual verdadeiro verdadeiro
    falso falso
    falso
    verdadeiro verdadeiro

    Derivar número virtual do número de série

    Use ao processar um registro de computador que pode ser virtual e quando um número de série é fornecido pela fonte e o status virtual é ambíguo. Pode ser usado junto com outras transformações de Classe de IC de Derivação.

    Detalhes
    Tabela sn_cmdb_int_util_derive_virtual_from_serial_number_operation
    Campos de entrada source_sys_rte_eb_fields
    A ordem de entrada é:
    1. Número de série
    2. O valor do sinalizador virtual atual
    Campo de saída target_sys_rte_eb_field

    A saída é o sinalizador virtual resultante (verdadeiro/falso). Se o sinalizador virtual atual for "verdadeiro", o resultado será verdadeiro. Caso contrário, o resultado será "verdadeiro" ou "falso".

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationVirtualDetectionUtil().detectVirtualFromSerialNumber (serial_in, is_virtual_in)

    Procura indicadores no número de série de um dispositivo virtual (VMware).

    Tabela 17. Exemplos
    Número de Série Sinalizador virtual Resultados do sinalizador virtual
    123 verdadeiro verdadeiro
    123 falso falso
    123 falso
    vmware-123 verdadeiro verdadeiro
    verdadeiro verdadeiro
    falso falso
    falso

    Extrair e escalar por unidades

    Use quando a origem tiver valores numéricos que precisam ser escalonados e um valor numérico com uma entrada como 2048 MB. A origem nem sempre fornece as unidades, portanto, pode ser necessário calcular ou adivinhar as unidades fornecidas. As unidades de destino dependem do campo de destino no CMDB. Se não for especificado, o campo que designa as casas decimais será definido como 2 por padrão.

    Nota:
    Este campo faz distinção entre maiúsculas e minúsculas.
    Detalhes
    Tabela sn_cmdb_int_util_extract_and_scale_by_units_operation
    Campos de entrada source_sys_rte_eb_fields
    Campo de saída target_sys_rte_eb_field
    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationExtractScaleUnitUtil().extractAndScaleUnits(input,defaultUnit,outputUnit,decimalPlaces)
    Tabela 18. Exemplos
    Valor de entrada Unidade padrão Unidade de Saída Resultado
    2048 MB MB GB 2 GB
    17179869184 B GB 16 GB

    Primeiro valor não nulo

    Use quando você tiver uma lista de campos fornecendo informações semelhantes que devem ser mapeadas para um único campo e quiser classificar a ordem em que eles podem fornecer esses valores.

    Por exemplo, internamente no SolarWinds, há uma hierarquia de tabelas que são unidas. Em um exemplo, o nome de um computador pode vir da tabela secundária ou de qualquer uma das tabelas primárias, mas cada uma delas é um campo separado na extração. Começando com a tabela mais específica, os valores são pesquisados para a primeira instância de um valor de nome.

    Detalhes
    Tabela sn_cmdb_int_util_first_non_null_operation
    Campos de entrada source_sys_rte_eb_fields

    A entrada é uma lista de campos de qualquer tamanho.

    Campo de saída target_sys_rte_eb_field

    Saída é o valor do primeiro campo na lista que não tem um valor nulo (ou vazio).

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationFirstNonNullValueUtil().firstNonNullValue(batch[i])
    Tabela 19. Exemplo
    Campo 1 Campo 2 Campo 3 Resultado
    foo foo2 foo

    Nome do Processo, Domínio, FQDN, Conjunto de DNS

    Use quando a origem fornecer informações de nome, domínio, FQDN ou DNS. Pode ser usado somente para um subconjunto deles (se, por exemplo, a origem fornecer somente o nome e o domínio). No caso de uma origem fornecer apenas campos que são inferiores na lista de entrada (FQDN), a inclusão de script CmdbIntegrationHardwareNameUtil pode ser chamada de uma operação de script para minimizar a necessidade de criar campos fictícios vazios.

    Detalhes
    Tabela sn_cmdb_int_util_process_name_set_operation
    Campos de entrada source_sys_rte_eb_fields
    Usa até quatro Campos de entrada (todos os campos adicionais são ignorados), na seguinte ordem:
    1. Nome
    2. Domínio
    3. FQDN
    4. DNS

    Você não precisa fornecer todos os quatro valores de entrada, mas deve fornecer esses valores na ordem especificada. Se, por exemplo, você quiser limpar apenas o domínio, deverá fornecer um atributo de nome, mesmo que esteja vazio.

    Campo de saída target_sys_rte_eb_field

    A saída é um conjunto concatenado de valores na mesma ordem, usando um canal triplo (|||): {name}|||{domain}|||{fqdn}|||{dns}

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet(name, domain, fqdn, dns)

    O FQDN e o DNS são processados primeiro para ver se os formatos deles estão corretos. O FQDN tem uma regex de descoberta adicional que deve ser aprovada (por meio de propriedades): glide.discovery.fqdn.regex – padrão: ^([^.]+)\\.((?:[^.]+\\.)+[^.]+)$

    Os possíveis valores de nome e domínio são extraídos, se possível. Quando o nome e o domínio forem processados, se não houver FQDN, será gerado um valor, se possível. Um valor de nome resultante também é modificado usando os seguintes sinalizadores de descoberta:
    1. glide.discovery.hostname.case – default: sem alterações. Pode ser definido como "Minúsculas", "Maiúsculas", "Sem alterações"
    2. glide.discovery.hostname.include_domain – padrão: falso. Se for "verdadeiro", o domínio será adicionado ao valor do nome final
    Tabela 20. Exemplos
    Nome Domínio FQDN DNS Resultados
    myName other.net otherName.other.net mycomp.servicenow.com myName|||other.net|||otherName.other.net|||mycomp.servicenow.com
    n/d other.net otherName.other.net mycomp.servicenow.com otherName|||other.net|||otherName.other.net|||mycomp.servicenow.com
    servicenow.com |||servicenow.com||||||
    name.servicenow.com name|||servicenow.com|||name.servicenow.com|||name.servicenow.com
    name.servicenow.com name|||servicenow.com|||name.servicenow.com|||
    name.servicenow.com name|||servicenow.com|||name.servicenow.com|||
    nome servicenow.com name|||servicenow.com|||name.servicenow.com|||

    FQDN do Processo

    Use quando a origem fornecer um valor de FQDN suspeito, e nenhum outro campo de nomeação, como nome, domínio ou DNS.

    Detalhes
    Tabela sn_cmdb_int_util_process_fqdn_operation
    Campos de entrada source_sys_rte_eb_field

    A entrada é um só campo que contém um FQDN.

    Campo de saída target_sys_rte_eb_field

    A saída é um conjunto concatenado de valores na mesma ordem, usando um canal triplo (|||): {name}|||{domain}|||{fqdn}|||{dns}

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationHardwareNameUtil().processNameDomainFqdnDnsSet('’, '’, fqdn, '’)

    O processamento segue a mesma lógica da transformação "Nome do processo, domínio, FQDN, conjunto DNS", exceto pelo fato de que somente o FQDN é usado como entrada.

    Tabela 21. Exemplo
    Entrada Resultado
    mycomputer.servicenow.com mycomputer|||servicenow.com|||mycomputer.servicenow.com|||

    Unidade de escala

    Use quando a origem tiver entradas numéricas que devam ser escalonadas. A origem nem sempre fornece as unidades atuais, portanto, pode ser necessário calcular ou adivinhar as unidades fornecidas. As unidades de destino dependem do campo pretendido no CMDB.

    Detalhes
    Tabela sn_cmdb_int_util_scale_unit_operation
    Campos de entrada source_sys_rte_eb_fields
    As entradas em ordem são:
    1. Valor de entrada
    2. Unidades atuais
    3. Unidades de destino
    Campo de saída target_sys_rte_eb_field

    Saída é o valor de entrada escalonado das unidades atuais para as unidades de destino. Se nenhuma unidade for encontrada para as unidades atuais, o valor de entrada será retornado. Se não forem encontradas nenhuma unidade atual ou de destino, a entrada será retornada como saída.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationScaleUnitUtil().scaleUnits(input_value, input_unit, output_unit)
    Tabela 22. Exemplo
    Entrada Resultado
    • Campo de entrada 1: 1
    • Campo de entrada 2: GB
    • Campo de entrada 3: MB
    1024

    Pesquisa de ID de pacote de software

    Use quando uma origem, como Jamf, não fornecer o fornecedor do software, mas fornecer um ID de pacote de software para Mac. A pesquisa de ID de pacote de software pesquisa registros na tabela de pesquisa de pacote configurável [sn-cmdb_int_util_bundleid_lookup] por bundle_id. Se existir um registro com o bundle_id especificado, ele extrairá o respectivo fornecedor de software. Caso contrário, ele criará um novo registro que será consultado na próxima vez em que a fonte de dados de IDs de pacote de software de pesquisa do Mac for executada.

    Detalhes
    Tabela sn_cmdb_int_util_software_bundle_id_lookup_operation
    Campos de entrada
    • source_sys_rte_eb_field
    • ID do pacote
    Campo de saída target_sys_rte_eb_field

    A saída é o nome do artista, o nome da faixa e o nome do vendedor resultantes, todos concatenados em um canal triplo (|||) ou uma cadeia de caracteres vazia se nenhuma correspondência for encontrada.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationSoftwareBundleIdLookup. lookupSoftware(bundleId)
    Tabela 23. Exemplo
    Entrada Resultado
    Campo de entrada 1: com.microsoft.Word Microsoft Corporation|||Microsoft Word||| Microsoft Corporation

    Pesquisa de usuário

    Use para pesquisar um usuário na tabela Usuário [sys_user] por nome de usuário ou e-mail, tentando fazer a correspondência na seguinte ordem:
    1. O Nome de Usuário correspondente ao atributo user_name.
    2. O e-mail correspondente ao atributo de e-mail.
    3. Se não houver correspondência, retornará vazio.
    Detalhes
    Tabela sn_cmdb_int_util_user_lookup_operation
    Campos de entrada source_sys_rte_eb_fields
    As entradas em ordem são:
    1. Nome de usuário
    2. E-mail (opcional)
    Campo de saída target_sys_rte_eb_field

    sysId do sys_user.

    Função de inclusão de script sn_cmdb_int_util.CmdbIntegrationUserLookup. lookupUser(username, email)
    Tabela 24. Exemplos
    Entrada Resultado
    Campo de entrada 1: abel.tuter 62826bf03710200044e0bfc8bcbe5df1
    • Campo de entrada 1: atuter
    • Campo de entrada 2: abel.tuter@example.com
    62826bf03710200044e0bfc8bcbe5df1