Виды представлений и особенности работы с ними

Определение представления описано в статье определение представления.

Виды представлений

В каждом классе, при его создании, должны быть созданы три основных представления (E, L, T), а также при необходимости детейловое представление (D). Примечание: при использовании быстрой прототипизации представления E и L создаются автоматически.

В качестве названия используются имя класса и постфикс. Название должно удовлетворять шаблону: <ИмяКласса> + <Постфикс> (например: ВидСобытияE, ВидСобытияL, ВидСобытияT).

Постфикс Название Применение
E Представление для редактирования Используется для форм редактирования и для GroupEdit, AjaxGroupEdit. GroupEdit является средством быстрого редактирования объектов и может обладать функциональностью, позволяющей открыть текущий объект на форме редактирования. При этом другие атрибуты, невидимые в GroupEdit’е, также должны заполняться значениями. Поэтому для формы редактирования и для GroupEdit’а должно использоваться одно представление
L Списковое представление Используется на формах списка (свойство ViewName компонента ObjectListView, WebObjectListView)
T Деревянное представление Используется для поиска в фильтрах, и служит для построения ограничений на списки
D Детейловое представление Используется для поиска в фильтрах, и служит для построения ограничений на списки по атрибутам детейла.

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

Представление D отличается от представления T лишь тем, что не содержит атрибутов агрегатора. Так как представление D тоже служит для построения ограничений на списки, то его атрибуты также должны присутствовать в представлении L.

Основные правила использования

  • Все атрибуты должны иметь удобочитаемый заголовок, описывающий сущность атрибута, вне зависимости от видимости атрибута. Заголовок пишется с большой буквы, слова раздельно (например: атрибут – ТипМестаПроисш, заголовок - Тип места происшествия).
  • Допускаются общепринятые сокращения, основным критерием чего служит отсутствие точек, например: кол-во, ФИО (например: ФИО заявителя).
    Если заголовок очень длинный, допускаются сокращения с точкой для соблюдения разумной длины заголовка (например: Кол-во неизв. пострадавших, Доп. характеристики места).
    Сокращение не должно быть двусмысленно или непонятно. Плохим примером является Кол-во л/с, поскольку его можно трактовать как Количество лошадиных сил, хотя подразумевалось Количество личного состава. В таком случае рекомендуется использовать полное название (“Кол-во личного состава).

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