Category | Centro de Integraciones Aranda

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

↩ Volver a Configuración