La propiedad “model” relaciona los Estados y los Campos Adicionales de ASMS, el archivo de configuración tiene el siguiente JSON para model:
{
"model": [
{
"state": [
{
"value": "",
"id": 0,
"commentary": {
"Key": "",
"value": ""
}
}
],
"id": 0,
"additionalFields": [
{
"id": 0,
"field": {
"type": "",
"key": "",
"SearchBy": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
]
}
],
"urgency": [
],
"impact": [
],
"case": [
],
"typeRegister": [
],
"service": [
],
"project": [
],
"category": [
],
"applicant": [
],
"responsibleGroup": [
],
"responsible": [
]
}
En secciones anteriores se crearon relaciones entre las propiedades de ASMS y ServiceNow
| Propiedad en ASMS | Propiedad en ServiceNow |
|---|---|
| project | u_inquilinochoice |
| idByProject | u_external_id_field |
| category | category |
| subject | short_description |
| description | description |
| typeRegister | contact_type |
| state | state |
| impact | impact |
| urgency | urgency |
| responsibleGroup | assignment_group |
| responsible | assigned_to |
| service | N/A |
1. Con ayuda de un administrador de Aranda Service Management (ASMS) obtenga los IDs de los valores para la propiedad Model.
2. Escoja un modelo que usará para la integración.
3. Escriba los valores en la propiedad “model.id” del archivo de configuración:
{
"model": [
{
"state": [
],
"id": 15,
"additionalFields": [
]
}
]
}
4. Con ayuda de un administrador de Aranda Service Management (ASMS) obtenga los IDs de los valores para la propiedad Estado.
5. La propiedad Estado de ASMS se relaciona con la propiedad State de ServiceNow.
6. obtenga los valores para la propiedad State de ServiceNow.
7. Establezca una equivalencia entre los valores para los Estados de la siguiente forma:
| State ServiceNow | Tipo de registro ASMS | ID Tipo de registro ASMS | VALUE Channel SERVICENOW |
|---|---|---|---|
| New | New | 187 | 1 |
| In Progress | In Progress | 188 | 2 |
| On Hold | On Hold | 189 | 3 |
| Resolved | Resolved | 190 | 5 |
| Closed | Closed | 191 | 6 |
8. Escriba los valores en la propiedad “model.state” del archivo de configuración:
{
"model": [
{
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189
},
{
"value": "5",
"id": 190
},
{
"value": "6",
"id": 191
}
],
"id": 15,
"additionalFields": [
]
}
]
}
8. En ASMS por configuración los casos requieren que la propiedad “Solución” tenga un valor, esta solución está determinada por el estado en el que se encuentre el caso.
Para solventar este requerimiento el archivo de configuración permite agregar un valor de forma estática u obtenerlo directamente de ServiceNow, mediante la siguiente propiedad:
{
"commentary": {
"key": "",
"value": ""
}
}
Donde:
“key”: nombre de la propiedad ServiceNow donde se obtendrá la solución. “value”: valor estático que se asignará a la solución de ASMS.
9. Asigne un campo de ServiceNow que relacionará con el campo “Solución” de ASMS
10. Escriba en el archivo de configuración la relación del campo solución de ASMS con el campo de ServiceNow.
Tenga en cuenta que no todos los estados requieren una solución, depende de la configuración de las plataformas.
{
"model": [
{
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "5",
"id": 190,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "6",
"id": 191,
"commentary": {
"Key": "close_notes"
}
}
],
"id": 15,
"additionalFields": [
]
}
]
}
11. En ASMS y 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.
12. Se recomienda crear una tabla con los campos que desea agregar en la integración de la siguiente forma:
| campo en ServiceNow | campo en ASMS | Id campo SERVICENOW | Id campo ASMS |
|---|---|---|---|
| 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 |
13. 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.
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.
{
"model": [
{
"state": [
],
"id": 0,
"additionalFields": [
{
"type": "Data",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "Data",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "Choice",
"id": 288,
"field": {
"key": "u_glide_list"
}
},
{
"type": "Reference",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
14. 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.
15. Para completar la configuración del tipo choice listar los id de los valores en ASMS y ServiceNow y escribirlos en la propiedad mapping donde id es el identificador del valor de la lista en ASMS y value en identificador del valor en la lista de ServiceNow.
{
"model": [
{
"state": [
],
"id": 0,
"additionalFields": [
{
"type": "Data",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "Data",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "Choice",
"id": 288,
"field": {
"key": "u_glide_list"
},
"mapping": [
{
"id": 16,
"value": "Bogota"
},
{
"id": 17,
"value": "Bucaramanga"
},
{
"id": 18,
"value": "Santa marta"
}
]
},
{
"type": "Reference",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
16. 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”.
{
"model": [
{
"state": [
],
"id": 0,
"additionalFields": [
{
"type": "Data",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "Data",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "Choice",
"id": 288,
"field": {
"key": "u_glide_list"
},
"mapping": [
{
"id": 16,
"value": "Bogota"
},
{
"id": 17,
"value": "Bucaramanga"
},
{
"id": 18,
"value": "Santa marta"
}
]
},
{
"type": "Reference",
"id": 298,
"field": {
"key": "u_reference_12",
"SearchBy": "u_name"
},
"mapping": [
{
"id": 846,
"value": "item de configuracion 1"
},
{
"id": 847,
"value": "item de configuracion 2"
},
{
"id": 848,
"value": "autobus de produccion"
}
]
}
]
}
]
}