Relación de estados y campos adicionales con las propiedades de los WorkItem de DevOps
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 DevOps | ver |
| additionalFields | Relación de los campos adicionales entre ASMS y los campos de DevOps | 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 DevOps Estados DevOps |
| 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 DevOps; donde “key” es el identificador del campo en DevOps; si la propiedad “key” es null puede asignar un valor por defecto mediante “value”. |
EJEMPLO: Relación de estados ASMS / DevOps
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 DevOps.
- Asigne la siguiente equivalencia de estados:
- La propiedad commentary (Representa la “Solución del caso” en ASMS), la relacionamos con un campo equivalente en DevOps para el ejemplo usaremos el nombre close_case.
| Estado en DevOps | Estado en Aranda | Id State Aranda | Value state DevOps |
|---|---|---|---|
| New | NUEVO | 1 | value_new |
| Closed | CERRADO | 13 | value_closed |
- Escriba el Id State Aranda en la propiedad “id” y el Value state DevOps de su equivalente tomado de DevOps 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 DevOps
La relación entre los campos adicionales y los campos equivalentes de DevOps 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 DevOps | ver |
| mapping | Relación de valores para los campos de ASMS y DevOps, donde “id” es el identificador en ASMS y “value” el identificador en DevOps |
Listado de los tipos de campo adicionales soportados
Listado de relación entre los tipos de campos de las plataformas:
| ASMS | Nombre/Etiqueta del campo en DevOps |
|---|---|
| Short Text | Text (single line) |
| Paragraph | Text (multiple lines) |
| Date | Date/TimeFecha |
| Date and Time | Date/Time |
| Numeric | Integer |
| Decimal | Decimal |
| List | Picklist (string) - Picklist (integer) |
| Link | Text (single line) |
| Catalog (List) | Picklist (string) - Picklist (integer) |
| True/false | Bolean |
| Url | Text (multiple lines) |
⚐ Nota: Asociar 2 campos diferentes a los relacionados en la anterior tabla genera un error en tiempo de ejecución***