FAQ¶
В данном разделе представлены часто задаваемые вопросы по технической реализации продукта VK People Hub.
| № | Категория вопроса | Вопрос | Ответ |
|---|---|---|---|
| 1 | Организационный | Как организовать доработку или разработку новой функциональной возможности VK People Hub? | Каждый запрос на доработку системы обсуждается с заказчиком индивидуально |
| 2 | Организационный | Совместимы ли разные версии VK People Hub между собой? | Обратная совместимость квартальных релизов не гарантируется. Нельзя брать часть компонентов из одного квартального релиза, а часть из другого |
| 3 | Организационный | Какова политика обратной совместимости релизов продукта? | Официально поддерживается только текущая актуальная квартальная версия решения,включая все минорные и патч-версии. LTS-версии не поддерживаются |
| 4 | Организационный | Как анонсируются новые релизы? | Новые релизы представляются во время проведения DemoDay. Сначала проходит внутренняя демонстрация, на которой решаются ключевые вопросы и вносятся предложения о доработках. За две недели до DemoDay для партнёров направляются приглашения на электронную почту. Предварительные даты проведения внутренних демо и демо для партнёров можно смотреть в публичной документации по ссылке |
| 5 | Организационный | Как анонсируются изменения функциональности? | Анонс изменений можно узнать из сообщения, которое прилагается к приглашению на DemoDay, более детально про изменения продукта можно узнать на самой встрече |
| 6 | Организационный | Как можно воспользоваться калькулятором сайзинга? | Калькулятор представляет собой Excel-таблицу с макросами. Мы предоставляем для партнёров доступ на чтение, а также инструкцию по использованию. На партнёров выдаётся доступ на одни адрес электронной почты представителя партнёра. Запрос на доступ осуществляется через вашего руководителя продаж на стороне VK. Калькулятор версионируется в соответствии с версией релиза продукта VK People Hub |
| 7 | Аутентификация | Вопросы доменной аутентификации: пользователь не может войти. В чём может быть проблема? | Скорее всего проблема на стороне внешнего IdP (например, AD или FreeIPA), если нет, то необходимо более подробное описание проблемы |
| 8 | Аутентификация | Вопросы доменная аутентификации: не работает беспарольный вход. Что делать? | Скорее всего проблема на стороне внешнего IdP (например, AD или FreeIPA). Возможно неправильно заданы настройки Keycloak. Если нет, то необходимо более подробное описание проблемы |
| 9 | База знаний | В базе знаний для ЛНА можно добавить реквизит – ссылка на Документ в 1С Документооборот в отдельное поле? | Нет возможности создавать дополнительные поля в базах знаний. Ссылку на документ можно разместить в комментариях к файлу |
| 10 | Безопасность | Есть ли журнал действий конкретного пользователя в системе? | Журнал действий конкретного пользователя расположен на ноде kubernetes, журнал пишется в stdout. Пример расположения журнала – /var/log/pods/develop_comments-7c9bbf8987/comments/0.log |
| 11 | Безопасность | Каким образом регистрируются события аудита? | События аудита регистрируются в общем логе событий. О настройке журналирования более подробно можно узнать в публичной документации |
| 12 | Безопасность | Как забирать в SIEM систему события аудита из продукта? | Интеграция с SIEM прорабатывается проектным архитектором или инженером внедрения. Должны учитываться все ограничения и требования со стороны информационной безопасности. В общем случае весь поток логов может быть получен из stdout сервиса (логи пода в терминологии kubernetes). Предпочтительный вариант – интеграция по протоколу syslog с использованием rsyslog |
| 13 | Геймификация | Как происходит настройка наград геймификации? | Настройки автоматического присвоение наград пока нет. Награды присваиваются администратором вручную в профиле пользователя |
| 14 | Геймификация | Как настраивается стоимость наград за коины в сервисе геймификации? | Инструкция по назначению коинов пользователю при выдаче награды в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 15 | Главная страница | Как настраивается главная страница – для всех сотрудников выглядит одинаково или могут быть разные главные страницы, например, в зависимости от департамента? Можно ли отключить возможность редактирования страницы конечным пользователем? | Навигационное меню в левой части страницы настраивается администратором. Настраивать можно только для всех пользователей портала. Дизайн портала настраивается также для всех пользователей |
| 16 | Главная страница | Настраивается ли список доступных виджетов для главной страницы? Если да, то как? | Пользователь может настраивать виджеты на главной странице. Инструкция по настройке виджетов на главной странице размещена в нашей публичной документации по ссылке |
| 17 | Главная страница | На главной странице ничего не отображается, она пустая. Что делать? | Настройте виджеты на главной странице по инструкции, размещённой в нашей публичной документации по ссылке |
| 18 | Группы и сообщества | Модерирование контента и постов – автоматическое, ручное, система жалоб, список стоп-слов? Может ли администратор удалять посты и группы? | Премодерация контента доступна в группах. Премодерация происходит пользователями с ролями: администратор группы, модератор, администратор системы (superuser). Администратор системы (superuser) может удалять любой пост в группе. Автоматической модерации нет |
| 19 | Группы и сообщества | Как создать пространство на портале, которое можно ограничить для других пользователей? | Необходимо создать закрытую группу и пригласить в неё только ограниченный круг сотрудников. Тогда у сотрудников появится закрытое файловое хранилище, галерея и пространство для общения |
| 20 | Дизайн | Как поменять цветовую схему и логотип на портале? | Ознакомиться с инструкцией по изменению дизайна можно в нашей публичной документации по ссылке |
| 21 | Дизайн | Как поменять значок веб-сайта или веб-страницы, отображаемый браузером во вкладке перед названием страницы, и в качестве картинки рядом с закладкой, а также в адресной строке в некоторых браузерах (favicon)? | Нет возможности поменять favicon в интерфейсе продукта VK People Hub |
| 22 | Дизайн | Как поменять название, отображаемое в браузере на вкладке? | Поменять название, отображаемое в браузере на вклдках, с помощью интерфейса продукта VK People Hub невозможно |
| 23 | Дизайн | Как поменять логотип на странице авторизации? | Инструкция по настройке страницы авторизации (кастомизации) в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 24 | Дизайн | Как поменять фон на странице авторизации? | Инструкция по настройке страницы авторизации (кастомизации) в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 25 | Дизайн | Как изменить наименование кнопки или сервиса? | В коробочной поставке VK People Hub возможности изменить наименование кнопки или сервиса нет |
| 26 | Дорожная карта | Где посмотреть дорожную карту продукта? | Актуальную дорожную карту на следующий квартал по продукту VK People Hub представляют при проведение DemoDay. Подробрее в разделе дорожная карта |
| 27 | Идеи | Как предложить идею и, что важно, получить по ней обратную связь? | Инструкция по созданию идей по развитию продукта VK People Hub размещена в нашей публичной документации по ссылке. После создания идеи вам на почту придёт письмо с номером зарегистрированной задачи по обработке вашей идеи |
| 28 | Интеграции | Есть ли обратная интеграция КЭДО -> Портал? | Обратной интеграции продукта КЭДО и продукта VK People Hub нет |
| 29 | Календарь | Как создаются переговорные? Можно ли делать переговорные доступными для выбора в зависимости от локации пользователя? | На портале создавать переговорные нельзя. Данные о переговорных загружаются в систему во время интеграции |
| 30 | Календарь | Что делать, если не отображается фотография переговорной при просмотре информации о переговорной? | Необходимо добавить картинку переговорной комнаты. Инструкция по настройке переговорной комнаты в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 31 | Курс валют и погода | Почему не работает динамика курса валют? | Отображение динамики курса валют не поддерживается продуктом VK People Hub, начиная с релиза 4 квартала 2023 года (версия продукта 3.60.1) |
| 32 | Курс валют и погода | Как настроить виджеты курса валют и погоды? | Отображение курса валют и погоды не поддерживается продуктом VK People Hub, начиная с релиза 4 квартала 2023 года (версия продукта 3.60.1) |
| 33 | Курс валют и погода | Как настроить виджет погоды по геолокации? Если пользователь из Санкт-Петербурга зашёл на портал, хотелось бы, чтобы ему отображалось состояние погоды Санкт-Петербурга | Отображение погоды не поддерживается продуктом VK People Hub, начиная с релиза 4 квартала 2023 года (версия продукта 3.60.1) |
| 34 | Новости | Есть разграничение видимости для новостей для разных организаций на одном портале? | Нельзя разделить видимость новостей между разными организациями в рамках одного продукта VK People Hub |
| 35 | Опросы | Какие возможности будут в сервисе опросы? | Сервис опросы на данный момент не реализован |
| 36 | Организационная структура | Можно ли создать несколько организационных структур для одной организации и загрузить их все через интеграцию? | Нет, доступно создание только одной организационной структуры для одной организации |
| 37 | Организационная структура | Требуется обзор возможности интеграции портала и методов интеграции. Нам нужен подробный ликбез, как это делается, какие поля можно подтягивать из HRM в профиль. Можно более подробно рассказать, как работать с json файлами? | Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 38 | Организационная структура | Каждый JSON-файл должен содержать информацию только об одном сотруднике или организационной единице? | Нет, в каждом JSON-файле может храниться список сотрудников. Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 39 | Организационная структура | Поясните, атрибуты parent_id, leader_keycloak_attribute_id для организаций, а keycloak_attribute_id для сотрудника? | parent_id – родительская организационная единица, leader_keycloak_attribute_id – keycloak_id руководителя для организаций, keycloak_attribute_id – keycloak_id cотрудника. Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 40 | Организационная структура | Реализация схемы интеграции со стороны продукта, когда SAML, т.е. пользователи в Keycloak не импортируются разом, а появляются при первом входе, т.о. интеграция никого не нашла в Keycloak и ни по кому не отработала. Что делать? | В полном объёме аутентификация через user-federation с использованием SAML/OIDC временно не поддерживается |
| 41 | Организационная структура | При использовании в Keycloak IdP сущность пользователя появляется в Keycloak, да и в продукте тоже, только после первого входа пользователя в портал. При таком поведении не представляется возможным выполнить импорт оргструктуры через json-файлы. В Keycloak я не нашел возможности принудительного импорта пользователей из IdP (ADFS, Azure). Даже если бы она была, это бы не создало сотрудника на портале. Вопрос: вы прорабатывали сценарий использования IdP? | Для IdP = LDAP необходимо совместное использование типовой интеграции оргструктуры |
| 42 | Персональная лента | Не обновляется лента событий. Что делать? | Необходимо почистить кеш браузера. Конкретные действия по очистке кеша зависят от браузера и описаны в его справочной документации. После очистки кеша необходимо обновить страницу и повторно пройти авторизацию в VK People Hub |
| 43 | Персональная лента | Изменил настройки ленты, но она не изменилась. Что делать? | Настройки ленты влияют только на будущие уведомления, уже существующие уведомления в ленте не изменяются |
| 44 | Персональная лента | Как разделять контент по организациям внутри одного портала? | Нельзя разделить видимость контента между разными организациями в рамках одного продукта VK People Hub |
| 45 | Персональная лента | Как создать баннер для каждой организации в одном портале, исходя из какой организации заходит пользователь? | Разделять видимость контента между разными организациями в рамках одного продукта VK People Hub нет возможности |
| 46 | Профиль | Можно ли изменять поля профиля – переименовывать, добавлять уникальные, удалять? | Нет, поля в профиле фиксированные |
| 47 | Профиль | Есть ли возможность массовой загрузки фото в профиль? | Нет |
| 48 | Профиль | Можно ли загружать пользователей и оргструктуру через портал? | Через портал загружать пользователей нельзя. Существующая функциональность позволяет только менять должности существующих пользователей. Загружать новых пользователей нужно через отдельный сервис Keycloak |
| 49 | Профиль | Совместители имеют один профиль или несколько? Могут ли они между ними переключаться, если несколько? | В коробочном решении нет функциональсти совместителей |
| 50 | Профиль | Что происходит с пользователем при увольнении? Полное удаление, блокировка, деактивация? Можно ли вручную деактивировать пользователя и активировать обратно? | Отдельной функции увольнения нет, можно заблокировать пользователя и потом однажды при необходимости разблокировать. Это делается через параметр в json-файле пользователя. Можно удалить пользователя из Keycloak, но восстановить его потом будет невозможно. Через портал активировать или деактивировать пользователя нельзя |
| 51 | Профиль | Как полностью удалить профиль? Настраиваются ли правила удаления профиля, например, удаление пользователя через 5 лет неактивности? | Полностью удалить профиль нельзя |
| 52 | Профиль | Настраивается ли модель данных для профиля или оргструктуры? | Нет, модель данных предоставляется как есть |
| 53 | Профиль | При повторном найме после увольнения создаётся новый профиль или активируется старый? | Если при увольнении пользователя удалили из Keycloak и при повторном найме завели заново, то будет новый профиль. Если при увольнении пользователя отключили через параметр в json-файле пользователя, то при повторном найме этого пользователя можно снова включить, используя тот же параметр в json-файле этого пользователя |
| 54 | Профиль | Какие идентификаторы есть у пользователей? | Идентификаторы сервиса Keycloak |
| 55 | Профиль | Что происходит с организационной структурой, если директор совмещает эту должность в нескольких юридических лицах? У него несколько профилей? | На портале одному пользователю нельзя быть сразу в нескольких организациях или подразделениях. В таком случае нужно создать несколько пользователей на портале и в Keycloak |
| 56 | Профиль | Сколько хранятся документы уволенного сотрудника? Имеет ли к ним доступ администратор системы (superuser)? Можно ли настроить правила удаления этих документов, например, полностью удалить через год? | Документы хранятся без возможности удаления |
| 57 | Профиль | Возможно ли изменить идентификатор внутри VK People Hub, по которому идёт привязка к Active Directory или другой системе, если они разные? | Нет, идентификатор не изменяется |
| 58 | Профиль | Удалили учётную запись пользователя из Keycloak, как её можно восстановить? | Восстановить учётную запись пользователя, удалённую из Keycloak, невозможно. При необходимости можно создать новую учётную запись |
| 59 | Профиль | Можно ли удалить пользователей навсегда, чтобы больше не отображались ни контент, ни сами профили, например, уволенного сотрудника? | Полностью удалить профиль невозможно |
| 60 | Профиль | Как переименовать поле, изменить тип поля (строку заменить на справочник), добавить новое поле, удалить или скрыть поле для отдельной роли? | Данные действия в продукте VK People Hub недоступны |
| 61 | Профиль | Как настроить обязательность полей в профиле? | Невозможно настроить обязательность полей в профиле |
| 62 | Профиль | Заложен ли механизм подтверждения подписки со стороны того, на кого подписываются? | Нет. Логика продукта не подразумевают использования элементов ЭДО или сложных процессов при взаимодействии людей, это сильно снижает вовлеченность и построение горизонтальных связей |
| 63 | Профиль | Нажимаю в профиле сотрудника на подразделение, но ничего не происходит. Как перейти в подразделение сотрудника? | Перейти в подразделение сотрудника можно в разделе Структура организации, найдя сотрудника по ФИО |
| 64 | Расширенный поиск | Есть поиск сотрудника по должности? | Есть поиск сотрудников по должности: в строке поиска в версии продукта, начиная с версии продукта 3.61.4 и в оргструктуре, начиная с версии продукта 3.61.4. Также начиная с версии 4.30.1 доступен фильтр по должности в расширенном поиске |
| 65 | Реакции | Можно ли отключить реакции? Можно ли редактировать список реакций? Можно ли добавить дополнительные реакции? | Реакции можно редактировать и добавлять в справочниках. Отключать реакции возможно в группах – как во всей группе, так и для отдельного поста в группе, в базе знаний, в идеях, новостях и микро-постах |
| 66 | Справочники | Как настраивается зависимость между справочниками, например, справочником станций метрополитена и справочником городов? | Станции метро (metro) закреплены за городами (city) посредством GUID города в json-файле метро. Чтобы узнать GUID города, нужно зайти в панель администратора Django |
| 67 | Справочники | Можно ли выгрузить справочники из VK People Hub? | Справочники выгружать нельзя |
| 68 | Структура организации | Как визуализировать организационную структуру, например, как дерево с возможностью отображения до определенного уровня оргструктуры (только руководители первого второго уровня)? | В рамках продукта VK People Hub предусмотрено отображение организационной структуры только в одном виде. Инструкция размещена в нашей публичной документации по ссылке |
| 69 | Структура организации | Как настроить поиск в организационной структуре по атрибутам пользователя: телефон, почта и т.д.? | На данном этапе развития продукта VK People Hub поиск возможен по следующим полям: ФИО или должность сотрудника, название или часть названия подразделения |
| 70 | Структура организации | Где найти справочника сотрудников в табличной форме, с возможностью настроить отбор (организация, подразделение)? | В продукте VK People Hub отсутствует правочник сотрудников в табличной форме с фильтрами |
| 71 | Структура организации | В организационной структуре в подразделении невозможно увидеть всех сотрудников, необходимо их раскрывать через "+", а нужен весь список. Что делать? | В сервисе Структура организации возможен просмотр только должности, затем сотрудников |
| 72 | Структура организации | Как загрузить организационную структуру? | Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке. Инструкция по загрузке организационной структуры через административную панель продукта VK People Hub размещена в нашей публичной документации по ссылке |
| 73 | Структура организации | Что такое keycloak_attribute_id в json с пользователями и откуда его взять? | Keycloak_attribute_id это параметр в json с пользователями, который необходимо заполнить при составлении json. Заполняется последовательными уникальными номерами, начиная со значения 100. Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 74 | Структура организации | Как разместить json с пользователями/подразделениями/организациями в Airflow? | Инструкция по загрузке организационной структуры через интеграцию в продукте VK People Hub размещена в нашей публичной документации по ссылке |
| 75 | Уведомления | Присылает ли система пользователям уведомления по почте? Если да, где можно найти список уведомлений и редактируется ли текст? | Уведомления отправляются только внутри портала. Редактора уведомлений внутри портала нет |
| 76 | Уведомления | Уведомления из Outlook в панель уведомлений можно добавить? | Получать уведомления из Outlook в колокольчик продукта VK People Hub невозможно |
| 77 | Уведомления | Есть ли интеграция с Телеграм, боты, как в КЭДО? | Через Публичное API Телеграм-бот может забирать любые нужные данные в пределах возможностей API. Первая alfa версия публичного API будет представлена на демо 19/24 апреля 2024 года |
| 78 | Уведомления | Если подписываюсь на человека, то приходит уведомление о его дне рождения? Можно отдельно на день рождения подписаться? | В продукте VK People Hub не предусмотрено уведомление о дне рождения пользователя, на которого вы подписаны |
| 79 | Файловое хранилище | Можно ли поделиться ссылкой на папку или файл с внешним неавторизованным пользователям? | Ссылки на папки и файлы доступны только пользователям, прошедшим авторизацию на портале |
| 80 | WidgetSDK | Как можно дополнить имеющиеся виджеты новыми, используя средства, указанные в требованиях к команде разработки (React, Antd)? | Разработка новых виджетов производится с использованием WidgetSDK. Возможность появится после релизов второго или третьего кварталов 2024 года. Инструкции для разработчиков будут доступны в публичной документации |
| 81 | WidgetSDK | Как нужно будет дополнять микросервисы для добавления виджетов? | Запрещено вносить изменения в существующий код микросервисов продукта. Более подробные инструкции для разработчиков будут доступны в публичной документации |
| 82 | Диагностика и исправление неисправностей | Ошибка 401 при заходе на портал. Что это означает и что делать? | Ошибка 401 – ошибка при создании UserProfileKeycloak. Существует другой пользователь с таким именем пользователя (username). Чаще всего это происходит, когда пользователя добавили в сервис KeyCloak, потом удалили и создали заново с таким же username. Для исправления ошибки нужно удалить пользователя из KeyCloak и опять создать, но с новым уникальным username. Подробрее диагностика и исправление неисправностей |
| 83 | Диагностика и исправление неисправностей | При попытке зайти в созданное файловое хранилище система выдаёт ошибку – Файловое хранилище еще не создано | Ошибка возникает из-за того, что сервис создания личного файлового хранилища ещё не обработал учётную запись данного пользователя из KeyCloak. Обработка происходит раз в час. Поэтому повторите попытку зайти в личное файловое хранилище через час. Подробрее диагностика и исправление неисправностей |
| 84 | Диагностика и исправление неисправностей | Истёк срок действия токена – token expire. Что делать? | Для решения проблемы нужно обновить портал (нажать кнопку F5) или, в случае неудачи, точечно получить новый токен из KeyCloak. Подробрее диагностика и исправление неисправностей |
| 85 | Диагностика и исправление неисправностей | Ошибка 403 при получении токена. Что делать? | нужно убедиться, что в переменных окружения стоит верная audience, realm и KEYCLOAK_API_BASE_URL (адрес KeyCloak). Подробрее диагностика и исправление неисправностей |
| 86 | Диагностика и исправление неисправностей | Возникла ошибка при попытке загрузить файл. Что делать? | При попытке загрузить файл куда-либо внутри портала может возникнуть ошибка – Размер файла очень большой. Для её исправления необходимо выставить правильный максимальный размер файла. По умолчанию максимальный размер файла для загрузки на портал – 2Гбайта. Подробрее диагностика и исправление неисправностей |
| 87 | Диагностика и исправление неисправностей | Что делать, если Kafka брокер не запускается из-за нехватки памяти? | Необходимо увеличить параметр Xmx в heapOpts: -Xmx1024m -Xms1024m.Необходимо увеличить лимиты ресурсов в values helm chart. Подробрее диагностика и исправление неисправностей |
| 88 | Диагностика и исправление неисправностей | Если продюсер не может отправить сообщения на топик из-за ограничений по размеру сообщения, что делать? | Необходимо увеличить параметр message.max.bytes в конфигурации топика или продюсера. Подробрее диагностика и исправление неисправностей |
| 89 | Диагностика и исправление неисправностей | Когда Minio сервер выдает ошибку Access Denied при попытке доступа к объектам, что делать? | Необходимо проверить корректность настроек доступа, включая правильные ключи доступа и секреты. Подробрее диагностика и исправление неисправностей |
| 90 | Диагностика и исправление неисправностей | Что делать при недоступности Minio сервера из-за неправильной конфигурации ingress в Kubernetes? | Необходимо проверить настройки Ingress и убедиться, что сервис Minio правильно доступен извне. Подробрее диагностика и исправление неисправностей |
| 91 | Диагностика и исправление неисправностей | Система выдаёт ошибку Connection refused при попытке подключения к PostgreSQL. Что можно предпринять? | Необходимо проверить правильность настроек подключения к PostgreSQL, убедиться, что указан правильный хост и порт. Проверить доступность базы данных и состояние контейнера PostgreSQL. Подробрее диагностика и исправление неисправностей |
| 92 | Диагностика и исправление неисправностей | Что я могу предпринять, если произошёл сбой при обновлении базы данных из-за отсутствия места на диске? | Необходимо освободить место на диске или увеличить размер данных на сервере. Подробрее диагностика и исправление неисправностей |
| 93 | Диагностика и исправление неисправностей | Чта делать, если Redis сервер периодически отключается из-за истечения времени жизни соединения? | Необходимо увеличить таймаут на соединение в конфигурации Redis. Подробрее диагностика и исправление неисправностей |
| 94 | Диагностика и исправление неисправностей | Что делать в ситуации, когда появляется ошибка аутентификации пользователей из-за неправильной конфигурации клиентского приложения? В ответах API запроса сервиса Отсутствует токен в запросе или Неверный токен | Необходимо проверить настройки клиентского приложения в Keycloak и убедиться, что они совпадают с конфигурацией на сервере (jwt_pub_token или keycloak_audince). Подробрее диагностика и исправление неисправностей |
| 95 | Диагностика и исправление неисправностей | Как можно решить проблемы с обновлением паролей пользователей через Keycloak? | Необходимо пересмотреть настройки политики паролей и прав доступа к изменению паролей. Подробрее диагностика и исправление неисправностей |