Стимулы

Перед установкой решения необходимо убедиться, что установлены модули: "Миграции для разработчиков"; "Валюты" (Информация об установке), а также для возможности импорта и экспорта XML-файлов, которые  необходимы для установки файлов миграции, необходимо убедиться, что расширения XMLWriter и XMLReader установлены и включены. В BitrixVM по умолчанию данные расширения уже установлены, но отключены. Поэтому нужно их включить, если этого раньше не было сделано. Включение расширений осуществляется под пользователем root из консоли следующими командами:

[CODE]# cd /etc/php.d/ # mv 30-xmlreader.ini.disabled 30-xmlreader.ini # mv 20-xmlwriter.ini.disabled 20-xmlwriter.ini # systemctl reload httpd[/CODE]Решение создано только для браузеров, поддерживающих HTML 5. Установка модуля осуществляется штатными средствами Битрикс24 из раздела "Маркетплейс" в 2 шага: на первом шаге установки (рисунок 1) при необходимости есть возможность установить демонстрационные данные (тестовое KPI для группы пользователей, которую(группу) так же можно выбрать или создать новую, со своими формулами, коэффициентами и пользовательскими свойствами).

Рисунок 1 - Первый шаг установки модуля "Стимулы"      

На втором шаге модуль устанавливается, при этом создаются:

1. раздел в левом меню "Стимулы";
2. страница настроек модуля в административной части портала;
3. страница настроек импорта данных "Импорт персональных показателей" в подразделе "Сервисы" в административной части портала;
4. группа "Модератор KPI", участники которой смогут модерировать KPI в разделе "Стимулы" совместно с администраторами портала;
5. группа, которая создавалась для тестового KPI, если такое создание запрашивалось на первом шаге установки модуля.

[COLOR=#ff0000]Внимание! [/COLOR] Файлы миграций только накатываются на портал, у которого в региональных настройках формат времени задан как: [COLOR=#00aeef]DD.MM.YYYY HH:MI:SS [/COLOR] Поэтому если вы используете другие настройки даты и времени, следует в административной части портала перейти по пути Рабочий стол->Настройки->Настройки продукта->Языковые параметры->Региональные настройки и произвести смену настроек (Региональные настройки). По окончании установки модуля можно будет вернуть предыдущие настройки. Настройки модуля. Администратору доступны настройки модуля в административной части портала, которые располагаются на вкладках:

1. "Основное";
2. "Ограничения";
3. "Демо-режим";
4. "Доступ".

На вкладке "Основное" есть возможности:

1. активировать/деактивировать модуль путем отметки/снятия галки с поля "Активность";
2. задания учета времени работы сотрудника (вести можно как на портале, так и во внешних системах);
3. задания цвета элементов pop-up-окна "Показатели KPI" на личной странице сотрудника компании;

На вкладке "Ограничения" существуют возможности:

1. ограничения количества символов на ввод в названиях объектов KPI;
2. выбора групп пользователей, которые не будут участвовать в расчетах KPI.

На вкладке "Демо-режим" реализована возможность включения демо-режима расчета ожидаемого фонда оплаты труда для определенного(-ых) сотрудника(-ов) с целью демонстрации функционала модуля, который доступен сотрудникам, для которых рассчитываются показатели и производится расчет ожидаемого фонда оплаты труда. Причем можно запустить демонстрацию расчета для любого KPI с любыми данными ранее сохраненными в пресет. На вкладке "Доступ" существует возможность задания доступов к настройкам модуля для сотрудников, которые имеют доступ к административной части портала. Реализованы права:

1. [D] - закрыт;
2. [R] - просмотр всех данных модуля;
3. [W] - запись.

Уровни доступа настроены согласно штатного функционала Битрикс24. Разворачивание внешней БД и настройка BitrixVM для возможности осуществления импорта данных из внешней БД Решение поддерживает импорт данных из БД: 1. MySQL; 2. MS SQL Server; 3. PostgreSQL. Для того, чтобы можно было импортировать данные из MS SQL Server, из консоли под пользователем root осуществляется настройка следующими командами: Настройки импорта значений из внешней базы данных. Для задания настроек импорта значений необходимо в административной части портала пройти по пути: Сервисы->Импорт персональных показателей (рисунок 2). Рисунок 2 - Импорт персональных показателей. Вкладка "Основное" После осуществления перехода пользователю будут доступны к заполнению вкладки с настройками:

1. "Основное";
2. "Подключение";
3. "Группы пользователей";
"Пользовательские свойства".

Вкладка "Основное" Перечень полей для заполнения приведен в таблице 1. Таблица 1 - Перечень полей для заполнения вкладки "Основное"[TABLE][TR][TD] [CENTER]№[/CENTER] [/TD][TD] [CENTER]Название[/CENTER] [/TD][TD] [CENTER]Тип[/CENTER] [/TD][TD] [CENTER]Обяз.[/CENTER] [/TD][TD] [CENTER]Множ.[/CENTER] [/TD][TD] [CENTER]Описание[/CENTER] [/TD][/TR][TR][TD]

1.

[/TD][TD]

«Название взаимодействия*»

[/TD][TD]

Строка

[/TD][TD]

Нет

[/TD][TD]

Нет

[/TD][TD]

Название взаимодействия. Например, "Импорт персональных показателей"

[/TD][/TR][TR][TD]

2.

[/TD][TD]«Периодичность обхода агента, сек»

[/TD][TD]Число[/TD][TD]Нет[/TD][TD]Нет[/TD][TD]Та периодичность, с которой данные из промежуточной базы будут поступать в БД Битрикс24. Например, "900"[/TD][/TR][TR][TD]

 3.

[/TD][TD]

 «Описание взаимодействия»

[/TD][TD]

 Текстовая область

[/TD][TD]

 Нет

[/TD][TD]

 Нет

[/TD][TD]

 Информация о взаимодействии

[/TD][/TR][TR][TD]

 4.

[/TD][TD]

 «Активность"

[/TD][TD]

 Чекбокс

[/TD][TD]

 Нет

[/TD][TD]

 Нет

[/TD][TD]

Если поле отмечено галкой, взаимодействие активно. По умолчанию поле отмечено галкой

[/TD][/TR][/TABLE]Поля "Направление" и "Дата последнего взаимодействия" заполнены автоматически. Направления взаимодействия - "Импорт", а в поле "Дата последнего взаимодействия" указывается дата и время осуществленного последнего взаимодействия". Вкладка "Подключение" На рисунке 3 показан общий вид вкладки "Подключение". Рисунок 3 - Вкладка "Подключение" В таблице 2 представлен перечень полей, выводимых для заполнения на вкладке "Подключение"  [CENTER]Таблица 2 - Список полей, выводимых для заполнения на вкладке «Подключение»[/CENTER][TABLE][TR][TD] [CENTER]№[/CENTER] [/TD][TD] [CENTER]Название[/CENTER] [/TD][TD] [CENTER]Тип[/CENTER] [/TD][TD] [CENTER]Обяз.[/CENTER] [/TD][TD] [CENTER]Множ.[/CENTER] [/TD][TD] [CENTER]Описание[/CENTER] [/TD][/TR][TR][TD]

1.

[/TD][TD]

«СУБД*»

[/TD][TD]

Выпадающий список

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

Тип СУБД, к которой осуществляется подключение. Например, "MS SQL Server". Также доступны MySQL и PostgreSQL

[/TD][/TR][TR][TD]

2.

[/TD][TD]

«Имя сервера*»

[/TD][TD]

Строка

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

IP-адрес сервера

[/TD][/TR][TR][TD]

3.

[/TD][TD]

«Порт*»

[/TD][TD]

Строка

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

Порт подключения

[/TD][/TR][TR][TD]

4.

[/TD][TD]

«База данных*»

[/TD][TD]

Строка

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

Название базы данных

[/TD][/TR][TR][TD]

5.

[/TD][TD]

«Имя пользователя*»

[/TD][TD]

Строка

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

Логин пользователя

[/TD][/TR][TR][TD]

6.

[/TD][TD]

«Пароль*»

[/TD][TD]

Строка

[/TD][TD]

Да

[/TD][TD]

Нет

[/TD][TD]

Пароль пользователя, отображается при вводе в зашифрованном виде

[/TD][/TR][TR][TD]

 7.

[/TD][TD]

«Таблица со списком групп*»

[/TD][TD]

 Строка

[/TD][TD]

 Да

[/TD][TD]

 Нет

[/TD][TD]

 Таблица во внешней БД, в которой представлен перечень групп, для которых будут строиться KPI

[/TD][/TR][TR][TD]

 8.

[/TD][TD]

«Таблица со списком пользовательских свойств*»

[/TD][TD]

 Строка

[/TD][TD]

 Да

[/TD][TD]

 Нет

[/TD][TD]

 Таблица во внешней БД, в которой представлен перечень пользовательских свойств

[/TD][/TR][TR][TD]

 9.

[/TD][TD]

«Таблица с пользовательскими свойствами*»

[/TD][TD]Строка

[/TD][TD]

 Да

[/TD][TD]

 Нет

[/TD][TD]

Таблица со значениями пользовательских свойств. Уникальность определяется id записи и e-mail-ом пользователя

[/TD][/TR][TR][TD]

 10.

[/TD][TD]

 «Таблица с данными по месяцам*»

[/TD][TD]

 Строка

[/TD][TD]

 Да

[/TD][TD]

 Нет

[/TD][TD]

Таблица со значениями фонда оплаты труда пользователя за последние 12 месяцев работы. Уникальность определяется id записи и e-mail-ом пользователя

[/TD][/TR][/TABLE]Если все данные введены верно и сохранены, по клику на кнопку "Тест подключения" возле этой кнопки отобразится сообщение "Тест пройден успешно". В противном случае - "Тест провален". Вкладка "Группы пользователей" На рисунке 4 представлена вкладка "Группы пользователей". Рисунок 4 - Вкладка "Группы пользователей" На странице необходимо сопоставить все найденные в смежной БД группы пользователей с группами в Битрикс24. Если по какой-то причине не все группы подтянулись, необходимо кликнуть по кнопке "Обновить список групп". По клику страница будет обновлена, а новые группы появятся на странице. Вкладка "Пользовательские свойства" На рисунке 5 представлена вкладка "Пользовательские свойства". Рисунок 5 - Вкладка "Пользовательские свойства" На странице необходимо сопоставить все найденные в смежной БД группы пользовательскими свойствами с пользовательскими свойствами, заведенными в разделе "Пользовательские свойства" раздела "Стимулы" в публичной части портала Битрикс24. Если по какой-то причине не все пользовательские свойства подтянулись, необходимо кликнуть по кнопке "Обновить список свойств". По клику страница будет обновлена, а новые пользовательские свойства появятся на странице. Логирование событий Реализовано логирование событий в журнал событий Битрикс, который находится в административной части портала по пути: Настройки->Инструменты->Журнал событий В журнал событий заносится информация о событиях, связанных с изменением настроек импорта персональных показателей, а также информация для каких пользователей был осуществлен импорт персональных показателей из внешней БД.