Разработка > Элементы разработки > Модуль

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

Вычисляемые папки могут находиться:

•в модуле. Например, в модуле «Делопроизводство» есть папка «Документы к возврату», в которой отображаются делопроизводственные документы, бумажные экземпляры которых выданы сотрудникам и подлежат возврату;

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

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

Вы можете создавать свои вычисляемые папки, а также изменять папки в перекрытиях модулей базового решения. У любой вычисляемой папки есть узел «FilterPanel», с помощью которого можно настроить панель фильтрации.

*Иконка. Будет отображаться в списке папок в проводнике системы. Добавьте две иконки в формате SVG и в размерах 16х16 и 32х32 пикселя. Иконки, используемые в базовом решении, можно найти в локальной папке исходных кодов. Расположение папки задается при установке системы. Например, в папке C:\DEVRX\Base\Sungero.Company\Sungero.Company.ClientBase\Icons можно найти файлы иконок модуля «Компания».

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

*Основное содержимое. Тип сущности, по которому для содержимого папки определяется состав видимых колонок, кнопки быстрого создания, действия на ленте и в контекстном меню. Основным содержимым могут быть:

•для папки модуля – любые типы сущностей;

•для папки, которая находится в папке «Входящие» – только типы заданий, заданий на приемку и уведомлений;

•для папки, которая находится в папке «Исходящие» – только типы задач.

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

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

1.Откройте редактор типа сущности и перейдите в узел «Действия».

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

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

Отображать папку в проводнике системы. Используется в перекрытиях модулей. Снимите флажок, чтобы скрыть папку в перекрытии.

Отображать количество непрочитанных заданий. Справа от названия папки указывается количество непрочитанных заданий. Флажок отображается, если в поле *Область отображения указано значение Папка «Входящие».

Использовать настройки представления от родительской папки. Внешний вид папки (состав видимых колонок, настройка группировки и т.д.) по умолчанию дублирует внешний вид той папки, в которой она находится. Если флажок установлен, то настройки внешнего вида в области предпросмотра станут доступны только для просмотра. Флажок отображается, если в поле *Область отображения указано значение Папка «Входящие» или Папка «Исходящие».

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

Получение данных. Обработчик события для вычисления содержимого папки. В коде обработчика пишут:

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

•условия фильтрации содержимого папки, если настроена панель фильтрации.

Событие доступно, если заполнено поле *Основное содержимое.

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

ВАЖНО. Чтобы пользователи увидели папку в системе и могли работать с ней, в обработчике события инициализации нужно программно выдать права доступа на папку.

Проверка фильтра. Обработчик события для валидации панели фильтрации. Проверка фильтра работает только в веб-клиенте. Подробнее см. «Проверка фильтров в списках и папках» и пример, как настроить валидацию панели фильтрации для входящих документов.

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

По умолчанию вычисляемая папка содержит колонки ИД и Имя. В области «Настройка представления» можно изменить ее внешний вид:

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

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

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

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

Подбирать ширину колонок. Ширина колонок будет автоматически подбираться по ширине экрана.

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

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

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

СМ. ТАКЖЕ