Model | Centro de Integraciones Aranda

Relación de estados y campos adicionales con las propiedades de las clases de ServiceNow

Este apartado indica las relación de los estados entre las plataformas y los campos adicionales según la configuración de las plataformas

"model": [
    {
        "id": 0,
        "state": [              
            {
                "value": "",
                "id": 0,
                "commentary": {
                    "Key": "",
                    "value":""
                }
            }
        ],       
        "additionalFields": [                
            {
                "id": 0,
                "field": {
                    "type": "",
                    "key": "",
                    "SearchBy": ""
                },
                "mapping": [
                    {
                        "id": 0,
                        "value": ""
                    }
                ]
            }
        ]
    }
]

Propiedades
A continuación se da una descripción de las propiedades del anterior json

Propiedades	Descripción
id	Identificador del modelo en ASMS
state	Relación de los valores del estado de ASMS y ServiceNow	Ver
additionalFields	Relación de los campos adicionales entre ASMS y ServiceNow	Ver

Relación de los estados

Para relacionar los estados la integración proporciona el siguiente esquema json:

{
    "value": "",
    "id": 0,
    "commentary": {
        "value": "",
        "Key": ""
    }
}

A continuación se da una descripción de las propiedades internas del objecto state

Propiedades	Descripción
value	Identificador del estado en ServiceNow (sys_id si es un campo tipo “Reference” o value si es un campo tipo “Choice”) Propiedades ServiceNow
id	Identificador del estado en ASMS
commentary	Relaciona el campo solución por el cambio de estado en ASMS, donde “key” es el identificador del campo en ServiceNow y “value” el valor a agregar en dichos campos

EJEMPLO: Relación de estados ASMS / ServiceNow

Para crear la relación de los estados siga las siguientes instrucciones:

Obtenga los IDs de los estados de ASMS.
Obtenga los sys_id o value de los estados de ServiceNow.
Asigne la siguiente equivalencia de estados:
La propiedad commentary (Representa la “Solución del caso”), se relaciona con un campo equivalente “close_notes” en ServiceNow.

Estado en ServiceNow	Estado en Aranda	ID STATE ARANDA	VALUE STATE SERVICENOW
New	NUEVO	1	value_new
Closed	CERRADO	13	value_closed

Escriba el ID STATE ARANDA en la propiedad “id” y el VALUE STATE SERVICENOW de su equivalente tomado de la CMDB de ServiceNow en la propiedad value:

 [
    {
       "id": 1,
       "value": "value_new",
       "commentary": {
          "Key": "close_notes"
       }
    },
    {
       "id": 13,
       "value": "value_closed",
       "commentary": {
          "Key": "close_notes"
       }
    }
 ]

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 plataforma ASMS, se agrupan en el segmento de información adicional

⚐ Nota: los campos adicionales son creados según las necesidades del cliente, esta imagen es sólo representativa.

Propiedades internas additionalFields

{
    "id": 0,
    "field": {
        "type": "",
        "key": "",
        "SearchBy": ""
    },
    "mapping": [
        {
            "id": 0,
            "value": ""
        }
    ]
}

A continuación se da una descripción de las propiedades internas del objecto additionalFields

Propiedades	Descripción
id	Identificador del campo adicional en ASMS
field	Información del campo en ServiceNow, más información	ver
mapping	Relación entre valores del campo de ASMS y ServiceNow, donde “id” es el identificador en ASMS y “value” el identificador en ServiceNow (sys_id si es un campo tipo “Reference” o value si es un campo tipo “Choice”)

Listado de los tipos de campo adicionales soportados
Listado de relación entre los tipos de campos de las plataformas:

ASMS	Identificador del campo campo en ServiceNow	Nombre/Etiqueta del 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: Asociar 2 campos diferentes a los relacionados en la anterior tabla genera un error en tiempo de ejecución***

↩ Volver a Configuración