The property “model” relates the States and Additional ASMS Fields, the configuration file has the following JSON for model:
{
"model": [
{
"id": 0,
"reference": "",
"state": [
{
"value": "",
"id": 0,
"commentary": {
"Key": "",
"value": ""
}
}
],
"additionalFields": [
{
"id": 0,
"field": {
"key": ""
},
"mapping": [
{
"id": 0,
"value": ""
}
]
}
]
}
]
}
1. With the help of a Aranda Service Management (ASMS) get the model ID using the Project, Service, and Category IDs obtained in The previous section, this value will be recorded in the model.id in the configuration file.
Choose the model you will use for the integration, with the help of an Aranda Service Management (ASMS) administrator obtain the model ID associated with the project, service and category, previously assigned.
2. Type the values in the “model.id” from the configuration file:
{
"model": [
{
"reference": "project 1",
"id": 15,
"state": [
],
"additionalFields": [
]
}
]
}
Case Statuses
3. With the help of a Aranda Service Management (ASMS) get the IDs of the States of the case.
4. The property State ASMS relates to ownership Status This relationship cannot be modified and/or related to another property of the DevOps WorkItem.
5. Get the values for the property Status of DevOps, as taught in the “Register model”, you will find an example of how to check these statuses.
6. Establish an equivalence between the values for the States as follows:
| Status DevOps | ASMS Record Type | ID ASMS Record Type |
|---|---|---|
| New | New | 187 |
| In Progress | In Progress | 188 |
| On Hold | On Hold | 189 |
| Resolved | Resolved | 190 |
| Closed | Closed | 191 |
7. Type the values in the “model.state” from the configuration file:
{
"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": [
]
}
]
}
Solution
8. In ASMS by configuration cases require the “Solution” property to have a value, this solution is determined by the state in which the case is located.
To solve this requirement, the configuration file allows you to add a value statically or obtain it directly from DevOps, using the following property:
{
"commentary": {
"key": "",
"value": ""
}
}
Where:
“key”: name of the DevOps property where the solution will be obtained. “value”: static value to be assigned to the ASMS solution.
9. Assign a DevOps field that you will relate to the ASMS “Solution” field
10. Type in the configuration file the relationship of the ASMS solution field to the DevOps field.
Keep in mind that not all states require a solution, it depends on the configuration of the platforms.
{
"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": [
]
}
]
}
Additional fields
11. In ASMS and DevOps the creation of additional fields is allowed, if you want to include some of them in the integration follow the instructions below.
12. We recommend that you create a table with the fields you want to add in the integration as follows:
| field in DevOps | field in ASMS | DevOps field id | Id ASMS field |
|---|---|---|---|
| Fixed field | Fixed field | Custom.campo_fijo | 286 |
| Short text | Short text | Custom.texto_corto | 287 |
| towns | towns | Custom.list | 288 |
| Configuration Item | Configuration Item | Custom.reference | 298 |
13. Choose the type of integration to which each field is going to be related: FIELDVALUE, VALUE or MAPPING and write the information in the json file.
The value property is only required when constant values are desired.
{
"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. To complete the configuration in the MAPPING types, you have to add the mapping property.
15. To complete the configuration of the MAPPING type, list the ids of the values in ASMS and DevOps and write them in the mapping property, where id is the identifier of the value of the list in ASMS and value in identifier of the value in the DevOps list.
Example for a list of values of the Mapping, with the help of an ASMS administrator, identify the IDs of each value of the additional field in ASMS and the IDs of each value of the additional field in DevOps:
| field in DevOps | field in ASMS | Id value DevOps | Id value ASMS |
|---|---|---|---|
| Countries | Countries | Colombia | 35 |
| Countries | Countries | 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"
}
}
]
}
]
}
Continue: Register the “Urgency” property (step 5) ↪