Дополнительные параметры: бизнес-логика¶

Обзор¶

Расширенные параметры (ДП) — механизм расширения задачной модели без изменения базовой схемы задачи.

Каждый ДП задаёт бизнес-поле с типом, правилами отображения, наследования, валидации и правами.

Доменная модель¶

Мета-уровень¶

Определение параметра (ExtParams).
Привязка к подкатегории (ExtParamsInSubcat).
Специализированные настройки (lookup/table/file/select-users/through).

Уровень значений¶

Значения параметров (ExtParamValues + типизированные колонки).
Связанные таблицы для сложных типов (lookup selected tasks, table rows, files и т.д.).

Основные сценарии¶

1. Добавление ДП в подкатегорию¶

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

2. Изменение значения в задаче¶

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

3. Наследование и копирование¶

При создании новой задачи часть параметров копируется из задачи-источника по правилам DontCopySourceTaskValue и NewTaskMode.

4. Сквозные параметры (Through)¶

Значение вычисляется/подтягивается по цепочке связанных задач и пересчитывается при изменении источника.

5. История изменений ДП¶

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

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

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

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

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

Бизнес-правила¶

Тип параметра определяет допустимый формат хранения и редактор.
Права на просмотр/редактирование применяются до сохранения значения.
Наследование при создании задачи управляется настройками подкатегории, а не только UI.
Through-цепочки должны быть валидны и непротиворечивы до запуска пересчёта.

Зависимости¶

tasks, categories, smart-filters, form-controls, files, users-and-groups.

Операционные риски¶

Неконсистентная конфигурация lookup/through.
Ошибки наследования при создании задач из разных точек UI.
Деградация чтения при большом объёме ExtParamValues без корректных оптимизаций.

Что проверять при инцидентах¶

Настройки ExtParamsInSubcat и типовые настройки ДП.
Сохранённые значения в ExtParamValues и связанных таблицах.
Выполнение PullThroughExtParam для through-кейсов.
Параметры входного API при создании/обновлении задачи.

Пользовательские сценарии: специализированные типы¶

ДП «Адрес»¶

Поле адреса распознаёт введённое значение и предлагает варианты из списка с указанием точности:

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

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

См. также: types-reference.md#дп-адрес-address — хранение и настройки

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

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

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

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

См. также: types-reference.md#дп-адресаты-email-extparamaddressees — хранение

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

Управление видом¶

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

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

Виртуальные колонки¶

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

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

Редактирование ячеек¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Множественный выбор (для ключевого столбца)¶

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

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

Секционирование¶

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

Импорт и экспорт Excel¶

Операция

Особенности

Экспорт

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

Импорт

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

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

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

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

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

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

Файлы в ячейках¶

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

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

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

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

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

Отображение в виде ссылки¶

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

Итоговое значение по колонке¶

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

Отображение в виде набора полей (с 2.265)¶

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

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

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

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

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

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

ДП «Галочка» (Checkbox): пользовательский интерфейс¶

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

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

ДП «URL» (Внешняя ссылка): пользовательский интерфейс¶

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

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

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

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

Вкладки¶

По умолчанию чек-лист без вкладок. Кнопка + добавляет вкладку с указанным названием. При нескольких вкладках навигация — кликом по их названиям.

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

Задачи (элементы списка)¶

Два способа добавить задачу:

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

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

Для редактирования — клик по задаче, изменения, «Сохранить».

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

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

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

Ввод значения¶

Три способа:

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

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

Видимые и доступные даты¶

Администратор может настроить два независимых диапазона:

Видимые даты — какие даты вообще отображаются в календаре.
Доступные для выбора — какие из них можно выбрать.

Пример: видимые 01.02 – 28.02, доступные 03.02 – 09.02.

Слоты для «Дата и время»¶

Доступны два варианта: - Свободный формат — произвольный ввод времени. - Слоты — фиксированный набор времён.

Для слотов настраивается: - Диапазон: рабочее время или 24 часа. - Шаг: 5, 15 или 30 минут.

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

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

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

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

Нумератор (для «Число»)¶

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

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

Без форматирования¶

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

С форматированием¶

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

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

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

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

Удаление элемента в Editor.js¶

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

Локализация¶

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

Эмодзи¶

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

Ошибка показа Editor.js¶

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

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

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

Режим «Телефон»¶

Лимит — 18 символов (поддерживает российские и зарубежные номера). Знак + и скобки вокруг кода города проставляются автоматически.

Слева от поля — флаг страны. Клик открывает список стран с поиском по коду или названию. При интеграции с корпоративной телефонией рядом с номером появляется кнопка быстрого вызова.

Подсказки при вводе¶

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

Локализация¶

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

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

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

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

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

Поведение¶

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

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

Варианты отображения¶

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

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

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

Поиск значений¶

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

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

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

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

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

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

Создание значения «на лету»¶

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

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

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

Удаление значения¶

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

Multilookup: табличный вид¶

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

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

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

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

Загрузка¶

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

В однофайловом поле новый файл заменяет предыдущий; в мультифайловом — добавляется к списку.

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

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

Контекстное меню файла¶

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

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

Имя файла и история¶

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

История изменений значений ДП — кнопка справа от имени файла.

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

Просмотр и редактирование документов¶

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

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

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

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

Сканирование¶

Если для ДП включена опция сканирования, под полем появляется кнопка «Сканировать».

Добавление файла из таблицы категории (с 2.265)¶

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

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

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

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

См. также: types-reference.md — полный справочник типов ДП и колонок таблиц