Plugin redmine_connections

Плагин предназначен для связывания между собой различных объектов redmine, как для удобства навигации между ними, так и для структурирования данных. Объекты могут относиться как к стандартным redmine, так и к добавляемым другими плагинами. Например, задачи, накладные (плагин redmine_store), заказы и счета (плагин remine_products и redmine_contacts_invoices) и др.

Основные возможности:

Отображение связанных объектов на страницах просмотра. Например, списки нужных приходных и расходных накладынх в заказе.
Быстрая навигация по связанным объектам.
Быстрое создание новых связанных объектов. Напримре, из счета одним кликом попадаем на форму новой накладной с заполненным списком товаров.
Гибкая настройка связей.
Доступ к возможностьи добавления новых связанных объектов регулируется правами на просмотр этих объектов.

Реализованные связи

Версия плагина 0.9.6

Связь между накладными и заказами.
Связь между накладными и счетами.
Связь между накладными и задачами.
Связь между задачами и заказами.
Связь между задачами и счетами.
Связь между сделками и заказами.
Связь между приходными и расходными накладными
Связь между операциями и заказами.
Связь между заказами и заказами.
Связь между операциями и счетами.

Требования

Redmine >= 3.4 (условная поддержка от 3.2 ¹)
Ruby >= 2.2.0
Rails >= 4.2.0
Databases: SQLite, MySQL, PostgreSQL, SQL Server

Установка

Распакуйте архив с плагином в папку ./plugins/ в вашей директории redmine. В результате должно получиться примерно так:
```
./plugins/redmine_connections/init.rb
```
Установите необходимые gems следующей командой:
```
$ bundle install --without development test
```

Выполните миграцию БД командой:

$ bundle exec rake redmine:plugins NAME=redmine_connections RAILS_ENV=production

Примените патч 0001-Move-issue-relations-to-connection-plugin.patch ²

Если у вас redmine находится в git репозитории:
```
$ git apply --stat 0001-Move-issue-relations-to-connection-plugin.patch
```
```
$ git apply --check 0001-Move-issue-relations-to-connection-plugin.patch
```
```
$ git am < 0001-Move-issue-relations-to-connection-plugin.patch
```
Если репозиторий не развернут, то:
```
$ patch -p1 < 0001-Move-issue-relations-to-connection-plugin.patch
```
Если используется другая система контроля версий, изучайте документацию по тому как применять патч файлы.
После перезапуска redmine в разделе администрирования в списке установленных плагинов вы должны увидеть Redmine Connections plugin. Можно переходить в настройки плагина и уcтанавливать необходимые вам опции.

Настройка плагина

Все управление настройками плагина осуществляется через раздел админитрирования плагина Redmine Connections plugin.

вы можете включать или выключать отображение связей в определенных объектах. Например, мы можете хотеть связывать накладные со счетами, но не хотите чтобы в счете отображался блок связанных с ним накладных. Это управляется через включение/выключение отображение связей для соответствуюзих объектов.
вы можете настраивать тип связи - многие или единичные. Т.е. вы можете установить связь как один к одному, так и многие ко многим (и промежуточные варианты, конечно).
если для включения какого либо блока связей не обнаружены необходимые плагины, то для этого блока будет выведено информационное сообщение о том каких плагинов не хватает.

Удаление

Выполните удаление из БД таблиц плагина командой (все данные связей будут удалены):
```
$ bundle exec rake redmine:plugins NAME=redmine_connections RAILS_ENV=production VERSION=0
```
Откатите патч 0001-Move-issue-relations-to-connection-plugin.patch

Если используете git репозиторий
```
$ git apply -R 0001-Move-issue-relations-to-connection-plugin.patch
```
Если репозиторий не установлен
```
$ patch -p0 -R < 0001-Move-issue-relations-to-connection-plugin.patch
```
Удалите папку с кодом плагина ./plugins/redmine_connections/.

Лицензия

redmine_connections is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

redmine_connections is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with redmine_connections. If not, see http://www.gnu.org/licenses/.

Условная поддержка означает, что с большой вероятностью плагин будет работать на условно поддерживаемых версиях. Но возможны ошибки, т.к. на этих версиях мы плагин не проверяем. В случае возникновения ошибок их ожидаемая трудоемкость исправления - низкая. Исправления будут производиться за счет заказчика. Использование плагинов на условно поддерживаемых версиях целесообразна в случае, когда трудоемкость обновления версии Redmine значительно выше, чем возможное добавление поддержки плагину. ↩
Этот патч изменяет стандартный код redmine. Скрывает показ блока связанных задач, т.к. этот функционал перенесен в плагин связей. А также вносит небольшую правку визуального оформления. ↩

Wiki

redmine_connections / Home