Representation¶

class View.Representation¶: Элемент определяет отображение выборки. Содержит метаданные относящиеся к конкретному отображению. Отображение с именем “Default” считается отображением по умолчанию. Остальные отображения наследуют все свойства отображения “Default”.

Вложенные элементы:

elem highCapacity → View.Representation.HighCapacity¶: Параметры работы выборки в режиме высокой ёмкости.

Added in version 1.25.0-rc1.

See also

View.Representation.highCapacityEnabled

elem layout → View.Representation.Layout¶

Макет.

Элемент определяет способ отображения данных выборки в интерфейсе приложения.

elem filter → View.Representation.Filter¶: Стандартный фильтр.

elem bandGroups → View.Representation.BandGroups¶: Коллекция групп объединения. Группы применимы к: списку, дереву и карточке.

elem levelGroups → View.Representation.LevelGroups¶: Коллекция групп выравнивания. Группы применимы к: карточке.

elem attributes → View.Representation.Attributes¶: Атрибуты выборки.

elem operations → View.Representation.Operations¶: Операции выборки.

elem documentation → String¶

Атрибуты:

attr name → String¶: Имя отображения. Имя уникально, задается латиницей.

attr ignoreAppReadOnly → Boolean¶: Если True, выборка остаётся доступной для редактирования при выполнении приложения с правами только на чтение.

attr allowModifyingColumnVisibility → Boolean¶: Доступно изменение видимости колонок

attr autoMoveAttr → String¶: Это свойство позволяет применять логику автоперемещения к некоторому подмножеству строк выборки. Здесь нужно указать имя атрибута, в котором возвращается некоторое произвольное значение. Это значение будет сравниваться со значением свойства “Значение, определяющее автоперемещение”. Автоперемещение будет работать только для тех строк, у которых эти значения равны.

attr autoMoveAttrValue → String¶: Значение, определяющее активацию автоперемещения. См. описание AutoMoveAttr.

attr autoMoveTextWidth → Integer¶: Количество символов, которые нужно ввести в атрибут, чтобы сработало автоперемещение на следующий атрибут.

attr autoMoveFromControl → Boolean¶: Если True, при редактировании атрибута фокус ввода будет автоматически переходить на следующий атрибут при достижении определенного количества символов.

attr autoMoveNextLine → Boolean¶: Переход на следующую строку при достижении конца текущей строки в гриде или дереве.

attr bdnTopic → String¶: Позволяет задать справочную информацию по данной форме, которая будет доступна при открытии справки от фрейма данной выборки В свойстве хранится системное имя статьи справочной системы BDN (Bitec Developer Network).

attr helpText → String¶: Помощь

attr businessObject → String¶: Бизнес-объект системы, к которому принадлежит выборка и в соответствии с настройками которого будет осуществляться администрирование выборки.

attr fitColumnsToGridWidth → Boolean¶: Флаг указывает, что все колонки списка или дерева должны размещаться на экране, и изменять свои размеры при изменении ширины списка или дерева.

attr doubleClickOperation.createFormMode → String¶: Системное имя операции, которая сработает при двойном клике по записи в случае открытии формы в режиме без возрата данных (форма открыта методом: OpenForm, OpenModalForm).

attr doubleClickOperation.lookupMode → String¶: Системное имя операции, которая сработает при двойном клике по записи в случае открытии формы в режиме возрата данных (форма открыта методом: DoLookup).

attr fetchAllTree → Boolean¶: Прогружать дерево полностью. Свойство управляет режимом отображения данных в древовидном списке. Если свойство установлено в False (по умолчанию), то выборка выфетчивает все данные, возвращённые запросом, и при навигации по дереву (разворачивании узлов), не происходит дополнительных запросов к базе данных, поскольку считается что все данные в дерево уже загружены. Если свойство установлено в True, SQL запрос начинает оборачиваться дополнительным запросом с условием, ограничивающим возвращаемые данные только первым уровнем древа, а при раскрытии узлов дерева, производится запрос, возвращающий воложенные узлы только для раскрываемого узла.

attr filterType → View.Representation.FilterTypes¶: Тип используемого фильтра. Свойство указывает, на тип фильтра, редактор которого будет отображен при нажатии кнопки “Фильтр” на панели управления.

attr formSize.fixed → Boolean¶: Фиксированный размер формы. В случае включения данного свойства станет нельзя изменять размер формы в модальном режиме. Также будет нельзя максимизировать форму. Применяется к главной выборке формы, для модальных форм и mdi-форм, открытых в оконном режиме.

attr formSize.height → Integer¶: Высота формы. Свойство задаёт высоту формы в пикселях, устанавливаемую при ее первом открытии. Настройки, сохранённые в реестре, перекрывают это значение. Применяется к главной выборке формы, для модальных форм и mdi-форм, открытых в оконном режиме.

attr formSize.width → Integer¶: Ширина формы. Свойство задаёт ширину формы в пикселях, устанавливаемую при ее первом открытии. Настройки, сохранённые в реестре, перекрывают это значение. Применяется к главной выборке формы, для модальных форм и mdi-форм, открытых в оконном режиме.

attr ignoreSuperParamChange → Boolean¶: Не обновлять выборку при изменении super$ параметров. Свойство отключает связь мастер-деталь для данной выборки. Т.е. при изменении параметров мастер выборки, на которые данная выборка смотрит по super$, обновление детальной выборки происходить не будет.

attr loadDataOnFirstOpen → Boolean¶

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

При первом открытии выборки запрос GetSQLText окружается конструкцией {@code “Select * from ( {GST} ) where &LoadData#”}, и значение макроса &LoadData# равное “(1 = 2)”. В результате, данный запрос не возвращает данных. После нажатия на кнопку “Перечитать запрос с сервера” в макрос &LoadData# подставляется значение “(1 = 1)”, и запрос возвращает данные. При всех последующих выполнениях запроса, макрос так же будет иметь значение “(1 = 1)”. В случае курсорного GetSQLText, если существует макрос &LoadData# или параметр :LoadData# им будут устанавливаться соответствующие значения.

Скриптовый метод Selection.ApplyFilter; не производит перезапрос выборки, а только изменяет цвет иконки GetSQLText.

Скриптовый метод Selection.ResetFilter; не производит перезапроса выборки, а только сбрасывает фильтры и значения параметров фильтра.

attr partitionMode → View.Representation.PartitionModes¶: Режим загрузки данных. Свойство указывает механизм загрузки данных в смарт-клиент. Возможные значения: “Полностью прогружаемый” (NOTPARTITIONED) - Все записи, возвращённые запросом, загружаются на клиента. “Частично прогружаемый” (USEFETCHROWS) - Данные на клиента загружаются секциями длинной, указанной в свойстве “PartitionedSize”. В этом режиме для перехода в конец выборки на клиента будут загружены все записи, возвращённые запросом.

attr partitionSize → Integer¶: Размер секции для режима загрузки “Частично прогружаемый”. Определяет размер окна данных, загружаемых в выборку при открытии или обновлении, и затем подгружаемых при скроллинге данных (только для Oracle-решений).

attr ignoreAdminPolicy → Boolean¶: Не применяются настройки ограничения доступа. При установленном в свойстве значении «Да» на выборку не распространяются настройки администрирования. Управление этим свойством позволяет поэтапно применять настройки администрирования на выборки приложения. Выборка, на которую не распространяются настройки администрирования, для всех пользователей системы ведет себя так, как если бы пользователь, который к ней обращается, имел включенную настройку “На пользователя не распространяются настройки системы администрирования”.

attr noBESavePoint → Boolean¶: Не устанавливать SavePoint перед началом редактирования. При начале редактирования (создания, удаления) записи в выборке происходит установка SavePoint, чтобы можно было отменить последнее совершенное действие. Установка данного свойства позволяет не осуществлять установку SavePoint. Необходимо для служебных выборок, не изменяющих данных на сервере, для организации пользовательских диалогов, работы настроек фильтрации и т.п.

attr notRefreshDataOnGroupChange → Boolean¶: Не обновлять данные при изменении текущей группы на панели группировки. Для выборок, у которых свойство выставлено в TRUE, не будет работать автообновление обновление при изменении idGroup#. Используется в #OnLoadMeta на уровне SEL_CLASS в отображениях List и RoList

attr editMode → View.Representation.EditModes¶: Возможность редактирования.

attr showNotification → Boolean¶: Отображать напоминания. Выставляется для выборки в интерфейсе настройки приложений. В выборках приложений происходит обработка данного флага и в зависимости от него выводятся напоминания

attr showTips → Boolean¶: Отбражать советы. Выставляется для выборки в интерфейсе настройки приложений. В выборках приложений происходит обработка данного флага и в зависимости от него выводятся советы.

attr stdFilter.isAvailable → Boolean¶: Доступность стандартного фильтра. Флаг управляет доступностью стандартного фильтра в отображении выборки. По умолчанию, если стандартный фильтр существует и активен, он используется во всех отображениях выборки, в не зависимости от видимости панели фильтрации. В случае же, если на панели фильтрации присутствуют выпадающие списки, происходит прогрузка метаданных и открытие этих выборок, что приводит к замедлению в работе системы. Если нет необходимости в использовании стандартного фильтра в каком либо отображении сними данный флаг.

attr stdFilter.saveValues → Boolean¶: Сохранять значения стандартного фильтра. Если TRUE, при закрытии формы значения стандартного фильтра будут сохранены в реестре. При повторном открытии формы значения будут восстановлены.

attr rowStyleAttr → String¶: Атрибут управления стилем раскраски строки в списке и дереве.

attr applySrvSortOrderMacros → Boolean¶: Накладывать макрос сортировки. Свойство дает возможность отключить наложение макроса сортировки &SortOrder#. По умолчанию свойство включено, и условие макроса применяется. Если свойство выключить, то каждый раз вместо значения макроса будет подставляться пустое условие.

attr applySrvFilterMacros → Boolean¶: Накладывать макросы фильтрации. Свойство дает возможность отключить наложение макросов фильтрации &DefUniFltMacros и &DefUniFltMacrosRO на условия серверного фильтра. По умолчанию свойство включено, и условия макросов накладываются. Если свойство выключить, то каждый раз вместо значений макросов будет подставляться не ограничивающее условие (2=2).

attr caption → String¶: Отображаемое имя выборки. Отображается в загаловке окна.

attr description → String¶: Описание. Используется, в том числе, в расширенном заголовке формы.

attr isWebActive → Boolean¶: Свойство определяет доступность выборки в Web-версии приложений. Если выборка не доступна в Web, вместо неё будет отображено сообщение о недоступности функционала.

attr isMultiSelect → Boolean¶: Мультиселект (выбор нескольких записей). Свойство указывает, что в списке будет доступен выбор нескольких записей. Выбор нескольких записей осуществляется путём зажатия клавиши Ctrl + клик левой кнопкой мыши на нужной записи или Ctrl + Space.

attr megaSel.restoreFocusRecOnRefresh → Boolean¶: При обновлении частично прогружаемой выбороки запрашивать только первый блок данных. Свойство удобно использовать для контроля положения выделенной записи. При установленом свойстве возможны следующие варианты поведения при обновлении выборки: 1) если выделенная ранее запись входит в первый блок данных (находится в верхней части таблицы), то фокус вновь возвращается на нее. 2) иначе фокус ставится на первую запись. По умолчанию свойство выключено. В этом случае возможна ситуация, когда выделенная ранее запись расположена глубоко по порядку, или вообще отсутствует по установленным условиям выбора. Тогда загрузка выборки может занять длительное время. Например, это актуально для выборок с настроенной группировкой и большим количеством данных.

attr acItemRep → String¶: Группа элемента администрирования.

attr highCapacityEnabled → Boolean¶

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

Доступны 2 режима работы:

Гибридный режим использования кучи View.Representation.HighCapacity.HeapUsage.hybrid.
Фиксированный режим использования кучи View.Representation.HighCapacity.HeapUsage.fixed.

Added in version v1.24.0_ms23.