Mapeando classes do ServiceNow | Centro de Integração Aranda

1. Pesquise no CMDB do ServiceNow a classe que representa o dispositivo “Desktop” do ADM; para o exemplo “Desktop” estará relacionado à classe “cmdb_ci_computer” do ServiceNow, esta classe tem diferentes classes relacionadas (Referenciado); serão tidos em conta para o registo no arquivo.

2. Procure classes que tenham uma referência com “cmdb_ci_computer”, como os registros ID do Modelo, Fabricante e Gerenciado por:

3. Escolha e pesquise o nome das classes referenciadas que deseja incluir, por exemplo, as seguintes classes estão incluídas:

Mensalidade	Descrição
core_company	Forneça informações sobre a empresa que criou o dispositivo ou a empresa da qual ele faz parte.
sys_user	Fornece informações sobre a pessoa ou usuário responsável pelo dispositivo.
cmdb_model	Fornece informações sobre o modelo do dispositivo, para relacionar dispositivos como “Computador” O ServiceNow usa a classe “cmdb_hardware_product_model” que herda de “cmdb_model”, onde os modelos dos dispositivos serão adicionados se não existirem.
sys_choice	Seu valor é obtido por meio de uma “caixa de seleção”.

4. Na propriedade “classCMDB” No arquivo de configuração, as classes que você pesquisou anteriormente serão adicionadas.

Escreva o nome das classes na propriedade Nomecomo segue:

{
  "classCMDB": [
    {
      "searchBy": [
      ],
      "name": "cmdb_ci_computer",
      "fields": [

      ]
    },
    {
      "searchBy": [
      ],
      "name": "sys_user",
      "fields": [

      ]
    },
    {
      "searchBy": [
      ],
      "name": "cmdb_hardware_product_model",
      "fields": [

      ]
    },
    {
      "searchBy": [
      ],
      "name": "sys_choice",
      "fields": [

      ]
    }
  ]
}

5. Escolha os atributos da classe IC “cmdb_ci_computer” que você relacionará com os atributos dos dispositivos, conforme descrito no “Atributos de classes de IC (campos)”.

Os atributos escolhidos para a classe “cmdb_ci_computer” são:

os_version

Nome

short_description

disk_space

dns_domain

ip_address

sys_created_on

disk_space

CARNEIRO

cpu_count

cpu_core_count

object_id

6. Adicione o nome e o tipo dos atributos no “campos”, observe as seguintes propriedades:

{
    "type": "", 
    "name": "", 
    "mappingType": "", 
    "mappingName": "",
    "isRequired": false, 
    "classReference": "" 
}

[
        {
            "type": "string",
            "name": "os_version",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "name",
            "mappingType": "",
            "mappingName": "" , 
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "short_description",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "dns_domain",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "ip_address",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "ram",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_count",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_core_count",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        },
        {
            "type": "string",
            "name": "object_id",
            "mappingType": "",
            "mappingName": "",
            "isRequired": ,
            "classReference": null
        }
        ]

7. Na propriedade “éObrigatório” Digite “true” ou “false” se essa propriedade for necessária ou não, respectivamente, da seguinte maneira:

[
        {
            "type": "string",
            "name": "os_version",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "name",
            "mappingType": "",
            "mappingName": "" , 
            "isRequired": true,
            "classReference": null
        },
        {
            "type": "string",
            "name": "short_description",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "dns_domain",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "ip_address",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "ram",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_count",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_core_count",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "object_id",
            "mappingType": "",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        }
        ]

8. A propriedade “mappingType” É aditado de acordo com as seguintes informações:

Tipos de campos

Campos	Descrição
Mapeador	Representa o valor obtido diretamente da API Aranda DEVICE MANAGEMEN ADM, transforma-o no tipo de valor permitido pelo ServiceNow e o valor é adicionado.
Escolha do sistema	Ele representa um valor que se refere a uma entidade em que os dados são agregados em listas correspondentes à classe CI (para a classe de exemplo cmdb_ci_computer), o nome dessa classe é “sys_choice” que foi incluída na propriedade “classCMDB”.
Referência	O valor inserido cria uma relação entre o IC e a classe CMDB.

Os campos adicionados acima obterão seu valor das APIs do Aranda DEVICE MANAGEMEN ADM, no “mappingType” Insira o valor de “Mapeador” conforme mostrado abaixo:

[
        {
            "type": "string",
            "name": "os_version",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "name",
            "mappingType": "Mapper",
            "mappingName": "" , 
            "isRequired": true,
            "classReference": null
        },
        {
            "type": "string",
            "name": "short_description",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "dns_domain",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "ip_address",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "unit": "MB",
            "name": "ram",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "unit": "GB",
            "name": "disk_space",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_count",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_core_count",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "object_id",
            "mappingType": "Mapper",
            "mappingName": "",
            "isRequired": false,
            "classReference": null
        }
        ]

9. para a propriedade “mappingName” serve para formar uma relação entre a propriedade “classCMDB” e “Mapeador” ou “dataReference” conforme apropriado Ver mais.

Adicione os seguintes valores relacionados ao “Mapeador”, quando mais configurações de arquivo forem concluídas:

Referência do Computador do Dispositivo
DeviceComputerReferenceNetwork

O valor de DeviceComputerReferenceNetwork é adicionado para caracterizar os componentes de rede, ele não influencia o mapeamento.

O arquivo de configuração com a propriedade “mappingName” é configurado da seguinte maneira:

[
        {
            "type": "string",
            "name": "os_version",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "name",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference" , 
            "isRequired": true,
            "classReference": null
        },
        {
            "type": "string",
            "name": "short_description",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "disk_space",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "dns_domain",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReferenceNetwork",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "ip_address",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReferenceNetwork",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "sys_created_on",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "unit": "MB",
            "name": "ram",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "unit": "GB",
            "name": "disk_space",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_count",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "integer",
            "name": "cpu_core_count",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        },
        {
            "type": "string",
            "name": "object_id",
            "mappingType": "Mapper",
            "mappingName": "DeviceComputerReference",
            "isRequired": false,
            "classReference": null
        }
        ]

10. Registre os atributos da classe “cmdb_ci_computer” com referência; conforme explicado no 3 A classe “cmdb_ci_computer” tem as seguintes referências:

“core_company” (tipo: Referência).
“sys_user” (tipo: Referência).
“cmdb_model” => “cmdb_hardware_product_model” (tipo: Referência).
“sys_choice” (tipo: SysChoice).

Os atributos que forem do tipo “Referência” serão registrados no “mappingType” com o valor de “Reference”, que determina que essa propriedade relacione a classe IC com as classes já listadas.

Na propriedade “classReference” Coloque o nome da tabela à qual o atributo faz referência, por exemplo:

Atributo	Classe referenciada
fabricante	core_company
Companhia	core_company
model_id	cmdb_hardware_product_model
assigned_to	sys_user

Adicione essa relação com as propriedades listadas no 6

{
    {
        "type": "string",
        "name": "manufacturer",
        "mappingType": "Reference",
        "mappingName": "",
        "isRequired": false,
        "classReference": "core_company"
    },
    {
        "type": "string",
        "name": "company",
        "mappingType": "Reference",
        "mappingName": "",
        "isRequired": false,
        "classReference": "core_company"
    },
    {
        "type": "string",
        "name": "model_id",
        "mappingType": "Reference",
        "mappingName": "",
        "isRequired": false,
        "classReference": "cmdb_hardware_product_model"
    },
    {
        "type": "string",
        "name": "assigned_to",
        "mappingType": "Reference",
        "mappingName": "",
        "isRequired": false,
        "classReference": "sys_user"
    },
}

Os atributos do tipo “SysChoice” são adicionados da seguinte maneira:

{
    {
        "type": "string",
        "name": "os",
        "mappingType": "SysChoice",
        "mappingName": "",
        "isRequired": false,
        "classReference": "sys_choice"
    },
    {
        "type": "string",
        "name": "discovery_source",
        "mappingType": "SysChoice",
        "mappingName": "",
        "isRequired": false,
        "classReference": "sys_choice"
    }
}

11.. Observe que as propriedades da classe “cmdb_ci_computer” referentes a outras classes que contêm atributos do tipo “Mapper” serão usadas “mappingName” para se referir a “mapeador”; Essas classes usarão a referência para resolver seu valor.

EmpresaFabricanteReferência
CompanyOwnerReference
HardwareProductModelReference
UserDeviceReference
OperatingSystemReferenced
DiscoverySourceReferenced

NÃO as classes na propriedade “classCMDB” serão duplicadas; O campo “mappingName” estabelece como a classe referenciada obterá os valores.

Insira os valores acima nos atributos da seguinte maneira:

{
    {
        "type": "string",
        "name": "manufacturer",
        "mappingType": "Reference",
        "mappingName": "CompanyManufactureReference",
        "isRequired": false,
        "classReference": "core_company"
    },
    {
        "type": "string",
        "name": "company",
        "mappingType": "Reference",
        "mappingName": "CompanyOwnerReference",
        "isRequired": false,
        "classReference": "core_company"
    },
    {
        "type": "string",
        "name": "model_id",
        "mappingType": "Reference",
        "mappingName": "HardwareProductModelReference",
        "isRequired": false,
        "classReference": "cmdb_hardware_product_model"
    },
    {
        "type": "string",
        "name": "assigned_to",
        "mappingType": "Reference",
        "mappingName": "UserDeviceReference",
        "isRequired": false,
        "classReference": "sys_user"
    },
}

Os atributos do tipo “SysChoice”:

{
  {
    "type": "string",
    "name": "os",
    "mappingType": "SysChoice",
    "mappingName": "OperatingSystemReferenced",
    "isRequired": false,
    "classReference": "sys_choice"
  },
  {
    "type": "string",
    "name": "discovery_source",
    "mappingType": "SysChoice",
    "mappingName": "DiscoverySourceReferenced",
    "isRequired": false,
    "classReference": "sys_choice"
  }
}

12. Os objetos que adicionamos no “classCMDB” ter a propriedade “searchBy”, essa propriedade é usada para localizar o dispositivo ou os dados adicionados ao ServiceNow. Para o exemplo, as informações entre o ADM e o ServiceNow são comparadas usando o ID do dispositivo fornecido pelo Aranda DEVICE MANAGEMENT ADM e mapeadas para o “object_id” da classe “cmdb_ci_computer”; Este ID é único e servirá para evitar a duplicação de dispositivos, por esse motivo, insira o “object_id” Dentro da propriedade searchBy do arquivo de configuração, conforme apresentado abaixo.

{
  "classCMDB": [
    {
      "searchBy": [
        "object_id"
      ],
      "name": "cmdb_ci_computer",
      "fields": [

      ]
    }
  ]
}

Como resultado, o seguinte JSON é obtido, com os atributos a serem mapeados:

{
  "classCMDB": [
    {
      "searchBy": [
        "object_id"
      ],
      "name": "cmdb_ci_computer",
      "fields": [
        {
          "type": "string",
          "name": "os",
          "mappingType": "SysChoice",
          "mappingName": "OperatingSystemReferenced",
          "isRequired": false,
          "classReference": "sys_choice"
        },
        {
          "type": "string",
          "name": "discovery_source",
          "mappingType": "SysChoice",
          "mappingName": "DiscoverySourceReferenced",
          "isRequired": false,
          "classReference": "sys_choice"
        },
        {
          "type": "string",
          "name": "manufacturer",
          "mappingType": "Reference",
          "mappingName": "CompanyManufacturerReference",
          "isRequired": false,
          "classReference": "core_company"
        },
        {
          "type": "string",
          "name": "company",
          "mappingType": "Reference",
          "mappingName": "CompanyOwnerReference",
          "isRequired": false,
          "classReference": "core_company"
        },
        {
          "type": "string",
          "name": "model_id",
          "mappingType": "Reference",
          "mappingName": "HardwareProductModelReference",
          "isRequired": false,
          "classReference": "cmdb_hardware_product_model"
        },
        {
          "type": "string",
          "name": "assigned_to",
          "mappingType": "Reference",
          "mappingName": "UserDeviceReference",
          "isRequired": false,
          "classReference": "sys_user"
        },
        {
          "type": "string",
          "name": "os_version",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "name",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": true,
          "classReference": null
        },
        {
          "type": "string",
          "name": "short_description",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "integer",
          "name": "disk_space",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "dns_domain",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReferenceNetwork",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "ip_address",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReferenceNetwork",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "sys_created_on",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "sys_created_on",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "integer",
          "unit": "MB",
          "name": "ram",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "integer",
          "unit": "GB",
          "name": "disk_space",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "integer",
          "name": "cpu_count",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "integer",
          "name": "cpu_core_count",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        },
        {
          "type": "string",
          "name": "object_id",
          "mappingType": "Mapper",
          "mappingName": "DeviceComputerReference",
          "isRequired": false,
          "classReference": null
        }
      ]
    },
    {
      "searchBy": [
      ],
      "name": "sys_user",
      "fields": [

      ]
    },
    {
      "searchBy": [
      ],
      "name": "cmdb_hardware_product_model",
      "fields": [

      ]
    },
    {
      "searchBy": [
      ],
      "name": "sys_choice",
      "fields": [

      ]
    }
  ]
}  

Para as aulas que não estão registradas nesta seção, colocamos os seguintes links, que você pode consultar; O processo é o mesmo que o realizado com o cmdb_ci_computer.

ServiceNow Classes

↩ Exemplo de BackServiceNow ↪

Continuar: Relação entre classCMDB e mapeador (etapa 3) ↪