Relação entre ASMS e Jira Cloud

Para realizar a integração, é necessário relacionar os campos do ticket Aranda ASMS com os campos da issue do Jira Cloud 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 Cloud 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 Cloud, excluindo a propriedade subject e description.

Propriedades:

Caso en ASMS: Ilustración de referencia, información del cliente de los casos en la plataforma ASMS

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

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

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 Cloud, 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”: atribua o nome da propriedade no Jira Cloud como assigned_to (Propriedades no Jira Cloud).
5. “defaultValue”: atribua o defaultValue.

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

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 Cloud; 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
    }
  ]
}

⚐ Nota: 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”: atribua o nome da propriedade no Jira Cloud como applicant_id_jira_cloud (Propriedades no Jira Cloud).

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

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

1. A relação implica que você deve associar o Aranda Desk Requesters (ASMS) aos Jira Cloud Requesters, é recomendável escrever o Id do requerente a ser relacionado, 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 Cloud***

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”: atribua o nome da propriedade no Jira Cloud como applicant_id_jira_cloud (Propriedades no Jira Cloud).

{
  "case": [
    {
      "reference": "incident",
      "definition": {
        "applicant": {
          "type": "FieldValue",
          "key": "applicant_id_jira_cloud"
        }
      }
    }
  ]
}

↩ Voltar para Configurações