Инструкция по установке плагина «KPI»

Перед установкой

  1. Убедитесь, что ваш сервер соответствует системным требованиям плагина «KPI»

Redmine Ruby Rails Database Браузер
Гарантировано 3.0 - 3.4 1.9.3, 2.0 - 2.4 3.2, 4.2 MySQL Chrome, Firefox, Opera, Internet explorer 9, 10
Должно работать > 3.4 > 2.4 x PostgreSQL, MSSQL Любой современный браузер

  1. Убедитесь, что установлен бинарный режим передачи файлов на сервер, если копируете файлы через ftp или ssh-клиент.

Установка

  1. Все файлы используемые в инструкции вы можете скачать в своем личном кабинете.
  2. Скачайте версии плагинов, соответствующую вашей версии Redmine.
  3. Разархивируйте полученный архив с плагином «KPI»
  4. Скопируйте папку с плагином «KPI» в папку плагинов «Redmine» — «plugins»
  5. Скопируйте папку с плагином «ldap_users_sync» в папку плагинов «Redmine» — «plugins»
  6. Скачайте архивы «a_common_libs», «global_roles», «ajax_counters»(не требуется для Redmine 3.4).
  7. Откройте скачанные архивы с плагинами и выберите папки, соответствующую вашей версии Redmine.
  8. Скопируйте их содержимое в папку «Redmine» — «plugins».
  9. Клонируйте плагин «mathjax» в папку плагинов «Redmine» — «plugins» с «GitHub»: git clone https://github.com/SkiF91/mathjax.git
  10. Скопируйте папку «rgloader» в корневую директорию «Redmine»
  11. Убедитесь, что пользователь, из-под которого запускается web-сервер, имеет доступ к корневой директории установки «Redmine». Как возможное решение, для операционных систем семейства UNIX, запустите следующие команды:
    sudo chmod 775 -R your_redmine_root_folder
    sudo chown -R your_web_server_group:your_web_server_user your_redmine_folder
  1. Запустите `bundle install`, находясь внутри корневого каталога «Redmine» для установки необходимых гемов
    bundle install
  1. Выполните миграции плагина (убедитесь, что выполняя команду, находитесь в корневой директории установки «Redmine»):
    rake redmine:plugins:migrate RAILS_ENV=production
    
  1. Заполните базу данных необходимыми данными (укажите язык правильно).
    rake redmine:fill_kpi_values LANG=ru RAILS_ENV=production
  1. Для корректной работы плагина, мы настоятельно рекомендуем изменить режим хранения сессионных данных на табличный внутри базы вместо использования файлов cookie.
    Для этого необходимо сделать следующее: Отредактируйте конфигурационный файл приложения «Redmine»: your_redmine_dir/config/application.rb. Закомментируйте строчку с настройкой для хранения сессий в cookie и дополните файл опцией для использования хранилища в базе данных.
    # config.session_store :cookie_store, :key => '_redmine_session'
    config.session_store :active_record_store

После установки

  1. Зайдите в настройки плагина «A common libs» и убедитесь, что флаги для подключения библиотек «Select2», «jqPlot» и «Bootstrap» выставлены. Также должны быть включены флаги «Включить javascript патчи» и «Разрешить модальные окна»
  2. Зайдите в пункт «Отделы» в административном интерфейсе и создайте структуру вашей компании. Используйте кнопку «Добавить отдел» для добавления новых подразделений.
  3. Зайдите в пункт «Должности» в административном интерфейсе и создайте должности, которые существуют в вашей компании. Используйте кнопку «Добавить должность» для добавления новых должностей.

После данных действий, вы можете зайти в плагин через ссылку «KPI» в верхнем меню и настроить необходимые расчетные периоды. Вы можете посмотреть, как настроено в примере: http://ru.demo.saas.rmplus.pro/kpi/

Создайте показатели результативности и шаблоны расчета KPI. Затем вы сможете создать расчетные периоды, основанные на шаблонах KPI.

Для корректного расчета зарплаты необходимо задать «Норму часов» на вкладке «Зарплата» в параметрах расчетного периода. Вы можете задать их вручную, или же брать их из показателей, которые будут проставляться каждый месяц специально выделенным для этого сотрудником.

Для того, чтобы показатель мог быть использован как норма часов для расчетного периода, вы должны установить флаг «Это норма часов» в окне создания/редактирования показателя.

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

Подробно о шагах настройки KPI вы можете узнать в инструкции: Настройка плагина KPI по шагам