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***