Redmine

This integration enables you to automatically create an issue in Redmine whenever a test case is marked as failed in Tuskr.

Integration is achieved using Make — a SaaS service to create flexible integrations visually without writing code. Make has a generous free plan and is quite affordable. To understand our rationale behind using Make, read — why our approach is better than first-class integrations.

Blueprint

Blueprints are files that you can import into your Make account. A blueprint allows you to integrate Tuskr with other tools in just a few minutes.

Download

Prerequisites

Before you begin, make sure you have:

• A Tuskr account
• A Redmine instance
• A Redmine API Key
• A Make.com account

Step 1: Import the Blueprint into Make.com

1. Download the integration blueprint from the box above.
2. Log in to Make.com.
3. Click Create a New Scenario.
4. Select Import Blueprint.
5. Upload the downloaded blueprint file.

After importing, a new scenario will be created automatically.

Step 2: Configure the Webhook

1. Open the first module (Webhook).
2. Click Add.
3. Enter a name for your webhook.
4. Click Save.
5. Copy the generated webhook URL.

Step 3: Configure the Tuskr Webhook

1. Log in to Tuskr.
2. Navigate to Administration → Webhooks.
3. Click Add Webhook.
4. Fill in the required fields.
5. Paste the webhook URL copied from Make.com into the URL field.
6. Save the webhook configuration.

Step 4: Configure Redmine API Authentication

1. Return to your Make.com scenario.
2. Open the second module.
3. Click Add Credential.
4. Enter a name.
5. Paste your Redmine API Key into the API Key field.
6. Update the highlighted URL with your actual Redmine URL.
7. Verify that the API Key header name is:
   The API Key header name must be X-Redmine-API-Key.
8. Click Save.

Step 5: Configure the Redmine Issue Creation Module

1. Open the third module in the scenario.
2. Select the Api Name you created in the previous step.
3. Update the URL with your Redmine URL. For example:

   https://your-redmine-url/issues.json

4. Save the module configuration.

Step 6: Link Tuskr Projects with Redmine Projects

In Redmine

1. Navigate to Projects.
2. Create a new project or open an existing project.
3. Copy the project's Identifier value.

In Tuskr

1. Create a new project or edit an existing project.
2. Navigate to Advanced Settings.
3. Locate the External ID field.
4. Paste the Redmine Project Identifier copied earlier.
5. Save the project.

Step 7: Test the Integration

1. Return to Make.com.
2. Click Run Once to start listening for webhook events.
3. Open Tuskr.
4. Navigate to a Test Run.
5. Mark any test case as Failed.
6. Wait approximately one minute for Make.com to process the event.
7. Open Redmine and navigate to the associated project.

A new issue should now be created automatically in Redmine based on the failed test case.