Relacionamento entre o ASMS e o Jira Server

Para realizar a integração é necessário relacionar os campos do ticket Aranda ASMS com os campos do problema do Jira Server através da seção “case” do arquivo de configuração.

Estrutura JSON

{
  "case": [
    {
    "reference": "",
    "definition": {
      "subject": {
        "type": "",
        "key": ""
      },
      "description": {
        "type": "",
        "key": ""
      },
      "responsible": {
        "type": "",
        "key": "",
        "searchBy": [ "Email" ],
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      },
      "responsibleGroup": {
        "key": "",
        "type": "",
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      },
      "client": {
        "type": "",
        "key": "",
        "searchBy": [ "Email" ],
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      },
      "company": {
        "type": "",
        "key": "",
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      },
      "applicant": {
        "type": "",
        "key": "",
        "searchBy": [ "Email" ],
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      },
      "typeRegister": {
        "type": "",
        "key": "",
        "defaultValue": {
          "id": 0,
          "value": ""
          }
      },
      "ci": {
        "type": "",
        "key": "",
        "defaultValue": {
          "id": 0,
          "value": ""
        }
      }
      }
    }
  ]
}

Propriedades :

Definição

Para realizar a integração é necessário relacionar os campos de caso no Aranda ASMS com o Jira Server Issue através da seção “definição” do arquivo de configuração, essas propriedades no ASMS podem ser associadas a campos do tipo list ou string no Jira Server, excluindo a propriedade subject e description.

Propriedades:

Caso em ASMS: Ilustração de referência, informações do cliente de casos na plataforma ASMS

Caso en ASMS parte 2: Ilustración de referencia, información básica de los casos en la plataforma ASMS

Issue Jira Server: Ilustración de referencia, información básica de los tickets en la plataforma Jira Server

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 o caso em Aranda ou valorPadrão.valor para o problema 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 do caso 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:

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

Pesquisar Propriedade

A propriedade searchBy é OPCIONAL, só é válido para o tipo “ValorCampo” e para os campos responsável, solicitante e cliente.

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 do solicitante com a opção de pesquisar por “E-mail”.

{
  "applicant": {
      "type": "FieldValue",
      "key": "Custom.applicant",
      "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 do caso Pegue a propriedade Requerente (requerente) e atribua o tipo de associação como Valor.

{
    "case": [
        {
          "reference": "incident",
          "definition": {
            "applicant": {
              "type": "Value"
            }
          }
        }
  ]
}

1. A relação implica que um valor deve ser atribuído de maneira comum para todos os Casos, isso é feito usando a propriedade “applicant”, conforme mostrado abaixo:

{
    "case": [
        {
          "reference": "incident",
          "definition": {          
            "applicant": {
              "type": "Value"
            }
          }
        }
  ],
  "applicant": [
        {
            "reference": "",
            "id": 10
        }
  ]
}

1. Atribuir um valor à propriedade “applicant.reference”:

{
    "case": [
        {
          "reference": "incident",
          "definition": {          
            "applicant": {
              "type": "Value"
            }
          }
        }
  ],
  "applicant": [
        {
            "reference": "incident",
            "id": 10
        }
  ]
}

Observação: o **Casos** associado à “referência” “incidente”, no ASMS será atribuído ao solicitante com ID 10.

Exemplo de tipo Mapeador

1. Defina o valor “incidente” como o Referência.
2. Na definição do caso Pegue a propriedade Requerente (requerente).
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).

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

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

1. O relacionamento implica que você deve associar os Solicitantes do Aranda Desk (ASMS) aos Solicitantes do Jira Server, é recomendável escrever o Id do requerente a ser listado, conforme mostrado abaixo:

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

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

⚐ Nota: O solicitante com o ID da tabela Aranda “5” (ASMS) está relacionado ao solicitante “id_solicitante_jira” no Jira Server

Exemplo de tipo Valor do campo

1. Defina o valor “incidente” como o mesa.
2. Na definição do caso Pegue a propriedade Requerente (requerente).
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).

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

        "applicant": {
          "type": "FieldValue",
          "key": "applicant_id_jira_Server"
        }
      }
    }
  ]
}

↩ Voltar para Configurações