Relationship between CMDB and hpTechpulse

To perform the integration it is necessary to relate the fields of the Aranda CMDB device with the fields of the device in hpTechpulse through the “ci” section of the configuration file.

JSON Structure

{
    "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
                    }
                }
            }
        }
    ]
}

Properties :

Definition

To perform the integration it is necessary to relate the fields of the CI in Aranda CMDB with the IC of hptechpulse using the “definition” section of the configuration file, these properties in CMDB can be associated with fields in Techpulse.

Properties:

Ci in CMDB: Reference illustration, IC information in the CMDB

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

Propiedades internas

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

Where:

Types of relationship or association of fields

The following types of association determine how the values of the properties of the ci will be obtained.

Example type Value

1. Set the value “computer” to the Reference.
2. In the definition of the Ci Take the property Applicant (model) and assign the association type as Value.

{
  "ci": [
    {
      "reference": "computer",
      "definition": {
        "model": {
          "type": "Value"
        }
      }
    }
  ]
}

1. The relationship implies that a value must be assigned in a common way for all the Ci, this is accomplished by using the “model” property, as shown below:

{
  "ci": [
    {
      "reference": "computer",
      "definition": {
        "model": {
          "type": "Value"
        }
      }
    }
  ],
  "model": [
    {
      "reference": "",
      "id": 10
    }
  ]
}

1. Assign a value to the property “model.reference”:

{
  "case": [
    {
      "reference": "computer",
      "definition": {
        "applicant": {
          "type": "Value"
        }
      }
    }
  ],
  "applicant": [
    {
      "reference": "computer",
      "id": 10
    }
  ]
}

⚐ Note: The Ci associated with the “reference” “computer”, in CMDB they will be assigned the applicant with ID 10.

Mapper type example

1. Set the value “computer” to the Reference.
2. In the definition of the Ci Take the property Applicant (model).
3. “type”: Assign the association type as Mapper.
4. “key”: Name the property in HPTechpulse as modelTechpulse (Properties in HpTechpulse).

{
  "ci": [
    {
      "reference": "computer",
      "definition": {
        "model": {
          "type": "Mapper",
          "key": "modelTechpulse"
        }
      }
    }
  ]
}

1. The relationship implies that you must associate the CMDB models with the HPTechpulse models, it is recommended that you write the Id of the model to be related, as shown below:

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

⚐ Note: The model with CMDB ID “5” is related to the “hp probook” model in HPTechpulse

Search Property

The searchBy property is for the responsible field.

This tag allows you to define the property by which the user search will be carried out on the CMDB and Techpulse platforms; the supported property is “Email”.

Use Case

For proper use of the “Email” search property, users of the two platforms must have the same email per user. The following is an example of the responsible property with the “Email” search option.

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

defaultValue property

1. The property defaultValue allows you to add default values, if you add this property with the value of defaultValue.id for the CI in Aranda.
2. You can only add a default value if the mapping type is “Mapper” or “FieldValue”.

Example:

1. Set the value “computer” to the Reference.
2. In the definition of the Ci Take Responsible Property (responsible).
3. “type”: Assign the association type as FieldValue.
4. “key”: Assign the name of the property in HpTechpulse as assigned_to (Properties in HpTechpulse).
5. “defaultValue”: Assign the defaultValue.

{
  "ci": [
    {
      "reference": "computer",
      "definition": {
        "responsible": {
          "key": "assigned_to",
          "type": "FieldValue",
          "defaultValue": {
            "id": 222
          }
        }
      }
    }
  ]
}

FieldValue Example

1. Set the value “computer” to the Reference.
2. In the definition of the Ci Take the property model (model).
3. “type”: Assign the association type as FieldValue.
4. “key”: Assign the name of the property in techpulse as modelHp (Properties in HpTechpulse).

{
  "ci": [
    {
      "reference": "computer",
      "definition": {
        "model": {
          "type": "FieldValue",
          "key": "modeloHp"
        }
      }
    }
  ]
}

↩ Back to Settings