La propiedad “case” es una lista que permite relacionar los campos de ASMS con los campos de ServiceNow:
Ejemplo de un caso en ASMS
Ejemplo de un caso en ServiceNow
Los campos de casos en ASMS y ServiceNow se presenta mediante el siguiente JSON (Archivo de configuración):
{
"case": [
{
"table": "",
"externalIdField": "",
"definition": {
"itemType": "",
"typeRegister": {
"type": "",
"searchBy": "",
"key": ""
},
"service": {
"type": "",
"searchBy": "",
"key": ""
},
"project": {
"type": "",
"searchBy": "",
"key": ""
},
"category": {
"type": "",
"searchBy": "",
"key": ""
},
"applicant": {
"type": "",
"searchBy": "",
"key": ""
},
"responsibleGroup": {
"type": "",
"searchBy": "",
"key": ""
},
"responsible": {
"type": "",
"searchBy": "",
"key": ""
}
}
}
],
"urgency": [
],
"impact": [
],
"model": [
],
"typeRegister": [
],
"service": [
],
"project": [
],
"category": [
],
"applicant": [
],
"responsibleGroup": [
],
"responsible": [
]
}
1. Cree una relación entre las tablas de ServiceNow (incident, problem, change_request) con los tipos de casos en ASMS:
| Tipos de casos en ASMS |
|---|
| Incidents, |
| Problem, |
| Change, |
| ServiceCall, |
| Release, |
| Table ServiceNow | Tipo de Caso ASMS |
|---|---|
| incident | Incidents |
| problem | Problem |
| change_request | Change |
2. En la propiedad “table” del archivo de configuración escriba el nombre de la tabla incident:
{
"case": [
{
"table": "incident",
"externalIdField": "",
"definition": {
"itemType": "",
"typeRegister": {
},
"service": {
},
"project": {
},
"category": {
},
"applicant": {
},
"responsibleGroup": {
},
"responsible": {
}
}
}
]
}
3. En la propiedad “definition.itemType” del archivo de configuración escriba el nombre del tipo de caso Incidents:
{
"case": [
{
"table": "incident",
"externalIdField": "",
"definition": {
"itemType": "Incidents",
"typeRegister": {
},
"service": {
},
"project": {
},
"category": {
},
"applicant": {
},
"responsibleGroup": {
},
"responsible": {
}
}
}
]
}
4. Obtenga el nombre de las propiedades de ServiceNow que relacionará con las propiedades de ASMS, dando clic derecho sobre el nombre del campo y seleccionando la opción show:
Propiedad en ServiceNow
| Label | Name |
|---|---|
| InquilinoChoice | u_inquilinochoice |
| external id field | u_external_id_field |
| Category | category |
| Short description | short_description |
| Description | description |
| Channel | contact_type |
| State | state |
| Impact | impact |
| Urgency | urgency |
| Assignment group | assignment_group |
| Assigned to | assigned_to |
5. Cree una relación 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 |
⚐ Nota: Los campos asignados con asterisco ( * ) se asignan de forma interna y no se pueden modificar.
6. Asigne el tipo de mapeo 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 |
| Value: | Toma el valor del archivo de configuración para el campo seleccionado |
| Mapper: | Asigne este valor de mapeo si necesita comparar o relacionar valores de ASMS y ServiceNow |
| Propiedad en ASMS | Propiedad en ServiceNow | Tipo de Mapeo |
|---|---|---|
| project | u_inquilinochoice | Mapper |
| category | category | Mapper |
| typeRegister | contact_type | Mapper |
| state | state | – |
| impact | impact | – |
| urgency | urgency | – |
| responsibleGroup | assignment_group | FieldValue |
| responsible | assigned_to | FieldValue |
| service | N/A | Value |
⚐ Nota: Las propiedades sin ningún tipo de mapeo se tratarán en otra sección.
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 ASMS | Propiedad en ServiceNow | Tipo de Mapeo | Campo de búsqueda |
|---|---|---|---|
| project | u_inquilinochoice | Mapper | – |
| category | category | Mapper | – |
| typeRegister | contact_type | Mapper | – |
| state | state | – | – |
| impact | impact | – | – |
| urgency | urgency | – | – |
| responsibleGroup | assignment_group | FieldValue | name |
| responsible | assigned_to | FieldValue | name |
| service | N/A | Value | – |
8. Escriba en el archivo de configuración la relación realizada en los pasos anteriores:
{
"case": [
{
"table": "incident",
"externalIdField": "",
"definition": {
"itemType": "Incidents",
"service": {
"type": "Value"
},
"typeRegister": {
"type": "Mapper",
"key": "contact_type"
},
"project": {
"type": "Mapper",
"key": "u_inquilinochoice"
},
"category": {
"type": "Mapper",
"key": "category"
},
"responsibleGroup": {
"type": "FieldValue",
"searchBy": "name",
"key": "assignment_group"
},
"responsible": {
"type": "FieldValue",
"searchBy": "name",
"key": "assigned_to"
}
}
}
]
}
9. La propiedad “externalIdField” está relacionada directamente con la propiedad “idByProject”, para el ejemplo esta propiedad tomará el valor del campo “external id field”: [u_external_id_field].
10. Escriba en el archivo de configuración el nombre del campo con el que relacionará la propiedad “idByProject”:
{
"case": [
{
"table": "incident",
"externalIdField": "u_external_id_field",
"definition": {
"itemType": "Incidents",
"service": {
"type": "Value"
},
"typeRegister": {
"type": "Mapper",
"key": "contact_type"
},
"project": {
"type": "Mapper",
"key": "u_inquilinochoice"
},
"category": {
"type": "Mapper",
"key": "category"
},
"responsibleGroup": {
"type": "FieldValue",
"searchBy": "name",
"key": "assignment_group"
},
"responsible": {
"type": "FieldValue",
"searchBy": "name",
"key": "assigned_to"
}
}
}
]
}
Continuar: Registrar las propiedades Mapping (paso 4) ↪