Перейти к концу метаданных
Переход к началу метаданных

Содержание

Введение 

Настройки грида – это информация о составе колонок грида, их ширины, закрепления, видимости и сортировки,  а также фильтра грида и некоторых других специфичных настроек, которые хранятся для каждого грида и каждого пользователя системы независимо.

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

Полный перечень настроек грида

  • Пользователь, которому принадлежат настройки - указывается пользователь, для которого применяются эти настройки
  • Суффикс - обозначает область применения данных настроек грида (для одной сущности существуют несколько настроек грида: для отображения в окне выбора ссылок, списка, мультиссылки), при инициализации настроек суффикс присваивается автоматически. Используется для предотвращения пересечения настроек для одинаковых сущностей в одной мультиссылке
  • Модуль - модуль, в котором хранить настройки грида
  • Сущность, к которой прикреплены настройки - настройки какой сущности (недоступно для редактирования)
  • Установленный фильтр - текущий фильтр сущности, при открытии сущности будет применяться сохраненный фильтр грида
  • Закрепляемые колонки - возможность закреплять колонки для удобства горизонтальной прокрутки списков с большим количеством колонок

Сортировка:

  • Поле сортировки - указывает поле, по которому будут сортироваться сущности по умолчанию
  • Порядок сортировки поля SortField (ASC|DESC) - направление сортировки сущностей (ASC по умолчанию)

Панель чтения:

  • Ширина правой панели чтения - ширина окна просмотра сущности при расположении панели справа
  • Ширина нижней панели чтения - ширина окна просмотра сущности при расположении панели снизу
  • Место отображения - указывает, где расположить панель предпросмотра выбранной сущности: справа, снизу либо скрыть ее

Пэйджинг:

  • Тип пэйджинга - тип реализации постраничного вывода (способ отображения записей сущности на странице)
  • Пэйджинг - количество записей на одной странице (если 0, то количество автоматически подбирается из размера окна пользователя)

Настройки каждой колонки грида:

  • Порядок колонки
  • Ширина колонки
  • Признак видимости колонки

Копирование настроек грида в шаблон


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

Откроем справочник Настройки грида и найдем на панели инструментов кнопку .

Выделим запись с нужными настройками пользователя для сущности (можно выбрать несколько записей для разных сущностей) и нажмем на кнопку Копировать в шаблон.

Справа появится всплывающее окно с информацией о количестве успешно скопированных записей:

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

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

Загрузка стандартных настроек грида


На рабочем столе на системной панели предусмотрена кнопка, с помощью которой все настройки грида текущего пользователя можно заменить настройками пользователя Шаблон:

На время выполнения замены настроек появляется спинер, а по завершению - сообщение:

Набор настроек для одной сущности


Каждый набор настроек содержит уникальный индекс на 3 поля, своего рода составной ключ. Это поля: 

  • сущность, к которой прикреплены настройки (SourceEntity)
  • пользователь, которому принадлежат настройки (User)
  • имя отображения - Суффикс (ViewName)

Таким образом, для каждого грида и каждого пользователя может храниться множество настроек. Это сделано для того, чтобы при отображении одной сущности в разных ситуациях пользователь мог создать для нее различные настройки. Для каждой отдельной ситуации настройкам присваивается отдельное имя отображения (ViewName):

  • Открыть сущность в отдельном табе
  • Открыть сущность как виртуальную таблицу в форме
  • Открыть сущность как список для выбора одного или нескольких элементов (например, после нажатия многоточия).

Соответственно имя отображения (ViewName) обозначает, какую настройку сейчас показать. Если открыть грид через панель навигации (откроем справочник Стили), то увидим в адресной строке браузера что-то вроде этого:

localhost/Werp.View/Main.aspx#Style:Regular, где для нас интересно #Style:Regular, Style - системное имя сущности, а Regular - это имя отображения этой сущности.

Можно открыть второй грид этой же сущности рядом, но с другим именем отображения. Например, так: localhost/Werp.View/Main.aspx#Style:Regular111.

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

В системе есть несколько константных видов имен - Regular, LinkSelection, tp_0_1.

  • Regular, например, для независимого списка, который показывается отдельно на вкладке, открывается из дерева навигации, например localhost/Werp.View/Main.aspx#Style:Regular.
  • linkSelection для окошка выбора ссылки.
  • для списков на форме у нас такой шаблон: tp_0_1, где 0 - имя сущности, грид которой отображается (linkedEntityName), 1 - имя поля табличной части/мультиссылки/виртуального грида на форме (fieldName).