A propriedade “modelo” relaciona os Estados ASMS e Campos Adicionais tanto para casos quanto para tarefas, a estrutura do JSON e sua configuração é a mesma para a seção de casos e para a seção de tarefas dentro do arquivo de configuração, o arquivo de configuração possui o seguinte JSON para 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.
Para a seção de tarefas, atribua o id do modelo usado para a tarefa com a ajuda de um administrador do Aranda Service Management (ASMS), lembre-se de que esse modelo deve ser atribuído ao tipo de caso que está sendo configurado; neste caso, estamos usando o tipo de caso incidente.
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” Como apenas uma categoria foi registrada, o modelo na seção Tarefa é único para cada Tarefa, então você não precisa adicionar a propriedade Referência.
Status de casos/tarefas
3. Com a ajuda de um Gerenciamento de Serviços Aranda (ASMS) obter os IDs do Estados do caso ou da tarefa.
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 Problema/subtarefa do Jira.
5. Obter os valores da propriedade Estado seção Jira Cloud, conforme ensinado na seção “Modelo de registro” ou “Modelo de registrador na tarefa”, 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"
}
}
]
}
]
}
Continue: Registre a propriedade “Urgência” (passo 6) ↪