Просмотр исходного текста страницы Добавление в настройку параметров экранных форм

При создании определенной функциональности на платформе [[Гедымин]] разработчик сохраняет созданные им объекты в [[Настройка|настройке]].

Рассмотрим на конкретном примере, как добавлять в настройки параметры экранных форм.

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

Прежде всего определимся, что по отношению к конечному пользователю элементы управления экранных форм могут быть разделены на настраиваемые и не настраиваемые. Настраиваемые элементы – это, прежде всего, гриды. Пользователь может изменять состав, положение и заголовки колонок, цветовую схему грида и проч. Все эти изменения хранятся для каждого пользователя отдельно. 
Ненастраиваемые элементы управления – это кнопки панелей инструментов, а также все элементы управления расположенные в шапке диалогового окна. Изменять параметры этих элементов может только разработчик ([[Administrator]]), эти изменения будут распространяться на всех пользователей прикладного решения.

Параметры, определяющие внешний вид экранной формы, содержатся в [[Хранилище|хранилище]]. И именно из хранилища эти параметры добавляются в настройку. При этом, параметры не настраиваемых элементов хранятся в глобальном хранилище (в выпадающем списке обозначено как <GLOBAL>), а параметры настраиваемых элементов – в пользовательском хранилище администратора (Administrator). Доступ к хранилищу можно получить через команду Исследователя системы «Сервис -> Хранилище». Внешний вид формы просмотра хранилища представлен ниже на рис. 1.

http://gsbelarus.com/gs/images/gs/2007/img1_storage.jpg

''Рис. 1. Форма просмотра хранилища.''

Для того, чтобы найти в хранилище параметры наших форм, надо знать [[РУИД]] типового документа. Узнать РУИД можно в справочнике типовых документов (Исследователь -> Сервис -> Типовые документы). Для этого можно отобразить в гриде колонку «РУИД» или воспользоваться правой кнопкой мыши и пунктом контекстного меню «Свойства» для нашего типового документа.

=== Добавление параметров формы в настройку ===

Итак, действия по добавлению параметров формы в настройку следующие:
#Открываем окно хранилища и выбираем тип <GLOBAL>.
#Нажимаем кнопку поиска и вводим в строку поиска [[РУИД]] нашего документа.
#Найденные разделы хранилища отобразятся в нижней части окна (рис. 1). В нашем примере таких разделов два. Один отвечает за хранение параметров формы просмотра (\DFM\Tgdc_frmUserComplexDocument\), второй – за хранение параметров диалогового окна документа (\DFM\Tgdc_dlgUserComplexDocument\). Обратите внимание, что в хранилище будут только параметры тех форм, которые подвергались настройке (изменению). То есть, если бы параметры формы просмотра не изменялись (что бывает довольно часто), то в результатах поиска был бы только один раздел – с параметрами диалогового окна.
#В результатах поиска щелкаем мышью по разделу формы просмотра. При этом в левой части окна отобразится ветвь хранилища, отвечающая за указанный раздел, а в правой части окна выделится параметр нашей формы. Синим шрифтом отображаются параметры, которые уже входят в какие-либо настройки. Как видно, параметры нашей формы пока не включены ни в одну настройку.
#Щелкаем правой кнопкой мыши по найденному параметру и выбираем команду «Добавить в настройку».

Дальнейшие действия такие же, как при добавлении в настройку любых других объектов.

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

Мы можем убедиться, что параметры нашей форм попали в настройку, если откроем окно настроек и найдем в нем нашу настройку. Данные хранилища, включенные в настройку, отображаются в правой нижней части окна (рис. 2).

http://gsbelarus.com/gs/images/gs/2007/img2_settings.jpg

''Рис.2. Форма просмотра настроек.''

=== Использование настройки setting_helper ===

Можно значительно упростить процесс добавления формы в настройку, если воспользоваться функциональностью настройки setting_helper.gsf (входит в раздел/папку «Общие»). После загрузки указанной настройки появится [[Глобальный макрос|глобальный макрос]] «Добавить форму в настройку». Чтобы решить нашу задачу нужно запустить этот макрос из формы, которую требуется добавить в настройку. При этом появится окно, изображенное на рисунке 3. 

http://gsbelarus.com/gs/images/gs/2007/img3_set_help.jpg

''Рис. 3. Добавление формы в настройку при помощи макроса.''

В окне отображаются все объекты и параметры, связанные с данной формой: отчеты, макросы, параметры хранилища и др. Нужно просто выбрать настройку и  проставить галочки напротив тех объектов, которые мы ходим в нее добавить. Кнопки в правом верхнем углу окна позволяют добавить в настройку сразу все объекты формы определенного типа. [[Макрос]] надо будет также запустить из формы диалогового окна, чтобы сохранить и ее параметры.

--[[Участник:Alex|Alex]] 16:43, 22 August 2007 (CEST)

[[Category: Документация]]