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

Материал из GedeminWiki
(Различия между версиями)
Перейти к: навигация, поиск
 
Строка 1: Строка 1:
При создании определенной функциональности на платформе [[Гедымин]] разработчик сохраняет созданные им объекты в настройки.
+
При создании определенной функциональности на платформе [[Гедымин]] разработчик сохраняет созданные им объекты в [[Настройка|настройке]].
  
Рассмотрим на конкретном примере, как добавлять в настройках параметры экранных форм.
+
Рассмотрим на конкретном примере, как добавлять в настройки параметры экранных форм.
  
 
Поскольку [[Гедымин]] – это платформа для создания документо-ориентированных приложений, то большинство экранных форм в любом прикладном решении – это формы типовых документов. В связи с этим рассмотрим задачу на примере типового документа пользователя, состоящего из шапки и позиций.
 
Поскольку [[Гедымин]] – это платформа для создания документо-ориентированных приложений, то большинство экранных форм в любом прикладном решении – это формы типовых документов. В связи с этим рассмотрим задачу на примере типового документа пользователя, состоящего из шапки и позиций.
  
Прежде всего, определимся, что по отношению к конечному пользователю элементы управления экранных форм могут быть разделены на настраиваемые и не настраиваемые. Настраиваемые элементы – это, прежде всего, гриды. Пользователь может изменять состав, положение и заголовки колонок, цветовую схему грида и проч. Все эти изменения хранятся для каждого пользователя отдельно.  
+
Прежде всего определимся, что по отношению к конечному пользователю элементы управления экранных форм могут быть разделены на настраиваемые и не настраиваемые. Настраиваемые элементы – это, прежде всего, гриды. Пользователь может изменять состав, положение и заголовки колонок, цветовую схему грида и проч. Все эти изменения хранятся для каждого пользователя отдельно.  
Не настраиваемые элементы управления – это кнопки панелей инструментов, а также все элементы управления расположенные в шапке диалогового окна. Изменять параметры этих элементов может только разработчик ([[Administrator]]), эти изменения будут распространяться на всех пользователей прикладного решения.
+
Ненастраиваемые элементы управления – это кнопки панелей инструментов, а также все элементы управления расположенные в шапке диалогового окна. Изменять параметры этих элементов может только разработчик ([[Administrator]]), эти изменения будут распространяться на всех пользователей прикладного решения.
  
Параметры, определяющие внешний вид экранной формы, содержатся в [[хранилище]]. И именно из хранилища эти параметры добавляются в настройку. При этом параметры не настраиваемых элементов хранятся в глобальном хранилище (<GLOBAL>), а параметры настраиваемых элементов – в пользовательском хранилище администратора (Administrator). Доступ к хранилищу можно получить через команду Исследователя «Сервис -> Хранилище». Внешний вид формы просмотра хранилища представлен на рисунке 1.
+
Параметры, определяющие внешний вид экранной формы, содержатся в [[Хранилище|хранилище]]. И именно из хранилища эти параметры добавляются в настройку. При этом, параметры не настраиваемых элементов хранятся в глобальном хранилище (в выпадающем списке обозначено как <GLOBAL>), а параметры настраиваемых элементов – в пользовательском хранилище администратора (Administrator). Доступ к хранилищу можно получить через команду Исследователя системы «Сервис -> Хранилище». Внешний вид формы просмотра хранилища представлен ниже на рис. 1.
  
Рис. 1. Форма просмотра хранилища.
+
http://gsbelarus.com/gs/images/gs/2007/img1_storage.jpg
  
Для того чтобы найти в хранилище параметры наших форм, надо знать [[РУИД]] типового документа. Узнать РУИД можно в справочнике типовых документов (Исследователь -> Сервис -> Типовые документы). Для этого можно отобразить в гриде колонку «РУИД» или воспользоваться правой кнопкой мыши и пунктом контекстного меню «Свойства» для нашего типового документа.
+
''Рис. 1. Форма просмотра хранилища.''
 +
 
 +
Для того, чтобы найти в хранилище параметры наших форм, надо знать [[РУИД]] типового документа. Узнать РУИД можно в справочнике типовых документов (Исследователь -> Сервис -> Типовые документы). Для этого можно отобразить в гриде колонку «РУИД» или воспользоваться правой кнопкой мыши и пунктом контекстного меню «Свойства» для нашего типового документа.
 +
 
 +
=== Добавление параметров формы в настройку ===
  
 
Итак, действия по добавлению параметров формы в настройку следующие:
 
Итак, действия по добавлению параметров формы в настройку следующие:
#Открываем хранилище и выбираем тип хранилища <GLOBAL>.
+
#Открываем окно хранилища и выбираем тип <GLOBAL>.
 
#Нажимаем кнопку поиска и вводим в строку поиска [[РУИД]] нашего документа.
 
#Нажимаем кнопку поиска и вводим в строку поиска [[РУИД]] нашего документа.
#Найденные разделы хранилища отобразятся в нижней части окна (рис. 1). В нашем примере таких разделов два. Один отвечает за хранение параметров формы просмотра (\DFM\Tgdc_frmUserComplexDocument\), второй – за хранение параметров диалогового окна документа (\DFM\Tgdc_dlgUserComplexDocument\). Обратите внимание, что в хранилище будут только параметры тех форм, которые подвергались настройке (изменению). То есть если бы параметры формы просмотра не изменялись (что бывает довольно часто), то в результатах поиска был бы только один раздел – с параметрами диалогового окна.
+
#Найденные разделы хранилища отобразятся в нижней части окна (рис. 1). В нашем примере таких разделов два. Один отвечает за хранение параметров формы просмотра (\DFM\Tgdc_frmUserComplexDocument\), второй – за хранение параметров диалогового окна документа (\DFM\Tgdc_dlgUserComplexDocument\). Обратите внимание, что в хранилище будут только параметры тех форм, которые подвергались настройке (изменению). То есть, если бы параметры формы просмотра не изменялись (что бывает довольно часто), то в результатах поиска был бы только один раздел – с параметрами диалогового окна.
 
#В результатах поиска щелкаем мышью по разделу формы просмотра. При этом в левой части окна отобразится ветвь хранилища, отвечающая за указанный раздел, а в правой части окна выделится параметр нашей формы. Синим шрифтом отображаются параметры, которые уже входят в какие-либо настройки. Как видно, параметры нашей формы пока не включены ни в одну настройку.
 
#В результатах поиска щелкаем мышью по разделу формы просмотра. При этом в левой части окна отобразится ветвь хранилища, отвечающая за указанный раздел, а в правой части окна выделится параметр нашей формы. Синим шрифтом отображаются параметры, которые уже входят в какие-либо настройки. Как видно, параметры нашей формы пока не включены ни в одну настройку.
 
#Щелкаем правой кнопкой мыши по найденному параметру и выбираем команду «Добавить в настройку».
 
#Щелкаем правой кнопкой мыши по найденному параметру и выбираем команду «Добавить в настройку».
Строка 27: Строка 31:
 
Мы можем убедиться, что параметры нашей форм попали в настройку, если откроем окно настроек и найдем в нем нашу настройку. Данные хранилища, включенные в настройку, отображаются в правой нижней части окна (рис. 2).
 
Мы можем убедиться, что параметры нашей форм попали в настройку, если откроем окно настроек и найдем в нем нашу настройку. Данные хранилища, включенные в настройку, отображаются в правой нижней части окна (рис. 2).
  
Рис.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
  
Можно значительно упростить процесс добавления формы в настройку, если воспользоваться функциональностью настройки setting_helper.gsf (входит в раздел/папку «Общие»). После загрузки указанной настройки появится [[глобальный макрос]] «Добавить форму в настройку». Чтобы решить нашу задачу нужно запустить этот макрос из формы, которую требуется добавить в настройку. При этом появится окно изображенное на рисунке 3. В окне отображаются все объекты и параметры, связанные с данной формой: отчеты, макросы, параметры хранилища и др. Нужно просто выбрать настройку и  проставить галочки напротив тех объектов, которые мы ходим в нее добавить. Кнопки в правом верхнем углу окна позволяют добавить в настройку сразу все объекты формы определенного типа. [[Макрос]] надо будет также запустить из формы диалогового окна, чтобы сохранить и ее параметры.
+
''Рис. 3. Добавление формы в настройку при помощи макроса.''
  
Рис. 3. Добавление формы в настройку при помощи макроса.
+
В окне отображаются все объекты и параметры, связанные с данной формой: отчеты, макросы, параметры хранилища и др. Нужно просто выбрать настройку и  проставить галочки напротив тех объектов, которые мы ходим в нее добавить. Кнопки в правом верхнем углу окна позволяют добавить в настройку сразу все объекты формы определенного типа. [[Макрос]] надо будет также запустить из формы диалогового окна, чтобы сохранить и ее параметры.
  
 
--[[Участник:Alex|Alex]] 16:43, 22 August 2007 (CEST)
 
--[[Участник:Alex|Alex]] 16:43, 22 August 2007 (CEST)

Версия 18:08, 22 августа 2007

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

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

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

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

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

img1_storage.jpg

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

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

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

Итак, действия по добавлению параметров формы в настройку следующие:

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

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

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

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

img2_settings.jpg

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

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

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

img3_set_help.jpg

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

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

--Alex 16:43, 22 August 2007 (CEST)

Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты