Relación de tareas de asms y sub-tareas en jira Server

La siguiente información es relevante para la creación de las tareas entre las plataformas.

• Las tareas a relacionar entre plataformas deben tener padres relacionados previamente entre asms y Jira Server.
• El reference utilizado para la task debe coincidir con un padre en especifico, como sucede en las plataformas. Si en asms mis casos para Incidentes tienen tareas del modelo A, el archivo de configuración debe mantener dicha relación para un correcto funcionamiento. Si se intenta relacionar con un modelo B, NO funcionará la relación de las tareas.
• Las tareas se relacionan por medio de sus propios endpoint ASMS y jira Server

{
  "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": ""
            }
          }
        ]
      }
    }
  ]
}

Donde:

Propiedades

reference: Se crea una relación entre la configuración de los casos y las tareas de asms por medio de la propiedad reference

Definition

Notas y recomendaciones

idByProject

{
   "idByProject": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Para esta definición solo se soporta el tipo FieldValue, en la propiedad key se ingresa el id del campo tipo texto en Jira y se usa para agregar el idByProject de la tarea de ASMS, así podrá identificar la tarea a la que está relacionada desde la interfaz de Jira.

Subject

{
   "Subject": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Se recomienda usar la propiedad summary de las sub-tareas en Jira Server.

Description

{
   "Description": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Se recomienda usar la propiedad description de las sub-tareas en Jira Server.

duration

{
   "duration": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Campo para especificar la duración de la tarea en asms, este valor es representado en minutos en las sub-tareas en Jira Server, por ende se recomienda usar un campo numérico o de texto corto.

enddate

{
   "enddate": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Campo NO editable y auto calculado para mostrar la fecha de finalización de la tarea en asms, este valor solo se asigna desde asms hacia las sub-tareas en Jira Server, se recomienda usar un campo de tipo fecha.

startdate

{
   "startdate": {
                  "type": "FieldValue",
                  "key": ""
               }
}

Campo con la fecha de inicio de la tarea en asms, se recomienda usar un campo tipo fecha.

Propiedades internas

{
  "key": "",
  "type": "",
  "searchBy": [ "Email" ],
  "defaultValue": {
    "id": 0,
    "value": ""
  }
}

Donde:

Propiedad defaultValue

1. La propiedad defaultValue permite agregar valores por defecto, si agrega esta propiedad con el valor de defaultValue.id para la tarea en Aranda o defaultValue.value para la sub-tarea en Jira Server, el sistema agrega el valor por defecto a la plataforma que estableció el valor.

2. Para los campos “subject, description”, no se puede agregar un valor por defecto porque son valores escritos por el usuario y no se admite una relación de valores.

3. Sólo podrá agregar un valor por defecto si el tipo de mapeo es “Mapper” o “FieldValue”.

Ejemplo:

1. Asigne el valor “incident” en la propiedad reference.
2. En la definición de task tome la propiedad Responsable (responsible).
3. “type”: Asigne el tipo de asociación como FieldValue.
4. “key”: Asigne el nombre de la propiedad en Jira Server como assigned_to (Propiedades en Jira Server).
5. “defaultValue”: Asigne la propiedad defaultValue.

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "key": "assigned_to",
          "type": "FieldValue",
          "defaultValue": {
            "id": 222,
            "value": "id_usuario_jira_Server"
          }
        }
      }
    }
  ]
}

Propiedad de búsqueda

La propiedad searchBy es OPCIONAL, solo es válida para el type “FieldValue” y para el campos responsible.

Esta etiqueta permite definir la propiedad por la cual se realizará la búsqueda de usuarios en las plataformas ASMS y Jira Server; la propiedad admitida es “Email” y por defecto buscará por la propiedad “name” si no se agrega la etiqueta “searchBy”.

Caso de uso

Para el uso adecuado de la propiedad de búsqueda “Email”, los usuarios de las dos plataformas deben tener el mismo correo por usuario. A continuación se describe un ejemplo de la propiedad responsible con la opción de búsqueda por “Email”.

{
  "responsible": {
      "type": "FieldValue",
      "key": "assigned_to",
      "searchBy": [ "Email" ]
      }
}

Tipos de relación o asociación de campos

Los siguientes tipos de asociación determinan como se obtendrán los valores de las propiedades del ticket.

Ejemplo tipo Value

1. Asigne el valor “incident” en la propiedad reference.

2. En la definición de task tome la propiedad Responsable (responsible) y asigne el tipo de asociación como Value.

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ]
}

3. La relación implica que debe asignarse un valor de forma común para todas las task, esto se logra mediante la propiedad “responsible”, como se muestra a continuación:

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "",
      "id": 10
    }
  ]
}

4. Asigne un valor a la propiedad “responsible.reference”:

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "Value"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "incident",
      "id": 10
    }
  ]
}

⚐ Nota: Las tareas asociados al “reference” “incident”, en ASMS se les asignará el responsible con Id 10.

Ejemplo tipo Mapper

1. Asigne el valor “incident” en la propiedad reference. 2. En la definición de task tome la propiedad Responsable (responsible). 3. “type”: Asigne el tipo de asociación como Mapper. 4. “key”: Asigne el nombre de la propiedad en Jira Server como applicant_id_jira_Server (Propiedades en Jira Server).

{
  "task": [
    {
      "reference": "incident",
      "definition": {

        "responsible": {
          "type": "Mapper",
          "key": "applicant_id_jira_Server"
        }
      }
    }
  ]
}

5. La relación implica que debe asociarse los responsables de la mesa de Aranda (ASMS) con los responsables de Jira Server, se recomienda escribir el id del responsable a relacionar, como se muestra a continuación:

Nota: tenga en cuenta que se van a reutilizar los mismos mapper tanto para casos y tareas.

{
  "task": [
    {
      "reference": "incident",
      "definition": {

        "responsible": {
          "type": "Mapper"
        }
      }
    }
  ],
  "responsible": [
    {
      "reference": "incident",
      "mapping": [
        {
          "id": 5,
          "value": "id_solicitante_jira"
        }
      ]
    }
  ]
}

⚐ Nota: Se relaciona el responsable con Id “5” de la mesa de Aranda (ASMS) con el responsable “id_solicitante_jira” en Jira Server***

Ejemplo tipo FieldValue

1. Asigne el valor “incident” en la propiedad responsible.
2. En la definición de la task tome la propiedad responsible (responsible).
3. “type”: Asigne el tipo de asociación como FieldValue.
4. “key”: Asigne el nombre de la propiedad en Jira Server como applicant_id_jira_Server (Propiedades en Jira Server).

{
  "task": [
    {
      "reference": "incident",
      "definition": {
        "responsible": {
          "type": "FieldValue",
          "key": "applicant_id_jira_Server"
        }
      }
    }
  ]
}

Configurar modelo del task