# Redmine Integration

> Connect Test Manager to Redmine to synchronize requirements and create defects in Redmine directly from test results.

If you use Redmine as your project planner, the integration with UiPath® Test Manager allows you to synchronize test relevant requirements between Test Manager and your Redmine instance. In addition, you can create defects in Redmine directly from test results in Test Manager.

The integration works for both Redmine Cloud and Server and the connection is defined at the project level for both tools.

## Conditions

* The name and description of an issue that you create in Redmine is synchronized as a [requirement in Test Manager](https://docs.uipath.com/test-manager/automation-suite/2.2510/user-guide/requirements).
* The synchronized requirements in Test Manager are read-only aside from any attachments, objects labels or links to your test cases.
* Deletion of synchronized requirements in Test Manager is not possible.

## Prerequisites

* Redmine Cloud or Server account.
* Test Manager administrator account.
* Redmine project

## Configure a Redmine Connection

Set up the connection between Test Manager and your Redmine instance by entering the server details, credentials, and tracker settings to enable requirement synchronization and defect reporting.

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** > **Integration**.
4. Select **New Connection** and select **Redmine** from the dropdown.
5. Configure the following connection settings:
   * **Name**: Enter a name for your Redmine connection.
   * **Description**(Optional): Add a description for reference.
   * **Server Url**: Add the endpoint server URL. For example: `https://company-name-redmine.azurewebsites.net`.
   * **Project Identifier**: Enter the project identifier from Redmine.
   * **User**: The username you use to authenticate to Redmine.
   * **Password**: The password you use to authenticate to Redmine.
   * **Polling interval**: Set the timeframe for fetching Defects and Requirements information through Redmine. By default, the value is set to 60 seconds. For more information on the Redmine issue tracking system, see [Redmine Trackers](https://www.redmine.org/projects/redmine/wiki/redmineissuetrackingsetup#Trackers).
   * **Fetch Trackers**: Select this option to retrieve trackers.
   * **Defect Tracker**: Set the tracker for which you want to synchronize items with Test Manager. You can choose only one option.
   * **Requirements Trackers**: Set the requirements that you want to synchronize. You can choose multiple requirements.
6. Select **Save** to confirm.

   ![Redmine connection settings form in Test Manager](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125622-28b5f4f1-ce4e3867.webp)

## Managing Redmine connections

The following table lists the actions that you can take to manage your Redmine connections.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Action  
     Description  
     Procedure  
  
 
 
  
    Edit 
     Edit your connection settings.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Go to Project Settings . 
         In the Integration tab, select the Redmine connection to expand the panel. 
         Select Edit to configure the connection. 
         Select Save to confirm. 
      

  
  
    Delete 
     Delete the selected connection and its associated requirements.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Go to Project Settings . 
         In the Integration tab, select the Redmine connection to expand the panel. 
         Select Delete to remove the connection. 
         Select OK to confirm. 
      

  
 

## Related articles

[Defect synchronization](https://docs.uipath.com/test-manager/automation-suite/2.2510/user-guide/defect-synchronization#defect-synchronization)

## Result

The Redmine connection is created and requirements are synchronized from Redmine to Test Manager. Defects created in Test Manager are synchronized back to Redmine using the configured defect tracker.