La propiedad “category” relaciona la “Categorías” (tipos de CIs) con las clases (tablas) de la CMDB de ServiceNow.
Las Categorías de la CMDB de Aranda tienen Estados y Campos Adicionales que se relacionarán con campos equivalentes de la CMDB de ServiceNow, el archivo de configuración tiene el siguiente JSON para category:
{
"category": [
{
"id": 0,
"projectId": 0,
"reference": "",
"externalFilter": "",
"cmdbFilter": "",
"ciSource": "",
"uploadAttachments": false,
"additionalFields": [
{
"id": 0,
"mappingDirection": "",
"field": {
"SearchBy": "",
"key": "",
"dataType": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
],
"state": {
"mappingDirection": "",
"field": {
"searchBy": "",
"key": "",
"dataType": ""
},
"mapping": [
{
"reason": 0,
"id": 0,
"value": ""
}
]
}
}
] ,
"externalClass": [
{
"reference": "computer",
"name": "cmdb_ci_computer"
}
]
}
1. Con ayuda de un administrador de Aranda Service Desk - CMDB obtenga los IDs de los proyectos registrados en la plataforma.
| Project | ID Project |
|---|---|
| Proyecto A | 1 |
| Proyecto B | 2 |
| Proyecto C | 3 |
2. Escoja el proyecto que se usará para la integración, para el ejemplo se toma el proyecto con ID 1.
3. En la propiedad “category.projectId” del archivo de configuración escriba el Id del proyecto seleccionado:
{
"category": [
{
"projectId": 1,
"id": 0,
"state": [
],
"additionalFields": [
]
}
]
}
4. Con ayuda de un administrador de Aranda Service Desk - CMDB obtenga los IDs de los tipos de CIs en la CMDB de Aranda para poblar category.
| Category | ID Category |
| Laptop | 16 |
| Disk | 17 |
| Desktop | 21 |
| Server | 24 |
5. Establezca una equivalencia entre las clases de la CMDB de ServiceNow y las categorías de la CMDB de Aranda:
Nota: En la sección anterior se obtuvieron los nombres de las clases - tablas de la CMDB de ServiceNow ver
| Category | ID Category | Table Name ServiceNow | Name ServiceNow | field “reference” |
| Laptop | 16 | cmdb_ci_computer | Computer | laptop |
| Disk | 17 | cmdb_ci_disk | Disk | disk |
| Desktop | 21 | cmdb_ci_computer | Computer | computer |
| Server | 24 | cmdb_ci_server | Server | server |
6. Escoja una Categoría que usará para la integración, para el ejemplo anterior se tomará la Categoría 17 que representa a los Desktop.
7. Escriba los valores en la propiedad “category.id” del archivo de configuración:
{
"category": [
{
"id": 17,
"projectId": 1,
"state": [
],
"additionalFields": [
]
}
]
}
8. La propiedad “reference” ayuda a relacionar las categorías (tipos de CIs) con las clases de la CMDB de ServiceNow.
9. En el punto 5 se estableció la relación que tendrían las categorías de la CMDB de Aranda con las clases o tablas de la CMDB de ServiceNow; la columna “reference” tiene por valor computer, asigne este valor en el archivo de configuración de la siguiente forma:
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"state": [
],
"additionalFields": [
]
}
]
}
10. La propiedad “externalFilter” se usa en la integración para cargues masivos, si requiere filtrar los CIs que importará en la CMDB de Aranda desde la CMDB de ServiceNow agregue esta propiedad.
En la siguiente imagen se ilustra como crear un filtro en ServiceNow:
En el ejemplo no se usará esta propiedad.
11. La propiedad “cmdbFilter” se usa en la integración para cargues masivos, si requiere filtrar los CIs por nombre que exportara de la CMDB de Aranda hacia la CMDB de ServiceNow agregue esta propiedad.
En el ejemplo no se usará esta propiedad.
12. La propiedad “ciSource” determina en que plataforma se crearán los CIs (la actualización de CIs está permitido en ambas direcciones por defecto):
- si el valor es true permitirá crear CIs en la CMDB de Aranda y sólo actualizar CIs en la CMDB de ServiceNow.
- si el valor es false permitirá crear CIs en la CMDB de ServiceNow y sólo actualizar CIs en la CMDB de Aranda.
Para el ejemplo tomaremos el valor como true, permitiendo crear CIs en la CMDB de Aranda desde la CMDB de ServiceNow.
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both"
"state": [
],
"additionalFields": [
]
}
]
}
13. Con ayuda de un administrador de Aranda Service Desk - CMDB obtenga los IDs de los valores para la propiedad Estado.
14. La propiedad Estado de la CMDB de Aranda se relaciona con la propiedad Operational status de ServiceNow.
15. En la propiedad “category.state.field.key” escriba el nombre del campo Operational status de ServiceNow de la siguiente forma:
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": true
"state":{
"field":{
"searchBy": "",
"key": "operational_status",
"dataType": ""
},
"mapping": [
]
},
"additionalFields": [
]
}
]
}
16. En la propiedad “category.state.field.dataType” escriba el tipo de campo en ServiceNow, como lo descrito en la sección category:
Según lo descrito es de tipo Choice:
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both",
"state":{
"field":{
"key": "operational_status",
"dataType": "Choice"
},
"mapping": [
]
},
"additionalFields": [
]
}
]
}
17. Obtenga los valores para la propiedad Operational status de ServiceNow.
18. Establezca una equivalencia entre los valores para los Estados de la siguiente forma:
| Estado ServiceNow | Estado CMDB Aranda | ID Estado CMDB Aranda | VALUE SERVICENOW |
| DR Stand | DR Stand | 187 | 4 |
| Non-Operational | Non-Operational | 188 | 2 |
| Operational | Operational | 189 | 1 |
| Repair in Progress | Repair in Progress | 190 | 3 |
| Retired | Retired | 191 | 5 |
17. Escriba los valores en la propiedad “category.state.mapping” del archivo de configuración:
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both",
"state":{
"field":{
"key": "operational_status",
"dataType": "Choice"
},
"mapping": [
{
"value": "4",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "1",
"id": 189
},
{
"value": "3",
"id": 190
},
{
"value": "5",
"id": 191
}
]
},
"additionalFields": [
]
}
]
}
18. En la CMDB de Aranda y las clases o tablas de ServiceNow se permite la creación de campos adicionales, si desea incluir algunos de ellos en la integración siga las instrucciones a continuación.
19. Se recomienda crear una tabla con los campos que desea agregar en la integración de la siguiente forma:
| Campo en ServiceNow | Campo en CMDB Aranda | key campo SERVICENOW | Id campo CMDB Aranda |
| Campo fijo | Campo fijo | u_campo_fijo | 286 |
| texto corto | texto corto | u_texto_corto | 287 |
| ciudades | ciudades | u_glide_list | 288 |
| item de configuración | item de configuración | u_reference_12 | 298 |
20. Elegir el tipo de integración con el que se van a relacionar cada campo, Data, Choice o Reference y escriba la información en el archivo json en la propiedad “additionalFields.field.dataType”.
Tenga en cuanta que para el tipo reference en requerida la propiedad searchBy que indica la propiedad por la cual se buscará en la tabla de ServiceNow.
La propiedad value sólo es requerida cuando se desean valores constantes.
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both",
"state": {
"field":{
"key": "operational_status",
"dataType": "Choice"
},
"mapping": [
{
"value": "4",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "1",
"id": 189
},
{
"value": "3",
"id": 190
},
{
"value": "5",
"id": 191
}
]
},
"additionalFields": [
{
"id": 286,
"value": [
"un valor que quiero que sea constante"
],
"field": {
"dataType": "Data",
"key": "u_campo_fijo"
}
},
{
"id": 287,
"field": {
"dataType": "Data",
"key": "u_texto_corto"
}
},
{
"id": 288,
"field": {
"dataType": "Choice",
"key": "u_glide_list"
}
},
{
"id": 298,
"field": {
"dataType": "Reference",
"key": "u_reference_12"
}
}
]
}
]
}
21. Para completar la configuración en los tipos Choice y Reference hay que agregar la propiedad mapping para ambos casos y la propiedad searchBy para el tipo Reference.
22. Para completar la configuración del tipo choice listar los id de los valores en la CMDB de Aranda y la CMDB de ServiceNow y escriba en la propiedad mapping donde id es el identificador del valor de la lista en la CMDB de Aranda y value en identificador del valor en la lista de la CMDB de ServiceNow.
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both",
"state": {
"field":{
"key": "operational_status",
"dataType": "Choice"
},
"mapping": [
{
"value": "4",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "1",
"id": 189
},
{
"value": "3",
"id": 190
},
{
"value": "5",
"id": 191
}
]
},
"additionalFields": [
{
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"dataType": "Data",
"key": "u_campo_fijo"
}
},
{
"id": 287,
"field": {
"dataType": "Data",
"key": "u_texto_corto"
}
},
{
"id": 288,
"field": {
"dataType": "Choice",
"key": "u_glide_list"
},
"mapping": [
{
"id": 16,
"value": "Bogotá"
},
{
"id": 17,
"value": "Bucaramanga"
},
{
"id": 18,
"value": "Santa marta"
}
]
},
{
"type": "Reference",
"id": 298,
"field": {
"dataType": "Reference",
"key": "u_reference_12"
}
}
]
}
]
}
23. Para completar los tipos Reference agregar el mapping y en la propiedad searchBy agregar el id del campo por la cual se buscará en la tabla de ServiceNow del campo adicional relacionado en este caso “u_reference_12”.
{
"category": [
{
"id": 17,
"projectId": 1,
"reference": "computer",
"ciSource": "Both",
"state": {
"field":{
"key": "operational_status",
"dataType": "Choice"
},
"mapping": [
{
"value": "4",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "1",
"id": 189
},
{
"value": "3",
"id": 190
},
{
"value": "5",
"id": 191
}
]
},
"additionalFields": [
{
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"dataType": "Data",
"key": "u_campo_fijo"
}
},
{
"id": 287,
"field": {
"dataType": "Data",
"key": "u_texto_corto"
}
},
{
"id": 288,
"field": {
"dataType": "Choice",
"key": "u_glide_list"
},
"mapping": [
{
"id": 16,
"value": "Bogotá"
},
{
"id": 17,
"value": "Bucaramanga"
},
{
"id": 18,
"value": "Santa marta"
}
]
},
{
"id": 298,
"field": {
"dataType": "Reference",
"key": "u_reference_12",
"SearchBy": "u_name"
},
"mapping": [
{
"id": 846,
"value": "item de configuración 1"
},
{
"id": 847,
"value": "item de configuración 2"
},
{
"id": 848,
"value": "autobús de producción"
}
]
}
]
}
]
}
Continuar: Registrar la propiedad “ci” (paso 3)