General notes

You can connect your project to one of the supported project management systems (PMS). Currently, both Jira and Redmine (including forks) are supported.

  1. First, you have to supply the PMS connection details on the Edit a project / Integrations tab. We recommend creating a separate user with limited access to the particular project. It should be able to create tasks/issues, post comments and change issue statuses.

  2. In case the connection can not be established, make sure the credentials are correct and the PMS instance is up and running. In case of further problems please contact our support team.

  3. Provide tasks statuses mappings between Drop Guard and PMS, so that when a task status changes in one of the systems, the corresponding task in another system changes its status accordingly. Example: when the task is closed in Jira by the project manager, the corresponding task in Drop Guard will be automatically closed, triggering all Actions attached. (!) Note, that only supported transitions will be executed. I.e. it won't be possible to transition the Drop Guard task from "Ready for update" to "Test passed" status because this transition is not supported by Drop Guard (you have to execute updates first). Such unsupported transitions will be ignored.

  4. Finally, configure a Webhook in your PMS so that it is capable of posting the data back to Drop Guard. The administrative privileges are usually required for that, so if you can't do it by yourself, ask your administrator.

  5. On the Edit a project / Events tab create the "Create a task in a project management system" action and fill in the task title and body using provided tokens.

Once the steps above are done, Drop Guard will be attempting to create a task in your project management system every time a corresponding update task in Drop Guard is created. It will then maintain two tasks in sync, changing statuses as per mappings specified on the Edit a project / Integrations tab.

This action follows the same logic as any other action, so you can execute it only for specific update types (i.e. "Highly critical" updates), or choose to create a PMS task only when an error occurs. Attaching the action to any of the events available is possible.

Jira

In Jira, issue statuses are configured for each issue type, so make sure you picked up the correct issue type available in your project before supplying any mappings.

Redmine

Before connecting to Redmine, make sure to check the "Enable REST web service" box on a page http:///settings?tab=api. If you don't do it, all incoming requests to Redmine instance will be rejected.

Webhooks functionality is not available in Redmine by default. You have to install and configure Redmine webhook plugin first.