Mantis

Integrating with Mantis enhances project management by seamlessly transferring TestMonitor issues to your Mantis Bug Tracking system.

If you are using Mantis Bug Tracking for the management of your bugs, you can integrate TestMonitor with the system to automate your workflow. TestMonitor provides you with test management features like data links and reports that make it the best place to originate issues from your testing. By integrating TestMonitor with Mantis, you’ll effortlessly send the useful information issues contain to create bugs, without having to manually copy this data. 

You’ll easily be able to trace back the link between TestMonitor issues and Mantis bugs to track their progress. Every bug sent over to Mantis will have a link back to TestMonitor. The integration will also let you select if some or all TestMonitor issues will become a bug in Mantis.

About Mantis

Mantis is an open source bug tracking software that can be used to track software defects for various software projects.

Features

Here's a list of feature(s) available for the Mantis integration:

• Send issues to Mantis

Prerequisites

Before you can use this integration, make sure that you meet these requirements:

• You must either be a admin or have the project manager role in TestMonitor.
• You have an active Mantis account.
  • This account has permissions for issue management (create and update issues).

• A project is set up in Mantis.
• A Mantis API token, the API token can be generated in your Mantis user profile settings.

When all these requirements are met, you can proceed with connecting to Mantis.

Connect to Mantis

Go to the Project Settings of the project you wish to set up an integration with. Once you have opened the project settings page:

1. Head over to the Integrations section and click on the Mantis panel.
2. In the top right corner, click on Connect. The connection wizard appears.
3. Fill the web address of your Mantis instance in the URL field (e.g. https://mantis.yourcompany.com).
4. Enter your Mantis API token.
5. Click on Authenticate.
6. When authentication is successful, proceed to the next step.
7. Select your Mantis project.
8. Click on Connect to complete the connection wizard.

You're now ready set up one or more features this integration has to offer.

Send issues to Mantis

By sending issues to Mantis from TestMonitor, teams can effectively prioritize and track problem resolution. This seamless integration allows for quick identification of issues, assignment to team members, and ongoing monitoring of progress.

To enable this feature, first, make sure you're connected to Mantis. Then, follow these steps to configure the send issues feature:

1. In the Issues panel:
   1. If you haven't configured the issues feature yet, click on Set up...
   2. When you've already configured the feature: click on Configure.
2. Enable the Send issues option in the first page of the wizard.
3. Proceed to the Send step and configure this option:
   • Send by default: Enables the Send to Mantis toggle as a default.
4. Proceed to the Confirm step and click Finish to activate the Send issues feature.

You are now ready to send issues to Mantis.

Send new issues to Mantis

Once the Send issues feature has been enabled, you can send new TestMonitor issues directly to Mantis. Head over to your project's issue management and follow these instructions:

1. Click the Add Issue... button.
2. Fill in the issue's details.
3. Enable the Send to Mantis toggle.
4. Click Create to confirm.

Once the process is complete, your issue will be created and sent to Mantis. Within the issue overview, a small Mantis badge will display the Mantis issue ID code alongside the issue, serving as a direct link to the corresponding Mantis page. Simply click on the badge to navigate directly to the Mantis issue page for further details on the issue.

The Mantis issue name will be aligned with TestMonitor, and the description will include the following details:

• Description (TestMonitor)
• Status
• Priority
• Category
• Assignee
• Custom fields (and their values)

Unlink issues from Mantis

If you have mistakenly linked the incorrect issue or simply wish to unlink the issue, you can follow these steps:

1. Open the issue's detail page.
2. In the top-right corner, click on the Mantis logo. A dropdown menu will appear.
3. Click on Unlink from Mantis.
4. Confirm your action by clicking Unlink.

Once the process is finished, the connection with Mantis will be removed.

Disconnect the Mantis Integration

If the integration is no longer required or your project comes to an end you can easily disconnect the integration. 

To disconnect the integration, go to the Project Settings of the integration's project and follow these steps:

1. Head over to the Integrations section and click on the Mantis panel.
2. In the top right corner, click on Disconnect... The connection wizard appears.
3. Click Disconnect to confirm.

Troubleshooting

If you encounter errors involving the Mantis integration with TestMonitor, here are some steps you can take to troubleshoot the issue:

Inspect the integration log

The integration log assists in identifying the reasons for integration failures by listing all encountered issues while interacting with Mantis. To access the log, follow these instructions:

1. Open the integration page
2. Click on the link in the right panel that reports the number of integration issues.

Investigate the log entry by reviewing the error type and description. You can dismiss the error by clicking on the check button on the right.

Re-enable the integration

If an integration fails due to a communication error or glitch, re-enabling it on the integration page may resolve the issue. Test importing or sending a test object to ensure proper functionality.

Re-authenticate the integration

Your integration may have become disabled due to an authentication error. This could occur if the credentials used for authentication have expired or become invalid.

1. Click on the three-dotted menu in the top-right corner.
2. Select Re-authenticate...
3. Confirm your action and provide your credentials when asked.
4. Check if the problem persists by either importing or sending a test object.

Contact support

If these solutions do not resolve your issue, feel free to reach out to our support team for additional assistance.