--- title: "How to Configure Jira XRAY for Cloud" slug: "how-to-configure-jira-xray-for-cloud" description: "How to configure Jira XRAY for Test Modeller Cloud " tags: ["Jira", "Connections and Integrations", "Test Modeller"] updated: 2024-09-27T15:01:04Z published: 2024-09-27T15:01:04Z canonical: "knowledge.curiositysoftware.ie/how-to-configure-jira-xray-for-cloud" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.curiositysoftware.ie/llms.txt > Use this file to discover all available pages before exploring further. # Configure JIRA Xray Cloud Connector In this article, we'll cover configuring the JIRA Xray Cloud connector with Quality Modeller. [Embedded content](https://www.youtube.com/embed/iGZgmRCVXg8?&wmode=opaque&rel=0) ## 1. Details Tab Select the connector Type as **Xray (JIRA Cloud) - Tests** Give your new connector profile a name: ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678463946317.png) --- ## 2. Connection Tab Provide the following connection information: - **URL:** The URL for your Jira Instance - **JIRA Username:**Must be an admin user in Jira - **JIRA API Key:** This can be generated by an admin user in your Jira instance. Please see instructions available [**here**](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#:~:text=Create%20an%20API%20token&text=Log%20in%20to%20https%3A%2F%2F,your%20token%20and%20click%20Create.)**.** - **Project Key:** Select the XRay project you would like to export test cases into. To unlock the list of available projects, click the blue reload button. - **XRay Client ID and XRay Secret Key:**Please see instructions available [**here**](https://docs.getxray.app/display/XRAYCLOUD/Global+Settings%3A+API+Keys). ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464010566.png) ### 2.1 Create a Jira API Key Inside of Jira, navigate to your **Profile** and **Account Settings**. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462580258.png) Then navigate to **Security** and **Create and Manage API Tokens**. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462585588.png) Click **Create a New API Token** and follow the instructions to generate the token. Copy and paste this token into Quality Modeller under Jira API key. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462749815.png) ### 2.2 Create a Xray Client ID and Secret Key Inside of Jira, navigate to**Settings** → **Apps**. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462773593.png) On the left-hand side of the application list, there is a section for Xray. Under Xray, there is a section called API Keys. Click **Create API Key** to generate a Client ID and Client Secret Key. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462786359.png)![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678462793795.png) --- ## 3. Field Mappings Tab **Field mappings** are divided into two areas: **Issue fields** and **Test Step Fields**. The configurations for each: - **Attribute** is the name of the field in your Jira instance. - **Internal Name** is the key for the field in Jira (usually this is the name of the field in all lowercase). - **Built In**refers to whether the field is required in Jira. - **Mapped Value** is the value that will be exported from Quality Modeller into your chosen Jira field. **Issue fields** are fields that are available in the normal Jira issue, such as the Summary and Description. By default, these will be included in your connection. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464062653.png) **Test Step Fields**are fields that are available in the Xray Test Details field as Steps. The default fields that are included with this connection type are Action, Data, and Expected Result. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464080678.png) ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464085675.png) ***Note:**if you would like to export Quality Modeller data into fields that are not already inside of your Jira instance, you will first need to create the fields inside Jira. Quality Modeller can only map to existing fields in Jira.* *For instructions on how to create custom fields in Jira, please refer to this*[***link***](https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/)*.* *For instructions on how to create custom fields in Xray, please refer to this*[***link***](https://docs.getxray.app/display/XRAY/Configuring+Test+Step+Custom+Fields)*.* ### Types of Mappings | **Type** | **Description** | **Availability** | | --- | --- | --- | | Model | Exports data from the [**model properties level**](/docs/model-properties-explained). | Issue and Test Step Field | | Model Version | Exports data for the specific version of the chosen model. | Issue and Test Step Field | | Test Suite | Exports data from the test suite level. | Issue and Test Step Field | | Path | Exports data from the model paths, or test case names. | Issue Field | | Nodes | Exports data from the action level inside of models (ex: task blocks) | Test Step Field | | Export Override | Overrides any given field with a property set inside the mapping value. | Issue and Test Step Field | --- ## Custom Fields in Quality Modeller **Custom Fields**can be created in Quality Modeller either at the Model or Node level to further customize what data can be exported. To add**custom fields** to navigate to **Workspace → Configuration → Custom Fields.**Here, you can hit the blue New Field button to create a new field and select either Model or Node for the Field Level. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464211669.png) Custom model properties will be available underneath the **Model Properties** tab in a model. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464233605.png) Custom node Properties will be available inside the **Properties** section of an action block. ![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-1678464239089.png) Quality Modeller is Curiosity's flow-driven model-based tool which provides a range of accelerators and connectors for building flowcharts rapidly. Align all stakeholders to quality outcomes and create critical assets early, delivering superior software at speed. A Model is a canvas and the Flow that is built onto it. There are several types of Model, some of which display different tabs and tools on the toolbar in Quality Modeller. ## Related - [Jira Xray](/jira-xray.md) - [Configure JIRA Xray On-Premise Connector](/xray-on-premise-connector.md) - [Export Tests to JIRA Xray](/export-tests-to-jira-xray.md) - [Export to a Folder on Xray Export](/how-to-create-a-folder-on-xray-export.md)