Инструкция по внедрению Synergy Knowledge¶

Первоначальная настройка¶

Настройки для портала¶

Прописать логин и пароль системного пользователя для Knowledge в файле /opt/synergy/jboss/standalone/deployments/lms.war/init.js:

var _SYNERGY_ACCESS_LOGIN_ = 'knowledge_login';
var _SYNERGY_ACCESS_PASS_ = 'knowledge_password';

Также необходимо проверить, что в файле /etc/nginx/sites-enabled/synergy-base настроен доступ к порталу:

location ~* /kw {
    proxy_pass          http://127.0.0.1:8080;
}

Install/upgrade configuration¶

Добавить системного пользователя в группу HCM полный доступ.
Проверить, что группе пользователей HCM полный доступ предоставлены все права на реестры.
Проверить корректность URL до Synergy в настройках внешнего модуля LMS.
Прописать логин и пароль системного пользователя в настройках всех скриптов интерпретатора:
- event.blocking.interpreter.changeSkills
- event.blocking.interpreter.courseCompleted
- event.blocking.interpreter.fill.courseUsers
- event.blocking.interpreter.matching.result_approve
Создать 2 пункта меню кнопки «Создать»:
- Карточка пользователя
  - код: hcm_create_userCard
  - реестр: «Карточка пользователя»
  - галочка «Добавить в «Избранное» пользователя по умолчанию» включена
  - права: автогруппе «ROOT»
- Сформировать ИПР
  - код: hcm_create_idp
  - реестр: «ИПР»
  - галочка «Добавить в «Избранное» пользователя по умолчанию» включена
  - права: автогруппе «ROOT»

Manual¶

Импортировать приложение Knowledge из архива /opt/synergy/apps/knowledge/app-knowledge.7zip.
Подсказка
1. При импорте приложения рекомендуем руководствоваться документацией.
2. Если на сервере уже был установлен продукт, следует сверить номера версий приложения в архиве и на сервере, при необходимости нужно увеличить номер версии в архиве.
Добавить системного пользователя в группу HCM полный доступ.
Проверить, что группе пользователей HCM полный доступ предоставлены все права на реестры.
Заменить URL до Synergy в настройках внешнего модуля knowledge.
Прописать логин и пароль системного пользователя в настройках всех скриптов интерпретатора:
- event.blocking.interpreter.changeSkills
- event.blocking.interpreter.courseCompleted
- event.blocking.interpreter.fill.courseUsers
- event.blocking.interpreter.matching.result_approve
Создать 2 пункта меню кнопки «Создать»:
- Карточка пользователя
  - код: hcm_create_userCard
  - реестр: «Карточка пользователя»
  - галочка «Добавить в «Избранное» пользователя по умолчанию» включена
  - права: автогруппе «ROOT»
- Сформировать ИПР
  - код: hcm_create_idp
  - реестр: «ИПР»
  - галочка «Добавить в «Избранное» пользователя по умолчанию» включена
  - права: автогруппе «ROOT»
В Kibana создать следующие шаблоны индексов:
- r-hcm_registry_usercards_custom
- r-hcm2_registry_competence
- r-hcm_registry_idp

В шаблоне индексов r-hcm_registry_usercards_custom добавить следующие Scripted fields:

course_finished

language: painless;
type: number;

script:

int fvalue=0;
if (doc['hcm_form_userCard_status_key.keyword'].value == '2' ||  doc['hcm_form_userCard_status_key.keyword'].value == '3') {
   fvalue=1;
}
return fvalue;

user_certified

language: painless;
type: number;

script:

int tvalue=0;
if (doc['hcm_form_userCard_certified_key.keyword'].value == '1') {
   tvalue=1;
}
return tvalue;

Проверить, что установлен плагин Kibana gauge (имеется непустая папка /usr/share/kibana/plugins/gauge-sg).

Примечание

При необходимости установить плагин самостоятельно по ссылке.
Импортировать визуализации из файла /opt/synergy/apps/knowledge/knowledge_visualizations.json.
Импортировать дашборды из файла /opt/synergy/apps/knowledge/knowledge_dashboards.json.

Подсказка

Дополнительные подробности доступны в подробной документации о Kibana.

Вариант установки «Clean»: настройки системы¶

Настройки, автоматически установленные в подсистеме администрирования¶

Во-первых, созданы следующие пользователи:

Администратор (с ролями «Администратор» и «Разработчик Synergy», логин/пароль: 1/1)
Системный Пользователь (с ролями «Администратор» и «Разработчик Synergy», логин/пароль: hcm_service_user/1)

Во-вторых, заведена следующая орг.структура:

ROOT (подразделение, руководитель Администратор)
- Системный пользователь (должность, назначен Системный Пользователь)

Настройки, автоматически установленные в конфигураторе¶

Во-первых, импортировано приложение Knowledge.

Во-вторых, созданы следующие группы пользователей:

HCM полный доступ (Системный Пользователь)
HCM частичный доступ

В-третьих, созданы 2 пункта меню кнопки «Создать»:

Карточка пользователя
- код: hcm_create_userCard
- реестр: «Карточка пользователя»
- галочка «Добавить в «Избранное» пользователя по умолчанию» включена
- права: автогруппе «ROOT»
Сформировать ИПР
- код: hcm_create_idp
- реестр: «ИПР»
- галочка «Добавить в «Избранное» пользователя по умолчанию» включена
- права: автогруппе «ROOT»

Добавление контента¶

Общий порядок добавления нового контента в систему:

создать каталог обучающих курсов;
добавить в каждый курс Итоговое задание;
создать группы курсов;
создать каталог Профилей обучения, указать обязательный набор курсов;

Дополнительные возможности:

создать тестовые вопросы;
создать карточки пользователей

Реестры, в которых данные формируются исключительно автоматически:

«Анкета эффективности курсов»
«ИПР»
«История прохождения курсов»

Настройки портала обучения¶

По умолчанию портал доступен по адресу <host>:<port>/knowledge.

URL витрины регулируется именем соответствующего файла war в папке /opt/synergy/jboss/standalone/deployments. Для изменения URL необходимо:

указать новое имя для файла kw.war
в конфигурации nginx /etc/nginx/sites-enabled/synergy-base изменить location для портала. Пример настройки для нового имени academy:
location /academy { proxy_pass http://127.0.0.1:8080/; }

Портал содержит следующие основные страницы:

Авторизация
«Профиль»
«Мои курсы»
«Все курсы»
«Библиотека»
Страница курса

Страницы «Профиль», «Мои курсы» и «Библиотека» берут значения из записи реестра «Карточка пользователя», соответствующей авторизованному пользователю. Страница «Все курсы» - из реестров «Группы курсов» и «Обучающие курсы». Страница курса - из реестра «Обучающие курсы».

Авторизация¶

Страница авторизации содержит следующую форму ввода:

«Логин»
«Пароль»
Кнопка входа в портал

Авторизация произойдет успешно только при одновременном выполнении следующих условий:

пользователь назначен на одну из должностей в оргструктуре
на хосте имеются все реестры из списка:
- «Уроки» (код kw_registry_tasks)
- «Обучающие курсы» (код kw_registry_course)
- «Группы курсов» (код kw_registry_courseGroups)
- «История прохождения курсов» (код kw_registry_course_history)
- «Профиль обучения» (код kw_registry_trainingProfile)
- «Карточка пользователя» (код kw_registry_userCards)
- «ИПР» (код kw_registry_idp)
в реестре «Профиль обучения» имеется запись, поле kw_form_position_choice которого совпадает с должностью авторизующегося пользователя
если в реестре «Карточка пользователя» еще нет записи, система предлагает создать Карточку пользователя

Авторизация¶

Страница авторизации содержит следующую форму ввода:

«Логин / E-mail»
«Пароль»
Кнопка перехода к странице авторизации

Профиль¶

В профиль попадают все поля из статической таблицы kw_form_userCard_profile. Новое поле таблицы необходимо добавлять наподобие уже добавленных в неё полей:

задать имя основному компоненту
добавить отдельный компонент для лейбла, задать ему имя в формате имя_основного_компонента-label

После полей профиля отображается кнопка выхода на страницу авторизации.

Мои курсы¶

Страница делится на 2 категории:

обязательные курсы (автоматически формируемый список на основе должности пользователя): из динамической таблицы kw_form_userCard_competenceTable
дополнительные курсы (добавленные пользователем вручную): из динамической таблицы kw_form_userCard_competenceTable_other

Для каждого курса отображается его фоновая картинка, название, статус, прогресс прохождения (при наличии), при наведении на плашку дополнительно - автор.

Все курсы¶

Страница содержит список всех курсов в двух видах:

сгруппированный список
сплошной список

Для каждой группы курсов отображается ее фоновая картинка, количество курсов в группе, название, описание.

Для каждого курса отображается его фоновая картинка, название, статус, прогресс прохождения (при наличии), при наведении на плашку дополнительно - автор.

Библиотека¶

На страницу библиотеки попадают файлы / ссылки из динамической таблицы kw_form_userCard_books.

Страница курса¶

Страница содержит 2 блока:

содержание курса (список уроков)
описание курса / содержимое выбранного урока

Содержание и содержимое уроков считывает данные из соответствующего реестра.