Mantis

If you use Mantis Bug Tracking, you can integrate it with TestMonitor to automate your workflow. This integration allows you to send issue details to Mantis without manual data entry, enabling easy tracking of TestMonitor issues and their corresponding Mantis bugs. Each bug created in Mantis will link back to TestMonitor, and you can choose whether to send some or all TestMonitor issues as bugs 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.... 
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.