qTest supports Integration with OnDemand/Local Bugzilla (version 4.0+) and OnDemand/Local Fogbugz (version 8.1.1+) for Defect submission.
If the Defect Trackers you are using are deployed on the Local Server and behind firewall protections to secure sensitive project data as well as prevent unauthorized accessess from the Internet, you need to check the following Configurations to ensure a successful connection with qTest Manager for Defect Integration.
- Make sure your Defect Tracker Local Server's IP address is configured to be a public IP address, so your Defect Tracker's instance is accessible from the public Internet.
- Configure your firewall's settings to accept accesses/requests from the following Amazon servers ' elastic IP addresses.
Set up Connection
This section describes one way to create a Connection with either Bugzilla OnDemand or Local.
- Go to the qTest Manager instance and access Integration Settings under Project Settings.
- Select Bugzilla 4.0+ from the External Systems list.
- Click the Add Connection button to define a connection with Bugzilla.
- Enter the Connection Name, Server URL, and Account Credentials.
- Click Test Connection.
- Click the Save & Configure button to finish adding the Connection and begin the Integration Configuration.
- Turn on the Activation Status and check Active one of Connection in the list. You can Save & Activate the connection after the Integration Configuration.
- The Integration with Bugzilla will be set as "In Use" upon successful Activation.
- You can add many Connections to Bugzilla with duplicate Accounts and URLs, but only one Connection can be activated at a time.
- We strongly recommend using the Admin Account to have full permissions to access configured projects for Defect Integration.
- If a user is submitting Defect internally while another Admin user is switching to Integration with External Defect Trackers, the data entered in qTest Defect is still submitted successfully, but user cannot view that internal Defect because the Defect menu is disabled in qTest. Until their the Integration with External Defect Tracker is deactivated, user can view that submitted qTest Defect.
Configure Defect Integration
For each Connection with Bugzilla added, you need a separate Defect Integration Configuration.
- Clic the Configure icon on the Connection to go to the Configure Connection. Alternatively, click the Save & Configure button on the Add Connection pop-up.
- qTest Manager automatically populates all available Projects from Bugzilla. In the pop-up Projects list, select one, multiple, or all projects to populate these selected Projects' fields to configure.
- Alternatively, click the Populate All Fields button to reload all available data from the configured Bugzilla Connection, including Projects, corresponding Defect Types, Defect Fields, and fields' values in Projects.
- Select the Project and Defect Type you want to integrate with. The selected types will be treated as Defects in qTest Manager. You have to separately configure the Defect's fields for each populated Project.
- Click the Re-sync Fields button to populate all fields and values of the selected Project and Defect Types.
- Click the Add Field button to create compulsive fields that cannot be populated from Bugzilla onto qTest.
- Enter the field name of Bugzilla you need to add.
- Click the Populate button to load all available values of that field in Bugzilla.
- Check "Required" according to the Bugzilla Field Settings.
- Click Add to create values that cannot be populated from that field in Bugzilla. If you add more field's values, they will NOT be updated back to your Bugzilla.
- Set the default value for the field.
- Click OK to finish adding the field.
- A list of the Defect's fields displays for configuration. You can:
- Reorder the fields display on the Defect Submission form using Drag & Drop or Move Up and Down arrow. The order does not affect the display of that Defect type in Bugzilla.
- Click the Re-populate icon on each Defect field to load its latest values.
- Click on hyperlinks of Defect Field names to Edit existing Defect Fields.
- Click the Delete icon to remove the display of specific fields from qTest Manager's defect submission form. Those deleted fields are still shown on the Bugzilla defect form.
- Set Auto-Filling for Defect's fields as Text-box type.
- Click a Name Link of the defect's text-box field to set Auto-Fill.
- In the Edit Field box, click the Add button to create the auto-fill value.
- Click the drop-down arrow and select a field of qTest Manager's Test Case or Test Run to be auto-filled in the Defect field.
- Click the OK button to finish creating Auto-filling.
- qTest Manager only supports certain field types. Unsupported field types in the external system will not be populated due to this limitation.
- If you choose to auto fill a field using many values at once, each value will be separated by a line in the output text box.
- Some fields from Bugzilla cannot be populated to qTest Manager for Integration Configuration.
For Integration with external Defect Tracking Systems, the only way to submit defects is through Test Execution. You can submit defects during Test Execution or from Test Log.
- Click the Bug icon linked to Test Steps or Submit Defect linked to a Test Run in the TestPad.
- Click the New button to create a new Defect.
- Select one of the mapped Project and Defect types from the drop-down list.
- Click the OK button and fill out the Defect Submission form.
- Click the Save & Close button to finish submitting a new Defect and close the Defect Submission form.
- Click the Save & New button to finish submitting one Defect and create more Defects linked to the same Test Step or Test Run.
- qTest Manager will return the Defect ID with Summary and latest Status of Defect from Bugzilla attached to the Bug icon.
You can delete any Connection you no longer need, as follows.
- Deactive the connection you want to delete.
- In the Action column of Connection List, click the Delete icon on a Connection you want to remove from the Configure Integration screen.
- Click Yes to confirm the connection deletion.
- Click Save in the Configure Integration screen to submit the deletion.
- If there is only one connection you want to delete, turn off the Activation Status to change that connection to deactivated.
- All configured defect integration of the deleted connection will be removed.