Документация ICMS 1.0 Help

Типы пользовательских полей

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

Строка

Простое поле, в котором участник может ввести текстовую информацию, например, номер телефона или паспортные данные. Поддерживается проверка формата вводимых данных с помощью регулярных выражений, а также ограничение минимальной и максимальной длины вводимого текста.

Примеры часто используемых регулярных выражений:

  • Разрешение ввода только кириллицы, пробела и дефиса: ^[А-ЯЁа-яё -]*$;

  • Номер телефона в формате +79001234567: ^\+79\d{9}$;

  • СНИЛС в формате 123-456-789 10: ^\d{3}-\d{3}-\d{3}[- ]\d{2}$.

Подробнее про регулярные выражения можно почитать здесь: https://learn.javascript.ru/regular-expressions.

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

Текстовое поле с особым поведением: отчество с ключом middleName, оно будет иметь галочку У меня нет отчества.

Логический

Галочка (или чекбокс), которую пользователь может отметить, например, согласие на обработку персональных данных. Если такое поле является обязательным, то галочку нужно обязательно поставить.

Специальных опций и проверки корректности такого типа пользовательских полей не предусмотрено.

Список

Список из нескольких заранее заданных пунктов, из которых нужно выбрать один или несколько, например, текущий класс или курс. Этот тип разделяется на два типа, Список (один вариант) и Список (несколько вариантов).

Пункты списка настраиваются в поле Опции. В нём для каждого пункта нужно указать его ключ (системное название пункта, которое будет сохраняться в системе) и название (оно будет отображаться в интерфейсах участника и администратора). Галочка Показывать участникам отвечает за то, будет ли отображаться пункт в списке в интерфейсе участника или нет. Это полезно, когда нужно запретить выставлять определённые значения участникам, но у администраторов эта возможность должна быть.

Дата

Поле, в котором участник может ввести дату и время (опционально), например, дата рождения. Дату можно выбрать из выпадающего календаря, время участник вводит самостоятельно.

С помощью поля Опции для этого типа можно настроить формат отображения даты. Доступны следующие форматы:

  • 14.06.2024

  • 14.06.2024 17:41

  • 14.06.2024 17:41:34

  • 14 июня 2024 г.

  • 14 июня 2024 г. 17:41

  • 14 июня 2024 г. 17:41:34

Учебное заведение

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

При выборе существующего учебного заведения нужно выбрать страну и в поле для ввода начать вводить город и название, при этом система начнёт предлагать подходящие под строку поиска учебные заведения (максимум 50).

Чтобы добавить своё учебное заведение, нужно нажать на кнопку Учебного заведения нет в списке в конце списка предложенных заведений, выбрать из списка страну, регион, населённый пункт и ввести название нового учебного заведения.

Специальных опций и проверки корректности такого типа пользовательских полей не предусмотрено.

Пароль

Поле, с помощью которого можно указать пароль для входа на платформу.

При редактировании это поле включает в себя два строковых поля: для ввода самого пароля и для его подтверждения. Оба поля по умолчанию маскируются (то есть вместо текста показываются точки), но можно показать пароль с помощью иконки глаза.

При входе пароль, разумеется, нужно указать лишь единожды.

Специальных опций и проверки корректности такого типа пользовательских полей не предусмотрено, однако платформа запрещает устанавливать пароль длиной менее 8 символов.

Файл

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

В опциях этого поля есть галочка Использовать шаблон для генерации. Отметив её, можно выбрать загруженный на платформу файл, из которого будет генерироваться файл в этом поле. Подробнее про генерацию файлов по шаблону можно почитать здесь: Генерация файлов по шаблону.

Last modified: 14 June 2024