YouTrack Server 2022.1 Help

Import from Mantis Bug Tracker

YouTrack lets you connect to a Mantis Bug Tracker (MantisBT) and import projects, users, issues, and other entities from MantisBT to YouTrack.

Prerequisites

Before you import projects from MantisBT to YouTrack, check the following requirements:

  • Your MantisBT version is 2.14.0 or later.

  • Your YouTrack and MantisBT are accessible to inbound connections. Specifically, you need to make sure that your network doesn't block connections between your MantisBT and YouTrack.

  • Your user account in MantisBT has administrative permissions.

Import Details

If the MantisBT database contains references to entities that do not already exist in YouTrack, they are created. The YouTrack user account that you use to run the import should have permissions to create all imported entities. We recommend that you use an account with a System Admin role or the Low-level Admin Write permission to run the import.

Here is the list of entities that are imported from MantisBT and their mapping to YouTrack entities:

Entity in MantisBT

Entity in YouTrack

Projects

Projects

Issues

Issues

Default issue fields

Custom fields

Version fields

Custom fields

Categories

Category custom field values

Tags

Tags

Notes

Comments

Attachments

Attachments

Users monitoring issues

Watchers

Relationships

Links

Set up an Import from Mantis Bug Tracker

The setup wizard guides you through the setup process.

To connect to a Mantis Bug Tracker:

  1. From the Administration menu, select Integrations > Imports.

  2. Click the New import button.

    • The New Import dialog opens.

    New Import dialog.
  3. Click Mantis.

    • The New Import from Mantis dialog opens.

    New Import from Mantis dialog.
  4. Enter values for the following settings:

    Setting

    Description

    URL

    Enter the URL of the MantisBT.

    Token

    Enter the API token from the administrator account in MantisBT.

    SSL key

    If your MantisBT requires client SSL authentication, activate the Use SSL key for client authentication switch. You can then select the SSL key that identifies your YouTrack server from the list.

    The list only displays SSL keys that have already been imported into YouTrack. To learn how to generate and upload SSL keys, see SSL Keys.

  5. Click the Next button.

    • The next part of the configuration dialog opens.

    New Import from Mantis dialog step two.
  6. Select source and target projects for import. For details, see Project Mapping.

  7. Click the Start import button.

    • The import process starts.

    • When the import is finished, Import Status is updated.

    Mantis import status.
  8. If you want to learn more details about the import, click the Download import log button.

Default Custom Fields

The list of custom fields with their values that are created in the target YouTrack project by default:

Name

Type

Values

Steps To Reproduce

text

Platform

string

OS

string

OS Build

string

Additional Informationn

text

Priority

enum

  • none

  • low

  • high

  • urgent

  • immediate

Status

enum

  • new

  • feedback

  • acknowledged

  • confirmed

  • assigned

  • resolved

  • closed

Resolution

state

  • open

  • fixed

  • reopened

  • unable to reproduce

  • not fixable

  • duplicate

  • no change required

  • suspended

  • won't fix

Severity

enum

  • feature

  • trivial

  • text

  • tweak

  • minor

  • major

  • crash

  • block

Reproducibility

enum

  • always

  • sometimes

  • random

  • have not tried

  • unable to reproduce

  • N/A

Assignee

user

Category

ownedField

Categories from projects in MantisBT

Project Mapping

On the final step of the import setup, you have an option to select those MantisBT projects that you want to import to YouTrack. You can also choose whether to create a new project for the import or import data into an existing project in YouTrack.

Project Mapping

To configure project mapping:

  1. Locate those MantisBT projects that you want to import.

    Use the filter bar on the right to filter projects by name.

  2. Select the projects that you want to import. Check the box on the top of the list to import all available MantisBT projects.

  3. Select a target YouTrack project for each MantisBT project.

    • When loading the list of MantisBT projects for mapping, YouTrack checks for existing YouTrack projects with corresponding names. If it finds a YouTrack project with the same name as the MantisBT one, YouTrack suggests it as the target project.

    • If there is no existing YouTrack project with the corresponding name, YouTrack suggests creating a new one.

  4. If you want to change a target project, select another option from the corresponding dropdown on the list.

  5. Click Start import to finalize import setup and start the import.

Delete the Import Configuration

When all your data is imported from MantisBT to YouTrack, you can delete the import configuration.

When you delete the import configuration:

  • MantisBT entity IDs that are attached to imported issues are also removed.

  • Projects, issues, users, and groups that were imported from the connected MantisBT are not affected.

If you delete the import settings and connect to the same MantisBT, the issues are re-imported into existing projects with new issue IDs.

To delete an existing import configuration:

  1. From the Administration menu, select Integrations > Imports.

  2. In the list of configured imports, select the one you need to delete.

    Details sidebar
  3. Click the trash icon in the main toolbar of the page, or the Delete button in the right details sidebar.

  4. In the shown dialog, confirm the operation by clicking Delete.

    Confirm delete operation
    • The current import settings are removed.

    • All entities that are already imported remain in YouTrack.

Last modified: 06 July 2022