Как создать свой рейтинг
Виды рейтингов
Модуль «Геймификация» позволяет создавать новые рейтинги. Такие рейтинги позволят повысить мотивацию сотрудников в нужных компании сферах и культивировать корпоративные ценности. Например, если для компании важна забота об экологии, можно привлечь сотрудников к участию в рейтинге «Сбор вторсырья» и поощрять за раздельный сбор отходов. А если речь идет об IT-компании, которой важно нарастить темп выпуска продуктов, то можно создать рейтинг «Эффективность разработчика» и ежемесячно начислять призерам баллы за скорость закрытия задач и их качество.

В модуле можно создавать два вида рейтингов:
-
Автоматические (с папкой логики). Примером таких рейтингов являются шесть базовых рейтингов Геймификации — начисление баллов по ним происходит автоматически. У таких рейтингов есть папка с логикой — в ней хранятся критерии, которые должен учитывать рейтинг. Автоматические рейтинги пересчитываются каждые сутки, а раз в месяц по ним определяются призеры, которым начисляются баллы. Автоматические рейтинги могут участвовать в Общем рейтинге.
-
Ручные (без папки логики). Начисление баллов по таким рейтингам происходит вручную, это делают сотрудники с соответствующими правами доступа. У ручных рейтингов нет собственной логики подсчета, то есть папки, где хранятся критерии, которые нужно учитывать. Соответственно, рейтинг не будет фиксировать нужные действия сотрудников и исходя из этого присваивать сотрудникам места.
Такие рейтинги не пересчитываются ежесуточно и по ним не происходит автоматического начисления баллов в конце месяца. По этим причинам ответственные сотрудники самостоятельно принимают решение о том, кто станет призером и какую сумму баллов получит. Также ручные рейтинги не участвуют в Общем рейтинге.
Права доступа к модулю «Геймификация»
Ручное начисление баллов за призовое место
Шесть основных рейтингов Геймификации
Создание ручного рейтинга
Доступ к созданию новых рейтингов есть только у администраторов портала.
Для создания рейтинга перейдите в административную часть портала по пути адрес_портала/bitrix/admin/. В шапке портала нажмите «Настройки» > «Улей: Геймификация».

Прокрутите вкладку «Общие настройки» ниже до таблицы с рейтингами. В нижней части таблицы нажмите «Добавить параметр» и подтвердите действие.


После этого в таблице появится строка с новым рейтингом. Здесь настройте следующие параметры:
-
Опубликовано. Эта опция влияет на отображение рейтинга в публичной части портала. Если галочка снята, в публичной части рейтинг не будет отображаться и по нему нельзя будет вручную начислять баллы.
-
Сортировка. С помощью этого поля устанавливается порядок рейтингов в списке. Чем меньше индекс, тем выше будет расположен рейтинг в списке. Здесь можно указать любое число.
-
Название рейтинга. В этом поле нужно указать название нового рейтинга. Поле обязательно для заполнения.
-
Описание рейтинга. Здесь указывается краткое описание рейтинга: что он учитывает, для каких целей он создан и так далее. Эту информацию пользователи увидят в публичной части портала.

-
Иконка. В данное поле можно загрузить изображение, которое станет иконкой рейтинга в публичной части портала. К загрузке доступны изображения в формате PNG и JPEG.
-
Видят рейтинг. Эта настройка влияет на то, какие отделы компании могут видеть рейтинг в публичной части портала. Если выбраны все отделы или не выбраны никакие, то по умолчанию рейтинг могут видеть все. Если выбрана часть отделов, то только их сотрудники смогут видеть рейтинг. Чтобы выбрать сразу несколько отделов зажмите Ctrl (⌘ Command на Mac) и кликните на все нужные названия.

Сохраните изменения. После этого рейтинг появится в публичной части портала.

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

На слайдере добавление операции заполните следующие поля:
-
Кому. В данном поле выберите сотрудников, которым нужно начислить баллы.
-
Тип операции. Выберите операцию «Начисление».
-
Тип начисления. Здесь укажите «Призовое место в рейтинге».
-
Рейтинг. В выпадающем списке выберите соответствующий рейтинг. После этого вы увидите сводную информацию о том, когда по этому рейтингу были последние начисления, кто был призером, и за какой месяц будет засчитано данное начисление. Если начисление баллов еще ни разу не производилось и рейтинг новый, то в блоке с информацией не будет данных.

- Сумма. Введите сумму баллов, которую нужно. На следующем шаге вы сможете распределить данную сумму между всеми призерами или начислить всем одинаковое количество баллов.

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

При необходимости вы можете заполнить поле «Описание» — комментарий к проведенной операции. После начисления баллов в разделе «Лента событий» появятся публикации о призерах рейтинга. Также призеры попадут на доску почета.

Баланс баллов каждого пользователя будет увеличен на указанную сумму, его можно будет увидеть в профиле сотрудника.

Создание автоматического рейтинга
Создание автоматического рейтинга требует знания кода, поэтому мы рекомендуем разрабатывать такие рейтинги только с помощью специалистов. Чтобы рейтинг стал автоматическим для него нужно создать папку, где будет храниться логика пересчета — сделать это проще всего на основе уже существующих рейтингов Геймификации. В этой статье мы рассмотрим простой пример того, как на основе рейтинга «Лидер продаж» создать новый рейтинг для конкретной воронки продаж. По этой же схеме вы сможете создавать отдельные рейтинги для всех воронок в CRM.
Права на создание рейтингов есть только у администраторов портала.
Создание папки с логикой
Перейдите в административную часть портала по пути адрес_портала/bitrix/admin/. В левом меню нажмите «Контент» > «Файлы и папки». В строку «Путь» введите /bitrix/modules/ithive.gamification/classes/ratings и нажмите «ОК» — так вы попадете на страницу с папками, в которых хранится логика пересчета всех основных рейтингов Геймификации.
Папка рейтинга «Лидер продаж» называется salesleaders, ее нужно скопировать и переименовать с учетом названия нового рейтинга. Для этого нажмите на бургер-меню рядом с папкой (≡) и выберите «Копировать».
В поле «В папку» вставьте путь /bitrix/modules/ithive.gamification/classes/ratings. Нажмите «Копировать».
Страница обновится и вы увидите новую папку с логикой. Снова нажмите на бургер-меню рядом с папкой (≡) и выберите «Переименовать», чтобы задать свое название для папки, например salesleadersOne. Обратите внимание, что в название должно быть на латинице и не должно содержать символов, таких как скобки, тире и подчеркивания.
Редактирование файла с логикой
Откройте созданную папку и обратите внимание на файл salesleaders.php. Именно в этом файле хранятся настройки пересчета рейтинга. Данный файл должен называться так же, как и папка, в которой он находится, например salesleadersOne.php. Чтобы переименовать файл скопируйте название папки, нажмите на бургер-меню (≡) рядом с файлом и выберите «Переименовать». Вставьте новое название и сохраните изменения.
Обратите внимание, что после названия файла обязательно должен быть прописан его формат — «.php».
Теперь нужно внести изменения в содержимое файла, чтобы настроить логику пересчета нового рейтинга. Нажмите на бургер-меню (≡) рядом с файлом и выберите «Редактировать как PHP». Редактировать файл можно прямо на портале, но для удобства вы также можете скопировать его содержимое в текстовый редактор, например Notepad++.
Обратите внимание на строку 13, здесь указано значение class salesleaders. Вместо salesleaders нужно ввести текущее название папки и файла с логикой, в данном примере это salesleadersOne. Соответственно в строке будет написано class salesleadersOne.
Далее перейдите к строке 88. Здесь замените фильтр:
$arCategory = DealCategory::getList([])->fetchAll();
на фильтр:
$arCategory = DealCategory::getList(array('filter' => array('=ID' => 1)))->fetchAll();
Обратите внимание, что в фильтре указано значение 1 — это ID воронки продаж, для которой нужно создать рейтинг. Вместо единицы укажите ID нужной вам воронки продаж.
Узнать ID воронки можно в публичной части портала в разделе «CRM». Выберите нужную воронку из списка — ее ID будет указан в строке браузера. Других изменений в файл вносить не нужно — сохраните изменения. Логика пересчета рейтинга готова, далее нужно создать сам рейтинг.
Добавление нового рейтинга
Доступ к созданию новых рейтингов есть только у администраторов портала.
Для создания рейтинга перейдите в административную часть портала по пути адрес_портала/bitrix/admin/. В шапке портала нажмите «Настройки» > «Улей: Геймификация».
Прокрутите вкладку «Общие настройки» ниже до таблицы с рейтингами. В нижней части таблицы нажмите «Добавить параметр» и подтвердите действие.
После этого в таблице появится строка с новым рейтингом. Здесь настройте следующие параметры:
-
Опубл. (опубликовано). Опция влияет на отображение рейтинга в публичной части портала. Если галочка стоит, рейтинг будет отображаться в публичной части портала и при необходимости по нему можно будет производить ручное начисление баллов. Если галочка не стоит, доступ к рейтингу останется только у администраторов в настройках модуля. Поставьте галочку в данном чекбоксе, чтобы видеть рейтинг в публичной части портала.
-
Акт. (активность). Опция влияет только на рейтинги, у которых есть папка с логикой, поэтому чекбокс доступен только если у рейтинга указана папка (см. пункт 6). Если галочка стоит, то рейтинг будет ежесуточно пересчитываться. Если галочка не стоит, автоматический пересчет будет отключен. Поставьте галочку в данном чекбоксе после указания папки.
-
Автоначисл. (автоначисление). Опция влияет только на рейтинги, у которых есть папка с логикой, поэтому чекбокс доступен только если у рейтинга указана папка (см. пункт 6). Если галочка стоит, то по результатам данного рейтинга призерам будут ежемесячно начисляться баллы. Поставьте галочку в данном чекбоксе после указания папки.
-
Сорт. (сортировка). С помощью этого поля устанавливается порядок рейтингов в публичной части портала. Чем меньше индекс, тем выше будет расположен рейтинг в списке. Здесь можно указать любое целое число или оставить значение по умолчанию — 500.
-
Название параметра/Доп. рейтинга. В этом поле укажите название рейтинга. При необходимости любой рейтинг можно переименовать.
-
Папка с логикой расчета. В данном поле укажите папку с логикой пересчета для данного рейтинга, которую вы создали.
-
Коэфф. веса параметра. Это поле актуально только для рейтингов, у которых есть папка логики. Здесь указывается значимость рейтинга в Общем рейтинге. Чем выше коэффициент, тем больше веса имеет данный рейтинг при расчете позиции сотрудника в Общем рейтинга. Здесь можно указать любое число или оставить значение по умолчанию — 1. Если значение не задано, то данный рейтинг не будет учитываться в расчетах Общего рейтинга.
-
Описание параметра. В этом поле укажите описание рейтинга: для чего он предназначен, какие параметры учитывает и тому подобное. Это описание будет отображаться в публичной части портала.
-
Иконка. В данное поле можно загрузить изображение, которое станет иконкой рейтинга в публичной части портала. К загрузке доступны изображения в формате PNG, JPEG и SVG.
-
Участвуют в рейтинге. Эта настройка влияет на то, какие подразделения будут участвовать в рейтинге. Если выбраны все отделы или не выбраны никакие, то по умолчанию в рейтинге могут видеть все. Если выбрана часть отделов, то только их сотрудники смогут участвовать в рейтинге. Чтобы выбрать сразу несколько отделов зажмите Ctrl (⌘ Command на Mac) и кликните на все нужные названия.
-
Видят рейтинг. Эта настройка влияет на то, какие отделы компании могут видеть рейтинг в публичной части портала. Если выбраны все отделы или не выбраны никакие, то по умолчанию рейтинг могут видеть все. Если выбрана часть отделов, то только их сотрудники смогут видеть рейтинг. Чтобы выбрать сразу несколько отделов зажмите Ctrl (⌘ Command на Mac) и кликните на все нужные названия.
После заполнения всех полей сохраните изменения. Новый рейтинг появится в публичной части портала и в настройках рейтингов. Также для данного рейтинга будет автоматически создан агент пересчета. Созданный рейтинг будет автоматическим — каждые сутки он будет пересчитываться, а раз в месяц по нему будет производиться начисление баллов призерам.

















