Конструктор полей

На этой странице мы расскажем вам о работе с конструктором полей и разберем следующие вопросы:

Что такое Конструктор полей

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

Используя этот функционал, администратор может добавлять, удалять и редактировать поля, указанные в профилях пользователей. Любые изменения полей также влияют как на импорт пользователей, так и на экспорт отчётов - в файлы добавляются соответствующие поля (подробнее описано ниже).

Как найти Конструктор полей

Для доступа к Конструктору полей в Административной части найдите раздел "Пользователи" и выберите пункт "Конструктор полей", откроется основная страница Конструктора.

Как выглядит список полей

На основной странице отображается список существующих полей.

Над ним расположен блок с чек-боксами фильтрации и полем поиска. Тут же расположена кнопка Добавить, для создания нового поля.

Страница со списком полей

(1) Кнопка "Добавить поле"; (2) Чек-боксы фильтрации полей по меткам; (3) Поле Поиск; (4) Список массовых действий и кнопка Выполнить; (5) Чек-бокс "Выбрать все";
(6) Столбец ID поля; (7) Столбец Название поля; (8) Столбец Тип поля; (9) Столбец Метки

Фильтры:

  • Профиль – будут выбраны поля, которые выводятся в профиль пользователя

  • Импорт – будут выбраны поля, которые выводятся в файл импорта пользователей

  • Отчёты – будут выбраны поля, которые выводятся в отчёты

  • Доступы – будут выбраны поля, которые используются для настройки доступов к материалам

  • Фильтры – будут выбраны поля, которые выводятся в пользовательских фильтрах

Фильтрация с помощью чек-боксов работает по логике И: при выборе фильтров "Профиль" + "Импорт" будут отобраны поля, которые выводятся в профиль И в файл импорта пользователей.
Поля фильтруются после выбора чек-боксов и нажатия кнопки Применить.

В списке у каждого поля отображаются:

Для выполнения массовых действий выберите отдельные строки с помощью чек-боксов, расположенных в начале строки, или все строки чек-боксом "Выбрать все" (5), выберите действие из списка и нажмите “Выполнить”.

По умолчанию все чек-боксы массовых действий и список действий неактивны. Выбор действия возможен после выбора любого чек-бокса массовых действий.

Возможные действия:

Какие типы полей существуют

На портале бывают поля:

  • Пользовательские — это поля, созданные администратором с помощью конструктора полей. Такие поля можно удалять, в них можно менять любые настройки. В них полях можно задать любой тип поля - см. таблицу ниже.

  • Системные — это поля "по умолчанию", они присутствуют на каждом портале и их невозможно удалить. У любых полей можно менять Название и Иконку. Другие настройки и их доступность отличаются для разных полей "по умолчанию". В такие полях нельзя вручную задать тип поля - у них установлен тип поля “Системный” и его нельзя изменить.

Для каких полей может быть установлен

Тип поля

Описание

Пример поля

Пример вида в публичной части: редактирование ЛК

Пример вида в публичной части: просмотр ЛК

Для каких полей может быть установлен

Тип поля

Описание

Пример поля

Пример вида в публичной части: редактирование ЛК

Пример вида в публичной части: просмотр ЛК

Пользовательские поля

Однострочное (по умолчанию)

  • Однострочное поле ввода текста

  • До 255 символов

Должность

Многострочное

  • Многострочное поле ввода текста

  • До 1000 символов

Важно! Поле с таким типом не выводится в пользовательские фильтры (если в конструкторе полей отмечены как выводимые в фильтры) и не выводится в Доступы

О себе

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

  • Доступен только единичный выбор

  • Для системных полей в список выбора попадают значения, заданные в системе

  • В файле импорта для каждого пользователя должно быть введено значение этого поля.  Из всех  уникальных значений этого поля в файла импорта пользователей формируются значения этого списка выбора в публичной части. 

  • Пример: пользовательское поле "Филиал" с типом "выпадающий список". В файле импорта есть 3 пользователя, у первого поля заполнено значением "Центральный", у второго и третьего - значением "Московский". В публичной части поле "Филиал" будет списком выбора из двух значений - Центральный, Московский.

Город

Дата

  • В публичной части формат поля ДД.ММ.ГГГГ

Важно! Поля с таким типом выводятся в пользовательские фильтры (если в конструкторе полей отмечены как выводимые в фильтры) и не выводятся в Доступы

Дата

Логический тип

  • В публичной части отображается как поле со значением Да/Нет

  • В публичной части в режиме редактирования отображается как свитчер

  • В панели администрирования в карточке пользователя отображается как чекбокс

-



Пользователи

  • В публичной части выпадающий список из всех активных не скрытых пользователей портала

  • В файле импорта в поле с типом "Пользователи" должен быть введен e-mail активного пользователя портала

Руководитель

Числовой

  • В публичной части и в файле импорта должно содержаться целочисленное значение:

    • Для ввода доступны только цифры 0-9

    • Точки, запятые, точки с запятыми и любые другие символы не допускаются

  • Если введено число с ведущими нулями (например, 000051254), нули отбрасываются и в системе сохраняется только целочисленное значение (51254)

-

Системные поля

Системный

Для системных полей тип поля предзадан в системе и его нельзя изменить



Соцсети

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

Важно: тип поля задается в момент создания поля, у созданного поля нельзя редактировать его тип. Если вам нужно изменить тип поля, удалите старое поле с неверным типом и создайте новое поле с верным типом поля.

Пользовательские поля и их особенности

Пользовательские — это поля, созданные администратором с помощью конструктора полей. Такие поля можно удалять, в них можно менять любые настройки. В этих полях можно задать любой тип поля - см. таблицу выше.

Название поля

Тип поля

Файл импорта

Обязательность поля

Профиль

Редактируемость

Настройка видимости

Отчёт

Фильтр

Доступ

Ограничение на количество символов

Ограничение значения

Заполняется пользователем

Заполняется пользователем

Список выбора с типом поля, см. возможные варианты типов пользовательских полей в списке в таблице выше.

По умолчанию выбран тип "Однострочное".

×

×

×

×

×

×

×

×

1000

 

Системные поля и их особенности

Системные — это поля "по умолчанию", они присутствуют в каждом портале и их невозможно удалить. У любых полей можно менять Название и Иконку. Другие настройки и их доступность отличаются для разных полей "по умолчанию" - см. таблицу. В такие полях нельзя вручную задать тип поля - у них установлен тип поля “Системный” и его нельзя изменить.

Название поля

Пример заполнения

Тип поля

Файл импорта

Обязательность поля

Профиль

Редактируемость

Настройка видимости

Отчёт

Фильтр

Доступ

Ограничение на количество символов

Ограничение значения

Название поля

Пример заполнения

Тип поля

Файл импорта

Обязательность поля

Профиль

Редактируемость

Настройка видимости

Отчёт

Фильтр

Доступ

Ограничение на количество символов

Ограничение значения

Имя

Иван

Системное

×

×

×

24



Фамилия

Иванов

Системное

×

×

×

32



Отчество

Иванович

Системное

×

×

×

×

×

×

×

×

32



Логин

ivanov

Системное

×

×

×

×

×

×

×

×

32

Только цифры, латиница и знак "_"

Пол

1

Системное

×

×

×

×

×

×

×



Для мужского пола - 1, М, Муж, Мужской, а для женского пола - 0, Ж, Жен, Женский

Признаки видимости

роп

Системное

×

×

×

(неактивно и заблокировано)

×

(неактивно и заблокировано)

×

(неактивно и заблокировано)

×

×

(неактивно и заблокировано)

×

×

Максимум символов для одного признака — 100.

Может содержать символы: a-z, а-я, 0-9, пробелы, спецсимволы кроме , и ;

Все признаки автоматически приводятся к нижнему регистру.

Внешний идентификатор

123456789bfgfgtrt

Системное

×

×

×

(неактивно и заблокировано)

×

(неактивно и заблокировано)

×

(неактивно и заблокировано)

×

×

(неактивно и заблокировано)

×

×

Максимум символов — 255

Может содержать символы: a-z, а-я, 0-9, спецсимволы

Значение должно быть уникальным (не повторяться у других пользователей)

Email

ivanov@example.com

Системное


(доступно для редактирования)


(доступно для редактирования)

×

×

×

×

255

Стандартный имейл вида *@*.*

Мобильный телефон

+7 987 654-32-10

Системное

×

×

×

×

×

×

× (недоступно для редактирования)

×

15

По международной маске

Используется для идентификации пользователя в Telegram и отображения основного номера на платформе

Дополнительный телефон

8987654321

Системное

×

×

×

×

×

×

×

×



Используется для отображения дополнительного номера на платформе

Дата рождения

01.12.70

Системное

×

×

×

×

×

×

×

×

дд.мм.гг

Только цифры

Город

Москва

Системное

×

×

×

×

×

×

×

×



Должно быть совпадение с городом из базы данных. При необходимости, можно добавить новый город

Адрес

ул. Тверская, д. 1, кв. 1

Системное

×

×

×

×

×

×

×

×

1000



Отдел

Менеджмент

Системное

×

×

×

×

×

×

×

255

Должно соответствовать файлу структуры

У одного пользователя может быть указано несколько отделов (через ; без пробелов, например: QA;IT;Менеджмент). При этом в публичной части (в ЛК, рейтинге и т.д.) отображаются все отделы пользователя через запятую. Если поле выводится в отчёты, в отчётах отображаются все отделы пользователя через запятую

Важно: при импорте пользователей поле "Отдел" может быть заполнено Id или названием отдела. При импорте по названию название отдела должно быть уникальным, иначе отобразится ошибка.

Должность

Менеджер

Системное

×

×

×

×

×

×

×

×

255



Работает с

01.12.80

Системное

×

×

×

×

×

×

×

×
(неактивно и заблокировано)

дд.мм.гг

Только цифры

Дата увольнения

01.12.90

Системное

×

×

×

×

×

×

×

дд.мм.гг

Только цифры

Руководитель

petrov@example.com

Системное

×

×

×

×

×

×

×

×

255

Стандартный имейл вида *@*.* Должно быть совпадение с полем "Почта" существующего на портале пользователя

Роли

Администратор

Системное

×

×

×

×

×



Импорт может быть выполнен только если указанная роль существует на портале.  При импорте пользователя в уже созданную роль, пользователь импортируются в нее.
При импорте пользователя с новым значением в поле Роль система выдает ошибку.

У одного пользователя может быть указано несколько ролей.
Важно: роли необходимо перечислять через запятую, без пробелов.

Пример: Роль1,Роль2,Роль3

Образование

Высшее

Системное

×

×

×

×

×

×

×

×

1000



Достижения

Президентский грант для главного проекта фирмы

Системное

×

×

×

×

×

×

×

×

1000



Интересы

Охота, рыбалка, компьютерные игры

Системное

×

×

×

×

×

×

×

×

1000



Компетенции

Всевозможные

Системное

×

×

×

×

×

×

×

×

1000



О себе

Скромность украшает

Системное


×

×

×

×

×

1000



Соцсети

vk.com/user1

Системное

×

×

×

×

×

×

 

 

Наставник

petrov@example.com

Системное

×

×

×

×

×

×

×

×

 

 

 

Легенда:



×

Настройка выключена

Настройка включена



Настройку нельзя изменить

Как изменить порядок полей

Если навести курсор на поле в списке, отобразится также индикатор жеста "перетаскивание" (англ. "drag'n'drop"). При клике и удержании клавиши мыши нажатой можно перетаскивать поля по списку.

 

Отображение индикатора жеста "перетаскивание" в списке полей

Порядок столбцов в шаблоне файла импорта и отчёте будет соответствовать порядку полей в этом списке. Порядок полей в Личном кабинете и Профиле пользователя в Публичной части меняется только для созданных администратором полей.

Как сохранить список полей и их порядок для Публичной части и файла импорта\отчёта

Чтобы новое поле стало отображаться в Публичной части и применилось для файла импорта и отчёта, на экране со списком полей необходимо нажать на кнопку "Сохранить".

Чтобы отменить изменения, сделанные на экране со списком полей, необходимо нажать на кнопку "Отменить" (до сохранения списка).

Кнопки "Сохранить" и "Отменить" находятся внизу страницы.

Как создать поле

Чтобы начать создание поля, необходимо кликнуть по кнопке "Добавить поле", при этом откроется экран создания поля.

На странице создания поля администратор может задать настройки будущего поля. Список настроек для полей:

  • Иконка - определяет, какая иконка будет отображаться рядом с полем в Профиле и Личном Кабинете пользователя

  • Название поля - определяет название поля

  • Файл импорта - определяет, будет ли поле отображаться в файле импорта

  • Обязательность поля - определяет, необходимо ли иметь поле в файле для успешного импорта

  • Профиль - определяет, выводится ли это поле в Личный кабинет пользователя на портале

  • Редактируемость - определяет, может ли пользователь редактировать поле в ЛК

  • Настройка видимости - определяет, может ли пользователь регулировать в ЛК, скрывать или нет поле для отображения в Профиле

  • отчёт - определяет, выводится ли поле в отчёты. Также при создании отчётов доступна фильтрация по всем полям со включенной настройкой "отчёты".

  • Фильтры - определяет, выводится ли поле в пользовательские фильтры (в отчётах, а также в различных модулях портала с фильтрацией по пользователям - Справочник сотрудника, Индекс счастья и т.п.)

    • Важно! Поля с типом Многострочное не выводятся в пользовательские фильтры

  • Доступ - определяет, выводится ли поле в Доступы

Если на странице админпанели Oauth /admin/system/auth поле конструктора выбрано в качестве:

  • Уникального идентификатора

  • Способа авторизации

  • Способа авторизации + Уникального идентификатора

то в Конструкторе полей у этого поля становятся включенными и недоступными для редактирования свитчеры Файл импорта и Обязательно.

Для свитчеров выводятся соответствующие подсказки о причине недоступности.

Все настройки, кроме полей Иконка и Название поля, представляют из себя переключатели. Переключатель может находится в двух состояниях ("включена" и "выключена") и в двух статусах (активно и неактивно).

— пример включенного активного переключателя. Такой переключатель можно выключить.

— пример включенного неактивного переключателя. Такой переключатель нельзя выключить.

— пример выключенного активного переключателя. Такой переключатель можно включить.

— пример выключенного неактивного переключателя. Такой переключатель нельзя включить.

Если статус настройки активный, администратор может изменять состояние по своему желанию, если статус неактивный - администратор не может изменять состояние настройки. Неактивный статус есть только у настроек для полей "по умолчанию", созданные администратором поля можно изменять как угодно, по желанию администратора.

Чтобы создать поле, после задания настроек, необходимо нажать на кнопку "Сохранить". Чтобы отменить создание поля, необходимо нажать на кнопку "Удалить". Они находятся внизу страницы.

Как отредактировать поле

Чтобы отредактировать существующее поле, необходимо нажать на кнопку "Настроить" в строке нужного поля на странице со списком полей. При этом откроется страница, идентичная созданию поля, кроме того, что кнопка "Удалить" заменена кнопкой "Сбросить настройки", которая отменяет изменения настроек, но не удаляет поле.

Важно! Удалить или Сбросить настройки невозможно, если наименование данного поля установлено в качестве значения поля “Уникальный идентификатор“ на странице Системное - Настройки системы | /admin/system/settings

Особенности редактирования системного поля Почта

Свитчеры Файл импорта и Обязательно по умолчанию включены и доступны для редактирования. При включении / выключении свитчеров работают по стандартным механикам описанным в https://motivityy.atlassian.net/wiki/spaces/Documentation/pages/5735591#%D0%9A%D0%B0%D0%BA-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D1%82%D1%8C-%D0%BF%D0%BE%D0%BB%D0%B5

Также:

  • Когда свитчер Файл импорта выключен , то почта не выводится в списке возможных уникальных идентификаторов на странице админпанели Oauth /admin/system/auth и следовательно не может быть выбрана в качестве уникального идентификатора на платформе.

  • Когда свитчер Обязательно:

    • Включен, то заполнение почты на платформе обязательно для всех пользователей и почта выводится на платформе в данных пользователей.
      Так как поле будет заполнено у всех, то оно доступно для выбора в качестве Уникального идентификатора на странице админпанели Oauth /admin/system/auth

    • Выключен, то заполнение почты для пользователей возможно, но необязательно. У пользователей, у которых почта заполнена, она выводится на платформе, если не заполнена — не выводится.
      Так как поле может быть у кого-то незаполнено, то оно не появится в списке возможных уникальных идентификаторов на странице админпанели Oauth /admin/system/auth и следовательно не может быть выбрана в качестве уникального идентификатора на платформе.
      Также чек-бокс двухфакторной авторизации становится пуст и недоступен для редактирования.

Если на странице админпанели Oauth /admin/system/auth почта выбрана в качестве:

  • Уникального идентификатора

  • Способа авторизации

  • Способа авторизации + Уникального идентификатора

то в Конструкторе полей у поля почты становятся включенными и недоступными для редактирования свитчеры Файл импорта и Обязательно.

Для свитчеров выводятся соответствующие подсказки о причине недоступности.


Обучающее видео