ES
Español
English
Português
    Model en Task

    Relación de estados y campos adicionales con las propiedades de las sub-tareas 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 de la tareas en ASMS  
    reference Identificador único para crear una relación entre las tareas por modelo  
    state Relación de los valores del estado de la tarea en ASMS y la sub-tarea en Jira Server Ver
    additionalFields Relación de los campos adicionales entre la tarea en ASMS y los campos de la sub-tarea en 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 de la tarea 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 tenga en cuenta las siguientes instrucciones:

    1. Obtenga los IDs de los estados de la tarea en ASMS.
    2. Obtenga los Ids de los estados de la sub-tarea en Jira Server.
    3. Asigne la siguiente equivalencia de estados:
    4. La propiedad commentary (Representa la “Solución de la tarea” en ASMS), la relacionamos con un campo equivalente en Jira Server para el ejemplo usaremos el nombre close_task.
    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_task"
          }
      },
      {
          "id": 13,
          "value": "value_closed",
          "commentary": {
          "Key": "close_task"
          }
      }
    ]
    

    Relación entre los campos adicionales y los campos de las subtareas 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,
      "type": "FIELDVALUE/MAPPING/VALUE",
      "field": {
        "key": ""
      },
      "value": [
        ""
      ],
      "mapping": [
        {
          "id": 0,
          "value": ""
        }
      ]
    }
    

    Donde:

    Propiedades Descripción  
    id Identificador del campo adicional en ASMS  
    type Se puede elegir entre (FIELDVALUE/MAPPING/VALUE) para especificar el comportamiento de la integración entre cada campo adicional ver
    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  

    type

    Propiedades Descripción
    FIELDVALUE Relación directa entre campos de las herramientas, teniendo en cuenta el listado de campos adicionales soportados
    MAPPING Relación por medio de mapeo de valores
    VALUE Agregar un valor constante a los campos

    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 (solo texto sin formato)
    Paragraph com.atlassian.jira.plugin.system.customfieldtypes:textarea Párrafo (admite texto enriquecido)
    Date com.atlassian.jira.plugin.system.customfieldtypes:datepicker Selector de fecha
    Date and Time com.atlassian.jira.plugin.system.customfieldtypes:datetime Selector de fecha y hora
    Numeric com.atlassian.jira.plugin.system.customfieldtypes:float Campo numérico
    Decimal com.atlassian.jira.plugin.system.customfieldtypes:float Campo numérico
    List com.atlassian.jira.plugin.system.customfieldtypes:select Lista de selección (opción individual)
    Link com.atlassian.jira.plugin.system.customfieldtypes:url Campo URL
    Catalog (List) com.atlassian.jira.plugin.system.customfieldtypes:select Lista de selección (opción individual)
    Catalog (List) com.atlassian.jira.plugin.system.customfieldtypes:cascadingselect Lista de selección (Cascada)

    Notas: Asociar 2 campos diferentes a los relacionados en la anterior tabla genera un error en tiempo de ejecución

    • Para el campo tipo lista de selección (cascada) solo se soporta un nivel como lo permite actualmente Jira, es decir padre e hijo
    • Actualmente el tipo de relación permitida para estos campos es de tipo FieldValue


    ↩ Volver a Configuración de task