PT
Español
English
Português
    Ci

    Relação entre CMDB e Intune

    Para realizar a integração, você precisa relacionar os campos do dispositivo Aranda CMDB aos campos do dispositivo no Intune usando a seção “ci” do arquivo de configuração.

    Estrutura JSON

    {
        "ci": [
            {
                "reference": "",
                "definition": {
                    "name": {
                        "type": "",
                        "key": ""
                    },
                    "brand": {
                        "type": "",
                        "key": ""
                    },
                    "model": {
                        "type": "",
                        "key": ""
                    },
                    "assetTag": {
                        "type": "",
                        "key": ""
                    },
                    "serial": {
                        "type": "",
                        "key": ""
                    },
                    "responsible": {
                        "SearchBy": [
                            "Email"
                        ],
                        "type": "",
                        "key": "",
                        "DefaultValue": {
                            "id": 0
                        }
                    }
                }
            }
        ]
    }
    

    Propriedades :

    Propriedades Descrição
    Referência Identificador exclusivo para criar uma relação entre os conceitos nome, marca, modelo, assetTag, serial, responsável ver
    Definição Permite relacionar campos de CI no CMDB a campos de CI no Intune

    Definição

    Para realizar a integração, relacione os campos de CI no Aranda CMDB ao CI do Intune usando a seção “definition” do arquivo de configuração. Essas propriedades no CMDB podem ser associadas a campos no Intune.

    Propriedades:

    Propriedades Descrição  
    Nome Representa o campo Nome do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune.  
    marca Representa o campo marca do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune. Propriedades internas
    modelo Representa o campo modelo do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune. Propriedades internas
    assetTag Representa o campo assetTag do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune. Propriedades internas
    serial Representa o campo serial do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune. Propriedades internas
    responsável Representa o campo responsável do CI em Aranda e permite relacionar esse campo a um campo equivalente do CI em Intune. Propriedades internas

    Ci no CMDB: Ilustração de referência, informações de IC no CMDB

    Ci en Intune: Ilustración de referencia, información básica del ci en la plataforma Intune

    Propiedades internas

    {
      "key": "",
      "type": "",
      "searchBy": [ "Email" ],
      "defaultValue": {
        "id": 0,
        "value": ""
      }
    }
    


    Onde:

    Propriedades Descrição  
    tipo Tipo de associação, os tipos suportados são Value, Mapper, FieldValue. FieldValue, Value, Mapper.
    Chave Nome do campo/propriedade no Intune onde a informação será pesquisada. Propriedades Intune
    searchBy Propriedade de pesquisa de campo, aplica-se apenas ao campo responsável ver
    defaultValue Permite adicionar um valor padrão. ver


    Tipos de relacionamento ou associação de campos

    Os seguintes tipos de associação determinam como os valores das propriedades do ci serão obtidos.

    Nome Descrição Exemplo
    Valor Permite atribuir um valor ao campo selecionado através do arquivo de configuração. O valor deve estar dentro das propriedades da taxa de valor Veja o exemplo
    Mapeador Busca associar e/ou relacionar os valores do CMDB IC com os valores do CI Intune no campo indicado, a razão de valores é feita 1 para 1, a atribuição não pode ser repetida Veja o exemplo
    Valor do campo Os valores de propriedade são enviados diretamente entre plataformas sem qualquer associação/relacionamento Veja o exemplo


    Tipo de exemplo Valor

    1. Defina o valor “computador” para o Referência.
    2. Na definição do Ci Pegue a propriedade Requerente (modelo) e atribua o tipo de associação como Valor.
    {
      "ci": [
        {
          "reference": "computer",
          "definition": {
            "model": {
              "type": "Value"
            }
          }
        }
      ]
    }
    
    1. A relação implica que um valor deve ser atribuído de maneira comum para todos os Ci, isso é feito usando a propriedade “model”, conforme mostrado abaixo:
    {
      "ci": [
        {
          "reference": "computer",
          "definition": {
            "model": {
              "type": "Value"
            }
          }
        }
      ],
      "model": [
        {
          "reference": "",
          "id": 10
        }
      ]
    }
    
    1. Atribuir um valor à propriedade “modelo.referência”:
    {
      "case": [
        {
          "reference": "computer",
          "definition": {
            "applicant": {
              "type": "Value"
            }
          }
        }
      ],
      "applicant": [
        {
          "reference": "computer",
          "id": 10
        }
      ]
    }
    


    Nota: O Ci associado à “referência” “computador”, no CMDB será atribuído ao requerente o ID 10.


    Exemplo de tipo de mapeador

    1. Defina o valor “computador” para o Referência.
    2. Na definição do Ci Pegue a propriedade Requerente (modelo).
    3. “type”: Atribua o tipo de associação como Mapeador.
    4. “chave”: Nomeie a propriedade no Intune como modelIntune (Propriedades Intune).
    {
      "ci": [
        {
          "reference": "computer",
          "definition": {
            "model": {
              "type": "Mapper",
              "key": "modelIntune"
            }
          }
        }
      ]
    }
    

    5. A relação implica que você precisa associar seus modelos CMDB aos seus modelos Intune, recomendamos que você escreva o Id do modelo a ser relacionado, conforme mostrado abaixo:

    {
      "case": [
        {
          "reference": "computer",
          "definition": {
            "model": {
              "type": "Mapper"
            }
          }
        }
      ],
      "model": [
        {
          "reference": "computer",
          "mapping": [
            {
              "id": 5,
              "value": "hp probook"
            }
          ]
        }
      ]
    }
    


    Nota: Relaciona o modelo com o CMDB ID “5” ao modelo “hp probook” no Intune


    Pesquisar Propriedade

    A propriedade searchBy é para o campo responsável.

    Essa tag permite definir a propriedade pela qual a busca do usuário será realizada nas plataformas CMDB e Intune; a propriedade suportada é “Email”.

    Caso de uso

    Para o uso adequado da propriedade de pesquisa “E-mail”, os usuários das duas plataformas devem ter o mesmo e-mail por usuário. Veja a seguir um exemplo da propriedade responsável com a opção de pesquisa “E-mail”.

    {
      "responsible": {
          "type": "FieldValue",
          "key": "user",
          "searchBy": [ "Email" ]
          }
    }
    


    propriedade defaultValue

    1. A propriedade defaultValue permite adicionar valores padrão, se você adicionar essa propriedade com o valor de defaultValue.id para o CI em Aranda.
    2. Você só poderá adicionar um valor padrão se o tipo de mapeamento for “Mapeador” ou “ValorDoCampo”.

    Exemplo:

    1. Defina o valor “computador” para o Referência.
    2. Na definição do Ci Assuma a propriedade responsável (responsável).
    3. “type”: Atribua o tipo de associação como Valor do campo.
    4. “chave”: Nomeie a propriedade no Intune como userPrincipalName (Propriedades Intune).
    5. “defaultValue”: atribua o defaultValue.
    {
      "ci": [
        {
          "reference": "computer",
          "definition": {
            "responsible": {
              "key": "userPrincipalName",
              "type": "FieldValue",
              "defaultValue": {
                "id": 222
              }
            }
          }
        }
      ]
    }
    

    Exemplo de FieldValue

    1. Defina o valor “computador” para o Referência.
    2. Na definição do Ci Pegue o modelo de propriedade (modelo).
    3. “type”: Atribua o tipo de associação como Valor do campo.
    4. “chave”: Nomeie a propriedade no Intune como modelo (Propriedades Intune).
    {
      "ci": [
        {
          "reference": "computer",
          "definition": {
            "model": {
              "type": "FieldValue",
              "key": "model"
            }
          }
        }
      ]
    }
    


    ↩ Voltar para Configurações