Continuing with the file configuration, a relationship between the ASMS task fields and the DevOps task fields must be recorded.
The relationship between ASMS and DevOps task fields is presented by the following JSON (Configuration File):
{
"task": [
{
"reference": "",
"definition": {
"idByProject": {
"type": "",
"key": ""
},
"subject": {
"type": "",
"key": ""
},
"description": {
"type": "",
"key": ""
},
"responsible": {
"type": "",
"key": "",
"SearchBy": [""]
},
"responsibleGroup": {
"key": "",
"type": "",
"defaultValue": {
"id": 0,
"value": ""
}
},
"duration": {
"type": "",
"key": ""
},
"enddate": {
"type": "",
"key": ""
},
"startdate": {
"type": "",
"key": ""
}
},
"model": {
"id": 0,
"additionalFields": [
{
"id": 0,
"type": "",
"field": {
"key": ""
},
"mapping": [
{
"id": 0,
"value": ""
},
{
"id": 0,
"value": ""
},
{
"id": 0,
"value": ""
}
]
}
],
"state": [
{
"id": 0,
"value": "",
"reason": 0,
"commentary": {
"key": "",
"value": ""
}
}
]
}
}
]
}
1. On the property “reference” in the configuration file type the “key” that he registered in The previous section; Duplicates of this property are not supported:
{
"case": [
{
"reference": "project 1",
"definition": {
"subject": {
},
"description": {
},
"idByProject": {
},
"responsibleGroup": {
},
"responsible": {
},
"duration": {
},
"enddate": {
},
"startdate": {
}
}
}
]
}
2. Get the name of the DevOps properties that you will relate to the ASMS properties, see DevOps Properties:
| DevOps Property | DevOps Property ID |
|---|---|
| Title | System.Title |
| Description | System.Description |
| idByProject | Custom.idByProject |
| Responsible | System.AssignedTo |
| Responsible Group | Custom.usergroup |
| Duration | Custom.duration |
| End up | Custom.enddate |
| startdate | Custom.startdate |
3. Create a relationship between ASMS and DevOps properties:
| Property in ASMS | DevOps Property |
|---|---|
| subject | System.Title |
| Description | System.Description |
| state | state * |
| responsible | System.AssignedTo |
| responsibleGroup | Custom.usergroup |
| Duration | Custom.duration |
| Finish it | Custom.enddate |
| initialdate | Custom.startdate |
| idByProject | Custom.idByProject |
⚐ Note: Fields assigned with an asterisk ( * ) are assigned internally and cannot be modified.
4. Assign the type of mapping that the properties will perform:
| Name | Description |
|---|---|
| Value | Allows you to assign a value to the selected field through the configuration file. The value is required to be within the value ratio properties |
| Mapper | Seeks to associate and/or relate the values of the Aranda task with the values of the associated DevOps field, the relationship of values is made 1 to 1, the assignment is not allowed to be repeated |
| FieldValue | Property values are sent directly between platforms without any association/relationship |
Field Relationship
| Property in ASMS | Jira Cloud Ownership | Mapping Type |
|---|---|---|
| subject | System.Title | FieldValue |
| Description | System.Description | FieldValue |
| state | state * | - |
| responsible | System.AssignedTo | Mapper |
| responsibleGroup | Custom.usergroup | Mapper |
| Duration | Custom.duration | FieldValue |
| Finish it | Custom.enddate | FieldValue |
| initialdate | Custom.startdate | FieldValue |
| idByProject | Custom.idByProject | FieldValue |
⚐ Note: Properties without any mapping will be covered in another section.
5. For this setting, defaults are set for the “responsible”, this value will be added if the “Responsible” from DevOps to Asms or Asms to DevOps is not found.
6. Consult the ID of the Responsible in Asms that you will assign by default.
7. Refer to the Responsible Id in DevOps that you will assign by default.
8. In internal ownership “defaultValue” of “responsible”, add the ID of the Responsible queried in point 8 in the property “id” defaultValue, 3 will be used for the example.
9. In internal ownership “defaultValue” of “responsible”, add the ID of the Responsible queried in point 9 in the property “value” defaultValue, the example will use user373.
10. Type the relationship defined in the previous steps in the configuration file:
{
"defaultValue": {
"id": 3,
"value": "user373"
}
}
11. Type in the configuration file the relationship created for the property’s defaults “responsible”:
{
"responsible": {
"type": "Mapper",
"key": "System.AssignedTo",
"defaultValue": {
"id": 3,
"value": "user373"
}
}
}
12. Replicate the steps for each definition and according to the client’s needs.
{
"task": [
{
"reference": "project 1",
"definition": {
"idByProject": {
"type": "FieldValue",
"key": "Custom.idByProject"
},
"subject": {
"type": "FieldValue",
"key": "System.Title"
},
"description": {
"type": "FieldValue",
"key": "System.Description"
},
"responsible": {
"type": "Mapper",
"key": "System.AssignedTo",
"SearchBy": [
"Email"
]
},
"responsibleGroup": {
"key": "Custom.grupodeusuarios",
"type": "Mapper",
"defaultValue": {
"id": 3,
"value": "user373"
}
},
"duration": {
"type": "FieldValue",
"key": "Custom.duration"
},
"enddate": {
"type": "FieldValue",
"key": "Custom.enddate"
},
"startdate": {
"type": "FieldValue",
"key": "Custom.startdate"
}
}
}
]
}
Continue: Register the “Mapping” property (step 4) ↪