Добавление в настройку параметров экранных форм
Материал из GedeminWiki
При создании определенной функциональности на платформе Гедымин разработчик сохраняет созданные им объекты в настройке.
Рассмотрим на конкретном примере, как добавлять в настройки параметры экранных форм.
Поскольку Гедымин – это платформа для создания документо-ориентированных приложений, то большинство экранных форм в любом прикладном решении – это формы типовых документов. В связи с этим рассмотрим задачу на примере типового документа пользователя, состоящего из шапки и позиций.
Прежде всего определимся, что по отношению к конечному пользователю элементы управления экранных форм могут быть разделены на настраиваемые и не настраиваемые. Настраиваемые элементы – это, прежде всего, гриды. Пользователь может изменять состав, положение и заголовки колонок, цветовую схему грида и проч. Все эти изменения хранятся для каждого пользователя отдельно. Ненастраиваемые элементы управления – это кнопки панелей инструментов, а также все элементы управления расположенные в шапке диалогового окна. Изменять параметры этих элементов может только разработчик (Administrator), эти изменения будут распространяться на всех пользователей прикладного решения.
Параметры, определяющие внешний вид экранной формы, содержатся в хранилище. И именно из хранилища эти параметры добавляются в настройку. При этом, параметры не настраиваемых элементов хранятся в глобальном хранилище (в выпадающем списке обозначено как <GLOBAL>), а параметры настраиваемых элементов – в пользовательском хранилище администратора (Administrator). Доступ к хранилищу можно получить через команду Исследователя системы «Сервис -> Хранилище». Внешний вид формы просмотра хранилища представлен ниже на рис. 1.
Рис. 1. Форма просмотра хранилища.
Для того, чтобы найти в хранилище параметры наших форм, надо знать РУИД типового документа. Узнать РУИД можно в справочнике типовых документов (Исследователь -> Сервис -> Типовые документы). Для этого можно отобразить в гриде колонку «РУИД» или воспользоваться правой кнопкой мыши и пунктом контекстного меню «Свойства» для нашего типового документа.
Добавление параметров формы в настройку
Итак, действия по добавлению параметров формы в настройку следующие:
- Открываем окно хранилища и выбираем тип <GLOBAL>.
- Нажимаем кнопку поиска и вводим в строку поиска РУИД нашего документа.
- Найденные разделы хранилища отобразятся в нижней части окна (рис. 1). В нашем примере таких разделов два. Один отвечает за хранение параметров формы просмотра (\DFM\Tgdc_frmUserComplexDocument\), второй – за хранение параметров диалогового окна документа (\DFM\Tgdc_dlgUserComplexDocument\). Обратите внимание, что в хранилище будут только параметры тех форм, которые подвергались настройке (изменению). То есть, если бы параметры формы просмотра не изменялись (что бывает довольно часто), то в результатах поиска был бы только один раздел – с параметрами диалогового окна.
- В результатах поиска щелкаем мышью по разделу формы просмотра. При этом в левой части окна отобразится ветвь хранилища, отвечающая за указанный раздел, а в правой части окна выделится параметр нашей формы. Синим шрифтом отображаются параметры, которые уже входят в какие-либо настройки. Как видно, параметры нашей формы пока не включены ни в одну настройку.
- Щелкаем правой кнопкой мыши по найденному параметру и выбираем команду «Добавить в настройку».
Дальнейшие действия такие же, как при добавлении в настройку любых других объектов.
Аналогично добавляются в настройку параметры гридов формы. Только в этом случае поиск параметров следует производить в пользовательском хранилище Администратора. В нашем примере надо будет добавить в настройку параметры главного и детального гридов формы просмотра, а также параметры грида диалогового окна.
Мы можем убедиться, что параметры нашей форм попали в настройку, если откроем окно настроек и найдем в нем нашу настройку. Данные хранилища, включенные в настройку, отображаются в правой нижней части окна (рис. 2).
Рис.2. Форма просмотра настроек.
Использование настройки setting_helper
Можно значительно упростить процесс добавления формы в настройку, если воспользоваться функциональностью настройки setting_helper.gsf (входит в раздел/папку «Общие»). После загрузки указанной настройки появится глобальный макрос «Добавить форму в настройку». Чтобы решить нашу задачу нужно запустить этот макрос из формы, которую требуется добавить в настройку. При этом появится окно, изображенное на рисунке 3.
Рис. 3. Добавление формы в настройку при помощи макроса.
В окне отображаются все объекты и параметры, связанные с данной формой: отчеты, макросы, параметры хранилища и др. Нужно просто выбрать настройку и проставить галочки напротив тех объектов, которые мы ходим в нее добавить. Кнопки в правом верхнем углу окна позволяют добавить в настройку сразу все объекты формы определенного типа. Макрос надо будет также запустить из формы диалогового окна, чтобы сохранить и ее параметры.
--Alex 16:43, 22 August 2007 (CEST)
