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": [
{
"reference": "project 1",
"id": 15,
"state": [
],
"additionalFields": [
]
}
]
}
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 Essa relação não pode ser modificada e/ou relacionada a outra propriedade do WorkItem do DevOps.
5. Obter os valores da propriedade Estado de DevOps, conforme ensinado no “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 DevOps | Tipo de registro ASMS | Tipo de registro ASMS de ID |
|---|---|---|
| Novo | Novo | 187 |
| Em andamento | Em andamento | 188 |
| Em espera | Em espera | 189 |
| Resolvido | Resolvido | 190 |
| Fechado | Fechado | 191 |
7. Digite os valores no “modelo.estado” No arquivo de configuração:
{
"model": [
{
"state": [
{
"value": "New",
"id": 187
},
{
"value": "In Progress",
"id": 188
},
{
"value": "On Hold",
"id": 189
},
{
"value": "Resolved",
"id": 190
},
{
"value": "Closed",
"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 DevOps, usando a seguinte propriedade:
{
"commentary": {
"key": "",
"value": ""
}
}
Onde:
“chave”: nome da propriedade DevOps em que a solução será obtida. “valor”: estático a ser atribuído à solução ASMS.
9. Atribua um campo DevOps que você relacionará ao campo “Solução” do ASMS
10. Digite no arquivo de configuração a relação do campo de solução ASMS com o campo DevOps.
Lembre-se de que nem todos os estados exigem uma solução, depende da configuração das plataformas.
{
"model": [
{
"state": [
{
"value": "New",
"id": 187
},
{
"value": "In Progress",
"id": 188
},
{
"value": "On Hold",
"id": 189,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 190,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 191,
"commentary": {
"Key": "Custom.close_notes"
}
}
],
"id": 15,
"additionalFields": [
]
}
]
}
Campos adicionais
11. No ASMS e DevOps é 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 DevOps | no ASMS | ID do campo DevOps | Campo Id ASMS |
|---|---|---|---|
| Campo fixo | Campo fixo | Custom.campo_fijo | 286 |
| Texto curto | Texto curto | Custom.texto_corto | 287 |
| Cidades | Cidades | Custom.list | 288 |
| Item de configuração | Item de configuração | Custom.reference | 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": "New",
"id": 187
},
{
"value": "In Progress",
"id": 188
},
{
"value": "On Hold",
"id": 189,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 190,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 191,
"commentary": {
"Key": "Custom.close_notes"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "Custom.campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "Custom.texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "Custom.list"
}
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "Custom.reference"
}
}
]
}
]
}
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 as ids dos valores no ASMS e no DevOps e grave-as na propriedade mapping, em que id é o identificador do valor da lista no ASMS e o valor no identificador do valor na lista do DevOps.
Exemplo para uma lista de valores do Mapeamento, com a ajuda de um administrador do ASMS, identifique as IDs de cada valor do campo adicional no ASMS e as IDs de cada valor do campo adicional no DevOps:
| no DevOps | no ASMS | Id valor DevOps | ASMS do valor de ID |
|---|---|---|---|
| Países | Países | Colômbia | 35 |
| Países | Países | Argentina | 34 |
{
"model": [
{
"id": 15,
"state": [
{
"value": "New",
"id": 187
},
{
"value": "In Progress",
"id": 188
},
{
"value": "On Hold",
"id": 189,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 190,
"commentary": {
"Key": "Custom.close_notes"
}
},
{
"value": "Resolved",
"id": 191,
"commentary": {
"Key": "Custom.close_notes"
}
}
],
"additionalFields": [
{
"type": "VALUE",
"id": 286,
"value": "un valor que quiero que sea constante",
"field": {
"key": "Custom.campo_fijo"
}
},
{
"type": "FIELDVALUE",
"id": 287,
"field": {
"key": "Custom.texto_corto"
}
},
{
"type": "MAPPING",
"id": 288,
"field": {
"key": "Custom.list"
},
"mapping": [
{
"id": 35,
"value": "Colombia"
},
{
"id": 34,
"value": "Argentina"
}
]
},
{
"type": "FIELDVALUE",
"id": 298,
"field": {
"key": "Custom.reference"
}
}
]
}
]
}
Continuar: Registrar a propriedade “Urgência” (etapa 5) ↪