Relación de estados y campos adicionales con las propiedades de los Issue de Jira Server
La relación de los estados entre las plataformas y los campos adicionales se representa con el siguiente JSON:
{
"model": [
{
"reference": "",
"id": 0,
"state": [
{
"value": "",
"id": 0,
"reason": 0,
"commentary": {
"Key": "",
"value": ""
}
}
],
"additionalFields": [
{
"id": 0,
"field": {
"key": ""
},
"value": [
""
],
"mapping": [
{
"id": 0,
"value": ""
}
]
}
]
}
]
}
Donde:
Propiedades
| Propiedades | Descripción | |
|---|---|---|
| id | Identificador del modelo en ASMS | |
| reference | Identificador único para crear una relación entre los conceptos project > category, itemType, typeRegister, applicant, responsibleGroup, responsible, company, client | ver |
| state | Relación de los valores del estado de ASMS y Jira Server | Ver |
| additionalFields | Relación de los campos adicionales entre ASMS y los campos de Jira Server | Ver |
Relación de los estados
Para relacionar los estados la integración proporciona el siguiente esquema json:
{
"value": "",
"id": 0,
"reason": 0,
"commentary": {
"value": "",
"Key": ""
}
}
Donde:
| Propiedad | Descripción |
|---|---|
| value | Identificador del estado en Jira Server Estados Jira Server |
| id | Identificador del estado en ASMS |
| reason | Identificador de la razón del cambio de estado en ASMS |
| commentary | Relaciona el campo solución del ticket en ASMS con un campo equivalente en Jira Server; donde “key” es el identificador del campo en Jira Server; si la propiedad “key” es null puede asignar un valor por defecto mediante “value”. |
EJEMPLO: Relación de estados ASMS / Jira Server
Para crear la relación de los estados siga las siguientes instrucciones:
- Obtenga los IDs de los estados de ASMS.
- Obtenga los Ids de los estados de Jira Server.
- Asigne la siguiente equivalencia de estados:
- La propiedad commentary (Representa la “Solución del caso” en ASMS), la relacionamos con un campo equivalente en Jira Server para el ejemplo usaremos el nombre close_case.
| Estado en Jira Server | Estado en Aranda | Id State Aranda | Value state Jira Server |
|---|---|---|---|
| New | NUEVO | 1 | value_new |
| Closed | CERRADO | 13 | value_closed |
- Escriba el Id State Aranda en la propiedad “id” y el Value state Jira Server de su equivalente tomado de Jira Server en la propiedad value:
[
{
"id": 1,
"value": "value_new",
"commentary": {
"Key": "close_case"
}
},
{
"id": 13,
"value": "value_closed",
"commentary": {
"Key": "close_case"
}
}
]
Relación entre los campos adicionales y los campos de las clases de Jira Server
La relación entre los campos adicionales y los campos equivalentes de Jira Server se realizan mediante la siguiente estructura JSON:
Propiedades internas additionalFields
{
"id": 0,
"field": {
"key": "",
},
"value":[
""
],
"mapping": [
{
"id": 0,
"value": ""
}
]
}
Donde:
| Propiedades | Descripción | |
|---|---|---|
| id | Identificador del campo adicional en ASMS | |
| value | Permite agregar valores a los campos adicionales como valores constantes | |
| field | Información del campo en Jira Server | ver |
| mapping | Relación de valores para los campos de ASMS y Jira Server, donde “id” es el identificador en ASMS y “value” el identificador en Jira Server |
Listado de los tipos de campo adicionales soportados
Listado de relación entre los tipos de campos de las plataformas:
| ASMS | Identificador del campo en Jira Server | Nombre/Etiqueta del campo en Jira Server |
|---|---|---|
| Short Text | com.atlassian.jira.plugin.system.customfieldtypes:textfield | Texto breve |
| Paragraph | com.atlassian.jira.plugin.system.customfieldtypes:textarea | Párrafo |
| Date | com.atlassian.jira.plugin.system.customfieldtypes:datepicker | Fecha |
| Date and Time | com.atlassian.jira.plugin.system.customfieldtypes:datetime | Marca de tiempo |
| Numeric | com.atlassian.jira.plugin.system.customfieldtypes:float | Número |
| Decimal | com.atlassian.jira.plugin.system.customfieldtypes:float | Número |
| List | com.atlassian.jira.plugin.system.customfieldtypes:select | Menú desplegable |
| Link | com.atlassian.jira.plugin.system.customfieldtypes:url | URL |
| Catalog (List) | com.atlassian.jira.plugin.system.customfieldtypes:select | Menú desplegable |
⚐ Nota: Asociar 2 campos diferentes a los relacionados en la anterior tabla genera un error en tiempo de ejecución