Wiki
Clone wikiredmine_connections / Home
Plugin redmine_connections
Плагин предназначен для связывания между собой различных объектов redmine, как для удобства навигации между ними, так и для структурирования данных. Объекты могут относиться как к стандартным redmine, так и к добавляемым другими плагинами. Например, задачи, накладные (плагин redmine_store), заказы и счета (плагин remine_products и redmine_contacts_invoices) и др.
Основные возможности:
- Отображение связанных объектов на страницах просмотра. Например, списки нужных приходных и расходных накладынх в заказе.
- Быстрая навигация по связанным объектам.
- Быстрое создание новых связанных объектов. Напримре, из счета одним кликом попадаем на форму новой накладной с заполненным списком товаров.
- Гибкая настройка связей.
- Доступ к возможностьи добавления новых связанных объектов регулируется правами на просмотр этих объектов.
Реализованные связи
Версия плагина 0.9.6
- Связь между накладными и заказами.
- Связь между накладными и счетами.
- Связь между накладными и задачами.
- Связь между задачами и заказами.
- Связь между задачами и счетами.
- Связь между сделками и заказами.
- Связь между приходными и расходными накладными
- Связь между операциями и заказами.
- Связь между заказами и заказами.
- Связь между операциями и счетами.
Требования
- Redmine >= 3.4 (условная поддержка от 3.2 1)
- 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 2
Если у вас 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/
.
Лицензия
Copyright (C) 2016 Global Story
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. Скрывает показ блока связанных задач, т.к. этот функционал перенесен в плагин связей. А также вносит небольшую правку визуального оформления. ↩
Updated