Параметры (дополнительные поля)¶
ℹ️ Дополнительные параметры (ДП) — это атрибуты задачи, позволяющие формализовать информацию, которая заносится в категориях в процессе работы. Подробнее об основных и дополнительных параметрах задачи можно прочитать в Руководстве пользователя
Список дополнительных параметров:
Над списком ДП расположено поле поиска, позволяющее отфильтровать параметры по названию типа. Это удобно при большом количестве параметров в системе, когда необходимо быстро найти все ДП определенного типа.
Система "Первая Форма" поддерживает следующие типы ДП:
| Тип данных | Внешний вид | Описание и настройка |
|---|---|---|
| Ссылка на другую задачу (Lookup) | Выбор задачи из категории. | |
| URL | Ссылка | |
| Адрес | Поле для ввода почтового адреса в формате, совместимом с КЛАДР (по нажатию на иконку справа от поля ввода открывается форма для просмотра адреса, разложенного на стандартные элементы). Для адресов в адресном классификаторе в БД хранятся также координаты указанного места — широта и долгота, что позволяет позиционировать точку на географической карте. Для корректной работы с адресами необходимо подключить хотя бы одного адресного провайдера. | |
| Адресаты email | Название ящика электронной почты пользователя, имя пользователя или набор символов | |
| Большой текст с форматированием | Текст длиной свыше 1000 символов с возможностью форматирования, отключения тегов Microsoft Word и просмотра HTML-кода. | |
| Большой текст без форматирования | Текст длиной свыше 1000 символов без возможности форматирования | |
| Выбор нескольких задач из категории (Multilookup) | Выбор нескольких объектов категории с возможностью добавления комментария, а также просмотра значения ДП категории к каждому из выбранных объектов | |
| Выбор пользователей | Выбор одного или нескольких пользователей, а также групп пользователей или элементов орг.структуры | |
| Выпадающий список | Выбор одного значения из фиксированного перечня (максимальная длина 200 символов). При вводе значения в поле курсор сразу помещается в строку поиска — произвольный текст в поле сохранить невозможно в отличие от ДП "Выпадающий список с редактированием". |
|
| Выпадающий список с редактированием | Фиксированный перечень значений с возможностью ввода своего значения (максимальная длина 200 символов). В отличие от ДП "Выпадающий список" (без редактирования) в поле ввода можно ввести произвольный текст — после завершения редактирования он будет сохранен в задаче (но не в источнике данных). |
|
| Дата | Выбор даты из календаря | |
| Дата и время | Выбор даты и времени из календаря | |
| Деньги | Число отображается с 2 знаками после запятой. В качестве разделителя применяется точка (".") или запятая (",") | |
| Дерево | Отображение древовидной структуры | |
| Нумератор | Автоматический нумератор | |
| Сквозной | Имеет вид любого другого ДП | Автоматическое вычисление значения на основании настроенной цепочки связей |
| Таблица | Ввод данных в виде таблицы. | |
| Текст | Текстовое значение | |
| Файл | Электронный файл любого типа, разрешенного для добавления администратором. | |
| Галочка (checkbox) | Да/Нет (True/False) | |
| Число | Тип отображения ДП "Число" определяется в настройках параметра: Текст, Нумератор, Слайдер |
ℹ️ При действиях с ДП типа "Таблица" автоматически сохраняются другие ДП, расположенные на карточке задачи ℹ️ Если в профиле пользователя включена настройка "Получать файлы в письмах в виде вложений, а не ссылок", ДП типа "Файл" также отправляются в виде вложений
Создание дополнительного параметра¶
Для создания ДП нажмите кнопку Создать ДП. Откроется окно добавления нового ДП.
Введите имя параметра, выберите тип данных и нажмите кнопку Создать. Новый ДП отобразится в общей таблице.
ℹ️ Запрещено создавать ДП с именем, совпадающим с именем системного параметра (например, "Дата завершения")
ℹ️ Обратите внимание на выбор типа данных параметра. После создания ДП изменить тип будет невозможно. Если потребуется изменить тип, вам необходимо будет создать новый параметр с правильным типом данных и самостоятельно перенести в него данные из старого параметра
Удаление ДП¶
Для удаления дополнительного параметра выберите пункт Удалить в контекстном меню нужной строки.
ℹ️ ДП нельзя удалить, если он используется хотя бы в одной категории
Настройки ДП¶
Для редактирования дополнительного параметра щелкните левой кнопкой мыши по соответствующей строке в таблице. Окно редактирования дополнительного параметра откроется на вкладке Основные настройки.
Основные настройки ДП:
| Параметр | Описание |
|---|---|
| ID | Индивидуальный номер параметра в БД |
| Название | Имя параметра, которое будет отображаться на карточках объектов категорий. Рядом с названием отображается значок мультиязычности |
| Тип | Тип параметра |
| Пример содержимого | Текст всплывающей подсказки, которую будет видеть пользователь при наведении мыши на ДП |
ℹ️ Обратите внимание на выбор типа данных параметра. После создания ДП изменить тип будет невозможно. Если потребуется изменить тип, вам необходимо будет создать новый параметр с правильным типом данных и самостоятельно перенести в него данные из старого параметра
Модуль¶
Выбор модуля, к которому относится данный параметр. Если модуль не выбран, параметр находится в глобальном модуле.
При создании ДП в категории они автоматически получают привязку к тому же модулю, что и сама категория. При этом система блокирует добавление в категорию ДП, модуль которых отличается от модуля категории
Регулярное выражение¶
ℹ️ Регулярные выражения (англ. regular expressions, сокр. RegExp, RegEx) — это формальный язык поиска и осуществления манипуляций с подстроками в тексте, основанный на использовании метасимволов. По сути это строка-образец (англ. pattern, по-русски её часто называют «шаблоном», «маской»), состоящая из символов и метасимволов и задающая правило поиска. Применение регулярных выражений позволяет сделать поиск и замену в тексте максимально эффективными
ℹ️ Не работают для ДП следующих типов: Галочка (checkbox), Дерево, Большой текст с форматированием, Выбор пользователя
ℹ️ Регулярное выражение не применяется, если в настройках параметра Текст активна опция Отображать ДП текст как телефон. Для таких параметров вшита маска "+X (XXX) XXX-XXXX"
Шаблон, согласно которому будет осуществляться ввод данных.
Если значение не проходит проверку, поле подсвечивается, а под ним появляется текст ошибки из поля Пояснение. Если пояснение не заполнено, отображается стандартный текст. Если в ДП с типом "Текст" помимо регулярного выражения задана маска, то приоритет проверки отдается регулярному выражению, если оно заполнено.
Список регулярных выражений можно найти в открытых источниках.
В таблице ниже приведены некоторые из часто встречающихся регулярных выражений, используемых в ДП. Следует отметить, что одно и то же регулярное выражение может быть написано разными способами.
| Что проверяется | Регулярное выражение | Комментарии |
|---|---|---|
| ФИО | \^[А-ЯЁа-яё]+(?:[\- \\А-ЯЁа-яё]+)* [А-ЯЁа-яё]+(?: [А-ЯЁа-яё]+)?\$ |
Учитывает возможные двойные фамилии или составнын имена. Не позволяет вводить цифры, латинские буквы и спецсимволы, кроме дефиса и пробела |
| Серия и номер паспорта | \^\d{4}[\s-]\d{6}\$ |
\ |
| Адрес прописки | .*\S.* |
\ |
| Дата в формате ДД.ММ.ГГГГ с учетом корректности дней в месяцах и високосных годов | \^(?:(?:31\.(?:0[13578]\|1[02])\|(?:30\|29)\.(?:0[13-9]\|1[0-2])\|(?:0[1-9]\|1[0-9]\|2[0-8])\.(?:0[1-9]\|1[0-2]))\.\\d{4}\|29\.02\.(?:\d{2}(?:0[48]\|[2468][048]\|[13579][26])))\$ |
Упрощенная версия (проверяет только формат, но не корректность даты): \^(0[1-9]\|[12][0-9]\|3[01])\.(0[1-9]\|1[0-2])\.\\d{4}\$ |
| ИНН | \^\d{10}\$ или \^\d{12}\$ |
10 или 12 цифр (для юридических и физических лиц соответственно) |
| Расчетный счет в формате ААА-ББ-ВВВ-Г-ДДДД-ЕЕЕЕЕЕЕ | \^\d{3}-\d{2}-\d{3}-\d{1}-\d{4}-\d{6}\$ |
\ |
| БИК | \^\d{9}\$ |
\ |
| Мобильный телефон (в виде "+7 (xxx) xxx-xx-xx") | \+7 \(\d{3}\) \d{3}-\d{2}-\d{2} |
\ |
\^[a-zA-Z0-9_\-\+\.]+[a-zA-Z0-9_\-\+]@[a-zA-Z0-9_\-]+(\.[a-zA-Z0-9_\-]+)*\.[a-zA-Z]\$ |
\ | |
| Оплата по этапу Перерегистрация | по тарифу\|\d+/06 |
\ |
| Оплата по этапу Закрытие счетов | по тарифу\|\d+/06 |
\ |
| ОКПО | ^[\d ,]+\$ |
\ |
| Новые коды ОКВЭД | \^(\d{1,2}(\.\d+)* *; *){1,21}\$ |
Перечислите коды, используя в качестве разделителя символ ";" (например: 65.2; 74.87.8); после последнего кода обязательно должен стоять символ ";"; максимальное число кодов в поле — 21 |
| Исключение кодов ОКВЭД | \^(\d{1,2}(\.\d+)* *; *){1,21}\$\|(\^нет\$)\|(\^-*\$)\|(\^все\$) |
Чтобы исключить коды, укажите "нет"; чтобы исключить все коды, укажите "все"; для исключения конкретных кодов перечислите их, используя в качестве разделителя символ ";", в конце также должен стоять символ ";"; максимальное число кодов в поле — 21 |
| Основной код ОКВЭД | \^(\d{1,2}(\.\d+)* *; *){1,21}\$\|\^тот\sже\$\|\^старый\$ |
Если менять не нужно, укажите "старый"; если нужно заменить код, укажите его и после поставьте символ ";" |
| Телефон для банка | \^((8\|\+7)[\- ]?)?(\(?\d{3}\)?[\- ]?)?[\d\- ]+\$ |
\ |
| Год показателя | \1-9\0-9\0-9\0-9\$ | \ |
| № телефона | \d+ | \ |
| Фио для визы | \^\a-z, A-Z +\$ | \ |
| Оборот с (млн) | \^\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}(,\d{0,2}){0,1}\$ | \ |
| Оборот по (млн) | \^\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}(,\d{0,2}){0,1}\$ | \ |
| Добавить компании | \^\d*\$ | \ |
| Порядок выполнения | \^\d{1,10}\$ | \ |
| Срок выполнения (дней) | \^\d{0,3}\$ | \ |
| Начало след. проекта (дней) | \^\d{0,3}\$ | \ |
| Сотрудников с | \^\d*\$ | \ |
| Сотрудников по | \^\d*\$ | \ |
| Годовой оборот (млн.) | \^\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}\d{0,1}\s{0,1}(,\d{0,2}){0,1}\$ | Укажите число миллионов |
| Время на дорогу (ч) | \^\d*\$ | Время на дорогу в один конец. В календаре время начала встречи будет передвинуто на время дороги до указанного времени встречи, а время окончания — на время дороги после указанного времени встречи |
| № выполненной задачи | \^\d{1,10}\$ | \ |
| Время начала | \^(\0-1\0-9\ | \2\0-3):(\0-5\0-9)\$ |
| Телефон для СМС | \^((8|\+7)\- \?)?(\(?\d{3}\)?\- \?)?\\d\- \$ | \ |
| Время на дорогу (мин) | \^\d*\$ | \ |
| Предельное количество участников | \0-9\ | \ |
| Доп. номер клиента | \^\d*\$ | Можно вводить только цифры |
| Текст | ( \^0-9\ ) | Можно вводить только буквы |
Синтаксис регулярных выражений крайне сложен и многообразен. В данном разделе приведены самые употребляемые метасимволы регулярных выражений с примерами их применения.
Большинство символов в регулярном выражении представляют сами себя за исключением специальных символов \ \ \ / \^ \$ . | ? * + ( ) { }, которые могут быть предварены символом \ (обратная косая черта) ("экранированы", "защищены") для представления их самих в качестве символов текста. Можно экранировать целую последовательность символов, заключив её между \Q и \E.
Синтаксис:
| Представление | Эквивалент | Значение |
|---|---|---|
| \d | \0-9\ | Цифра |
| \D | \^\d\ | Любой символ, кроме цифры |
| \w | \a-zA-Z0-9_\ | Символы, образующие «слово» (буквы, цифры и символ подчёркивания) |
| \W | \^\w\ | Символы, не образующие «слово» |
| \s | \ \t\v\r\n\f\ | Пробельный символ |
| \S | \^\s\ | Непробельный символ |
Символы для использования в регулярных выражениях:
| Символ | Описание | Примеры |
|---|---|---|
| . | Любой символ | ".+" — любая ненулевая строка в кавычках |
| \^ | Начало строки | \^[а-я] -- абзац, начинающийся со строчной буквы |
| \$ | Конец строки | \^\$ — пустая строка |
| \ \ | Набор символов | 0x[0a-c] -- числа, начинающиеся с 0×0, 0xa, 0xb или 0xc |
| | | Альтернатива (ИЛИ) | рабоч(его|ее) — ищем "рабочего" или "рабочее" |
| ( ) | Выделение подвыражения | (рабоч)(его|ее) -- два подвыражения |
| n | Использование подвыражения | (0x.., *)1 -- два одинаковых байта рядом в массиве |
| * | 0 и более раз | \^.* — выделение строк (пустых и не пустых) |
| + или | 1 и более раз | \^.+ — выделение непустых строк (абзацев) |
| ? или | 0 или 1 | мест[\^ \?] — ищет "мест", "места", "место"... |
| "Не жадный" режим | 0{2,4} в строке нолей найдёт "0000", а 0{2.4}? — "00" | |
| {n} | Итератор "n раз" | 0x\0-9a-f[\^0-9a-f] -- найдёт только байтовые числа |
| {n,} | Итератор "не менее n раз" | \^.{40,} — абзацы, в которых не менее 40 символов |
| {n,m} | Итератор "не менее n, не более m" | \<\:alpha:\> — искать слова от 2 до 4 символов |
| xnn | Шестнадцатиричное значение | x20 -- пробел |
| xnnnn | Шестнадцатиричное (Unicode) | x0410 -- буква "А" русского алфавита |
| t | TAB | \^t -- найти строку, начинающуюся с TAB |
| n | NL | \ |
| s или \ tnrf\ | Разделитель | \s |
| S или [\^ tnrf] | НЕ разделитель | \S |
| d или [0-9] | Цифра | \d — найти только цифры |
| D или [\^0-9] | НЕ цифра | \D — найти НЕ цифры |
| w или [a-zA-Z0-9_] | Символ слова | \w |
| W или [\^w] | НЕ символ слова | \W |
| b | Граница слова | \b |
| B | НЕ граница слова | \B |
| \< | Начало слова | (\< — найти круглую открывающую скобку в начале слова |
| > | Конец слова | [a-z_+>] — найти объявление массива |
| A | Начало текста | \A |
| Z | Конец текста | \Z |
| \:digit:\? или d | Цифра | \ |
| \:space:\? или \ \ | Пробел | \ |
| [:print:\?] | Все печатаемые и пробелы | \ |
| \:cntrl:\? или t | Непечатаемые (без пробелов) | \ |
| \:alnum:\? или [a-zA-Z0-9] | Цифра или буква | \ |
| \:alpha:\? или [a-zA-Z] | Буква | \ |
| [:lower:\?] | Буква в нижнем регистре | \ |
| [:upper:\?] | Буква в верхнем регистре | \ |
Для того, чтобы искать символ, совпадающий с метасимволом, его следует предварить обратной косой чертой — \ \^ + ...
Чтобы определить для поиска в перечне символ \ или \ , нужно поместить их в начало перечня, но лучше предварить косой чертой — [\a-z] \a-z]]
Чтобы определить для поиска в перечне символ - , нужно поместить его в начало или конец перечня, но лучше предварить косой чертой
Символ | не работает в перечне, поэтому б[о|а\р] найдёт "бор", "бар" или "б|р".
Символы для замены:
| Символ | Описание | Примеры |
|---|---|---|
| n | Найденное выражение | Replace: /*2*/ — замена строкового на блочный |
| \$n | Найденное выражение | Ещё один синтаксис подстановки подвыражения |
Пояснение к полю. Или вывод ошибки регулярного выражения:
- Если задано "Регулярное выражение": текст предупреждения, которое выдается пользователю, если введеные им данные не соответствуют регулярному выражению.
- Если "Регулярное выражение" не задано: текст в поле будет использован в качестве подсказки пользователю. Подсказка будет отображаться под параметром независимо от того, заполнено его значение или нет.
Некоторые типы ДП имеют индивидуальные Дополнительные настройки:
Большой текст с форматированием/без форматирования
Выбор нескольких задачи в категории (multilookup)
Используется¶
ℹ️ Эта информация особенно важна для администраторов, которые настраивают "Первую Форму" не "с нуля", а продолжают и развивают настройки, сделанные ранее, в том числе при первоначальном внедрении системы.
ДП могут использоваться в нескольких категориях одновременно. Изменения, вносимые в ДП в рамках настройки одной категории, сразу же распространяются и на остальные категории, где этот ДП задействован. Поэтому при изменении ДП необходимо проверять, в каких еще категориях он используется, и тщательно продумывать, как ваши изменения могут сказаться на работе других категорий и корректны ли будут эти изменения в масштабах всей системы.
Чтобы проверить, в каких еще категориях используется конкретный ДП, в его настройках перейдите на вкладку Используется.
Таблица доступна только для чтения.
| Параметр | Описание |
|---|---|
| Категория | Название категории, в которой используется дополнительный параметр |
| Обязателен | Указывается, является ли дополнительный параметр обязательным в задачах категории |
| Отображать при постановке | Указывается, отображается ли значение дополнительного параметра после постановки задачи |
| Заполняется один раз | Указывается, можно ли изменять значение дополнительного параметра после первого его заполнения |
Подписи¶
Во вкладке Подписи отображается список подписей, в которых данный дополнительный параметр задействован в настройках выбора акцептанта по параметру. Таблица только для чтения.
Переход к настройкам из пользовательского интерфейса¶
Пользователям с правами администратора в табличном представлении списка задач категории доступен пункт Формат в контекстном меню заголовков колонок. При этом данный пункт отображается только для колонок с дополнительными параметрами и скрыт для всех основных системных полей.
При его выборе открывается модальное окно настроек параметра в режиме администрирования.
Дополнительные параметры в прежнем интерфейсе администрирования Полезные ссылки