Relación entre la Categoría y las clases de ServiceNow
La integración requiere relacionar las Categorías de los CIs de la CMDB de Aranda con las clases (tablas) de la CMDB de ServiceNow, a continuación mostramos un esquema json que nos permite crear esta relación:
{
"category": [
{
"id": 0,
"projectId": 0,
"reference": "",
"externalFilter": "",
"cmdbFilter": [
{
"dataType": "",
"field": "",
"logicOperator": "",
"operator": "",
"value": ""
}
],
"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": ""
}
]
}
}
]
}
Donde
| Propiedades | Descripción |
|---|---|
| id | Identificador de la categoría en la CMDB de Aranda, en la parte superior derecha se puede observar el nombre de la Categoría (Desktop)Imagen |
| reference | Corresponde al nombre/alias (un pseudonombre puesto a la clase de ServiceNow) de la clase ServiceNow con la que relacionaremos la categoría del CI de Aranda |
| ciSource | La importación de CIs (crear CIs en la CMDB de Aranda) o exportación de CIs (enviar los CIs de la CMDB de Aranda hacia terceros) esta determinada por esta propiedad, ver |
| projectId | Identificador del proyecto a los que se asocia el CI creado en la CMDB de Aranda |
| uploadAttachments | Habilita la integración para el cargue de adjuntos entre plataformas, por defecto la propiedad esta en “false” |
| cmdbFilter | Asigna un filtro al momento de cargar los CIs de forma masiva desde la CMDB de Aranda hacia la CMDB de ServiceNow Definición de filtros en la CMDB de Aranda |
| externalFilter | Asigna un filtro al momento de cargar los CIs de forma masiva desde la CMDB de ServiceNow hacia la CMDB de Aranda; para mas información de los filtros y query de búsqueda, consulte la documentación de ServiceNow |
| state | Representa la relación de los estados del CI. Relación de estados de los CIs |
| additionalFields | Representa la relación entre los campos adicionales de la CMDB de Aranda y los campos de las clases de la CMDB de ServiceNow. Relación entre campos adicionales de la CMDB de Aranda y las clases de ServiceNow |
CI CMDB Aranda: Ilustración de referencia.
Relación de estados de los CIs
Estados del CI en la CMDB de Aranda.
Estados del CI en la CMDB de ServiceNow.
Para relacionar los estados la integración proporciona el siguiente esquema json:
{
"state": {
"mappingDirection": "",
"field": {
"key": "",
"dataType": "",
"searchBy": ""
},
"mapping": [
{
"id": 0,
"value": "",
"reason": null
}
]
}
}
Donde:
| Propiedades | Descripción | Propiedades internas |
|---|---|---|
| field | Representa la información correspondiente al campo en ServiceNow | ver |
| mapping | Representa la relación de los estados | ver |
| mappingDirection | Representa la plataforma que tiene permitido actualizar el campo del CI | ver |
EJEMPLO: Relación de estados CMDB de Aranda / CMDB de ServiceNow
Para crear la relación de los estados siga las siguientes instrucciones:
- Obtenga los IDs de los estados de la CMDB de Aranda.
- Obtenga los sys_id o value de los estados de la CMDB de ServiceNow.
- Asigne la siguiente equivalencia de estados:
| Estado en ServiceNow | Estado en Aranda | ID STATE ARANDA | SYS_ID STATE SERVICENOW |
| Operational | NUEVO | 1 | sys_id_operational |
| DR Standy | CERRADO | 13 | sys_id_dr_standy |
-
Escriba el ID STATE ARANDA en la propiedad “id” y el SYS_ID STATE SERVICENOW de su equivalente tomado de la CMDB de ServiceNow en la propiedad value
[ { "id": 1, "value": "sys_id_operational" }, { "id": 13, "value": "sys_id_dr_standy" } ]
Definición de filtros en la CMDB de Aranda
La propiedad “cmdbFilter” se usa en la carga masiva de CIs en sentido Aranda - ServiceNow
Esta propiedad permite filtrar los CIs de la CMDB de Aranda por:
-
Nombre del campo.
-
Tipo de dato del campo.
-
Tipo de relacion con otros criterios de búsqueda.
-
Clausula de búsqueda.
{
"category": [
{
"cmdbFilter": [
{
"field": "",
"dataType": "",
"logicOperator": "",
"operator": "",
"value": ""
}
]
}
]
}
Donde:
1. “field”: Nombre del campo por el que se realizaran las búsquedas; permite los siguientes valores:
| Nombre del campo |
|---|
| Name |
| StateId |
| ModelId |
| Serial |
| AssetTag |
| Price |
| ImpactId |
| BrandId |
| ManufacturerId |
| ProviderId |
| UnitId |
| UnitSize |
| ResponsibleId |
| LicenseNumber |
| CostCenterId |
| CreatedDate |
| ModifierId |
| AuthorId |
| Version |
| Type |
| ReasonId |
| ClosedDate |
| PreviousStateId |
| IntegrationId |
| RiskLevel |
2. “dataType”: Tipo de dato al que pertenece el campo a filtrar; permite los siguientes valores:
| Tipo de dato del campo a filtrar |
|---|
| ShortText |
| Datetime |
| LongText |
| Numeric |
| Decimal |
| Date |
| Currency |
3. “logicOperator”: Tipo de relacion con otros criterios de búsqueda; permite los siguientes valores:
| Relación con otros criterios de búsqueda |
|---|
| And |
| Or |
4. “operator”: Operador lógico que se usara en una clausula para buscar un patrón específico; permite los siguientes valores:
| Operador lógico de búsqueda |
|---|
| None |
| EqualTo |
| NotEqualTo |
| GreaterThan |
| GreaterThanOrEqualTo |
| LessThan |
| LessThanOrEqualTo |
| Like |
| And |
| Or |
Relación entre los campos adicionales y los campos de las clases de ServiceNow
A continuación una imagen informativa de cómo se podrían ver los campos adicionales en la CMDB de Aranda, se agrupan en el segmento de adicionales
⚐ Nota: los campos adicionales son creados según las necesidades del cliente, esta imagen es sólo representativa.
Propiedades internas additionalFields
{
"id": 0,
"mappingDirection": "",
"field": {
"dataType": "",
"key": "",
"searchBy": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
A continuación se da una descripción de las propiedades internas del objecto additionalFields
| Propiedades | Descripción | Propiedades internas |
|---|---|---|
| id | Identificador del campo en la CMDB de Aranda | |
| field | Representa la información correspondiente al campo en ServiceNow | ver |
| mapping | Representa la relación de los valores entre la CMDB de ServiceNow y la CMDB de Aranda | ver |
| mappingDirection | Representa la plataforma que tiene permitido actualizar el campo del CI | ver |
Listado de los tipos de campo adicionales soportados
Listado de relación entre los tipos de campos de las plataformas, para los campos adicionales.
| CMDB Aranda | Identificador tipo de campo en CMDB ServiceNow | Nombre/Etiqueta tipo de campo en ServiceNow |
|---|---|---|
| Short Text | string | String |
| Paragraph | string | String |
| True or False | true/false | True/False |
| Date | glide_date | Date |
| Date and Time | glide_date_time, calendar_date_time | Date/Time, Calendar Date/Time |
| Numeric | integer, longint | Integer, Long |
| Decimal | decimal | Decimal |
| List | choice, glide_list, reference | Choice, List, Reference |
| Catalog (List) | reference, choice | Choice, Reference |
| Currency | currency, price | Currency, Price |
| Link | url | URL |
| Time | glide_utc_time | UTC Time |
⚐ Nota: Relacionar campos de tipos distintos a los relacionados en la anterior tabla se generará un error
Valores permitidos para mappingDirection
| Nombre | Descripción |
|---|---|
| Both | Las dos plataformas permiten actualizar el campos, este valor es agregado por defecto |
| Aranda | Sólo la CMDB de Aranda puede actualizar el campo |
| External | Sólo la CMDB de ServiceNow puede actualizar el campo |
Valores permitidos para ciSource
| Nombre | Descripción |
|---|---|
| Both | Las dos plataformas permiten crear y actualizar CIs |
| Aranda | La CMDB de Aranda actúa como la fuente de información y le permite al sistema crear y actualizar CIs en la CMDB de ServiceNow. La CMDB de ServiceNow sólo se le permite actualizar CIs en la CMDB de Aranda |
| External | La CMDB de ServiceNow actúa como la fuente de información y le permite al sistema crear y actualizar CIs en la CMDB de Aranda. La CMDB de Aranda sólo se le permite actualizar CIs en la CMDB de ServiceNow |