A propriedade “modelo” relaciona os estados e os campos adicionais do ASMS, o arquivo de configuração tem o seguinte JSON para o modelo:
{
"model": [
{
"id": 0,
"reference": "",
"state": [
{
"value": "",
"id": 0,
"commentary": {
"Key": "",
"value": ""
}
}
],
"additionalFields": [
{
"id": 0,
"field": {
"key": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
]
}
]
}
1. Com a ajuda de um Gerenciamento de Serviços Aranda (ASMS) obter a ID do modelo usando as IDs de Projeto, Serviço e Categoria obtidas em A seção anterior, esse valor será registrado no model.id no arquivo de configuração.
Escolha o modelo que você usará para a integração, com a ajuda de um administrador do Aranda Service Management (ASMS) obtenha o ID do modelo associado ao projeto, serviço e categoria, previamente atribuídos.
2. Digite os valores no “model.id” No arquivo de configuração:
{
"model": [
{
"id": 15,
"state": [
],
"additionalFields": [
]
}
]
}
Nota: Não há necessidade de registrar a propriedade “referência” de “modelo” porque apenas uma categoria foi registrada.
Status do caso
3. Com a ajuda de um Gerenciamento de Serviços Aranda (ASMS) obter os IDs do Estados do caso.
4. A propriedade Estado ASMS refere-se à propriedade Estado do Jira Cloud, essa relação não pode ser modificada e/ou relacionada a outra propriedade do Jira Issue.
5. Obter os valores da propriedade Estado seção Jira Cloud, conforme ensinado na seção “Modelo de registro”, você encontrará um exemplo de como verificar esses status.
6. Estabelecer uma equivalência entre os valores para os Estados da seguinte forma:
Status JiraCloud | Tipo de registro ASMS | Tipo de registro ASMS de ID | VALOR Status JiraCloud |
---|---|---|---|
Novo | Novo | 187 | 1 |
Em andamento | Em andamento | 188 | 2 |
Em espera | Em espera | 189 | 3 |
Resolvido | Resolvido | 190 | 5 |
Fechado | Fechado | 191 | 6 |
7. Digite os valores no “modelo.estado” No arquivo de configuração:
{
"model": [
{
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189
},
{
"value": "5",
"id": 190
},
{
"value": "6",
"id": 191
}
],
"id": 15,
"additionalFields": [
]
}
]
}
Solução
8. No ASMS, por casos de configuração, exigem que a propriedade “Solution” tenha um valor, essa solução é determinada pelo estado em que o caso está localizado.
Para resolver esse requisito, o arquivo de configuração permite adicionar um valor estaticamente ou obtê-lo diretamente do Jira CLoud, usando a seguinte propriedade:
{
"commentary": {
"key": "",
"value": ""
}
}
Onde:
“chave”: nome da propriedade do Jira Cloud onde a solução será obtida. “valor”: estático a ser atribuído à solução ASMS.
9. Atribua um campo do Jira Cloud que você relacionará ao campo “Solução” do ASMS
10. Digite no arquivo de configuração a relação do campo da solução ASMS com o campo do Jira Cloud.
Lembre-se de que nem todos os estados exigem uma solução, depende da configuração das plataformas.
{
"model": [
{
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "5",
"id": 190,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "6",
"id": 191,
"commentary": {
"Key": "close_notes"
}
}
],
"id": 15,
"additionalFields": [
]
}
]
}
Campos adicionais
11. No ASMS e no Jira Cloud é permitida a criação de campos adicionais, caso queira incluir alguns deles na integração siga as instruções abaixo.
12. Recomendamos que você crie uma tabela com os campos que deseja adicionar na integração da seguinte maneira:
no Jira Cloud | no ASMS | ID do campo do Jira Cloud | Campo Id ASMS |
---|---|---|---|
Campo fixo | Campo fixo | u_campo_fijo | 286 |
Texto curto | Texto curto | u_texto_corto | 287 |
Cidades | Cidades | u_glide_list | 288 |
Item de configuração | Item de configuração | u_reference_12 | 298 |
13. Escolha o tipo de integração ao qual cada campo será relacionado: FIELDVALUE, VALUE ou MAPPING e escreva as informações no arquivo json.
A propriedade value só é necessária quando valores constantes são desejados.
{
"model": [
{
"id": 15,
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "5",
"id": 190,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "6",
"id": 191,
"commentary": {
"Key": "close_notes"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "u_glide_list"
}
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
14. Para concluir a configuração nos tipos MAPING, você precisa adicionar a propriedade mapping.
15. Para concluir a configuração do tipo MAPING, liste os ids dos valores no ASMS e no Jira Cloud e escreva-os na propriedade mapping, onde id é o identificador do valor da lista no ASMS e value no identificador do valor na lista do Jira Cloud.
Exemplo para uma lista de valores do Mapeamento, com a ajuda de um administrador do ASMS, identifique os IDs de cada valor do campo adicional no ASMS e os IDs de cada valor do campo adicional no Jira Cloud:
no Jira Cloud | no ASMS | Valor de ID Jira Cloud | ASMS do valor de ID |
---|---|---|---|
Países | Países | 10100 | 35 |
Países | Países | 10101 | 34 |
{
"model": [
{
"id": 15,
"state": [
{
"value": "1",
"id": 187
},
{
"value": "2",
"id": 188
},
{
"value": "3",
"id": 189,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "5",
"id": 190,
"commentary": {
"Key": "close_notes"
}
},
{
"value": "6",
"id": 191,
"commentary": {
"Key": "close_notes"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "u_campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "u_texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "u_glide_list"
},
"mapping": [
{
"id": 35,
"value": "10100"
},
{
"id": 34,
"value": "10101"
}
]
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "u_reference_12"
}
}
]
}
]
}
Continuar: Registrar a propriedade “Urgência” (etapa 5) ↪