Our documentation site has been updated to AIO Tests Knowledge Base
Permissions
With introduction of Cross Linking feature (release 2.1), Cases from different Projects can be added to a Cycle. Users who do not have access to a project, will not be able to access the Case / Run from that project in the Cycle.
To indicate the access user has on different Entities - Case / Cycle & Run, Permission object will be returned in response.
Sample Permission object is below:
"permission": {
"value": 7,
"error": null
}
Permission object has value and error properties.
Value is a bit map where in bits from right to left represent the Delete, Write & Read permissions.
7 - Full access (Delete, Write, Read)
3 - Only Write and Read
1 - Only Read
0 - No permissionError is an enum indicating why user does not have access over the cycle.
Error can be one of
EVALUATION_FAILED - There was error while evaluating the permission value.
JIRA_PROJ_NO_ACCESS - User does not have access on the entity as User does not have permission on entity’s Project.
AIO_TESTS_DISABLED_PROJ - User does not have access on the entity as AIO Tests has been disabled for the entity’s Project.
AIO_TESTRUN_REFSTEP_NO_ACCESS - User does not have access on the Run as one of the Referenced Step Case is not accessible.If user has permission (error value is null), then error will not be returned in the response.
Below table shows the Permission Values and Delete / Write / Read access it indicates.
If the bit is ON (having value 1), it means user has that permission for performing those operations.
Permission | Bit Map | ||
Value | Delete | Write | Read |
7 | 1 | 1 | 1 |
3 | 0 | 1 | 1 |
1 | 0 | 0 | 1 |
0 | 0 | 0 | 0 |
Below table shows the Run permissions based on corresponding Cycle and Case access.
User who has Read only access to Run, will not be able to change the status of a run, but would be able to view its data. On trying to update such a Run using the API will return a 4xx response.
Project Access | Run Permission | ||
Cycle | Case | Linked Step in Case | Value |
Y | Y | Y | 7 (All) |
Y | Y | N/D | 1 (Read) |
Y | N/D | - | 1 (Read) |
N/D | - | - | 0 (No Access) |
| |||
Y - User has access on the entity's project | |||
N - User does not have access on entity's project | |||
D - User has access, but AIO Tests is disabled |