Registrar caso | Centro de Integração Aranda

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": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "responsibleGroup": {
          "key": "",
          "type": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "client": {
          "type": "",
          "key": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "company": {
          "type": "",
          "key": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "applicant": {
          "type": "",
          "key": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "typeRegister": {
          "type": "",
          "key": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        },
        "ci": {
          "type": "",
          "key": "",
          "defaultValue": {
            "id": 0,
            "value": ""
          }
        }
      }
    }
  ]
}

Propriedades :

Propriedades	Descrição
Referência	Identificador exclusivo para criar uma relação entre os conceitos projeto > categoria, itemType, typeRegister, candidato, responsibleGroup, responsável, empresa, cliente ver
Definição	Permite relacionar os campos de caso do ASMS aos campos de problema no Jira Cloud

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:

Propriedades	Descrição
Assunto	Representa o campo Assunto do caso em Aranda e permite que você relacione este campo a um campo equivalente do Issue no Jira Cloud, é recomendável usar o Resumo.
Descrição	Representa o campo Descrição do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.
typeRegister	Representa o campo Tipo de registro do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas
responsibleGroup	Representa o campo Grupo Responsável do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas
responsável	Representa o campo Responsável do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas
candidato	Representa o campo Candidato do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas
Companhia	Representa o campo Companhia do caso em Aranda, permite que você relacione este campo a outro campo equivalente do Issue no Jira Cloud.	Propriedades internas
cliente	Representa o campo Cliente do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas
Ci	Representa o campo CI do caso em Aranda e permite que você relacione esse campo a um campo equivalente do Issue no Jira Cloud.	Propriedades internas

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

Propiedades internas

{
  "key": "",
  "type": "",
  "defaultValue": {
    "id": 0,
    "value": ""
  }
}

Donde:

Propriedades	Descrição
tipo	Tipo de associação, os tipos suportados são Value, Mapper, FieldValue.	FieldValue, Value, Mapper.
Chave	Nome ou ID do campo no Jira Cloud onde as informações serão pesquisadas e atualizadas.	Propriedades no Jira Cloud
defaultValue	Permite adicionar um valor padrão.	ver

Propiedad “defaultValue”

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.
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.
Você só poderá adicionar um valor padrão se o tipo de mapeamento for “Mapeador” ou “ValorDoCampo”.

Exemplo:

Defina o valor “incidente” como o Referência.
Na definição do caso Assuma a propriedade responsável (responsável).
“type”: Atribua o tipo de associação como Valor do campo.
“key”: atribua o nome da propriedade no Jira Cloud como assigned_to (Propriedades no Jira Cloud).
“defaultValue”: atribua o defaultValue.

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

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.

Nome	Descrição	Exemplo
Valor	Permite atribuir um valor ao campo selecionado através do arquivo de configuração. O valor deve estar dentro das propriedades da taxa de valor	Veja o exemplo
Mapeador	Procura associar e/ou relacionar os valores do caso Aranda com os valores do campo Jira Cloud Issue indicado na propriedade chave no Jira Cloud, a proporção de valores é feita de 1 para 1, a atribuição não pode ser repetida	Veja o exemplo
Valor do campo	Os valores de propriedade são enviados diretamente entre plataformas sem qualquer associação/relacionamento	Veja o exemplo

Ejemplo tipo Value

Defina o valor “incidente” como o Referência.
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"
        }
      }
    }
  ]
}

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

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

Defina o valor “incidente” como o Referência.
Na definição do caso Pegue a propriedade Requerente (requerente).
“type”: Atribua o tipo de associação como Mapeador.
“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"
        }
      }
    }
  ]
}

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

Defina o valor “incidente” como o mesa.
Na definição do caso Pegue a propriedade Requerente (requerente).
“type”: Atribua o tipo de associação como Valor do campo.
“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