La propiedad “workOrder” es una lista que permite relacionar los campos de AFLS con los campos de ServiceNow:
La relación de los campos de la orden de trabajo en AFLS y ServiceNow se presenta mediante el siguiente JSON (Archivo de configuración):
{
"workOrder": [
{
"table": "",
"reference": "",
"dataSource": "",
"definition": {
"note": {
"type": "",
"key": ""
},
"subject": {
"type": "",
"key": ""
},
"description": {
"type": "",
"key": ""
},
"service": {
"type": "",
"searchBy": "",
"key": "",
"defaultValue": {
"id": 0,
"value": ""
},
"onError": [
{
"action": "",
"message": "'{0}'"
}
]
},
"priority": {
"type": "",
"defaultValue": {
"id": 0,
"value": ""
},
"onError": [
{
"action": "",
"message": ""
}
],
"key": ""
},
"client": {
"type": "",
"searchBy": "",
"searchAfls": "Email,Name",
"defaultValue": {
"id": 0,
"value": ""
},
"onError": [
{
"action": "",
"message": ""
}
],
"key": ""
},
"company": {
"type": "",
"searchBy": "",
"defaultValue": {
"id": 0,
"value": ""
},
"onError": [
{
"action": "",
"message": ""
}
],
"key": ""
},
"location": {
"type": "",
"key": ""
}
}
}
],
"model": [ ],
"client": [ ],
"company": [ ],
"priority": [ ],
"service": [ ]
}
En ServiceNow las ordenes se trabajan en la entidad wm_order, para el ejemplo tomaremos esta entidad.
1. En la propiedad “table” del archivo de configuración escriba el nombre de la tabla wm_order.
2. En la propiedad “reference” del archivo de configuración escriba un nombre único orden_1, se usara para relacionar las propiedades “workOrder” con “model” y “mappings”.
3. La propiedad “dataSource” le permite a la integración determinar que plataforma será la fuente de información, por defecto su valor es “Both”, deje el valor por defecto.
{
"workOrder": [
{
"table": "wm_order",
"reference": "orden_1",
"definition": {
"note": {
},
"subject": {
},
"description": {
},
"service": {
},
"priority": {
},
"client": {
},
"company": {
},
"location": {
}
}
}
]
}
4. Obtenga el nombre de las propiedades de ServiceNow que relacionará con las propiedades de AFLS, dando clic derecho sobre el nombre del campo y seleccionando la opción show:
Propiedad en ServiceNow
| Label | Name |
|---|---|
| Company | company |
| Short description | short_description |
| Description | description |
| State | state |
| Notes | work_notes |
| Priority | priority |
| Location | location |
| Contact | caller |
5. Cree una relación entre las propiedades de AFLS y ServiceNow:
| Propiedad en AFLS | Propiedad en ServiceNow |
|---|---|
| subject | short_description |
| description | description |
| service | N/A |
| priority | priority |
| client | caller |
| company | company |
| state | state |
| location | location |
| note | work_notes |
6. Asigne el tipo de mapping que realizaran las propiedades :
| FieldValue: | Toma el valor directamente de ServiceNow; si el campo en ServiceNow es de tipo Reference debe agregar el valor “searchBy” en el archivo de configuración, este campo corresponde al campo por el que se buscará el valor |
| NotMapped | Solo disponible para el campo service, permite agregar un valor por defecto cuando no relacionamos un servicio. |
| Mapper: | Asigne este valor de mapping si necesita comparar o relacionar valores de AFLS y ServiceNow |
| Propiedad en AFLS | Propiedad en ServiceNow | Tipo de mapping |
|---|---|---|
| subject | short_description | FieldValue |
| description | description | FieldValue |
| service | N/A | NotMapped |
| priority | priority | Mapper |
| client | caller | FieldValue |
| company | company | FieldValue |
| state | state | – |
| location | location | FieldValue |
| note | work_notes | FieldValue |
⚐ Nota: Las propiedades que no tienen un tipo de mapping se asignaran en secciones posteriores.
7. Las propiedades asignadas con el “mapping type” “FieldValue”, requieren la propiedad “searchBy” en el archivo de configuración, esta propiedad permite realizar la búsqueda en ServiceNow:
Asigne el nombre de búsqueda para las propiedades tipo FieldValue:
| Propiedad en AFLS | Propiedad en ServiceNow | Tipo de mapping | Campo de búsqueda |
|---|---|---|---|
| subject | short_description | FieldValue | – |
| description | description | FieldValue | – |
| service | N/A | NotMapped | – |
| priority | priority | Mapper | – |
| client | caller | FieldValue | |
| company | company | FieldValue | name |
| state | state | – | – |
| location | location | FieldValue | – |
| note | work_notes | FieldValue | – |
⚐ Nota: Las propiedades como el “note”, “subject” y “description” no requieren la propiedad “searchBy” porque no son campos de tipo Reference en ServiceNow, a diferencia de las propiedades “client” y “company” que si requieren la propiedad “searchBy” porque son campos de tipo Reference en ServiceNow.” La propiedad “location” no requiere la propiedad “searchBy” porque internamente se busca por la latitud y longitud en la tabla “cmn_location”.
8. Escriba en el archivo de configuración la relación realizada en los pasos anteriores:
{
"workOrder": [
{
"table": "wm_order",
"reference": "orden_1",
"definition": {
"note": {
"key": "work_notes",
"type": "FieldValue"
},
"subject": {
"type": "FieldValue",
"key": "short_description"
},
"description": {
"type": "FieldValue",
"key": "description"
},
"service": {
"type": "NotMapped",
"defaultValue": {
"id": 1
}
},
"priority": {
"type": "Mapper",
"key": "priority"
},
"client": {
"type": "FieldValue",
"searchBy": "email",
"searchAfls": "",
"key": "caller"
},
"company": {
"type": "FieldValue",
"searchBy": "name",
"key": "company"
},
"location": {
"type": "FieldValue",
"key": "location"
}
}
}
]
}
9. La propiedad “client” requiere la propiedad “searchAfls” esta propiedad determina si enviara el Nombre o Email del cliente a buscar en ServiceNow, escriba el valor “Email” en el archivo de configuración:
{
"workOrder": [
{
"table": "wm_order",
"reference": "orden_1",
"definition": {
"client": {
"type": "FieldValue",
"searchBy": "email",
"searchAfls": "Email",
"key": "caller"
}
}
}
]
}
⚐ Nota: Tenga en cuenta que en ServiceNow el campo caller es un campo de tipo referencia al módulo de usuarios, por lo que se debe utilizar la propiedad “searchBy” para especificar el campo por el cual se realizará la búsqueda, en este caso asignamos el campo “email”.
10. Escriba en el archivo de configuración el nombre del campo con el que relacionará la propiedad “idByProject”:
{
"workOrder": [
{
"table": "wm_order",
"reference": "orden_1",
"definition": {
"note": {
"key": "work_notes",
"type": "FieldValue"
},
"subject": {
"type": "FieldValue",
"key": "short_description"
},
"description": {
"type": "FieldValue",
"key": "description"
},
"service": {
"type": "NotMapped",
"defaultValue": {
"id": 1
}
},
"priority": {
"type": "Mapper",
"key": "priority"
},
"client": {
"type": "FieldValue",
"searchBy": "email",
"searchAfls": "Email",
"key": "caller"
},
"company": {
"type": "FieldValue",
"searchBy": "name",
"key": "company"
},
"location": {
"type": "FieldValue",
"key": "location"
}
}
}
]
}