Таблица

Основные настройки

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

| Параметр | Описание |

| Режим Excel

Функция временно недоступна. В настоящее время она находится в стадии активной разработки

Дополнительные настройки

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

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

-Текст, -Деньги, -Выпадающий список, -Телефон, -Lookup, -Число, -Дата, -Дата и время, -RowID (в этом случае при импорте строки будут сопоставляться по порядковому номеру).

ℹ️ Если ключевой столбец не задана, то таблица импортируется в режиме полной перезаписи — все существующие строки удаляются и добавляются новые из файла

Параметр	Описание
Отображать как	Вид отображения таблицы:

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

Таблица в виде полей

Параметр	Описание
Максимальная высота таблицы в PX	Определяет максимальную высоту области отображения строк таблицы. Таблица отображает все данные сразу в пределах указанной высоты. Если данные не помещаются, появляется вертикальная полоса прокрутки. По умолчанию высота строк в ДП Таблица подстраивается автоматически под их содержимое. Вместо фиксированного расчета высоты система анализирует реальное наполнение каждой ячейки — учитываются переносы текста, превью изображений и кнопки управления. Минимальная высота строки при этом зафиксирована на уровне 150 пикселей, а максимальная определяется данной настройкой. Таблица работает без пагинации, поэтому отображение всегда идет единым списком: если в таблице всего одна запись, она занимает ровно одну строку, а если строк много, но они компактны, таблица растёт до тех пор, пока не достигнет максимальной высоты, после которой появляется полоса прокрутки. В тех случаях, когда записей очень много или требуется детальная работа с данными, предусмотрена кнопка раскрытия в модальное окно.
Разрешить экспорт	Если флажок включен, то в пользовательском режиме в правом верхнем углу таблицы будет отображаться иконка экспорта. По клику на нее будет открываться окно для выгрузки данных из таблицы в файл Excel.

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

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

ℹ️ Если ключевой столбец (см. выше) не задан, то таблица импортируется в режиме полной перезаписи — все существующие строки удаляются и добавляются новые из файла

Особенности импорта описаны в Руководстве пользователя |

Параметр	Описание
Загружать файлы в момент вкладывания	Если флажок включен, то файл, вложенный в ячейку, загружается в БД в момент вкладывания. Если флажок отключен, то загрузка вложенных файлов начинается в момент сохранения таблицы
Файловый провайдер	Выбор одного из файловых провайдеров, настроенных в системе. Если параметр не указан, используется провайдер по умолчанию
Сохранять строку после редактирования	Если настройка активна, то после добавления\удаления строки или редактирования ячейки таблица сразу же сохраняется автоматически. Кнопка "Сохранить" в таблице будет скрыта. Выбор ячейки при использовании клавиш Tab и Enter для перемещения по таблице не сбрасывается при активной опции, что позволяет продолжить работу в таблице без прерывания, используя клавиатуру
Создавать строки в модальном окне	Если настройка активна, то при добавлении строки в таблицу по кнопке "+" откроется модальное окно для ввода значений столбцов. Строка появится в таблице после нажатия кнопки "Ок" в модальном окне. Если настройка неактивна (значение по умолчанию), сразу добавляется пустая строка и данные могут быть заполнены в самой таблице, как в режиме редактирования без дополнительных окон
Включить секции столбцов в настройках таблицы	Включение настройки секций столбцов. Пример таблицы с настроенными секциями:

ℹ️ Выбранный файловый провайдер в настройках ДП учитывается, если значение ДП изменяется вручную, с помощью смарт-действия "Скачать файл" и с использованием LUA-скрипта. Во всех остальных случаях, включая другие смарт-действия, будет использован провайдер по умолчанию

Пример таблицы с настроенными секциями

ℹ️ Секции работают только в режиме с автоматическим сохранением данных — должна быть активна настройка Сохранять строку после редактирования

После активации настройки во вкладке Столбцы появится возможность выбора настроенных секций для столбцов. Секции создаются и настраиваются во вкладке Настройка секций столбцов |

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

Динамическая обязательность

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

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

Каждое правило содержит следующие поля:

Поле	Описание
Активный	Признак того, что правило участвует в проверке. Если флажок снят, правило сохраняется в настройках, но не применяется.
Целевая колонка	Столбец таблицы, который станет обязательным для заполнения при выполнении условий правила. Для условий можно выбирать столбцы текущей таблицы, кроме той колонки, которая указана как целевая.
Логика условий	Способ объединения условий внутри одного правила: -И (все условия) — правило срабатывает, только если выполнены все заданные условия. -ИЛИ (любое условие) — правило срабатывает, если выполнено хотя бы одно из условий.
Условия	Список проверок, по которым определяется, должна ли целевая колонка стать обязательной. Для добавления новой проверки используется кнопка Добавить условие. Если условия ещё не заданы, отображается сообщение Нет условий.

Каждое условие состоит из трёх частей:

-Столбец условия — столбец таблицы, значение которого будет проверяться. Для условий можно выбирать столбцы текущей таблицы, кроме той колонки, которая указана как целевая. -Оператор сравнения — одно из значений: = (равно), ≠ (не равно), > (больше), < (меньше), ≥ (больше или равно), ≤ (меньше или равно), пусто, не пусто, содержит, не содержит. -Значение для сравнения — значение, с которым система будет сравнивать содержимое выбранного столбца. Для столбцов типа Выпадающий список варианты значений подгружаются из настроек этого столбца.

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

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

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

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

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

Условное форматирование

Во вкладке Условное форматирование настраиваются правила подсветки ячеек по аналогии с Excel. Функция доступна для столбцов типов Число, Деньги и Текст.

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

Каждое правило содержит следующие поля:

Поле	Описание
Активно	Признак того, что правило участвует в проверке. Если флажок снят, правило сохраняется в настройках, но не применяется.
Колонка	Столбец таблицы, для ячеек которого будет применяться подсветка. Доступны столбцы с типом Число, Деньги и Текст.
Тип правила	Условие, при выполнении которого ячейка будет подсвечена. Для столбцов типа Число и Деньги доступны следующие типы правил: -Больше числа X — значение в ячейке больше X. -Меньше числа X — значение в ячейке меньше X. -Больше или равно X — значение в ячейке больше X или равно ему. -Меньше или равно X — значение в ячейке меньше X или равно ему. -Равно X — значение в ячейке равно X. -Не равно X — значение в ячейке не равно X. -Между X и Y — значение в ячейке больше X и меньше Y (включительно). -Вне X и Y — значение в ячейке меньше X или больше Y. -Минимум — ячейка содержит наименьшее значение в столбце. -Максимум — ячейка содержит наибольшее значение в столбце. -Повторяющиеся значения — в столбце есть другие ячейки с таким же значением. Для столбцов типа Текст доступны следующие типы правил: -Содержит — значение ячейки содержит строку X. -Не содержит — значение ячейки не содержит строку X. -Начинается с — значение ячейки начинается со строки X. -Заканчивается на — значение ячейки заканчивается на строку X. -Равен — значение ячейки в точности совпадает со строкой X. -Не равен — значение ячейки не совпадает со строкой X. -Повторяющиеся значения — в столбце есть другие ячейки с таким же значением.
Значение X	Пороговое значение для сравнения. Обязательно для типов правил, требующих одного порогового значения. Для числовых столбцов вводится число, для текстовых — строка.
Значение Y	Второй пороговый параметр. Заполняется при типах правил Между и Вне (задаёт второй предел диапазона).
Цвет	Цвет подсветки ячейки. Выбирается из предопределённого набора цветов (например: Основной, Красный, Зелёный, Жёлтый и др.).
Тон	Насыщенность выбранного цвета. Возможные значения: Светлый и Тёмный.
Приоритет	Числовое значение, определяющее порядок применения правил при конкуренции. Если несколько правил применимы к одной ячейке, применяется правило с наибольшим приоритетом. При одинаковом приоритете у нескольких правил применяется первое совпавшее.

Чтобы удалить правило, нажмите кнопку Удалить в карточке правила.

ℹ️ Если ячейка помечена как обязательная для заполнения (рамка обязательности), рамка отображается поверх фона подсветки и не теряется на её фоне.

ℹ️ Для столбцов типа Lookup и MultiLookup условное форматирование данной вкладки не настраивается: цвет этих столбцов берётся из связанной задачи или справочника по прежней логике.

Столбцы

Во вкладке Столбцы содержатся настройки столбцов таблицы. Каждая строка таблицы настроек соответствует столбцу таблицы в пользовательском режиме.

Чтобы добавить в таблицу новый столбец, нажмите кнопку Создать. Для редактирования настроек столбца выберите его в общем списке.

Параметр (столбец)	Описание
ID	Идентификатор столбца
Имя	Название столбца, которое будет отображаться в таблице
Порядок	Порядок расположения столбцов в пользовательском режиме. По умолчанию для всех столбцов установлено значение 0. Если порядок не указан, то столбцы отображаются в порядке следования
Участвует в группировке, порядок	Возможность задавать группировку в таблице по умолчанию. В это поле можно ввести цифру — номер позиции в группировке по умолчанию. Если оставить поле пустым, колонка не будет участвовать в группировке. Чем больше число, тем глубже уровень вложенности: например, строки с цифрой «2» будут вложены внутрь групп, обозначенных цифрой «1». Если номера идут не по порядку (например, заданы только 1 и 3), система все равно корректно выстроит иерархию, где самый большой номер отвечает за самый глубокий уровень. Важно учесть, что функция группировки не применяется, если одновременно активен режим секций — в такой ситуации приоритет всегда остается за секциями
Тип	Тип данных в столбце. Доступные типы данных:

-Текст -Большой текст без форматирования -Выпадающий список -Текст с маской -Деньги -Дата и время -Дата -Телефон -LookUp -Чекбокс (флажок) -Число -Файл -Виртуальная -Шаблонная -Блок кнопок -Выбор пользователей | Название секции

ℹ️ Поле доступно, если во вкладке Дополнительные настройки активна опция Включить секции столбцов в настройках таблицы

Выбор одной из настроенных секций во вкладке Настройка секций столбцов |

Параметр (столбец)	Описание
Сортировка по умолчанию	Столбец для сортировки строк таблицы. Возможные значения: -Нет -По возрастанию -По убыванию Может быть выбран только один столбец сортировки. Если в таблице уже был выбран столбец для сортировки, то при выборе другого столбца в прежнем сортировка отключается. Сортировка применяется автоматически при любом изменении значений в строках таблицы — как при ручном редактировании ячеек, так и при изменении через смарт-кнопки. Порядок строк обновляется сразу после сохранения без необходимости перезагрузки страницы.
Смарт выражение	Смарт-выражение для вычисления значения в столбце. Доступно для столбцов: Текст, Число, Дата, Дата и время, Деньги, Lookup, Большой текст без форматирования, Выбор пользователей Смарт-столбцы могут ссылаться друг на друга. Порядок вычисления смарт-столбцов определяется порядком их отображения в ДП "Таблица" (свойство "Порядок", если оно установлено, иначе — порядок создания столбцов). При использовании смарт-выражения для столбца становится недоступным режим "Обязателен для заполнения". Смарт-столбцы вычисляются в момент, когда пользователь завершил редактирование строки в ДП "Таблица" и сохранил изменения, но после вычисления и сохранения в БД всех "не смарт" столбцов в данной строке таблицы
Маска	Маска для данных типа "текст". Для прежней версии ДП "Таблица": При описании маски используются следующие спецсимволы: -# — цифра или пробел, -L — обязательно большая буква, -l — обязательно маленькая буква, -a — любой символ, -\<n..m> — обязательно числовое значение от n до m, -\<Символ1|Символ2|Символ3> — один из указанных символов,
Столбец шаблона значения	Настройка заполнения значения по шаблону в текстовом столбце. Опция доступна только для типа "Текст".

В опции выбирается другой столбец этой же таблицы с типом "Lookup поле" или "Текст", который содержит шаблон в нотации RegEx. Шаблон может включать символы \w для прописных букв и \d для цифр, а пробелы вокруг них обязательны или могут быть началом/концом строки. Если указан столбец "Lookup поле", то шаблон должен быть написан в тексте выбранной задачи. Пример шаблона в карточке задачи для значения в столбце с типом "Lookup поле"

ℹ️ Буквы регистрозависимы, при этом в качестве начального символа может использоваться как правая, так и левая косая черта

Примеры шаблонов: |

-Утвердить сотруднику \w выполнение ЦП за \w на \d % -Проект \w-\d -Заявка №\d Сперва необходимо выбрать значение в столбце с шаблоном, после чего шаблон будет применен к текстовому столбцу. Выбран шаблон в столбце "Lookup поле" При редактировании ячейки текстового столбца будет отображаться подсказка с серым фоном и фиксированным текстом "Текст" или "Число" в зависимости от типа шаблона. Редактирование текстового столбца с шаблоном Подсказка скрывается при вводе, а введенный текст отображается на том же фоне. Если шаблон содержит ссылки, они подчеркиваются. Ввод значений в шаблон При просмотре таблицы введенный текст также отображается с фоновым выделением. Отображение параметра после сохранения

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

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

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

Параметр (столбец)	Описание
Режим столюца	Возможные значения:

-Необязательно — столбец доступен, но не обязателен для заполнения. -Обязательно — столбец обязателен для заполнения (в пользовательском режиме такие столбцы отображаются курсивом). Если в таблице есть обязательные для заполнения столбцы, то, при создании новой задачи, пока они не будут заполнены, кнопка создания останется неактивной.

ℹ️ Режим Обязательно действует только в рамках ДП "Таблица", отсутствие значения в данном столбце не будет блокировать создание задачи

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

ℹ️ Настройка «Обязателен для завершения» (на уровне категории) к ДП «Таблица» неприменима — тип является составным, и эта проверка для него не работает.

-Только для чтения — столбец доступен только для чтения. |

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

ℹ️ Обратите внимание: режим Невидимая не поддерживается для столбцов с типом "Виртуальная" и "Шаблонная"

| Значение по умолчанию | Значение, подставляемое по умолчанию. Возможные значения:
-Оставить пустым
| Работает только для ДП Таблица нового формата (2.256)| | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -Фиксированное значение |

-Smart выражение Шаблоны для фиксированных значений: -Дата: DD-MM-YYYY, например 10-22-2018 -Дата и время: DD-MM-YYYY hh:mm, например 10-22-2018 10:30 -Лукап: {"Номер задачи":"Текст задачи"}, например {"123":"Продажа"} -Выпадающий список: {"Значение":"Текст"}, например {"2":"Встреча"}

ℹ️ Указанный формат шаблонов используется только для фиксированных значений и не соответствует формату смарт-выражений

Параметр (столбец)	Описание
Локализованное значение	Локализованное значение названия столбца в таблице
Ширина столбца	Ширина столбца.

Если значение не задано (равно 0), то ширина рассчитывается автоматически в соответствии с типом данных столбца. Если необходимо задать возможность растягивать ширину столбца до любых размеров курсором мыши (включая числа, даты, деньги и т.д.), используйте следующие значения: -1 —  Узкий диапазон Столбец "Количество" с шириной 1 -2 — Малый диапазон Столбец "Количество" с шириной 2 -4 — Средний диапазон Столбец "Количество" с шириной 4 -6 — Широкий диапазон Столбец "Количество" с шириной 6 Другие значения интерпретируются как ширина в пикселях (px). В отличие от значений 1, 2, 4, 6 столбцы будут растягиваться по ширине только до своего предела в зависимости от типа | Макс высота | (Устаревшее, не используется) | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Максимальная высота столбца. |
Если значение не задано, в столбцах с типом "Текст", "Lookup поле" и "Большой текст без форматирования" полностью будет осуществлен перенос текстового значения по строкам. Если настройки высоты указаны, текст переносится до максимального значения и затем обрезается троеточием. Если для нескольких столбцов указано разное значение высоты, учитывается максимальное.
Если для столбца с типом "Файл" активна настройка Отображать превью для картинок и задана высота превью, она будет учтена в качестве высоты столбца таблицы. В случае, если для этой же или любого другого столбца в таблице задана максимальная высота и она меньше заданной высоты превью, учитывается высота превью в качестве максимальной | | Выравнивание текста | Определяет способ выравнивания заголовка столбца и его содержимого. Возможные значения: |

ℹ️ В настроящее время возможность ручного управления высотой строк или столбцов в таблице отсутствует. Если необходимо изменить количество отображаемых данных, воспользуйтесь настройкой Количество строк на странице

-по левому краю -по центру -по правому краю -по ширине

ℹ️ Выравнивание по ширине недоступно для нового ДП "Таблица"

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

ℹ️ Скрытые столбцы не экспортируются ℹ️ Скрытые столбцы и столбцы "только для чтения" не импортируются

После активации параметра текст будет автоматически переноситься на следующую строку при достижении ширины столбца. При отключенной настройке в столбце с типом "Выбор пользователей" данные отображаются в одну строку с обрезкой текста; при наведении курсора отображается полный список имен через запятую. Если пользователей несколько, виден только первый, за которым следует многоточие. При включенной настройке в ячейке можно выбрать только одного пользователя, и его имя отображается полностью с переносом | Видимость в закрытых секция | Столбец отображается в закрытой секции | | --- | --- | | Видимость в открытых секциях | Столбец отображается в открытой секции | | Участвует в поиске | Если опция активна, то данный столбец таблицы участвует в поиске в списке задач в категории, если включен режим в полях | | Логировать действия с файлами | Если настройка активна, то скачивание, просмотр, редактирование и удаление файла будет записано в системный журнал Диск.
Доступно только для столбца с типом Файл | | Итого | Вывод итогов по столбцу. |

Доступно только для столбца с типом Число, Деньги | Столбец шаблона значения

Функция временно недоступна. В настоящее время она находится в стадии активной разработки

Выбор столбца этой же таблицы с типом Текст или Lookup. |

Шаблон задается в виде регулярного выражения, которое указывается в столбце-источнике. Регулярное выражение работает в режиме редактирования и является регистрозависимым, где символ \w соответствует только прописным латинским буквам, а символ \d — любым цифрам. Пробелы вокруг этих символов обязательны, вместо пробела может быть начало или конец строки. Например, если значение столбца-шаблона — "Утвердить сотруднику \w выполнение ЦП за \w на \d %", то ввод в целевом столбце будет проверяться по этому шаблону. Для столбца типа "Lookup" в качестве шаблона используется текстовое значение связанной задачи. Проверка выполняется отдельно для каждой строки таблицы. Доступно только для столбца с типом Текст

Параметр (столбец)	Описание
Настройки	Переход к дополнительным настройкам столбца (см. ниже)

Следующие виды столбцов имеют свои дополнительные настройки: Lookup, Выбор пользователей, Выпадающий список, Файл, Число, Деньги, Виртуальная, Шаблонная и Блок кнопок. Они доступны в окне настроек при клике на строку во вкладке Дополнительные настройки или в столбце Настройки.

Дополнительные настройки столбца Lookup

Столбец Lookup настраивается путем создания или выбора ДП соответствующего типа.

Дополнительные настройки столбца Выбор пользователей

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

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

Дополнительные настройки столбца Выпадающий список

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

Дополнительные настройки столбца Чекбокс (флажок)

Столбец типа "Чекбокс (флажок)" представляет собой поле выбора, которое может принимать только значения "да/нет" (вкл/выкл).

Визуальное отображение: - В режиме просмотра отображается как чекбокс с отступами, оптимизированными для таблиц - В режиме редактирования чекбокс доступен для изменения при клике

Особенности: - Ширина столбца автоматически подстраивается под размер чекбокса - Рекомендуется использовать выравнивание "по центру" для лучшей визуализации

Дополнительные настройки столбца Файл

Столбец типа Файл настраиваются частично как ДП "Файл" (блок Работа с файлами Word, описание настроек см. здесь). Кроме этого, есть три дополнительные настройки:

Параметр	Описание
Разрешить сканирование	Если настройка активна, в окне добавления строки в таблицу рядом с полем "Файл" отображается значок сканирования
Создавать системные копии вложенных файлов при акцепте подписи	При акцепте подписи будет создана системная копия файла
Отображать превью для картинок	Отображать превью для картинок с указанием размеров превью.

Не работает для ДП с признаком "Мультифайл". Дополнительные настройки столбца Число

Столбец Число настраивается путем создания или выбора ДП соответствующего типа.

ℹ️ Обратите внимание: в столбце "Число" допустимый диапазон составляет от --99 999 999 999 999 до +99 999 999 999 999

Дополнительные настройки столбца Деньги

Столбец Деньги настраивается путем создания или выбора ДП соответствующего типа.

ℹ️ Обратите внимание: в столбце "Деньги" допустимый диапазон составляет от --922 337 203 685 476.99 до +922 337 203 685 476.99

Дополнительные настройки столбца Виртуальная

Виртуальный столбец позволяет отобразить в таблице дополнительные данные. Например, в таблице выбирается артикул товара, но необходимо отобразить также цвет и количество единиц в упаковке. В этом случае для артикула настраивается столбец Lookup, а для цвета и количества единиц в упаковке — два виртуальных столбца. Виртуальные столбцы имеют режим "только для чтения".\ В дополнительных настроках для виртуального столбца выбирается уже настроенный в таблице столбец Lookup, где хранится ссылка на задачу, и один из параметров в категории, на которую смотрит этот Lookup — этот параметр будет отображаться в столбце.\ Если виртуальный столбец имеет тип "Файл", то для него становятся доступны настройки превью изображений: Высота превью изображения, Ширина превью изображения, Отображать превью для картинок.

Примечание. Виртуальная колонка наследует настройки отображения Lookup-столбца, на который ссылается, включая параметр «Отображать как текст». Настройка применяется как в самой таблице, так и в окне множественного выбора.

Примечание. Если виртуальная колонка настроена на отображение значения дополнительного параметра из другой задачи (Виртуальная колонка ссылается на ДП), то при изменении этого параметра значение в таблице обновляется автоматически в реальном времени для всех пользователей, у которых задача с таблицей открыта в данный момент (или была открыта в течение последнего часа). Автоматическое обновление не применяется к проектным ДП-Таблицам (настроенным через ProjectTableJSONExtParamID в системных настройках), чтобы избежать избыточной нагрузки на интерфейс.

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

Дополнительные настройки столбца Шаблонная

Шаблонный столбец позволяет объединить в одном столбце данные из нескольких ДП. Шаблон может задаваться выражением вида "текст1 {{c123.stringValue}} текст2 {{с456.stringValue}} текст3", где 123 и 456 — ID других столбцов таблицы. Обратите внимание: запись регистрозависима, т.е. stringValue — корректно, а StringValue — нет.\ Принципы работы с шаблонами описаны здесь

ℹ️ В пользовательском режиме недоступна фильтрация по шаблонному столбцу

Дополнительные настройки столбца Блок кнопок

Столбец Блок кнопок имеют следующий набор дополнительных настроек:

Название	Описание
Имя	Текст, который будет отображаться на кнопке, если не задана иконка. Если для кнопки указана иконка, имя будет отображаться вместо описания во всплывающей подсказке при наведении курсора мыши на кнопку.

Кнопка без иконки и кнопка с иконкой

Название	Описание
Описание	Текст, который будет отображаться во всплывающей подсказке при наведении курсора мыши на кнопку, если не задана иконка
Иконка	Название иконки из набора, которая будет отображаться на кнопке (если не указан, на кнопке будет только текст). Набор доступен по адресу: /spa/content-icons.

Пример кнопки с иконкой

Название	Описание
JavaScript выражение	Текст скрипта JS, который должен выполняться по нажатию кнопки. Событие нажатия на кнопку возвращает три параметра: object Row — строка, в которой была нажата кнопка, UserID — пользователь, нажавший кнопку, ID кнопки.

В JS-вставке доступна переменная event: {\   originalEvent: MouseEvent;       // стандартный объект \ |

data: any;                       // строка с данными, к которой относится кнопка\ |

block: {\ |

reload: () => void;          // перезагрузить портальный блок\ |

freeze: () => void;          // сделать все кнопки в портальном блоке недоступными для нажатия\ |

unfreeze: () => void;        // сделать все кнопки в портальном блоке доступными для нажатия\ |

}\ |

} |

Описание стандартного объекта можно посмотреть здесь. С помощью объекта event.data можно обратиться к полям возвращаемого списка задач или других объектов. Можно обращаться по названию столбца возвращаемого набора данных, названия столбцов отображаются в таблице настроек. Например, event.data.isActive

| В момент нажатия на любую из настроенных кнопок все кнопки управления автоматически становятся недоступными для нажатия. Чтобы снова сделать их доступными, нужно вызвать событие event.block.unfreeze(). Например, такое JS-выражение сделает их доступными через 1 секунду после нажатия:

| setTimeout(function(){event.block.unfreeze()},1000)

Описание вызова методов веб-сервисов из JS-вставок |

ℹ️ Для каждой кнопки может быть задан либо JS-скрипт, либо смарт-пакет, которые будут выполняться по нажатию кнопки

Название	Описание
Колонка идентификатора (int)	Столбец, возвращающий идентификатор объекта. Это значение будет доступно при редактировании смарта в дереве сущностей в параметре "Идентификатор объекта". С его помощью в смарт-действии можно будет указать, в какой именно задаче будут выполняться действия по нажатию кнопки.

Это поле должно быть названо так, как это оно названо в возвращаемом наборе данных (например, TaskID)

ℹ️ Поле регистрозависимо!

Название	Описание
Пакеты действий	Смарт-пакет, который должен выполняться по нажатию кнопки.

В смарт-выражениях, используемых в данном пакете, доступны параметры события Нажатие на кнопку: -Идентификатор объекта (значение из столбца идентификатора или ID строки), -Строка с json-объектом, -ID кнопки, -Параметры текущего пользователя.

ℹ️ Для каждой кнопки может быть задан либо JS-скрипт, либо смарт-пакет, которые будут выполняться по нажатию кнопки

Название	Описание
URL	Смарт-выражение, возвращающее URL страницы, которая должна быть открыта в модальном окне после выполнения смарт-пакета.

Адрес страницы может быть относительным или абсолютным, например: /spa/tasks/12345  --- относительный адрес, https://Адрес_Приложения/spa/tasks/12345 — абсолютный адрес.

ℹ️ В абсолютной ссылке можно использовать только протокол https, а не http

Название	Описание
Колонка видимости (bool)	Название столбца, возвращающее признак видимости кнопки для текущего пользователя. Если значение не заполнено, то считается, что видимость включена всегда
Колонка активности (bool)	Название столбца, возвращающее признак активности кнопки. Если значение не заполнено, то считается, что активность включена всегда
Сообщение при успехе	Текст, который отображается после успешного выполнения операции, подтверждая, что действие завершено
Сообщение при ошибке	Текст, который появляется в случае неуспешного выполнения операции, информируя пользователя о причине неудачи
Информационное сообщение при нажатии	Текст, который отображается непосредственно в момент нажатия на кнопку, до выполнения основного действия. Он служит для подтверждения намерения пользователя или предоставления дополнительной информации о предстоящей операции
Режим видимости	Смарт-фильтр определяет видимость и доступность кнопок в зависимости от контекста. Настройка работают на основе контекста, включая данные о текущем пользователе и контекст строки таблицы. Это позволяет ограничивать доступ к кнопкам для разных пользователей, а также управлять доступностью кнопки в зависимости от соответствия строки заданным условиям
Смарт-фильтр видимости	Доступные значения:

-Блокировать по смарту — если кнопка заблокирована по смарту (смарт-фильтр возвращает true), она отображается, но недоступна для нажатия. -Скрыть по смарту — если кнопка скрыта по смарту  (смарт-фильтр возвращает true), она не отображается в интерфейсе. Для удаления доп.настройки столбца используется пункт Удалить в контекстном меню строки.

ℹ️ В пользовательском режиме недоступна фильтрация по столбцу с типом Блок кнопок

Удаление столбца

Для удаления столбца выберите пункт Удалить в контекстном меню строки.

Настройка секций столбцов

Столбцы таблицы могут быть распределены на секции. Пример таблицы с настроенными секциями:

Сперва активируйте опцию Включить секции столбцов в настройках таблицы таблицы во вкладке Дополнительные настройки:

Для создания новой секции нажмите на кнопку Создать над таблицей в настройках секций столбцов.

Для редактирования секции нажмите на нее в общем списке.

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

Для удаления секции выберите пункт Удалить в контекстном меню строки.

Для добавления столбца в секцию во вкладке Столбцы в настройках столбца выберите для нее созданную секцию в поле Название секции.

Видимость столбца в открытой и закрытой секции настраивается во вкладке Столбцы.

Настройки множественного выбора

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

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

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

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

ℹ️ Кнопка перехода к множественному выбору на панели инструментов таблицы не отображается, если в задаче активны настройки Ограничить добавление новых строк или Ограничить удаление строк

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

Вы можете настроить вид отображаемой таблицы со списком значений во вкладке Вид множественного выбора.

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

Вид множественного выбора

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

Значения в таблице доступны в том случае, если выбран ключевой столбец и настроен множественный выбор в соответствующей вкладке.

Шаблон в табличных представлениях

Для отображения ДП типа "Таблица" в табличном  представлении категории можно использовать шаблон.

При использовании шаблона таблица отображается в виде html-представления. Для шаблона можно задать следующие настройки:

Параметр	Описание
Отображать количество строк	Признак, будет ли в шаблоне отображаться общее число строк в таблице
Количество отображаемых строк	Количество первых строк таблицы, которые будут отображаться в шаблоне (если не указано, то данные в шаблоне не отображаются)
Использовать шаблон	Активирует шаблон и делает доступными соответствующие настройки
Синхронизировать существующие задачи	Позволяет обновить соответствующие значения в БД при изменении шаблона
Хранить html представление	Если настройка активна, будет реализовано хранение представления таблицы в GZip. Если настройка неактивна, в табличном представлении списка задач категории значение параметра отображаться не будет. Ограничение размера HTML-снимка: HTML-снимок таблицы для отображения в гриде категории ограничен 6900 байт. При превышении лимита строки, не поместившиеся в снимок, тихо отбрасываются без предупреждения. Фактическое количество строк в снимке может быть меньше значения настройки «Количество отображаемых строк». Данные в таблице сохраняются полностью — ограничение касается только отображения в гриде и Excel-экспорта из грида. В карточке задачи все строки отображаются корректно.

В базе данных HTML-представление ДП Таблицы хранится в атрибуте ExtParamValueGZip таблицы ExtParamValues. При денормализации значение из поля ExtParamValueGZip сопоставляется с колонкой ExtParamNativeValue. Новое значение HTML-представления записывается в истории изменений ДП (ExtParamHistory) в атрибуте ExtParamValueGZip, а старое — в ExtParamOldValueGZip.

ℹ️ Изменения параметров не будут отображаться в ленте комментариев теперь, т.к. значения в ExtParamHistory сжаты в gzip

Раз в 3 минуты запускается задание по таймеру TableExtParamValuesGZipCompressJob, которое перегоняет значения в таблицах базы данных ExtParamHistory и ExtParamValues в Gzip. Запускается раз в 3 минуты, и обрабатывает по 10,000 строк за раз. Сначала ExtParamValues, потом ExtParamHistory. |

Изменение в механизме хранения данных, вступающем в силу с версии 2.265: Начиная с версии 2.265 Цефей, значение ДП "Таблица" не хранится в атрибуте ExtParamValue таблицы БД ExtParamValues, а также в атрибуте ExtParamXXXValue в денормализованной таблице TasksInSubcatXXXDenormalized. При этом наличие значения в атрибуте ExtParamXXXNativeValue денормализованной таблицы, начиная с указанной версии, напрямую зависит от настройки параметра Хранить html представление. Если данная опция активна, значение будет записываться в базу данных, если опция отключена, запись производиться не будет

Параметр	Описание
Шаблон переменной количества строк	Служебное поле, доступно только для чтения
Заголовок	Текст, который повторяется один раз в начале представления
Шаблон строки таблицы	Текст с тегами, который заполняется данными для каждой строки; по клику на название столбца в поле добавляется соответствующий тег
Разделитель	Символ, которым строки отделяются друг от друга
Футер	Текст, который повторяется один раз в конце представления

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

Пример настройки обычного шаблона:

Отображение ДП "Таблица" по шаблону в табличном представлении категории:

ℹ️ Строковое представление, созданное для ДП "Таблица" , хранится в таблице БД в поле ExtParamTableValues.Value. Именно это значение будет возвращаться при обращении к свойству Value через хранимые процедуры, представления (view) или смарты

Обычный шаблон удобно использовать для анализа данных в ДП "Таблица" в отчетах, печатных формах, смартах и т.п.

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

Если для ДП "Таблица" шаблон не настроен или отключен параметр Использовать шаблон, то значение такого ДП "Таблица" хранится в БД в виде строки с html-тегами. В табличном представлении категории значение такого ДП отображается в виде "таблицы в таблице". В этом случае отображаются все столбцы ДП "Таблица" в том порядке, как они настроены в ДП. Однако ширина столбцов не фиксирована и подстраивается под содержимое, что не всегда удобно.

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

Для версии 264 существует возможность отключения генерации HTML-представления. Сделать это можно с помощью настройки Количество отображаемых строк. При установке значения 0 система создает пустой объект ExtParamValue и исключает формирование HTML-кода для данной таблицы. Соответственно, любые изменения значений в ДП не приводят к выполнению запросов UPDATE для таблицы ExtParamValues в базе данных.

Импорт/экспорт ДП Таблица

В пользовательском интерфейсе для ДП "Таблица" поддерживаются операции экспорта и импорта в Excel:

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

Файл с данными для импорта должен иметь расширение XLS или XLSX и содержать только одну страницу.

ℹ️ Для избежания ошибок импорта наименования столбцов ДП "Таблица" не должны содержать лишние пробелы после имени

ℹ️ При импорте все существующие в ДП "Таблица" строки удаляются, и таблица заново наполняется импортированными данными.

Опция Заголовки колонок в первой строке позволяет импортировать файл двумя способами:

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

• если опция неактивна, ниже будет выведен список столбцов — столбцы в файле должны быть расположены в этом порядке.

Значения столбца Lookup выгружаются в виде текста, а для загрузки в столбец Lookup можно использовать как текстовые данные (в этом случае ищется подходящая задача в нужной категории), так и ID задачи, на которую ссылается ячейка таблицы. Так, на рисунке ниже загрузка из обеих таблиц Excel (правой и левой) даст одинаковый результат в ДП "Таблица".

Если в ячейке с типом "Файл" загружен файл, то в Excel будет выгружена ссылка на него. При загрузке из Excel данные в столбце типа "Файл" игнорируются (не загружаются).

Дополнительные настройки Таблицы в прежнем интерфейсе администрирования Полезные ссылки

Работа с ДП "Таблица" в пользовательском режиме

Настройка ДП Lookup

Язык разметки при создании шаблона для колонки

Предзаполнение таблицы при создании задачи

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

Сделать это можно через URL-параметр ExtParamString. Значения передаются в формате JSON и применяются только к редактируемым колонкам.

Формат значения в URL: ?ExtParamString=$Ext{IDДП}${"rows":[{"c{IDколонки}":"значение",...}]} Где: - ID_ДП — идентификатор ДП типа Таблица - c{ID_колонки} — ключ с префиксом c и идентификатором колонки - rows — массив строк таблицы

Правила применения: - Значения применяются только к колонкам с режимом редактирования, отличным от ReadOnly и Invisible - Smart-колонки вычисляются автоматически, их значения в URL игнорируются - Виртуальные колонки заполняются из URL - URL-параметр имеет приоритет над настройкой DefaultValue категории - Поддерживается комбинация скалярных ДП и таблицы в одном ExtParamString

Пример: ?ExtParamString=$Ext12345${"rows":[{"c100":"Товар А","c101":10},{"c100":"Товар Б","c101":20}]}