.. _oracle_selection_properties: Свойства выборок ```````````````````` .. underconstruction:: Перечислены все задокументированные свойства Global1, часть из которых не работает в ApplicationServer. Основные свойства ''''''''''''''''''''''' Администрирование .................. .. btk:selprop:: idUserClass :title: Пользовательский класс Пользовательский класс, которому соответствует выборка. Настройка влияет на то, в соответствии с каким классом будет осуществляться применение настроек доступа, определенных на уровне бизнес-объекта. Значение свойства должно соответствовать свойству "Бизнес-объект". .. seealso:: * Документация Global1 :btk:selprop:`btk:idUserClass` .. btk:selprop:: BusinessObject :title: Бизнес-объект Бизнес-объект системы, в соответствии с настройками которого будет осуществляться администрирование выборки. .. seealso:: * Документация Global1 :btk:selprop:`btk:BusinessObject` .. btk:selprop:: AccessableWhileReadOnly :title: Не распространяется ограничение «доступ только на чтение» При установке свойства в 1 для пользователя с установленным флагом "Доступ только на чтение", на данную выборку не будут распространяться эти ограничения. Выставлено в 1 для выборок SEL_FilterClasses, SEL_Application, SEL_Module и для всех выборок, которые используются в конфигураторе (для загрузки реестра, метаданных и т.п.) .. seealso:: * Документация Global1 :btk:selprop:`btk:AccessableWhileReadOnly` .. btk:selprop:: NoAdminTunings :title: Не применяются настройки ограничения доступна Старое название свойства "Не распространяются настройки администрирования". При установке данного свойства в значении «Да» на выборку не распространяются настройки администрирования. Управление этим свойством позволяет поэтапно применять настройки администрирования на выборки приложения. Выборка, на которую не распространяются настройки администрирования, для всех пользователей системы ведет себя так, как если бы пользователь, который к ней обращается, имел включенную настройку "На пользователя не распространяются настройки системы администрирования". .. seealso:: * Документация Global1 :btk:selprop:`btk:NoAdminTunings` .. btk:selprop:: bNotSetActiveOper :title: Снимать активность для новых операций, устанавливаемых релизами В случае, если оно установлено, то при установке обновления при добавлении новых операций или выпуска старых выключенных операций с флагом активности 1, для них галка "Активность" устанавливается в 0. Свойство в релиз не выгружается, устанавливается на проекте для конкретной выборки. .. seealso:: * Документация Global1 :btk:selprop:`btk:bNotSetActiveOper` Настройки вывода ................. .. btk:selprop:: ColumnAutoWidth :title: Размещение всех колонок на экране Флаг указывает, что все колонки списка или дерева должны размещаться на экране, и изменять свои размеры при изменении ширины списка или дерева. .. seealso:: * Документация Global1 :btk:selprop:`btk:ColumnAutoWidth` .. btk:selprop:: StyleControlAttribute :title: Атрибут управления стилем раскраски Здесь указывается имя атрибута выборки, в котором возвращается стиль раскраски строки. .. seealso:: * Документация Global1 :btk:selprop:`btk:StyleControlAttribute` .. btk:selprop:: AllowModifingColumnVisibility :title: Изменение видимости колонок Флаг указывает на доступность возможности скрытия колонок списка или дерева. Если флаг снят, скрытие колонок пользователем становится невозможным. .. seealso:: * Документация Global1 :btk:selprop:`btk:AllowModifingColumnVisibility` .. btk:selprop:: idNotionUnit :title: Наименование Ссылка на представление понятия, содержащее текст заголовка фрейма на форме web-приложения. .. seealso:: * Документация Global1 :btk:selprop:`btk:idNotionUnit` Редактор ......... .. btk:selprop:: DefaultEditor :title: Тип фрейма Определяет тип фрейма, при помощи которого выборка будет отображаться на форме. .. seealso:: * Документация Global1 :btk:selprop:`btk:DefaultEditor` Параметры редактирования .......................... .. btk:selprop:: NoBESavePoint :title: Не устанавливать SavePoint перед началом редактирования При начале редактирования (создания, удаления) записи в выборке происходит установка SavePoint, для того, чтобы можно было отменить последнее совершенное действие. Установка данного свойства позволяет не осуществлять установку SavePoint. Необходимо для служебных выборок, не изменяющих данные на сервере, для организации пользовательских диалогов, работы настроек фильтрации и т.п. .. seealso:: * Документация Global1 :btk:selprop:`btk:NoBESavePoint` .. btk:selprop:: ReadOnlyType :title: Возможность редактирования Допустимые значения: - «Редактируется» - «Только чтение» - «Не редактируется, разрешены только вставка и удаление» Свойство блокирует возможности вставки и изменения атрибутов в случае выставления соответствующих настроек. .. seealso:: * Документация Global1 :btk:selprop:`btk:ReadOnlyType` Загрузка данных ................. .. btk:selprop:: IsStatefull :title: Длинная транзакция Возможны 2 режима работы с подключениями к БД: Stateless и Statefull. Если свойство равно 1, то режим Statefull, иначе Stateless. Stateless – подключение к БД выдается серверной форме, только на время обращения клиента к сервису данных. После окончания обработки запроса (request от клиентского приложения), сессия сохраняет (Commit) или отменяет (Rollback, в случае необработанных ошибок) все изменения и высвобождается. Данный режим используется по умолчанию. Вне зависимости от режима открытия формы (Modal, MDI, Lookup) каждая форма работает в отдельной сессии. Statefull – подключение выдается форме в момент создания, и сохраняется за ней в течении всей жизни формы. В данном режиме, окончание обработки запроса не означает окончания текущей транзакции. Сессия выполняет Commit или Rollback по команде с клиента или при закрытии формы. Если форма работает в режиме Statefull, то открываемые от неё MDI окна будут получать новую сессию, а модальные формы будут использовать текущую сессию, и будут также работать в режиме Statefull. При открытии модального окна в сессии устанавливается SavePoint, к которому будет произведен откат при закрытии формы с результатом mrCancel. При закрытии модального окна, не являющегося владельцем соединения с БД, Commit не происходит, если форма закрывается с результатом mrCancel, производится Rollback (SavePoint). .. seealso:: * Документация Global1 :btk:selprop:`btk:IsStatefull` Фильтрация ........... .. btk:selprop:: FilterType :title: Тип используемого фильтра Свойство указывает на тип фильтра, редактор которого будет отображен при нажатии кнопки "Фильтр" на панели управления. Возможные значения: - OLD - редактор стандартного фильтра - EXT - редактор расширенного фильтра - UNI - редактор универсального фильтра .. seealso:: * Документация Global1 :btk:selprop:`btk:FilterType` .. btk:selprop:: UseDefaultUniFilter :title: Использовать ун-ный фильтр Default отображения .. seealso:: * Документация Global1 :btk:selprop:`btk:UseDefaultUniFilter` .. btk:selprop:: StdFilterAvalible :title: Доступность стандартного фильтра Флаг управляет доступностью стандартного фильтра в отображении выборки. По умолчанию, если стандартный фильтр существует и активен, он используется во всех отображениях выборки, вне зависимости от видимости панели фильтрации. Однако, если на панели фильтрации присутствуют выпадающие списки, происходит прогрузка метаданных и открытие этих выборок, что может привести к замедлению в работе системы. Если нет необходимости в использовании стандартного фильтра в каком-либо отображении, можно снять данный флаг. .. seealso:: * Документация Global1 :btk:selprop:`btk:StdFilterAvalible` .. btk:selprop:: StdFilterSaveValues :title: Сохранять значения стандарт .. seealso:: * Документация Global1 :btk:selprop:`btk:StdFilterSaveValues` .. btk:selprop:: DontCloseDSOnMacrosUpdate :title: Не закрывать датасет при обновлении макроса .. seealso:: * Документация Global1 :btk:selprop:`btk:DontCloseDSOnMacrosUpdate` .. btk:selprop:: Sel.RowSource :title: Источник данных Источник данных, используемый в универсальном фильтре при фильтрации выборки. Если свойство не указано, то в качестве источника данных будет взят источник данных, указанный в пользовательском классе выборки. Если и в классе свойство пустое, то берется автосоздаваемый источник данных класса. .. seealso:: * Документация Global1 :btk:selprop:`btk:Sel.RowSource` .. btk:selprop:: Sel.bUseClientUniFlt :title: Использовать клиентский универсальный фильтр Управляет активностью универсального фильтра и его операции "Ячейку в фильтр". .. seealso:: * Документация Global1 :btk:selprop:`btk:Sel.bUseClientUniFlt` Помощь ....... .. btk:selprop:: bdn_topic :title: Статья справочной системы Позволяет задать справочную информацию по данной форме, которая будет доступна при открытии справки от фрейма данной выборки. В свойстве хранится системное имя статьи справочной системы BDN (Bitec Developer Network). .. seealso:: * Документация Global1 :btk:selprop:`btk:bdn_topic` .. btk:selprop:: idHelpNotionUnit :title: Текст справки Устаревшее свойство. Для задания контекстной помощи используйте свойство "Статья в справочной системе". Позволяет задать справочную информацию по данной форме, которая будет доступна при открытии справки от фрейма данной выборки. Настройка текста справки осуществляется при помощи ввода описания в специальные представления понятия, находящиеся в разделе "Помощь". .. seealso:: * Документация Global1 :btk:selprop:`btk:idHelpNotionUnit` Дополнительные свойства ''''''''''''''''''''''' Загрузка данных ................ .. btk:selprop:: AutoRefreshDetailsOnUIGST :title: Обновлять детальные выборки при вызове GetSqlText через UI элементы Свойство влияет только на пользовательские вызовы GetSQLText через элементы интерфейса (тулбар, кнопки, контекстное меню и т.д.) Значение по умолчанию: **True** - **True** Детальные фреймы обновляются следом за мастером. - **False** Обновляется только основная выборка. .. attention:: - Свойство не влияет на вызовы скриптовых методов обновления выборки, а также на вызов обновления по парамхукам. - Свойство не производит блокировку обновлений по парамхукам. .. seealso:: - :btk:oper:`GetSqlText` - :pas:meth:`TbtkScriptSelectionObject.Refresh` - :pas:meth:`TbtkScriptSelectionObject.RefreshDetails` - Документация Global1 :btk:selprop:`btk:AutoRefreshDetailsOnUIGST` .. btk:selprop:: LoadDataOnFirstOpen :title: Загружать данные при открытии фрейма Свойство управляет загрузкой данных при первом открытии выборки. Значение по умолчанию: **True** - **True** Данные загружаются в соответствии с наложенными условиями фильтрации. - **False** Данные не загружаются. .. warning:: Для работы свойства в :term:`GST` должен присутствовать :ref:`dataloading_macro`. .. attention:: Свойство влияет только на первое открытие выборки. При последующих открытиях, даже если они предваряются закрытием, данное свойство игнорируется. .. seealso:: * Документация Global1 :btk:selprop:`btk:LoadDataOnFirstOpen` .. btk:selprop:: IgnoreParamChange :title: Не обновлять выборку при изменении super$ параметров Свойство отключает связь мастер-деталь для данной выборки. Т.е. при изменении параметров мастер выборки, на которые данная выборка смотрит по super$, обновление детальной выборки происходить не будет. .. seealso:: * Настройка из скриптора :pas:attr:`TbtkScriptSelectionObject.IgnoreParamChange` * Документация Global1 :btk:selprop:`btk:IgnoreParamChange` Макросы ........ .. btk:selprop:: ApplyServSortOrderMacros :title: Накладывать макрос сортировки. Свойство дает возможность отключить наложение :ref:`макроса сортировки`. По умолчанию свойство включено, и условия сортировки применяются. Если свойство выключить, то в качестве значения макроса будет использоваться пустая строка. .. seealso:: * Документация Global1 :btk:selprop:`btk:ApplyServSortOrderMacros` .. btk:selprop:: ApplyServFilterMacros :title: Накладывать макросы фильтрации. Свойство дает возможность отключить наложение :ref:`макросов фильтрации`. По умолчанию свойство включено, и условия фильтрации применяются. Если свойство выключить, то в качестве значений макросов будет использоваться не ограничивающее условие ``(2=2)``. .. seealso:: * Документация Global1 :btk:selprop:`btk:ApplyServFilterMacros`