La propiedad “model” relaciona los Estados y los Campos Adicionales de ASMS, el archivo de configuración tiene el siguiente JSON para model:
{
"model": [
{
"id": 0,
"reference": "",
"state": [
{
"value": "",
"id": 0,
"commentary": {
"Key": "",
"value":""
}
}
],
"additionalFields": [
{
"id": 0,
"field": {
"key": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
]
}
]
}
1. Con ayuda de un administrador de Aranda Service Management (ASMS) obtenga el ID del modelo usando los Ids del Proyecto, Servicio y Categoría obtenidos en la sección anterior, este valor se registrara en la propiedad model.id del archivo de configuración.
Escoja el modelo que usará para la integración, con ayuda de un administrador de Aranda Service Management (ASMS) obtenga el ID del modelo asociado al proyecto, servicio y categoría, asignados anteriormente.
2. Escriba los valores en la propiedad “model.id” del archivo de configuración:
{
"model": [
{
"id": 15,
"state": [
],
"additionalFields": [
]
}
]
}
Nota: No es necesario registrar la propiedad “reference” de “model” porque se registró una sola categoría.
Estados del caso
3. Con ayuda de un administrador de Aranda Service Management (ASMS) obtenga los IDs de los Estados del caso.
4. La propiedad Estado de ASMS se relaciona con la propiedad Status de Jira Cloud, esta relación no se puede modificar y/o relacionar con otra propiedad del Issue de Jira.
5. Obtenga los valores para la propiedad Status de Jira Cloud, como se enseña en la sección “Registrar model”, encontrará un ejemplo de como consultar dichos estados.
6. Establezca una equivalencia entre los valores para los Estados de la siguiente forma:
Status JiraCloud Tipo de registro ASMS ID Tipo de registro ASMS VALUE Status JiraCloud
New New 187 1
In Progress In Progress 188 2
On Hold On Hold 189 3
Resolved Resolved 190 5
Closed Closed 191 6
7. 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": [
]
}
]
}
Solución
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 Jira CLoud, mediante la siguiente propiedad:
"commentary": {
"key": "",
"value":""
}
Donde:
“key”: nombre de la propiedad Jira Cloud donde se obtendrá la solución. “value”: valor estático que se asignara a la solución de ASMS.
9. Asigne un campo de Jira Cloud 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 Jira Cloud.
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": [
]
}
]
}
Campos adicionales
11. En ASMS y Jira Cloud 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 Jira Cloud campo en ASMS Id campo Jira Cloud 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: FIELDVALUE, VALUE o MAPPING y escriba la información en el archivo json.
La propiedad value sólo es requerida cuando se desean valores constantes.
{
"model": [
{
"id": 15,
"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"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "u_glide_list"
}
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
14. Para completar la configuración en los tipos MAPPING hay que agregar la propiedad mapping.
15. Para completar la configuración del tipo MAPPING listar los id de los valores en ASMS y Jira Cloud 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 Jira Cloud.
Ejemplo para relación de valores de los Mapping, con ayuda de un administrador de ASMS identifique los IDs de cada value del campo adicional en ASMS y los IDs de cada value del campo adicional en Jira Cloud:
campo en Jira Cloud campo en ASMS Id value Jira Cloud Id value ASMS
Paises Paises 10100 35
Paises Paises 10101 34
{
"model": [
{
"id": 15,
"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"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "u_glide_list"
},
"mapping": [
{
"id": 35,
"value": "10100"
},
{
"id": 34,
"value": "10101"
}
]
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
Continuar: Registrar la propiedad “Urgency” (paso 5)