Continuando con la configuración del archivo se debe registrar una relación entre los campos de la tarea de ASMS con los campos de la sub-tarea de Jira Cloud.
La relación entre los campos de las tareas de ASMS y Jira Cloud se presenta mediante el siguiente JSON (Archivo de configuración):
{
"task": [
{
"reference": "",
"definition": {
"idByProject": {
"type": "",
"key": ""
},
"subject": {
"type": "",
"key": ""
},
"description": {
"type": "",
"key": ""
},
"responsible": {
"type": "",
"key": "",
"SearchBy": [""]
},
"responsibleGroup": {
"key": "",
"type": "",
"defaultValue": {
"id": 0,
"value": ""
}
},
"duration": {
"type": "",
"key": ""
},
"enddate": {
"type": "",
"key": ""
},
"startdate": {
"type": "",
"key": ""
}
},
"model": {
"id": 0,
"additionalFields": [
{
"id": 0,
"type": "",
"field": {
"key": ""
},
"mapping": [
{
"id": 0,
"value": ""
},
{
"id": 0,
"value": ""
},
{
"id": 0,
"value": ""
}
]
}
],
"state": [
{
"id": 0,
"value": "",
"reason": 0,
"commentary": {
"key": "",
"value": ""
}
}
]
}
}
]
}
1. En la propiedad “reference” del archivo de configuración escriba el “key” que registró en la sección anterior; no se admite duplicados de esta propiedad:
{
"task": [
{
"reference": "project 1",
"definition": {
"subject": {
},
"description": {
},
"idByProject": {
},
"responsibleGroup": {
},
"responsible": {
},
"duration": {
},
"enddate": {
},
"startdate": {
}
}
}
]
}
2. Obtenga el nombre de las propiedades de Jira Cloud que relacionará con las propiedades de ASMS, consulte Propiedades Jira Cloud:
| Propiedad en Jira Cloud | Id de la propiedad de Jira |
|---|---|
| Titulo | summary |
| Description | description |
| idByProject | customfield_10293 |
| Responsable | assignee |
| Responsible Group | customfield_10041 |
| duration | customfield_10294 |
| enddate | customfield_10295 |
| startdate | customfield_10296 |
3. Cree una relación entre las propiedades de ASMS y Jira Cloud:
| Propiedad en ASMS | Propiedad en Jira Cloud |
|---|---|
| subject | summary |
| description | description |
| state | state * |
| responsible | assignee |
| responsibleGroup | customfield_10041 |
| duration | customfield_10294 |
| finaldate | customfield_10295 |
| initialdate | customfield_10296 |
| idByProject | customfield_10293 |
⚐ Nota: Los campos asignados con asterisco ( * ) se asignan de forma interna y no se pueden modificar.
4. Asigne el tipo de mapeo que realizarán las propiedades :
| Nombre | Descripción |
|---|---|
| Value | Permite asignar un valor al campo seleccionado a través del archivo de configuración. Se requiere que el valor se encuentre dentro de las propiedades de relación de valores |
| Mapper | Busca asociar y/o relacionar los valores de la tarea de Aranda con los valores del campo asociado de Jira Cloud, la relación de valores se hace 1 a 1, no se admite que la asignación se repita |
| FieldValue | Los valores de las propiedades se envían directamente entre plataformas sin ningún tipo de asociación/relación |
Relación de campos
| Propiedad en ASMS | Propiedad en Jira Cloud | Tipo de Mapeo |
|---|---|---|
| subject | summary | FieldValue |
| description | description | FieldValue |
| state | state * | - |
| responsible | assignee | Mapper |
| responsibleGroup | customfield_10041 | Mapper |
| duration | customfield_10294 | FieldValue |
| finaldate | customfield_10295 | FieldValue |
| initialdate | customfield_10296 | FieldValue |
| idByProject | customfield_10293 | FieldValue |
⚐ Nota: Las propiedades sin ningún tipo de mapeo se tratarán en otra sección.
5. Para esta configuración se establecen valores por defecto para la propiedad “responsible”, este valor se agregará si no se encuentra el “Responsable” de Jira hacia Asms o de Asms hacia Jira.
6. Consulte el Id del Responsable en Asms que asignará por defecto.
7. Consulte el Id del Responsable en Jira que asignará por defecto Usuarios Jira Cloud.
8. En la propiedad interna “defaultValue” de “responsible”, agregue el id del Responsable consultado en el punto 8 en la propiedad **“id” de defaultValue, para el ejemplo se usará 3.
9. En la propiedad interna “defaultValue” de “responsible”, agregue el id del Responsable consultado en el punto 9 en la propiedad “value” de defaultValue, para el ejemplo se usará user373.
10. Escriba en el archivo de configuración la relación definida en los pasos anteriores:
{
"defaultValue": {
"id": 3,
"value": "user373"
}
}
11. Escriba en el archivo de configuración la relación creada para los valores por defecto de la propiedad “responsible”:
{
"responsible": {
"type": "Mapper",
"key": "assignee",
"defaultValue": {
"id": 3,
"value": "user373"
}
}
}
12. Replicar los pasos para cada definición y en función a las necesidades del cliente
{
"task": [
"reference": "project 1",
"definition": {
"idByProject": {
"type": "FieldValue",
"key": "customfield_10293"
},
"subject": {
"type": "FieldValue",
"key": "summary"
},
"description": {
"type": "FieldValue",
"key": "description"
},
"responsible": {
"type": "FieldValue",
"key": "assignee",
"SearchBy":["Email"],
"defaultValue": {
"id": 3,
"value": "user373"
}
},
"responsibleGroup": {
"key": "customfield_10041",
"type": "Mapper"
},
"duration": {
"type": "FieldValue",
"key": "customfield_10294"
},
"enddate": {
"type": "FieldValue",
"key": "customfield_10295"
},
"startdate": {
"type": "FieldValue",
"key": "customfield_10296"
}
}
]
}
Continuar: Registrar la propiedad “Mapping” (paso 4) ↪