Show/Hide Toolbars

Руководство администратора

dev_icon Скоро эта страница будет выглядеть по-новому

На данной вкладке настраивается перечень и расположение дополнительных параметров (ДП) категории. Все ДП в категории отображаются в виде таблицы.

В левой части вкладки находятся колонки со свойствами ДП, в левой — область для настройки ДП.

cats_dp_spa

Редактирование категории. Вкладка "Доп. параметры"

Колонка

Описание

ID

Уникальный идентификатор ДП

Имя ДП

Наименование ДП в общем списке всех ДП в системе

Может отличаться от имени ДП в категории

dp_hidden_icon Скрытый параметр

Доп. параметр не отображается в пользовательском интерфейсе

Тип

Тип ДП. Возможные значения:

Lookup поле

URL

Адрес

Адрес Email

Большой текст без форматирования

Большой текст с форматированием

Выбор нескльких задач из категории

Выбор пользователей

Выпадающий список

Выпадающий список с редактированием

Галочка (checkbox)

Дата

Дата и время

Деньги

Дерево

Нумератор

Сквозной

Таблица

Текст

Файл

Число

dp_block_iconИмя блока

Название блока доп. параметров (если в категории есть настроенные блоки)

dp_smart_access_icon Смарт доступ

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

Добавление и редактирование правил смарт-доступа для ДП описаны в разделе "Смарт-доступ".

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

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

Настройки ДП

Настройки ДП

Параметр

Описание

Отображение

Имя ДП в категории

Чтобы не создавать избыточно большое количество ДП, одни и те же ДП можно использовать в нескольких категориях. При этом пользователям было бы удобнее, чтобы в каждой категории этот ДП отображался на карточке задачи под своим названием. Например, в одной категории ДП типа "Файл" может отображаться как "Проект договора", в другой "Проект КП", в третьей "Проект соглашения" и т.п.

В поле задается название ДП в данной категории, которое будет отображаться:

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

в стандартном дизайне задачи (название поля, предупреждение об обязательности заполнения ДП),

в истории изменений ДП,

в комментариях об изменении значений ДП,

в пакетной обработке задач в категории,

в блоках "Используется", настроенных на данную категорию,

в карточке задачи в мобильном приложении.

warning_icon Названия не должны совпадать с системными зарезервированными именами, такими как Заказчик, Исполнитель, Статус, Категория, Задача (т.е. с названиями колонок, которые доступны для вывода в табличном представлении категории). Также в названиях нельзя использовать спецсимволы: \/<>

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

Имя блока

Название блока доп. параметров (если в категории есть настроенные блоки)

Скрыть при пустом значении

Если включен, то на МТФ не будут отображаться пустые значения.

Скрыть поле при пустом значении не только на МТФ, но и на НТФ возможно с помощью пользовательского ключа HideEmptyEpOnNtf — если он принимает значение true, то ДП без значений в карточке создания задачи с включённой настройкой "Скрыть при пустом значении", будут скрыты.

Количество занимаемых колонок

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

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

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

warning_icon Не работает для следующих типов ДП: Большой текст без форматирования, Большой текст с форматированием, Таблица

Скрытый

Если включен, то ДП будет скрыт при постановке и в карточке задачи.

Правила

Значения по умолчанию

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

cats_dp_1

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

Флажок "Не копировать значения из задачи-источника" по умолчанию не включен.

Флажок проверяется в том случае, если из контекста текущей задачи-источника создается задача в другой (целевой) категории:

из блока "Используется",

из окна выбора значений ДП типа Lookup или "Выбор нескольких значений в категории" (multilookup),

при создании связанной или подчиненной задачи.

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

warning_icon Настройка "Не копировать значения из задачи-источника" должна быть включена в той категории, из которой вызывается создание задачи

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

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

Обязателен для завершения

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

Требовать комментарий при изменении

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

warning_icon Опция не работает для ДП "Таблица"

warning_icon При первичном внесении значений в ДП причина запрашиваться не будет

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

Идентификатор задачи

Статус задачи

Пользователь, изменяющий значение ДП

Если одновременно с этим указана настройка "Смарт-выражение для проверки" или добавлено смарт-действие "Отменить" перед изменением этого ДП, то после изменения значения:

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

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

example_dp_save_cycle

Пример цикла

Заполняется один раз

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

warning_icon Опция не влияет на возможность изменения значения дополнительного параметра пользователями с правами "Администратор категории" и "Администратор задач"

Подтверждение при автосохранении

Если включен, то при нажатии кнопки Сохранить в карточке задачи если значение ДП было изменено, запрашивается подтверждение вида "Вы уверены, что хотите изменить значение ДП?"

Только уникальные значения

Установка уникальности для значений ДП в категории.

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

Доступ и валидация

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

Отображать – ДП будет отображаться на карточке при создании новой задачи,

Не отображать – ДП не будет отображаться на карточке при создании новой задачи,

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

warning_icon Если ДП "Lookup", "Выбор нескольких задач из категории" (Multilookup) обязателен для заполнения и текущему пользователю доступно только одно значение из списка, при создании задачи этим пользователем в карточке новой задачи это значение будет выбрано автоматически.

Режимы "Отображать" или "Обязателен" нельзя использовать с ДП типа "нумератор".

warning_icon Параметр "Режим при постановке" имеет значение при копировании задачи в пользовательском режиме — копируются все ДП с режимом "Отображать" или "Обязателен"

Доступ

По задаче – возможность редактировать ДП получают пользователи, обладающие в данной категории правом "Исполнять";

Только по группам – доступ к ДП определяется принадлежностью пользователя к группам;

По задаче или группам – доступ определяется как объединение прав по задаче и группе (логическое ИЛИ);

По задаче и группам – доступ определяется как пересечение прав по задаче и группе (логическое И).

Для настройки доступа для групп нажмите значок !detailsInNewWindow, который появляется справа от данного поля. Доступ может выдаваться на редактирование или только на чтение:

cats_dp_4

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

Для настройки необходимых компонентов матрицы доступа нажмите значок !detailsInNewWindow справа от данного поля:

cats_dp_matrix

Если у пользователя нет доступа к просмотру ДП, в списке задач он увидит вместо значения этого ДП надпись "(нет доступа)".

По SQL-функции – доступ к ДП определяется по заданной SQL-функции.

Для настройки доступа по SQL-функции нажмите значок !detailsInNewWindow, который появляется справа от данного поля. В открывшемся модальном окне необходимо указать имя функции в поле "Скалярная" и, по необходимости,  в поле "Пакетная". Пакетная функция позволяет вызывать функцию доступа к ДП только для массива переданных значений, а не для каждого значения N-раз для каждой строки списка задач.

sql_access_func

На основании указанного имени изменяется или создаётся табличная функция для разграничения доступа. Доступ по SQL-функции является удобной настройкой для более гибкой установки доступа: к примеру, для случаев, когда необходимо выдать доступ в зависимости от другого ДП.

Пакетная функция является необязательной - если она не указана, то применяется скалярная функция.

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

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

Пример скалярной SQL-функции (MS SQL)

Пример скалярной SQL-функции (PG SQL)

Пакетная функция на вход принимает следующие атрибуты:

@TaskIds dbo.id_tbl_type readonly,

@ExtParamId int,

@UserId int  

Остальные параметры задач следует расчитать внутри функции.

Пример пакетной SQL-функции

warning_icon В случае, если ДП отображается в карточке создания новой задачи, параметр функции @StateId должен принимать значение is null

warning_icon Права доступа для категории имеют больший вес по сравнению с правами доступа к ДП — если у пользователя нет доступа к категории, а доступ к ДП предоставлен, то этот доступ действовать не будет

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

Доступ зависит от статуса

Доступ к ДП зависит от статуса. При включении флажка отображается значок !detailsInNewWindow, по клику на который открывается окно настройки прав доступа

cats_dp_3

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

warning_icon В строке-подзаголовке расположены флажки, которыми можно сразу включить доступ на все статусы. Однако включение "общего" флажка не подразумевает, что при добавлении в категорию нового статуса на него автоматически будет выдан доступ на чтение/редактирование. Флажки предназначены только для удобства и быстроты выдачи прав.

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

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

Смарт доступ

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

Добавление и редактирование правил смарт-доступа для ДП описаны в разделе "Смарт-доступ".

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

Допустимая длина текста

Максимальная длина значения, которое может храниться в БД (действует только для денормализованных категорий).

Ограничение действует для ДП типов "Текст", "Большой текст" (с форматированием и без), "Адрес", "Число", "Деньги", "Нумератор", "Выпадающий список" (с редактированием и без), "Флажок", "Дата", "Дата и время", URL.

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

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

Для ДП типов "Выбор нескольких задач в категории" (multilookup), "Файл", "Таблица", "Адресаты Email" ограничение не устанавливается и не действует.

Для ДП "Место", "Тема события" и "Описание встречи", которые автоматически добавляются в категорию при выборе значения "Календарь" в опции "Тип категории",  ограничение длины по умолчанию не устанавливается.

warning_icon ДП "Текст" и "Большой текст с форматированием" не могут хранить свыше 8 000 символов.

warning_icon Настройка не применяется для ДП "Большой текст с форматированием" с редактором Editor.js

warning_icon Если вы меняете тип ДП (например, "Текст" на "Большой текст с форматированием" и т.п.), проверяйте допустимую длину, так как по умолчанию она остается прежней. При необходимости вы можете ее увеличить или уменьшить вручную.

warning_icon При включении режима шифрования для ДП ограничение по количеству символов для этого ДП сбрасывается

Добавить индекс

Использование этой настройки позволит ускорить загрузку списка задач категории, что полезно при большом количестве задач.

Автоматически активируется и становится недоступной для редактирования при включении настройки "Только уникальные значения".

Смарт-выражение для проверки

По нажатию кнопки !detailsinnewwindow открывается окно для настройки проверок значения ДП.

Прочее

Участвует в поиске

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

Сохранять историю изменений ДП

Если включен, то для данного ДП регистрируется история изменений значений.

По умолчанию при добавлении ДП в категорию опция отключена

warning_icon Если опция неактивна, уведомления о смене значения ДП не будут отправляться в комментарии задачи.

Возможность редактировать историю

(Устаревшее, не используется)

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

Используется в шифровании

Флажок действует только для ДП типов "Текст", "Большой текст" и "Большой текст с форматированием", а также только если в категории разрешено шифрование (т.е. в основных настройках категории в параметре "Режим шифрования" выбрано значение "Разрешить шифрование" или "Шифрование обязательно").

warning_icon Зашифрованные ДП расшифровывать обратно нельзя. Соответственно, включенную для ДП настройку уже нельзя будет отключить.

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

История значений ДП шифруется только с момента включения флажка, значения, введенные раньше, остаются незашифрованными.

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

warning_icon При включении режима шифрования для ДП ограничение по количеству символов для этого ДП сбрасывается.

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

Синхронизировать в родительскую

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

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

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

Синхронизировать в дочернюю

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

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

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

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

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

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

cats_table_access

В полях Ограничить добавление новых строк и Ограничить удаление строк можно указать смарт-фильтры, которые определяют, будут ли в пользовательском интерфейсе отображаться кнопки сохранения и удаления на панели инструментов таблицы, а также кнопка множественного выбора. Если смарт-фильтр возвращает значение "true", кнопки отображаются в таблице, если "false" - не отображаются.

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

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

dp_table_filter 

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

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

Ограничения импорта и экспорта и отображение соответствующих значков настраивается в самом ДП "Таблица".

warning_icon Ограничения прав доступа к колонкам не действуют для служебного пользователя, указанного в Общих настройках приложения в параметре Диспетчер задач — от имени этого пользователя можно устанавливать значения даже для колонок с доступом "только на чтение" (это необходимо для корректной работы смарт-автоматизации)

Добавление ДП или создание ДП

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

add_dp

Добавление ДП в категорию

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

create_dp

Создание нового ДП

warning_icon Не рекомендуется создавать в категории > 150 ДП, это существенно замедляет работу системы (каждая колонка ДП "Таблица" считается как отдельный ДП).

Редактирование ДП

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

edit_dp_link

Ссылка для редактирования ДП

По нажатию на эту ссылку откроется стандартная форма редактирования дополнительного параметра.

edit_dp

Стандартная форма редактирования ДП

Копирование ДП

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

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

copy_dp

Копирование ДП

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

warning_icon Опция не работает для ДП с типом "Таблица" и "Дерево".

Шифрование ДП

Если в категории для отдельных ДП включается флажок "Используется в шифровании" (см. ниже), то значения этих ДП начнут шифроваться начиная с момента включения флажка. Если же необходимо зашифровать значения этих ДП в уже существующих задачах, нужно нажать кнопку Шифровать ДП. Если категория денормализована, после шифрования ее нужно повторно денормализовать вручную.

Настройка правила проверки значения ДП (валидация)

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

smart_valid

Настройки валидации ДП

 

Параметр

Описание

Смарт выражение для проверки

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

dp_valid_example

Запускать на сохранении

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

Запускать на создании задачи

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

Запускать на переходах

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

Запускать по нажатию на настраиваемые кнопки

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