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 Servidor Jira, 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 do Servidor Jira, conforme ensinado no “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 JiraServer | Tipo de registro ASMS | Tipo de registro ASMS de ID | VALOR Status JiraServer |
|---|---|---|---|
| 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 Server, usando a seguinte propriedade:
{
"commentary": {
"key": "",
"value": ""
}
}
Onde:
“chave”: nome da propriedade do Servidor Jira onde a solução será obtida. “valor”: estático a ser atribuído à solução ASMS.
9. Atribua um campo do Jira Server 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 Jira Server.
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 Server, a criação de campos adicionais é permitida; se quiser 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 Server | no ASMS | ID do campo do Jira Server | 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 Server e grave-os na propriedade mapping, onde id é o identificador do valor da lista no ASMS e o valor no identificador do valor na lista do Jira Server.
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 Server:
| no Jira Server | no ASMS | Valor Id Jira Server | 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) ↪