Page History
...
- Xray and Jira configuration
- Xray server/DC or Xray Cloud ? (which implicitly will define if Jira server/DC or Jira Cloud are being used)
- Server/DC specific settings
- Use Jira username/password or Personal Access Token?
- Jira username
- Jira password
- Personal Access Token
- Cloud specific settings
- Jira username
- Jira API Token
- On each test on the tool, associate it to an existing Xray Test issue
- specify Test issue key
- Discover the custom fields ids of the entities being used
Xray internals
How is Xray data stored
Xray server/DC
Xray data is stored on Jira's database, mostly in Xray specific tables (e.g., for test runs).
...
Some of this information is exposed and managed using the Jira's REST API or through Xray's REST API.
Xray Cloud
Due to the way Atlassian cloud architecture works, apps such as Xray manage their data in their own way (e.g., in the app cloud infrastructure or in a cloud DB provider). Jira related information (e.g., issues, links) is managed by Atlassian and stored in Atlassian's cloud imfrastructure.
...
It's possible to generate a dump of the Xray managed data; note that this dump doesn't contain the information managed by Jira/Atlassian as that follows a different mechanism.
Custom fields
Generically speaking, custom fields (CFs) are like custom attributes. They exist as a means to add additional, well-defined information, to certain entities.
...
- Xray managed Jira CFs: Xray data managed as a Jira CF (server/DC, cloud); some of these CFs are read-only, while other are read/write. These are also Jira CFs in strict sense. Xray server/DC has many of these; Xray cloud has very few, due to the way apps integrate with Jira cloud. On Xray server/DC some of these fields are stored in Jira's database, others are stored on lucene.
- Xray's Test step custom fields: Xray proprietary way of defining named attributes for steps on "manual" scripted tests; definable at project level. These are not listable/includable on Jira issues/gadgets nor exportable using standard Jira mechanisms; they are also not visible to Jira's REST API.
- Xray's Test Run custom fields: Xray proprietary way of defining named attributes for Test Runs; definable at project level. These are not listable/includable on Jira issues/gadgets nor exportable using standard Jira mechanisms; they are also not visible to Jira's REST API.
...
| Xray managed CF | Xray server/DC | Xray Cloud |
|---|---|---|
| Begin Date | x (rw) | x (rw) |
Conditions | x (rw) | - |
| Cucumber Scenario | x (rw) | - |
| Cucumber Test Type | x (rw) | - |
| Dataset values | x | - |
| End Date | x (rw) | x (rw) |
| Generic Test Definition | x (rw) | - |
| Manual Test Steps | x (rw?) | - |
| Pre-Condition Type | x (rw) | - |
| Pre-Condition association with a Test | x (rw?) | - |
| Requirement Status | x (r) | - |
| Revision | x (rw) | x |
| Steps Count | x (r) | - |
| Test Type | x (rw?) | - |
| TestRunStatus | x (r) | - |
| Test Plans associated with a Test | x (rw?) | - |
| Test Repository Path | x (rw) | - |
| Test Sets associated with a Test | x (rw?) | - |
| Test Count | x (r) | - |
| Tests association with a Pre-Condition | x (rw?) | - |
| Tests associated with a Test Plan | x (rw?) | - |
| Tests association with a Test Set | x (rw?) | - |
| Tests association with a Test Execution | x (r) | - |
| Test Environments | x (rw) | - |
| Test Execution Defects | x (r) | - |
| Test Execution Status | x (r) | - |
| Test Set Status | x (r) | - |
| Test Plan Status | x (r) | - |
Tips
- try to use the proper APIs as much as possible and avoid using CFs to obtain or modify data
References
- Xray Cloud
- Xray server/DC
...