How To Map JIRA Custom Fields
How to map JIRA custom fields?
First you will need to connect a JIRA account. Follow the instructions here
Choose one of your apps you want to connect and press the Activate
button.
Here you can configure the JIRA fields:
In the JIRA configuration screen choose the project (Project Key) you want to connect:
Once the project is selected, select the issue type you want to configure:
If you want to first test the connection to the JIRA project you can Press the TEST
button to validate the JIRA issue creation.
You will get a pop-up window with the response. Make sure you get a valid JIRA link.
In case you get a PENDING response check the connection configuration.
Each Issue type has different fields associated with it:
- Name - the field name.
- Type - the type of field as defined in the JIRA system.
- Value - the values from the JIRA system (* in addition to predefined fixed values and -Dynamic value-, see below)
- Required? - is the field required or optional.
When defining fields in the Configure Fields window follow the below conventions:
- When you choose a field from a drop down this field as is (text) will be populated in the corresponding JIRA field in the issue opened.
- You can also choose from the fixed predefined values in the list below:
{user.id}
- the UserId of the session running.{session.timestamp}
- the timestamp of the session.{session.url}
- the url of the session on the TestFairy dashboard.{session.ipAddress}
- the IP address of the device running the session.{device.os}
- the running device OS{device.model}
- the device model of the handset{device.osVersion}
- the OS version on the device (if the iPhone is running version IOS 12 value=12){app.name}
- the app name.{app.version}
- the versionName or CFBundleShortVersionString of the build. example: 1.7.0{app.fullVersion}
- the versionName + (versionCode or CFBundleVersion) of the build. example: 1.7.0 (1700){feedback.text}
- the feedback message{feedback.timestamp}
- the timestamp of the feedback (absolute){feedback.relTimestamp}
- relative timestamp of the feedback (mm:ss) since session started
In order to use these values add them to the -Dynamic value-
field that opens when you select the -Dynamic value- option like so:
- You can also add attributes that are defined in your apps code to the
-Dynamic value-
field. The structure of a dynamic field is as follows:{attr.[attribute_name]||[default_value]}
attribite_name
- is the name of the Teasfairy attribute set in the code by theTestFairy.setAttribute
function. What passes to the JIRA is the value of this attribute.default_value
- for each attribute you can set a default value so if you receive a null or wrong attribute value from the code (not possible in this field in JIRA) the default value will instead be passed to JIRA.
Last updated on 2023-06-06