Lista de tarefas e subtarefas ASMS no Jira Server

As informações a seguir são relevantes para a criação de tarefas entre plataformas.

• As tarefas a serem relacionadas entre plataformas devem ter pais previamente relacionados entre asms e Jira Server.
• A referência usada para a tarefa deve corresponder a um pai específico, como ocorre nas plataformas. Se em ASMS meus casos para Incidentes tiverem tarefas do modelo A, o arquivo de configuração deve manter essa relação para operação adequada. Se você tentar se relacionar com um modelo B, a relação entre as tarefas NÃO vai funcionar.
• As tarefas estão relacionadas por meio de seus próprios endpoints ASMS e Servidor jira

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

Onde:

Propriedades

Referência: Uma relação é criada entre a configuração dos casos e as tarefas ASM usando a propriedade de referência

Definição

Notas e recomendações

idByProject

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

Para essa definição, somente o tipo Valor do campo, na propriedade Chave O ID do campo de texto é inserido no Jira e usado para adicionar o idByProject da tarefa ASMS, para que você possa identificar a tarefa à qual ela está relacionada pela interface do Jira.

Assunto

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

Recomenda-se usar o Resumo de subtarefas no Servidor Jira.

Descrição

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

Recomenda-se usar o Descrição de subtarefas no Servidor Jira.

Duração

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

Para especificar a duração da tarefa em asms, esse valor é representado em minutos nas subtarefas do Jira Server, portanto, recomenda-se usar um campo numérico ou de texto curto.

Acabar

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

Campo NÃO editável e autocalculado para mostrar a data de término da tarefa em ASMS, esse valor é atribuído apenas dos asms às subtarefas no Jira Server, recomenda-se usar um campo de data do tipo.

data de início

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

Campo com a data de início da tarefa em ASMs, recomenda-se usar um tipo de campo data.

Propriedades internas

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

Onde:

propriedade defaultValue

1. A propriedade defaultValue permite adicionar valores padrão, se você adicionar essa propriedade com o valor de defaultValue.id para a tarefa em Aranda ou valorPadrão.valor para a subtarefa no Jira Server, o sistema adiciona o valor padrão à plataforma que definiu o valor.
2. Para os campos “assunto, descrição”, você não pode adicionar um valor padrão porque eles são valores gravados pelo usuário e não há suporte para uma relação de valor.
3. Você só poderá adicionar um valor padrão se o tipo de mapeamento for “Mapeador” ou “ValorDoCampo”.

Exemplo:

1. Defina o valor “incidente” como o Referência.
2. Na definição de Tarefa Assuma a propriedade responsável (responsável).
3. “type”: Atribua o tipo de associação como Valor do campo.
4. “key”: nomeie a propriedade no Jira Server como assigned_to (Propriedades no Jira Server).
5. “defaultValue”: atribua o defaultValue.

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

Pesquisar Propriedade

A propriedade searchBy é OPCIONAL, é válido apenas para o tipo “FieldValue” e para os campos responsáveis.

Essa tag permite definir a propriedade pela qual a pesquisa do usuário será realizada nas plataformas ASMS e Jira Server; a propriedade suportada é “Email” e, por padrão, pesquisará a propriedade “name” se a tag “searchBy” não for adicionada.

Caso de uso

Para o uso adequado da propriedade de pesquisa “E-mail”, os usuários das duas plataformas devem ter o mesmo e-mail por usuário. Veja a seguir um exemplo da propriedade responsável com a opção de pesquisa “E-mail”.

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

Tipos de relacionamento ou associação de campos

Os tipos de associação a seguir determinam como os valores das propriedades do ticket serão obtidos.

Exemplo de tipo Valor

1. Defina o valor “incidente” como o Referência.

2. Na definição de Tarefa Assuma a propriedade responsável (responsável) e atribua o tipo de associação como Valor.

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

3. A relação implica que um valor deve ser atribuído de forma comum para todos os Tarefa, isso é alcançado usando a propriedade “responsável”, conforme mostrado abaixo:

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

4. Atribuir um valor à propriedade “responsável.reference”:

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

⚐ Nota: O Tarefas associado ao “incidente” de referência, no ASMS eles receberão o responsável com ID 10.

Exemplo de tipo Mapeador

1. Defina o valor “incidente” como o Referência. 2. Na definição de Tarefa Assuma a propriedade responsável (responsável). 3. “type”: Atribua o tipo de associação como Mapeador. 4. “key”: nomeie a propriedade no Jira Server como applicant_id_jira_Server (Propriedades no Jira Server).

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

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

5. A relação implica que você deve associar os gerenciadores de mesa Aranda (ASMS) aos gerentes do servidor Jira, recomenda-se escrever o Id da parte responsável a ser listada, conforme mostrado abaixo:

Nota: Note que os mesmos mapeadores serão reutilizados tanto para casos quanto para tarefas.

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

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

⚐ Nota: O gerente com Id “5” da tabela Aranda (ASMS) está relacionado ao gerente “id_solicitante_jira” no Servidor Jira***

Exemplo de tipo Valor do campo

1. Defina o valor “incidente” como o responsável.
2. Na definição do Tarefa Assuma Propriedade Responsável (responsável).
3. “type”: Atribua o tipo de associação como Valor do campo.
4. “key”: nomeie a propriedade no Jira Server como applicant_id_jira_Server (Propriedades no Jira Server).

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

Configurar Modelo de Tarefa