Элемент служит для формирования списка полей, значения которых необходимо получать из базы данных для работы графического элемента Справочник.
Важно! Для возможности использования справочника в исполнительную систему должна входить опция MSRT4D-Catalog. Данная опция включена в базовый функционал лицензии Enterprise.
Для добавления элемента в пользовательскую библиотеку нужно выполнить пункт контекстного меню библиотеки Добавить.Справочник:
Появится группа Справочники, в которую будет добавлен элемент Справочник_1:
Имя добавленного элемента можно изменить в его панели свойств.
Важно! Имя Справочника должно совпадать с именем таблицы в базе данных.
Далее в Справочник нужно добавить Поля. После выполнения пункта Добавить.Поле контекстного меню Справочника откроется диалоговое окно, в котором нужно выбрать тип данных для этого поля:
В данном окне можно выбрать как простые типы данных, так и любые библиотечные. Также в качестве типа данных поля можно выбрать и другой справочник, который был ранее добавлен в библиотеку.
После выбора типа данных появится новый элемент в справочнике:
Набор полей справочника и их свойства (имя, тип данных и др.) должны совпадать с набором полей в реальной таблице базы данных, с которой необходимо обмениваться данными.
Вид панели свойств Поля справочника:
Кроме стандартных свойств категория Общие содержит дополнительные свойства:
Название |
Тип |
Назначение |
Ключевое поле |
BOOL |
Определяет является ли данное поле ключом для справочника. Если флаг установлен, то через это поле идут ссылки на данный справочник из других справочников, а также из обычных параметров. Если ни у одного поля не установлен флаг Ключевое поле, то в таблице необходимо создать дополнительное числовое поле Id, которое будет являться ключом. |
Отображаемое имя |
BOOL |
Определяет будет ли значение данного поля использовано в отображении значений полей других справочников, ссылающихся на данный. |
Описание других свойств находятся в соответствующих разделах.
Далее необходимо перетащить Справочник на элемент дерева системы БД справочников.
Параметр типа Справочник
Параметр объекта или программы может иметь тип Справочник. После добавления типа Справочник в библиотеку в окне настройки параметра появится дополнительная вкладка Справочники:
Во вкладке можно выбрать нужный справочник, при этом узел, где исполняется данный объект, должен иметь связь с базой данных, соответствующей этом справочнику. В этом случае параметр будет ссылаться на некоторую запись из данного справочника. Работа с таким параметром аналогична параметру структурного типа с некоторыми особенностями:
•Нельзя изменять отдельные поля справочника
•Отдельные поля можно перетаскивать в окна, передавать в другие параметры. Будет браться значение поля выбранной записи
•Если параметр экземпляра объекта имеет тип справочник, то в режиме разработки можно из комбобокса выбрать нужную запись (в случае, если доступно подключение к БД, где хранятся справочники этого типа). В этом случае в режиме исполнения в этот параметр записывается ссылка на выбранный экземпляр
•Период обновления значений полей выбранной записи задается в настройке БД справочников Период обновления параметров из справочника.