Дополнительные параметры

Industry-мост. Дополнительные параметры (ДП) — это custom fields / dynamic attributes в индустриальной терминологии: настраиваемые поля задач, аналогичные Salesforce Custom Field, Jira Custom Field, Dynamics 365 Attribute. Lookup-ДП = foreign key (ссылка на другую задачу), Multilookup-ДП = many-to-many relation, сквозной ДП (Through) = derived/computed field.

В этом документе приведено описание дополнительных параметров (ДП, custom fields) в карточке задачи, настраиваемых администратором под бизнес-процессы. Руководство предназначено для пользователей системы и описывает основные сценарии взаимодействия с параметрами, особенности их сохранения и редактирования. Внутри подробно рассматриваются специализированные типы ДП, включая таблицы, чек-листы, даты, числа, файлы и другие поля.

Обзор и ключевые особенности дополнительных параметров

Дополнительные параметры (ДП) — поля задачи, которые администратор настраивает под конкретный бизнес-процесс. Именно ДП содержат всю специфическую для процесса информацию: суммы, даты, ссылки, файлы, выбор из справочника и т.д.

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

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

Основные сценарии взаимодействия

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

1. Добавление ДП в категорию Администратор создаёт параметр, настраивает тип и подключает в категории с правилами видимости и обязательности.

2. Изменение значения в задаче Пользователь вводит значение; система проверяет тип, права и смарт-ограничения, затем сохраняет.

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

4. Сквозные параметры (Through) Значение вычисляется или подтягивается по цепочке связанных задач и пересчитывается при изменении источника.

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

Пункт меню «Больше → История изменений ДП» в карточке задачи открывает таблицу всех изменений дополнительных параметров: дата, пользователь, старое и новое значения, тип параметра, комментарий при изменении. В историю попадают и системные параметры (категория, текст, заказчик, срок и др.), не только дополнительные. Клик по строке раскрывает полный текст значений; для ДП «Таблица» — табличный вид.

Сохранение истории изменений отключено по умолчанию и включается администратором отдельно для каждого параметра.

Изменение «Большого текста с форматированием» в ленте. Когда у такого параметра включена история, его изменение попадает в ленту задачи ссылкой с названием поля, а не содержимым. Клик открывает историю изменений, отфильтрованную по этому параметру и по времени изменения — до секунды. Если одним сохранением изменились несколько таких параметров, в ленте появляется отдельная ссылка на каждый. Пользователь, у которого нет права читать параметр, значений в истории не видит: старое и новое значения не отдаются. Параметры других типов показываются в ленте по-прежнему.

Для ДП «Таблица» история показывает представление таблицы для списка задач, а не сами данные строк, поэтому зависит от настроек таблицы. Если у ДП выключена настройка «Хранить html представление» — история табличного ДП пустая. Если включён шаблон в табличных представлениях — история показывает вывод шаблона (заголовок, футер, количество строк), а не значения ячеек. Подробнее — в справочнике настроек ДП «Таблица».

Контекстное меню по ПКМ:

Действие	Описание
Фильтр по значению	Оставить только строки с указанным точным значением в выбранной колонке (без частичных совпадений)
Исключая значение	Скрыть строки с указанным точным значением
Содержит хотя бы одно значение	Для ячеек с несколькими значениями — оставить строки, где есть точное совпадение хотя бы по одному из них
Содержит и другие	Точное совпадение плюс дополнительные элементы (исключает строки только с указанным значением)
Не содержит ни один	Скрыть строки, где есть совпадение с указанным значением
Копировать / Копировать с заголовками	Копирование значения (с заголовками или без)
Восстановить значение ДП из истории	Установить старое значение как текущее

Восстановление через «Восстановить значение ДП из истории» поддерживается для типов: Дата, Дата и время, Число, Текст, Большой текст (с форматированием и без), Файл, Выпадающий список.

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

Сохранение значений дополнительных параметров

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

Поведение при сохранении зависит от типа дополнительного параметра:

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

Поля с клавиатурным вводом — текст, число, большой текст (с форматированием и без). Значение сохраняется при снятии фокуса с поля: клик в другое место карточки, переход на другое поле или закрытие карточки. На время сохранения поле блокируется — это визуально показывает, что данные обрабатываются. После успешного сохранения поле снова доступно для редактирования. У параметров типов «Текст», «Число», «Деньги», «Нумератор» и «URL» на время редактирования рядом с полем отображаются две иконки. Галочка подтверждает ввод — значение сохраняется, поле возвращается в режим просмотра. Крестик отменяет ввод — в поле возвращается прежнее значение, подсветка ошибки валидации снимается, сохранение не выполняется, поле также возвращается в режим просмотра. Иконки доступны только в карточке существующей задачи и только при праве на редактирование параметра; в форме создания задачи их нет.

Кнопка перехода по маршруту. Значение, введённое в поле с клавиатурным вводом и не подтверждённое галочкой, сохраняется и при нажатии кнопки перехода по маршруту: карточка записывает его до запроса перехода, поэтому смарт «Перед переходом» и проверка обязательных параметров видят уже заполненное значение, а окно о несохранённых данных не показывается. На обычное закрытие карточки — крестиком, клавишей Esc, кликом по затемнённому фону или уходом навигацией — это не распространяется: значения молча не записываются, пользователю показывается окно «У вас есть несохранённые данные…».

Большой текст и поле «Задача». У параметров «Большой текст с форматированием» и «Большой текст без форматирования», а также у системного поля «Задача» подтверждение и отмена выглядят иначе: под полем в режиме редактирования показываются две подписанные кнопки — «Сохранить» и «Отмена». Кнопки идут сразу под полем и толкают вёрстку вниз, не накладываясь на текст, блок ошибки и подсказку. «Сохранить» записывает введённый текст и возвращает поле в режим просмотра, «Отмена» возвращает прежнее значение и тоже закрывает редактирование; прежние способы выхода — Esc, Tab и клик вне поля — работают как раньше. Кнопки есть в карточке существующей задачи, в форме создания задачи их нет.

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

Если сохранение не прошло — значение отклонено проверкой, ввод отменён автоматизацией или запрос завершился ошибкой, — переход не выполняется, а введённое значение остаётся в поле, чтобы его можно было исправить и повторить переход. Несохранённые данные другого вида — правки системного поля «Задача», неотправленный комментарий в ленте, изменения во встроенной в карточку форме — по-прежнему требуют подтверждения перед переходом.

При закрытии карточки крестиком, клавишей Esc, кликом по подложке или уходе на другую страницу порядок другой: ДП с клавиатурным вводом не записываются без подтверждения — система спрашивает, покидать ли карточку с несохранённым значением. Разница заметна, когда поле осталось в режиме редактирования: переход по маршруту уже сохранит введённое, а закрытие карточки сначала спросит.

Отмена правки клавишами Ctrl+Z / Cmd+Z. В открытом на редактирование поле комбинация возвращает значение к последнему сохранённому и выводит поле из режима редактирования — так же, как Esc и крестик отмены. Отмена одна на все поля и одной ступенью: пошагового отката набора нет, повторное нажатие ничего не меняет. Правило распространяется и на редакторы форматированного текста: содержимое редактора живёт на экране отдельно от значения поля и само к сохранённому не возвращается, поэтому комбинация возвращает именно сохранённое значение. Единственное исключение — «Большой текст без форматирования»: у этого поля своя обработка комбинации, и панель в неё не вмешивается.

Отмена правки и поле «Файл». Если в поле «Файл» был показан файл, ещё не загруженный на сервер, а затем пользователь отменил правку клавишами Ctrl+Z / Cmd+Z, результат такой же, как при отмене по Esc: на экране показывается сохранённое в задаче значение, а локально приложенный файл перестаёт считаться незагруженным — при последующем удалении файл удаляется из задачи, а не только с экрана.

Групповое сохранение связанных параметров. Если администратор настроил у параметра явные «Зависимые ДП», изменение ведущего параметра открывает окно «Связанные параметры»: в нём можно заполнить весь набор связанных полей и сохранить его одной кнопкой «Сохранить». Окно открывается только тогда, когда хотя бы один из прямых зависимых параметров есть в этой задаче, не скрыт на ней и доступен для правки; зависимые, скрытые в задаче, в окно не попадают. Поля, которые в окне править нельзя (файл, таблица, доступ только на чтение), показываются в нём строкой со ссылкой «Перейти к параметру» — их значение по-прежнему меняется в самой карточке.

Обычная фильтрация значений по другому списку (связь «ведущий — ведомый») окна не открывает: выбранное значение сохраняется сразу, как и у параметра без зависимостей. В форме создания задачи (НТФ) окна нет.

Если при сохранении возникает ошибка валидации, поле подсвечивается красным, под ним отображается текст ошибки. Модальное окно с предупреждением в этом случае не появляется.

Проверка значений лукапов по источнику данных. Значения ДП «Выбор нескольких задач из категории» (и одиночного лукапа) проверяются по источнику данных параметра — категории/сводному разделу, статусам и смарт-фильтру — и при сохранении, и при автоподстановке. Задача, не входящая в выборку параметра, не принимается: при автоподстановке (значение по умолчанию, перенос из задачи-источника, предзаполнение по ссылке создания задачи) такое значение отбрасывается, поле остаётся пустым, создание задачи не прерывается; при ручном сохранении — отклоняется.

По правому клику у дополнительного параметра доступно контекстное меню с действиями над значением. Набор пунктов зависит от типа параметра: у «Выбора нескольких задач из категории» с табличной схемой оформления пунктов «Изменить» и «Вставить» нет — значение правится прямо в таблице, — а у «Флажка» нет пункта «Вставить».

Рядом со значением могут отображаться кнопки действий, настроенные администратором.

Пользовательские сценарии для специализированных типов параметров

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

ДП «Адрес»

Дополнительный параметр типа «Адрес» распознаёт введённое значение и предлагает варианты из списка с указанием точности:

• Точные координаты — адрес найден однозначно
• Ближайшая координата — найден ближайший вариант
• Требуется уточнение координат — необходима дополнительная информация

После выбора адреса рядом с полем появляется иконка «Инструкция», открывающая детальную информацию: индекс, страна, город, район города, улица, дом, корпус, коды ФИАС/КЛАДР/ОКАТО/ОКТМО, координаты на карте.

Расшифровка аббревиатур кодов:

• ФИАС — Федеральная информационная адресная система.
• КЛАДР — Классификатор адресов России.
• ОКАТО — Общероссийский классификатор объектов административно-территориального деления.
• ОКТМО — Общероссийский классификатор территорий муниципальных образований.

Подробнее: Справочник типов ДП

ДП «Адресаты email»

Дополнительный параметр типа «Адресаты email» служит для хранения адресов электронной почты получателей. При отправке задачи система может автоматически формировать email-уведомления на указанные адреса — это зависит от настроек категории, выполненных администратором.

Поле принимает как имена пользователей платформы, так и внешние почтовые адреса. Внешний адрес автоматически распознаётся по формату (например, pochta@mail.ru) — если формат некорректен, значение удаляется.

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

Нажатие на имя пользователя открывает его полный профиль. Для удаления отдельного адресата используется иконка, появляющаяся при наведении на аватар.

Подробнее: Справочник типов ДП

ДП «Таблица»: пользовательский интерфейс

Дополнительный параметр типа «Таблица» предоставляет интерфейс для работы с табличными данными внутри задачи.

Управление видом таблицы

Управление внешним видом таблицы дополнительных параметров включает сортировку, фильтрацию, группировку и изменение ширины столбцов.

Возможность	Поведение
Сортировка	Клик по заголовку столбца меняет направление (по возрастанию → убыванию → без сортировки). Контекстное меню — «Сортировать по возр./убыв.», «Очистить сортировку». При следующем открытии задачи сортировка сбрасывается, если администратор не настроил её по умолчанию. При настроенной сортировке по умолчанию порядок строк автоматически обновляется после редактирования ячеек или выполнения смарт-кнопок — без перезагрузки страницы
Фильтрация	Кнопка фильтра показывает строку под заголовками. Недоступна для типов «Шаблонная» и «Блок кнопок»
Группировка	ПКМ по заголовку → «Сгруппировать». Сгруппированный столбец автоматически скрывается из таблицы; снятие группировки возвращает столбец
Группировка по умолчанию	Задаётся администратором в настройках столбца («Участвует в группировке, порядок»). При открытии сохранённой задачи таблица сразу сгруппирована, а столбцы, по которым построена группировка, скрыты — так же, как при группировке вручную. При снятии такой группировки столбец возвращается с прежней видимостью: скрытый администратором или пунктом «Скрыть столбец» остаётся скрытым
Ширина столбцов	Кнопка переключает 3 режима: По заголовкам / По размеру экрана / По содержимому. По умолчанию ширина столбцов установлена «по размеру экрана». Изменения не сохраняются — после перезагрузки восстанавливается режим, заданный администратором. Кнопка отображает следующий режим, а не текущий
Открыть в модальном окне	Кнопка в правом верхнем углу. Если задача уже открыта в модальном — таблица открывается в новой вкладке. Окно закрывается крестиком или клавишей Esc; клик по затемнённому фону его не закрывает

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

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

Автообновление не применяется к проектным ДП-Таблицам.

Секционирование Колонки таблицы могут быть разделены на секции (настраивает администратор). Секции отображаются в развёрнутом или свёрнутом виде; администратор настраивает, какие столбцы видны в каждом из видов.

Отображение в виде ссылки Если таблица большая, в карточке задачи может выводиться только ссылка. По клику ссылка открывает таблицу в отдельной вкладке браузера.

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

Отображение в виде набора полей (с 2.265) Альтернативный вид: каждая строка отображается как набор стандартных полей друг за другом. Поддерживаются столбцы Текст, Выбор пользователей, Lookup, Дата, Дата и время. Вычисляемые столбцы не отображаются. Группировка — одним уровнем; новые наборы добавляются кнопкой «Добавить строку». Поведение сохранения зависит от настройки таблицы (автосохранение или сохранение по кнопке).

Редактирование ячеек таблицы

Редактирование ячеек в таблице дополнительных параметров выполняется двойным кликом или через контекстное меню.

• Двойной клик по ячейке → режим редактирования (или пункт «Редактировать» в контекстном меню).
• Изменённая ячейка выделяется цветом до сохранения. Сохранение — кнопка Сохранить на тулбаре таблицы; отмена — кнопка Отменить.
• Можно отредактировать несколько ячеек и сохранить разом.
• Клавиатура:

Клавиша	Поведение
Enter	Сохранить и перейти к ячейке ниже (с открытием редактирования)
Esc	Отменить, закрыть редактор
Tab	Сохранить и перейти к ячейке справа с редактированием. Первое нажатие — без редактирования, последующие — с
↑/↓/←/→	Перемещение фокуса (вне режима редактирования)
Любая печатная клавиша на ячейке	Очистить значение и начать ввод

Ввод даты в ячейке. В колонках «Дата» и «Дата и время» календарь открывается выпадающей панелью под ячейкой и показывает месяц по значению ячейки; доступна кнопка «Сегодня». В колонке «Дата и время» время задаётся прокруткой часов и минут — списка готовых интервалов времени, как у самостоятельного ДП «Дата и время», в ячейке таблицы нет. Если колонка ссылается на ДП-источник с настроенными видимыми и доступными датами, в ячейке действуют те же ограничения, что и у самостоятельного ДП: календарь показывает только видимый диапазон, выбрать и ввести вручную можно только доступную дату. Ограничения работают и в табличном виде, и в виде набора полей; если у колонки нет ДП-источника или диапазон у него не задан, выбирается любая дата.

• При вводе даты в кратком формате (30.03.23) год автодополняется до полного (30.03.2023).
• Нередактируемые строки/столбцы окрашены серым.

Множественное выделение и копирование:

• Ctrl/Cmd + клик — выбор отдельных ячеек/строк.
• Выделение непрерывных диапазонов мышью.
• Ctrl+C / Ctrl+V для копирования и вставки. Копирование работает и для редактируемых, и для заблокированных ячеек.
• При вставке проверяется совместимость типов: вставка проходит, если типы столбцов источника и назначения совпадают или схожи (например, Число → Деньги, Число → Текст); несовместимая вставка (Число → Файл) блокируется для всего блока, а значение в целевой ячейке очищается.
• Автозаполнение «протягиванием»: потянуть за уголок выделенной ячейки распространяет значение по горизонтали/вертикали/в обоих направлениях.

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

Аналогичные возможности мультиредактирования (выделение диапазона, копирование/вставка, протягивание) доступны в блоке «Используется» при включённом режиме редактирования грида — см. task-forms/blocks-reference.md § 4. БИ-блок.

Контекстное меню ячейки

Пункт	Назначение
Редактировать	Аналогично двойному клику
Удалить	Очистить значение ячейки (до сохранения можно вернуть)
Вернуть значение	Восстановить удалённое значение (только до сохранения)
Добавить строку выше	Вставить новую строку над текущей
Добавить строку ниже	Вставить новую строку под текущей
Дублировать строку	Создать копию строки. До сохранения — в начале таблицы; после — перемещается в конец. При создании новой задачи — остаётся в начале
Копировать	Скопировать значение в буфер

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

Если администратор включил в настройках таблицы сравнение версий, изменённые ячейки остаются выделенными и после сохранения — в отличие от подсветки правки, которая держится только до сохранения.

• Зелёная ячейка — число стало больше прежнего значения, красная — меньше. У столбца с обратной метрикой цвета меняются местами: рост красный, снижение зелёное.
• Голубая ячейка — значение изменилось, но направление не показывается: столбец нечисловой, настроен только на факт изменения или число совпало с прежним.
• Голубая строка — строка добавлена после того, как зафиксировали версию сравнения; выделяются только сравниваемые столбцы.

Подсказка у изменённой ячейки показывает прежнее значение — «Было: 10». Для столбцов «Число» и «Деньги» в скобках добавлена разница со знаком: «Было: 10 (+10)».

С чем именно сравнивается значение и с какого момента — зависит от настроек ДП, см. ДП «Таблица» — справочник настроек.

Добавление и удаление строк таблицы

Добавление новых строк в таблицу дополнительных параметров выполняется кнопкой «+» на тулбаре, а удаление — через контекстное меню строки.

Добавление — кнопкой + на тулбаре. В зависимости от настроек категории — пустая строка прямо в таблицу или модальное окно с полями. Обязательные поля выделяются красным фоном (или красной рамкой при редактировании, если значение очищено пользователем). Состав доступных полей определяет администратор.

Кнопка … в конце строки открывает меню самой строки: «Добавить строку» («Выше», «Ниже») и «Переместить» («Выше», «Ниже», «В начало таблицы», «В конец таблицы»). Строку можно перенести и мышью — перетаскиванием за левый край. Новый порядок сохраняется сразу и действует при следующих открытиях задачи. Область перетаскивания слева и кнопка … справа занимают узкие служебные колонки без заголовков, закреплённые по краям таблицы: данных в них нет, и при беглом взгляде их можно принять за пустые технические столбцы.

Слева у таблицы есть служебная колонка с номерами строк — как в Excel: номер показывает место строки в таблице и не меняется ни при фильтрации, ни при сортировке, ни при переходе на другую страницу. Удаление строки пропуска не оставляет: следующие строки сдвигаются на освободившийся номер. Номера строк скрываются настройкой «Скрыть номера строк» в дополнительных настройках таблицы. Настройка «Запретить перемещение строк» убирает возможность менять порядок: и пункты меню, и перетаскивание за левый край отклоняются с ошибкой, а добавление, удаление, импорт и экспорт строк работают как обычно.

Перемещение — и пунктами меню, и перетаскиванием — недоступно, пока к таблице применена сортировка или группировка, а также для строки, которая ещё не сохранена. В режиме просмотра из меню доступно только копирование.

Строка, добавленная кнопкой +, встаёт в конец таблицы и остаётся там после сохранения и перезагрузки — ей присваивается следующий порядковый номер. Строка, добавленная пунктами «Добавить строку выше» и «Ниже», встаёт на указанное место. До подтверждения новая строка отмечается цветом; после сохранения автоматически открывается последняя страница.

Режимы пакетного добавления (в модальном окне):

Режим	Поведение
«Добавить ещё одну строку»	Окно не закрывается после сохранения; поля очищаются для следующей записи
«Сохранить данные»	Окно не закрывается; поля сохраняют введённые значения для копирования с правками

Поведение модального окна добавления. При открытии окна курсор автоматически ставится в первое редактируемое поле. Окно закрывается по клавише Esc или клику по фону; если в поля уже введены несохранённые данные, перед закрытием запрашивается подтверждение — чтобы случайно не потерять ввод.

Удаление строки: кнопка … в конце строки → «Удалить». Помеченная строка подсвечивается красным до подтверждения. Перед сохранением — модальное окно с подтверждением.

Восстановить помеченную на удаление: кнопка … → «Восстановить».

«Удалить все строки» — кнопка корзины на тулбаре. Доступна только при правах на редактирование всех ячеек/столбцов, без автоподсчёта и заблокированных строк и при разрешённом удалении строк: если в настройках ДП в категории удаление ограничено, кнопка не показывается — как и кнопка удаления отдельной строки. На пустой таблице — неактивна. Перед очисткой — модальное окно подтверждения.

Множественный выбор (для ключевого столбца) Если в таблице есть столбец «Ссылка на задачу», настроенный как ключевой, на тулбаре появляется кнопка множественного выбора. Открывается окно: в ключевом столбце все доступные значения (задачи из категории), слева — чекбоксы. После сохранения отмеченные строки добавляются в таблицу.

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

Работа в окне множественного выбора:

• Над списком показан счётчик «Выбрано: X» — сколько объектов уйдёт в таблицу по кнопке «Применить». Это число выбранных объектов, а не видимых отмеченных строк.
• Выбор накапливается. Поиск, фильтрация, сортировка, группировка и перелистывание страниц не снимают уже отмеченное: нужное можно набирать в несколько проходов, меняя запрос и страницу.
• При открытии окна отмечено всё, что уже сохранено в таблице, — в том числе строки, не попавшие на первую страницу списка.
• Пока полный список сохранённых строк подгружается, окном можно пользоваться: счётчик сначала отражает только показанные строки и обновляется после загрузки остальных. Если полный список загрузить не удалось, выбранное и счётчик не сбрасываются — показывается сообщение об ошибке.
• По «Применить» в таблицу попадают все отмеченные объекты из любого положения списка: под фильтром, под группировкой, с любой страницы. Отмеченная ранее строка, невидимая под текущим фильтром, из таблицы не удаляется.
• Кнопка «Обновить» перечитывает список, не снимая отметок: переименованные значения подхватываются, новые появляются неотмеченными, а ставшие недоступными снимаются с выбора с уведомлением.
• Закрытие окна без применения отбрасывает набранный в нём выбор — при повторном открытии показано только то, что сохранено в таблице.

Недоступные сохранённые строки. Объект сохранённой в таблице строки может стать недоступен пользователю: его удалили из справочника-источника или закрыли правами. Такие строки при открытии окна и по кнопке «Обновить» снимаются с выбора — отметка уходит, счётчик «Выбрано» уменьшается, показывается одно уведомление с числом снятых записей. Недоступность система определяет по явному признаку сервера, а не по тому, что строка не попала в текущий список: доступная строка под фильтром, под группировкой или на другой странице по ошибке не снимется. Снятие с выбора не удаляет строку из таблицы — её значение остаётся в параметре, пока пользователь не удалит строку сам. Если объект снова станет доступен, при следующем открытии окна строка опять окажется отмеченной как сохранённая. Если запрос завершился ошибкой, выбор не чистится: остаётся как был, с сообщением об ошибке.

Импорт и экспорт данных в Excel

Таблица дополнительных параметров поддерживает операции экспорта данных в Excel и импорта из него.

Операция	Особенности
Экспорт	Выгружается вся таблица независимо от текущей фильтрации. Ссылка на задачу — текст; файл — ссылка
Импорт	Работает только в карточке существующей задачи (не в карточке создания). Сохраняется стилизация (границы, жирный, подчёркивание). Файлы из Excel игнорируются. Состав колонок для импорта/экспорта может быть ограничен администратором

Режимы импорта зависят от настройки таблицы:

• Без ключевой колонки — полная перезапись: старые строки удаляются, добавляются новые из Excel.
• С ключевой колонкой — сопоставление по значению ключевой колонки. Для строк из Excel без соответствия в таблице на выбор: добавить новой строкой или проигнорировать.

Опция «Заголовки колонок в первой строке»:

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

Особенности экспорта:

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

Текст в столбце «Ссылка на задачу» при импорте ищется как название задачи в нужной категории; альтернатива — указать номер задачи.

Числа в файлах Excel хранятся с точностью до 15 значащих цифр, и целая часть входит в их счёт. Поэтому значение с большим числом знаков при выгрузке округляется — например, 12345.123456789012345 выгружается как 12345.123456789, — а при импорте в таблицу попадает ровно то число, которое записано в файле. Внутри этих 15 значащих цифр значение колонки «Число» сохраняется без потерь, в том числе при обмене между карточкой задачи и сервером. Колонки «Деньги» выгружаются и импортируются как прежде.

Файлы в ячейках таблицы

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

Одинарный клик: файл скачивается. Если файл имеет тип, который можно открыть для просмотра в браузере (изображения, PDF, документы Office), он открывается; если тип не поддерживается для онлайн-просмотра (архивы zip/rar/7z, исполняемые файлы и др.) — файл сразу скачивается на устройство.

Двойной клик:

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

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

При наведении на файл в ячейке доступны кнопки действий: «Скачать», «Скачать все» (если в ячейке несколько файлов), «История», «Посмотреть», «Редактировать» — набор зависит от типа файла.

Отображение в виде ссылки Если таблица большая, в карточке задачи может выводиться только ссылка. По клику ссылка открывает таблицу в отдельной вкладке браузера.

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

Поведение итогов при работе с большой таблицей

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

Если пользователь применяет или снимает фильтр, итог пересчитывается по новому набору строк. Значения итогов в колонках «Число» и «Деньги» отображаются независимо друг от друга.

Известное ограничение. Если под текущим фильтром в таблице больше 1000 строк, итог считается только по первым 1000 — без предупреждения об этом в интерфейсе.

ДП «Выпадающий список»: пользовательский интерфейс

Дополнительный параметр типа «Выпадающий список» содержит список преднастроенных значений, из которых пользователь выбирает одно. В подсказках выпадающего списка отображаются 3 последних значения, выбранных пользователем в этом параметре. При вводе подсказки скрываются.

Строка поиска в раскрытом списке. Список значений открывается по клику на стрелке раскрытия; над перечнем есть строка поиска, в которой набирается часть значения для фильтрации. Подсказка в строке поиска не повторяет текст самого поля: если в поле уже введено или выбрано значение, строка поиска показывает собственную подсказку «Поиск», а не это значение. Текст поля при этом остаётся в закрытом триггере.

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

Альтернативные представления

Вариант	Поведение
Радиокнопки	Все варианты видны сразу; один выбран. Расположение — в столбец или в ряд
Выпадающий список с редактированием	Можно ввести произвольный текст. Введённое значение сохранится в задаче, но не добавится в список доступных значений ДП

ДП «Галочка» (Checkbox) и «URL» (Внешняя ссылка)

Дополнительные параметры типов «Галочка» (Checkbox) и «URL» (Внешняя ссылка) используются для простых бинарных значений и ссылок соответственно.

ДП «Галочка» (Checkbox)

Состояние «выбрано / не выбрано». Три варианта отображения, настраиваемые администратором:

Вариант	Поведение
Чекбокс	Стандартный квадрат с галочкой; во включённом состоянии — отметка
Свитчер (переключатель)	Графический ползунок
Радио выбор	Два взаимоисключающих варианта «Да» / «Нет». Один из вариантов всегда выбран. Снять выбор со всех вариантов невозможно

ДП «URL» (Внешняя ссылка)

Поле для хранения внешних ссылок. Клик по полю открывает ссылку — как правило, в новой вкладке. Ссылки кликабельны и в списке задач категории.

Поле предназначено для адресов, которые открывает браузер или системный обработчик, — это схемы из общего списка разрешённых (см. types-reference.md, раздел «ДП «URL (ссылка)»»). Пути к локальной файловой системе браузеры блокируют по соображениям безопасности, а адреса со схемами вне списка (javascript:, data: и подобными) система не открывает.

При клике на ссылку в поле типа URL система определяет тип ссылки:

— Если значение начинается с http:// или https:// — ссылка открывается в новой вкладке браузера. — Если значение начинается с mailto:, tel: или e1c: — система передаёт ссылку браузеру, а он вызывает системный обработчик: почтовый клиент для mailto:, SIP-телефонию для tel:, клиент 1С для e1c:. Например, mailto:user@example.com откроет почтовый клиент, tel:+74951234567 — наберёт номер, а e1c://server/база#e1cib/data/… запустит клиент 1С и откроет в нём нужный объект — при условии, что протокол e1c: зарегистрирован в операционной системе. — Если в поле указан только домен без протокола (example.com) — система автоматически добавит https:// и откроет сайт.

Адреса с другими схемами — например, javascript: или data: — система не открывает: клик по ним ничего не делает.

Такое поведение позволяет использовать поле URL не только для сайтов, но и для интеграции с внешними сервисами и оборудованием.

ДП «Чек-лист»: пользовательский интерфейс

Дополнительный параметр типа «Чек-лист» предназначен для ведения списков задач непосредственно в карточке задачи. Поле для самостоятельного ведения списков задач в карточке. Отображается только в карточке уже созданной задачи (в режиме создания скрыт).

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

Задачи (элементы списка) Два способа добавить задачу: - «+ Добавить» — поля для быстрой постановки: Текст задачи, комментарий, срок, исполнители, напоминание. Список исполнителей берётся из категории-источника ДП. - «Добавить по шаблону» — выбор готового шаблона из системной категории чек-листов. Чтобы отметить задачу выполненной — галочка в строке. Поля завершённой задачи (кроме «Напоминание») недоступны для редактирования. Кнопка переключателя «Скрывать завершённые» убирает их из видимого списка. Для редактирования — клик по задаче, изменения, «Сохранить».

Индикатор выполнения

• На каждой вкладке отображается своя шкала прогресса (доля выполненных задач).
• Общий процент по всему чек-листу — отношение завершённых задач к общему количеству задач во всех вкладках.

ДП «Дата» и «Дата и время»: пользовательский интерфейс

Дополнительные параметры типов «Дата» и «Дата и время» позволяют пользователю вводить временные отметки вручную или через календарь.

Ввод значения Три способа: 1. Вручную в поле — разделители (., :) подставляются автоматически. В русскоязычном интерфейсе используется формат ДД.ММ.ГГГГ ЧЧ:ММ. 2. Через календарь — стрелки для перехода между месяцами; клик по названию месяца открывает выбор любого месяца текущего года; клик по диапазону лет — выбор года. 3. Готовые слоты времени (для «Дата и время»). При переходе к редактированию пустого параметра поле остаётся пустым, пока пользователь не выберет дату вручную или через календарь. Кнопка-крестик очищает уже заполненное значение, не подставляя текущую дату/время.

Незавершённый и невозможный ввод. Пока значение набрано не полностью или такой даты не существует (например, 31.02), новое значение не принимается: параметр сохраняет прежнее. При уходе из поля такой ввод отменяется, и в поле возвращается последнее принятое значение. Пустое значение сохраняется только при явной очистке крестиком: поле, через которое просто прошли клавишей Tab, очисткой не считается.

Сообщение об ошибке и обязательные параметры. Пока в поле остаётся незавершённое значение, параметр считается незаполненным: рядом с ним выводится «Не полное значение» или «Некорректная дата». Обязательный параметр с таким значением не пропускает сохранение так же, как пустой, а в окне «Изменить срок» кнопка сохранения недоступна.

Видимые и доступные даты Администратор может настроить два независимых диапазона: - Видимые даты — какие даты вообще отображаются в календаре. - Доступные для выбора — какие из них можно выбрать. Пример: видимые 01.02 – 28.02, доступные 03.02 – 09.02.

Слоты для «Дата и время» Доступны два варианта: - Свободный формат — произвольный ввод времени. - Слоты — фиксированный набор времён. Для слотов настраивается: - Диапазон: рабочее время или 24 часа. - Шаг: 5, 15 или 30 минут.

ДП «Число» и «Деньги»: пользовательский интерфейс

Дополнительные параметры типов «Число» и «Деньги» предназначены для ввода числовых и финансовых значений.

Параметр	Описание
Пустое значение	Может отображаться как 0 (поведение настраивается администратором)
Дробная часть	«Число» — до 8 знаков после запятой, «Деньги» — до 4 знаков. При вводе округляется автоматически
Минимум / Максимум	Если указать меньше/больше — значение заменяется на граничное
Разделитель разрядов	Пробел; включается администратором

Десятичный разделитель. В дробном числовом поле разделитель вводится и точкой, и запятой — с основной клавиатуры и с цифрового блока. Второй разделитель в значение не добавляется. В ячейке таблицы с целочисленной настройкой (дробная часть не задана) разделитель не вводится.

Различие Число vs Деньги:

• В «Число» оригинальное значение сохраняется без округления (округляется только отображение в карточке). При повторном редактировании виден полный знак.
• В «Деньги» округление настройкой длины дробной части обрезает само сохраняемое значение.

Нумератор (для «Число») Альтернативное отображение «Числа» — со стрелками увеличения/уменьшения. Шаг настраивается администратором.

Очистка значения. Когда в поле «Числа» есть значение и курсор стоит в поле, справа показывается крестик очистки — и в обычном поле, и в нумераторе. Клик по нему очищает поле; пустое значение сохраняется так же, как введённое число. Если пустое значение настроено отображаться как 0, после очистки в поле будет 0.

ДП «Большой текст»: пользовательский интерфейс

Дополнительный параметр типа «Большой текст» используется для ввода крупных объёмов текстовой информации с форматированием или без.

Язык панели инструментов. Визуальный редактор — и в режиме форматирования, и в режиме Markdown — показывает панель инструментов и подсказки кнопок на языке интерфейса пользователя: русском или английском. Для остальных языков панель выводится на английском, а если язык интерфейса не определён — на русском. Смена языка применяется при следующем открытии редактора. Локализация действует в веб-версии.

Без форматирования Используется для крупных объёмов простого текста (развёрнутые описания, фрагменты кода). Поддерживает многострочный ввод; форматирование не применяется.

С форматированием Доступно несколько редакторов (выбор делает администратор):

Редактор	Применение
HTML WYSIWYG	Классический визуальный редактор: жирный/курсив/зачёркивание, цвет текста и заливки, заголовки, маркированные/нумерованные списки, гиперссылки, цитаты, вставка спецсимволов и эмодзи. Кнопки вставки спецсимволов и эмодзи доступны в карточке задачи и в форме создания задачи — и в десктопной, и в мобильной вёрстке. Вставленный текст с Markdown-разметкой распознаётся: заголовки, списки, выделение и блоки кода превращаются в форматирование — и в этом редакторе, и в режиме Markdown
Editor.js	Блочный редактор (как в пространствах). Добавление элементов кнопкой +, у каждого типа элемента собственное меню настроек, конвертация одного типа в другой через панель инструментов выделенного фрагмента, порядок блоков меняется перетаскиванием
iFrame	Только просмотр контента сторонних ресурсов (карты, видео, документы). Редактирование недоступно
Notes	Информационный блок с заголовком, текстом, одной или двумя кнопками действий. Текст поддерживает HTML. Цвет настраивается. Редактирование недоступно
Виджет	Показ портального блока в карточке задачи. Занимает всю ширину параметра. Редактирование недоступно
Markdown	Форматирование панелью инструментов и Markdown-синтаксисом. Кнопка «Режим Markdown» открывает отдельное окно с поддержкой подсветки синтаксиса для выбираемых языков (C, C#, C++, CSS, и т.д.)

Очистка разметки при выводе. Значение параметра показывается по тому же списку разрешённой разметки, что и текст задачи: сохраняются оформление (цвета, размеры, отступы, таблицы, картинки), блок с оформлением и сворачиваемый блок с заголовком — последний раскрывается и сворачивается кликом по заголовку, а при заданном в разметке признаке исходного раскрытия открыт сразу. Кнопки, обработчики нажатий, встроенные формы и медиа вырезаются, текст внутри них остаётся. Правило единое для карточки задачи, формы создания и мобильного приложения; состав разрешённого администратор не настраивает.

Чек-лист в режиме просмотра. В редакторе Editor.js пункты блока «Чек-лист» отмечаются одним кликом прямо в режиме просмотра — переходить в редактирование поля не нужно. Отметка доступна, если у пользователя есть право на изменение этого параметра; при доступе только на чтение пункты можно лишь просматривать. Изменение сохраняется сразу и не создаёт запись в ленте задачи; текст пунктов при этом не редактируется — для правки формулировок нужно открыть поле на редактирование.

Markdown-синтаксис (быстрый справочник):

Элемент	Синтаксис
Заголовки	# Заголовок — стандартный синтаксис; ======== — альтернативный синтаксис заголовка 1-го уровня
Жирный	**текст**
Курсив	_текст_
Зачёркнутый	~~текст~~
Маркированный список	- или *
Нумерованный список	1.
Ссылка	[Название](https://example.com)
Цитата	> Это цитата
Галочка	[ ]

Удаление элемента в Editor.js Кнопка действий рядом с элементом → «Удалить» → пункт загорится красным → повторное нажатие подтверждает удаление (защита от случайного клика).

Вставка изображений Изображения, вставленные в большой текст с форматированием (БТСФ) через буфер обмена (Ctrl+V) или drag-and-drop, прикрепляются к задаче как отдельные вложения. Каждое изображение становится самостоятельным файлом — даже если у файлов одинаковые имена (например, скриншоты image.png).

Локализация Если для параметра включена локализация, рядом с названием — кнопка для ввода значений на разных языках. В карточке задачи и в списке отображается значение на языке профиля пользователя.

Эмодзи Ввод эмодзи в Большой текст возможен, но по умолчанию отключён — администратор включает функцию через настройки приложения.

Ошибка показа Editor.js При проблеме с отображением содержимого появляется баннер с кнопкой обновления параметра.

ДП «Текст»: пользовательский интерфейс

Дополнительный параметр типа «Текст» представляет собой текстовое поле для коротких значений, таких как имена или номера телефонов. Для больших объёмов — ДП «Большой текст с/без форматирования».

Режим «Телефон» Лимит — 18 символов (поддерживает российские и зарубежные номера). Знак + и скобки вокруг кода города проставляются автоматически. Слева от поля — флаг страны. Клик открывает список стран с поиском по коду или названию. При интеграции с корпоративной телефонией рядом с номером появляется кнопка быстрого вызова.

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

Подсказки при вводе Для специальных режимов администратор может включить подсказки: - ФИО (целиком) - Фамилия / Имя / Отчество (по отдельности) - Адрес (для адресов рекомендуется ДП «Адрес») - Email

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

ДП «Выбор пользователей»: пользовательский интерфейс

Дополнительный параметр типа «Выбор пользователей» позволяет назначать исполнителей, выбирать группы пользователей или организационные единицы. Поле для выбора одного или нескольких пользователей, групп пользователей или орг.единиц — в зависимости от настроек ДП.

Способы выбора

1. Ввод имени/названия в поле — после нескольких символов система предлагает подходящие элементы. С 2.265 под именем и фамилией пользователя показываются его должность и отдел.
2. Кнопка списка — открывает иерархический список групп или орг.единиц. Видимость зависит от настроек:
3. «Разрешить выбирать группы» — отображает группы.
4. «Разрешить выбирать орг.единицы» — отображает орг.структуру.
5. Чекбоксы при множественном выборе — отметка элементов галочками.

Поведение

• Клик по имени пользователя открывает его полный профиль.
• ПКМ по имени → «Информация о пользователе» — открывает мини-карточку профиля в модальном окне.
• В однозначных полях (один пользователь) выбор элемента сразу сохраняет значение и закрывает редактирование.
• В мультивалентных — клик за пределами поля сохраняет все выбранные.

Копирование и вставка списка

ПКМ по полю → «Копировать» помещает в буфер обмена перечень выбранных пользователей, групп и орг.единиц — их отображаемые имена через запятую.

Обратная операция заполняет поле списком: ПКМ → «Вставить» срабатывает прямо в режиме просмотра, а в режиме редактирования работает и обычная вставка с клавиатуры. Вставленный текст разбивается по запятым, точкам с запятой, табуляции и переводам строк, поэтому список можно скопировать и столбцом из таблицы. Каждое имя ищется по точному совпадению с отображаемым именем: регистр не учитывается, «ё» и «е» считаются одинаковыми. Если найден ровно один получатель, он добавляется в поле; если совпадений нет или их несколько (полные тёзки), имя остаётся в строке поиска — по нему можно доискать нужного человека вручную. Повторы отбрасываются, на время поиска поле заблокировано.

Показ при большом числе значений

В карточке задачи поле выводит первые десять выбранных получателей. Если их больше, рядом появляется ссылка «Ещё N+», где N — число скрытых значений; клик по ней раскрывает весь список прямо в поле.

Состав правится в самом поле: получатели добавляются поиском и удаляются как обычно, если ДП открыт на запись; при доступе «только чтение» список доступен для просмотра. Повторно выбранный получатель в список не добавляется. Скрытые значения из поля не пропадают: при правке видимой части они сохраняются вместе с ней.

Развернуть группу в список участников. Если в поле разрешён выбор нескольких значений и групп, в режиме редактирования ПКМ по выбранной группе → «Развернуть список» заменяет группу её участниками: группа удаляется из значения, участники добавляются к уже выбранным без повторов, остальные выбранные пользователи, группы и орг.единицы сохраняются.

ДП «Lookup поле» и «Multilookup»: пользовательский интерфейс

Дополнительные параметры типов «Lookup поле» и «Multilookup» служат для создания связей с другими задачами в системе.

Варианты отображения lookup-полей

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

Lookup (ссылка на одну задачу): ссылка / простой текст / радиокнопки.

Multilookup (несколько задач): табличный вид / облако тегов / чекбоксы (до 10 пунктов, для категорий с малым числом значений).

В режиме «облако тегов» администратор настраивает вариант отображения значений: только текст, текст + цвет аватара, только иконка, иконка + цвет. Цвет и иконка соответствуют аватару выбранной задачи: если цвет не установлен, по умолчанию используется серый; если иконка не задана — стандартная. В режиме редактирования всегда виден текст; иконки появляются после сохранения. Текст задачи также показывается при наведении на иконку.

В режиме «Чекбоксы» поле отображается списком флажков (до 10 пунктов); все варианты видны на первой странице. При клике на элемент новое состояние сохраняется автоматически. Выбранные и доступные пункты всегда показываются в исходном порядке, без группировки. В режиме чтения выбранные значения показываются в виде облака тегов.

Если Multilookup выведен в системные теги карточки задачи, в теге перечисляются все выбранные значения. Раскрытие списком работает как в ленте задач с настраиваемым видом карточки, так и в карточке задачи в мобильном приложении.

Поиск значений и подсказки последних значений

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

Три способа добавить значение:

1. Ввод в поле — система предлагает подходящие задачи. Поиск без приоритизации языка (русский/английский равнозначны), без учёта раскладки клавиатуры. Если запрос на русском не нашёл совпадений — поиск повторяется на английском (и наоборот).
2. Кнопка раскрытия списка — окно со всеми доступными задачами, аналогичное табличному представлению категории: фильтрация, группировка, отбор. В Multilookup доступна кнопка «Выбрать все» (с учётом фильтрации): выбирается не более установленного настройкой лимита (по умолчанию 10 000 записей), при пустом списке кнопка недоступна. Подтверждение — кнопка «Применить».
3. По номеру задачи — ввод номера в строку поиска заменяет его на текст задачи.

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

Порог количества задач:

• Менее 50 в категории-источнике — поиск работает с первого символа.
• Более 50 — с третьего.

В выпадающем списке отображаются 3 последних выбранных пользователем значения для этого параметра в любых задачах категории. При вводе текста подсказки скрываются.

Длинные названия в списке. Если название связанной задачи не помещается по ширине выпадающего списка и обрезается, при наведении курсора на пункт списка появляется всплывающая подсказка с полным текстом. Для коротких названий, которые видны целиком, подсказка не показывается. Поведение одинаково в списках одиночного выбора («Ссылка») и множественного выбора («Множественная ссылка»).

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

Подсказки не заменяют проверку прав: доступность задач определяется настройками доступа категории-источника. Также подсказки не отображаются для подчинённых Lookup-полей при настроенной связи. У «Выбора нескольких задач из категории» подсказки сверяются с текущим отбором так же, как у одиночного lookup: чип со значением вне отбора не выводится и значение по нему не добавляется — и в карточке задачи, и при правке значения в ячейке таблицы. Уже записанные в параметр значения при смене отбора не удаляются, а при выключенных подсказках поведение поля не меняется.

Сохранение выбранных значений при создании задачи

Значения, выбранные в полях «Ссылка» и «Множественная ссылка» на форме создания задачи, сохраняются в созданной задаче и видны в её карточке.

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

Создание и удаление связанных значений

Новые связанные задачи в lookup-полях можно создавать прямо из поля поиска, а существующие связи — удалять в режиме редактирования.

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

Условия	Поведение
Нет обязательных ДП, срока, исполнителя	Кнопка «Создать» в выпадающем списке. Создаёт задачу с текстом из поля поиска и сразу подставляет в ДП
Есть обязательные поля	Кнопка + открывает полную карточку создания. После сохранения задача подставляется в ДП

Кнопка создания доступна только при праве «Создавать задачи» в категории и при отсутствии запрета на создание из ДП. Если задача не может быть создана из-за автоматизации (например, отмена при постановке) — модальное окно с выбором: «Отменить» / «Продолжить в форме».

В режиме редактирования у выбранного значения отображается иконка удаления; по клику значение очищается. В Multilookup — кнопка удаления у каждого элемента списка.

Табличный вид параметра Multilookup

Для параметра Multilookup доступен табличный вид с настраиваемыми колонками и поддержкой импорта/экспорта в Excel.

Доступные колонки в табличном виде настраиваются администратором. Таблица в карточке задачи показывает без прокрутки столько строк, сколько задано в настройке «Количество строк на странице» (при значении 0 — 20), а если выбранных задач меньше — по их числу. Остальные строки листаются прокруткой внутри таблицы и подгружаются с сервера порциями, поэтому доступны все выбранные значения.

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

Формат значений в колонках. Числовые и денежные значения в таблице показываются в привычном виде: дробная часть отделяется запятой, разряды — пробелом (7 816,57). Разделять разряды или нет, задаёт настройка «Разделитель разрядов» ДП-источника: при выключенной настройке значение выводится как 7816,57. Число знаков после запятой берётся из настройки «Дробная часть»; если у денежного ДП-источника настройки не заданы, выводятся два знака, а числовая колонка без настроек показывается целым значением.

Группировка строк. Строки табличного вида можно сгруппировать по любой колонке, кроме служебной колонки действий: пункт группировки вызывается из меню колонки, а после включения над таблицей появляется панель группировки, где её можно изменить или снять. Группы считаются на сервере по всему набору выбранных значений, а не по уже загруженным строкам: счётчик на группе равен числу строк в ней, а при раскрытии показываются только строки этой группы, тоже порциями. В колонке-ссылке группы строятся по самой связанной задаче, а не по её отображаемому тексту, поэтому две разные задачи с одинаковым названием не сливаются в одну группу; строки с незаполненной ссылкой попадают в отдельную группу «Нет значения». Сортировка и фильтр в сгруппированном виде работают по-прежнему.

Если в табличной части выведена колонка «Текст в режиме Телефон» и настроена интеграция с корпоративной телефонией — рядом с номером появляется кнопка быстрого вызова.

Редактирование значений в ячейках. Значения колонок из «Параметров в гриде» можно менять прямо в таблице, не открывая задачу-источник: клик по ячейке открывает редактор, а после выхода из него значение сразу сохраняется в соответствующий ДП задачи этой строки. Редактируются колонки типов Текст, Большой текст с форматированием, Число, Деньги, Нумератор, Дата, Дата и время, Выпадающий список без редактирования и Lookup поле. Ячейку можно изменить, только если текущему пользователю разрешено менять этот ДП в задаче-источнике; отдельной настройки для этого нет. Ячейка поддерживаемого типа без такого права показана серой, редактор в ней не открывается.

Сквозной ДП в колонке. В колонки табличного вида выводится и сквозной ДП — он показывает значение из связанной задачи-источника, а не из самой строки. Числовое значение подставляется, когда источник сквозного числовой: у сквозного над ДП «Число» в колонке видно число источника, у сквозного над ДП «Деньги» — сумму источника, как в карточке задачи. Если источник — лукап, галочка или файл, числового значения в колонке нет. То же правило действует для сквозных ДП в колонках табличного представления категории.

Импорт/экспорт Excel:

• Экспорт — выгрузка всех значений в xls.
• Импорт — добавляет значения к существующим (не перезаписывает). Файл должен содержать только данные без заголовков.

ДП «Файл»: пользовательский интерфейс

Дополнительный параметр типа «Файл» предназначен для загрузки документов и изображений в карточку задачи.

Загрузка, сканирование и ограничения файлов

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

Под полем — кнопка «Прикрепить файл» (в поле «Мультифайл» — «Прикрепить файлы») и меню «…» с остальными способами: «Вставить из диска», «Картинка из буфера обмена», «Сканировать», «Создать» с подменю «Текстовый документ» и «Таблица»; у «Мультифайл» ниже разделителя — «Скачать все файлы». Пункты, недоступные по настройкам поля, не показываются, а если не остаётся ни одного — меню не выводится. В режиме только сканирования главной кнопкой становится «Сканировать». Пункт «Создать» есть в карточке сохранённой задачи, если в системе подключён онлайн-редактор Р7-Офис или OnlyOffice, поле доступно для изменения и не ограничено только изображениями: он создаёт пустой документ Word или таблицу Excel прямо в поле и сразу открывает его в этом редакторе для редактирования. «Текстовый документ» показывается, если поле допускает .docx, «Таблица» — если допускает .xlsx. Новый файл называется «Новый документ» или «Новая таблица», а если в поле уже есть файл с таким именем — с номером « (1)», « (2)». В поле «Файл» документ создаётся, только пока поле пустое; в поле «Мультифайл» он добавляется к прикреплённым. Если изменение поля требует комментария, комментарий запрашивается до создания документа. После закрытия редактора поле обновляется без перезагрузки карточки. Если документ создать не удалось, показывается сообщение об ошибке, и редактор не открывается.

Загрузить файл можно тремя способами:

• кнопкой «Прикрепить файл» под полем;
• перетаскиванием с рабочего стола;
• из буфера обмена — пункт «Картинка из буфера обмена» в меню «…». Только для скриншотов и скопированных в браузере изображений.

В однофайловом поле новый файл заменяет предыдущий; в мультифайловом — добавляется к списку. Когда поле «Файл» заполнено, кнопки «Прикрепить файл» под ним и кнопки замены на карточке нет: на карточке файла остаются меню «…» и крестик удаления. Замена устроена как «удалить — вложить»: по крестику файл убирается из поля, после чего под полем снова появляется кнопка «Прикрепить файл». Перетащить новый файл поверх заполненной карточки нельзя.

Ещё один способ — вставить файл с Диска: пункт «Вставить из диска» в меню поля, он доступен, если в настройках ДП разрешена загрузка из Диска. Файл, попавший в параметр с Диска, не копируется: в параметре сохраняется ссылка на исходный файл, и в меню такого файла появляется пункт «Открыть в папке диска».

Обрезка изображения по заданной пропорции. Если в настройках параметра задан «Тип пропорции», прикрепление изображения в формате JPEG, PNG, WebP или GIF открывает окно обрезки с рамкой фиксированного соотношения сторон. В параметр сохраняется только обрезанная копия, исходное изображение не загружается; GIF сохраняется как PNG. Отмена в окне обрезки отменяет вложение, прежнее значение параметра остаётся. Без этой настройки изображение загружается как есть, на файлы других форматов — PDF, документы — обрезка не распространяется. Окно открывается при выборе файла на устройстве, перетаскивании и вставке из буфера обмена; вложение с Диска и сканирование обрезку не запускают.

Состояния загрузки:

• В процессе — название и процент выполнения; кнопка отмены.
• Ошибка — сообщение «Ошибка загрузки» с кнопкой повторной попытки.
• Загружен — название, размер, дата загрузки. Длинное имя сокращается многоточием.

Файлы 0 байт не загружаются: «Файлы не переданы или не содержат данных».

Сканирование Если для ДП включена опция сканирования, в меню «…» под полем появляется пункт «Сканировать»; в режиме только сканирования он становится главной кнопкой вместо «Прикрепить файл».

Добавление файла из таблицы категории (с 2.265) В табличном виде категории по правому клику на файловую ячейку доступен пункт «Добавить файл» — открывается диалог выбора файла. После загрузки таблица обновляется, имя файла появляется в ячейке.

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

Если карточка этой задачи уже открыта в модальном окне, повторный отказ вложения — в том числе из грида используемых задач — не открывает вторую карточку: файл и текст смарт-отмены подставляются в уже открытую. Для категорий, где задача открывается не в карточке SPA, а в старой форме задачи, подставить файл в открытое окно нельзя, и открывается новое окно карточки.

Ограничения при загрузке

Ограничение	Поведение
Список разрешённых расширений	Настраивается администратором (список в подсказке к полю). При попытке вложить неподходящий тип — ошибка
«Только изображения»	При загрузке любого другого типа — ошибка
Максимальный размер	При превышении — ошибка с указанием лимита

Обновление поля при изменениях в другом месте

В карточке сохранённой задачи поле «Файл» или «Мультифайл» обновляется само, когда файл вложили или удалили в другой вкладке или это сделал другой пользователь, — в том числе если поле в этот момент раскрыто на редактирование. Файл, который показан в поле, но ещё не загружен на сервер, при таком обновлении заменяется актуальным значением поля. В форме создания задачи вложения автоматически не перезаписываются.

Действия и контекстное меню файлов

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

Пункт	Описание
Просмотр	Открыть файл (как клик по файлу)
Скачать	Сохранить локально. Скрыт, если включена опция «Защитить файл от загрузки». Скачивание блокируется при отсутствии прав, в т.ч. при перевоплощении
Открыть в папке диска	Перейти к папке Диска. Только для файлов, вложенных из Диска (отмечены специальной иконкой)
Открыть в новой вкладке	Просмотр файла в новой вкладке
Просмотр версий	Окно истории версий
Скопировать ссылку	Полный URL файла
Подписи ЭЦП	Список подписей (если у файла есть ЭЦП)
Удалить	Удалить файл из ДП и блока «Файлы»

В полях «Файл» и «Мультифайл» заполненный файл удаляется и кнопкой прямо на карточке — крестиком справа от названия, рядом с меню «…». Кнопка действует так же, как пункт «Удалить»: файл убирается из ДП и из блока «Файлы». Крестик виден, только если поле доступно на запись и удаление файлов разрешено настройкой категории: в режиме «только чтение» и без этого права крестика нет, как и пункта «Удалить» в меню. Если у поля включено «изменение с комментарием», перед удалением запрашивается причина; при отмене диалога файл остаётся в поле. В форме создания задачи удаление разрешено всегда, поэтому крестик есть и там.

Там, где поле показывается в прежнем виде — например, в редакторе файловой ячейки табличного ДП, — в дополнительном меню однофайлового поля (кнопка … справа от файла) также доступны:

• Заменить на изображение из буфера обмена — замена текущего вложения на скриншот.
• Вставить из диска — переход к связанной с задачей папке на Диске (если связь настроена). После смены версии файла на Диске файл обновляется и в поле ДП.

Имя файла и история Имя файла может совпадать с исходным или генерироваться автоматически. При повторных загрузках в имя может добавляться время в формате hh:mm. История изменений значений ДП — кнопка справа от имени файла. История версий файла — отдельный механизм; доступна когда у файла больше одной версии. В таблице — версия, кто вложил, дата, размер. Последняя версия выделена цветом и идёт первой.

Просмотр и редактирование документов Документы Microsoft Office можно просматривать и редактировать в браузере — без сохранения локально. Способ открытия настраивается в персональных настройках («Прочее»).

При доступе к ДП только на чтение редактирование вложенного файла недоступно.

Типы колонок ДП «Таблица»

Дополнительные параметры типа «Таблица» поддерживают различные пользовательские типы данных в своих столбцах.

Пользовательские типы данных в столбцах таблицы:

Тип колонки	Описание
Ссылка на задачу	Выбор задач из категории с поиском; при вводе несуществующего названия — предложение создать новую задачу; отображение как активные ссылки. Стилизация: возможны опции отображения цвета аватара или иконки задачи
Текст с шаблоном	Ввод по регулярному выражению (\w — латинские буквы, \d — цифры); при редактировании показывается подсказка с фиксированным текстом. Примеры шаблонов: Утвердить сотруднику \w выполнение ЦП за \w на \d %, Проект \w-\d, Заявка №\d
Телефон	Автоматическое форматирование (знак «+», скобки кода); при интеграции с корпоративной телефонией — кнопка быстрого вызова
Число	Диапазон: ±99 999 999 999 999; настраиваются дробная часть, минимум, максимум, нулевое значение как пустое
Деньги	Диапазон: –922 337 203 685 476.99 … +922 337 203 685 476.99. Знак валюты в столбце таблицы не отображается — для указания валюты используется заголовок столбца
Сумма по колонке	Итоговое значение по всей таблице для числовых столбцов
Файл	Один или несколько файлов в виде ссылок; двойной клик — стандартное представление с действиями
Галочка	Переключение клавишей Space при фокусе; автосохранение
Блок кнопок	Колонка не с данными, а с действиями: в каждой строке выводятся кнопки, запускающие JS-выражение или пакет смарт-действий. Видимость и активность кнопок задаются значениями других колонок строки или смарт-фильтром. Фильтрация по такой колонке не работает
URL	Адрес отображается кликабельной ссылкой — и в колонке, и в ячейке. Схема проверяется по общему списку разрешённых: адреса с веб-схемой открываются в новой вкладке, mailto:, tel: и e1c: передаются системному обработчику

Подробнее: Справочник типов ДП

Связи таблиц: значения ДП (модель данных)

Значения ДП в задачах хранятся в ExtParamValues (ключ — пара «задача + ДП»): простые типы лежат в типизированных колонках (ExtParamValue — строка, DateTimeValue, MoneyValue, DecimalValue, BoolValue), Lookup — в SelectedTaskId, адрес — ссылкой на Address. Сложные типы вынесены в отдельные таблицы: «Таблица» — ExtParamTableValues, «Выбор нескольких задач» — ExtParamValueSelectedTasks (+ папки ExtParamValueSelectedTaskFolders), «Выбор пользователей» — ExtParamSelectUsersValues и ExtParamSelectUsersValuesGroups, «Файл» — ExtParamsFiles.

graph LR
    EPV["ExtParamValues — значения ДП"]
    EP["ExtParams — справочник ДП"]
    T["Tasks — задачи"]
    ADR["Address — адресный классификатор"]
    EPTV["ExtParamTableValues — ДП «Таблица»"]
    EPST["ExtParamValueSelectedTasks — ДП «Выбор задач»"]
    EPSTF["ExtParamValueSelectedTaskFolders — папки выбора задач"]
    EPSU["ExtParamSelectUsersValues — ДП «Выбор пользователей»"]
    EPSUG["ExtParamSelectUsersValuesGroups — группы выбора"]
    EPF["ExtParamsFiles — ДП «Файл»"]
    U["Users — пользователи"]
    G["Groups — группы"]
    EPSUO["ExtParamSelectUsersValuesOrgUnits — выбор орг.единиц"]
    OSU["OrgStructureUnit — орг.единицы"]

    EPV -- "TaskID" --> T
    EPV -- "ExtParamID" --> EP
    EPV -- "SelectedTaskId (Lookup)" --> T
    EPV -- "AddressId" --> ADR
    EPTV -- "TaskID" --> T
    EPST -- "TaskID / SelectedTaskID" --> T
    EPST -- "ExtParamID" --> EP
    EPST -- "FolderId" --> EPSTF
    EPSU -- "UserID" --> U
    EPSU -- "ExtParamID" --> EP
    EPSUG -- "GroupID" --> G
    EPSUG -- "ExtParamID" --> EP
    EPF -- "TaskID" --> T
    EPF -- "UserID" --> U
    EPF -- "ExtParamID" --> EP
    EPSUO -- "OrgStructureUnitID" --> OSU
    EPSUO -- "ExtParamID" --> EP

ДП «Выбор пользователей» хранит выбранное раздельно по видам: пользователи — ExtParamSelectUsersValues, группы — ExtParamSelectUsersValuesGroups, орг.единицы — ExtParamSelectUsersValuesOrgUnits.

Денормализация. Для быстрого чтения значений ДП «Таблица» система генерирует по одному представлению (VIEW) на каждый такой ДП — ExtParamTable{ExtParamID}Denormalized, разворачивающему нормализованные строки в плоскую форму. Прежний механизм денормализации категорий (TaskInSubcat{ID}Denormalized) в актуальной версии не используется.

Полная версия с колонками и схемы связей других подсистем БД — в system/db-er-diagrams.md.