# Redmine plugin

# Introduction

Plugin to manage tickets for your Redmine projects.

# Compatibility matrix

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="width: 776px;"><tbody><tr><td style="width: 229px;">**Systems where it has been tested**</td><td style="width: 547px;">CentOS 7, Fedora

</td></tr><tr><td style="width: 229px;">**Systems where it should work**</td><td style="width: 547px;">Any linux system

</td></tr></tbody></table>

# Pre requisites

Required:

- Enable rest web services in redmine
- **\*** Python3
- **\*** Module requests

**\* In the binary version of the plugin it is not necessary to install these dependencies, since they are already included in the plugin.**

# Configuration

Web service rest must be enabled to use the plugin as it communicates with the API.

[![image-1641996074638.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641996074638.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641996074638.png)

To get to this menu, click on administration, then on configuration and finally on authentication.

The API token can be seen in "my account":

[![image-1641998437878.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641998437878.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641998437878.png)

**\* Remember that to create tickets (even manually in redmine) you have to do some basic configuration, like creating a ticket type, status and priority, this can be done in the administration menu:**

[![image-1641996396304.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641996396304.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641996396304.png)

[![image-1641996454638.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641996454638.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641996454638.png)

[![image-1641996482548.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641996482548.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641996482548.png)

[![image-1641996517861.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641996517861.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641996517861.png)

# Parameters

**Parameters**

<table border="1" id="bkmrk-method--m-get%2Cpost%2Cp" style="height: 435px;"><tbody><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">Method</td><td style="height: 29px; width: 56.3594px;">-m</td><td style="height: 29px; width: 195.172px;">post,put o delete</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">host</td><td style="height: 29px; width: 56.3594px;">-i, --ip</td><td style="height: 29px; width: 195.172px;">site redmine</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">token</td><td style="height: 29px; width: 56.3594px;">-t </td><td style="height: 29px; width: 195.172px;">token API</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">project id</td><td style="height: 29px; width: 56.3594px;">-p</td><td style="height: 29px; width: 195.172px;">id project</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket id</td><td style="height: 29px; width: 56.3594px;">-tid</td><td style="height: 29px; width: 195.172px;">ticket id</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">subject</td><td style="height: 29px; width: 56.3594px;">-s</td><td style="height: 29px; width: 195.172px;">subject</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">description</td><td style="height: 29px; width: 56.3594px;">-d</td><td style="height: 29px; width: 195.172px;">description</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">priority id</td><td style="height: 29px; width: 56.3594px;">-pi</td><td style="height: 29px; width: 195.172px;">priority</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">status id</td><td style="height: 29px; width: 56.3594px;">-st</td><td style="height: 29px; width: 195.172px;">state</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">assigned to id</td><td style="height: 29px; width: 56.3594px;">-a</td><td style="height: 29px; width: 195.172px;">allocation request</td></tr></tbody></table>

**Methods**

Get to list, post to create ticket, put to update ticket and delete to delete ticket.

# Create ticket

**Necessary arguments**

-m (post)

-i (host)

-t (token)

-p (project id)

-s (subject)

-d (description)

-pi (priority id)

-st (status id)

-a (asigned to id)

**Example manual execution**

```
./pandora_redmine -m post -i http://pandorap.m.redmine.org -t <token> -p 1 -s "este es el subject" -d "la descripcion" -pi 1 -st 1 -a 1
```

The request will be created in our project.

[![image-1641999655271.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641999655271.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641999655271.png)

# Update ticket

**Necessary arguments**

-m (post)

-i (host)

-t (token)

-p (project id)

-tid (ticket id)

-s (subject)

-d (description)

-pi (priority id)

-st (status id)

-a (asigned to id)

**Example manual execution**

```
./pandora_redmine -m put -tid 1 -i http://pandorap.m.redmine.org -t <token> -p 1 -s "omg" -d "descripcion" -pi 1 -st 1 -a 1
```

The ticket with id #1 will be updated

[![image-1641999846846.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/scaled-1680-/image-1641999846846.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-01/image-1641999846846.png)

# Delete ticket

It will be eliminated by searching the request by id.

  
Example manual execution:

```
./pandora_redmine -m delete -tid 2 -i http://pandorap.m.redmine.org -t <token>
```