Создание типа Справочника

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево библиотек > Пользовательская библиотека >

Создание типа Справочника

Элемент служит для формирования списка полей, значения которых  необходимо получать из базы данных для работы графического элемента Справочник.

Для добавления элемента в пользовательскую библиотеку нужно выполнить пункт контекстного меню библиотеки Добавить.Справочник:

sozd_tipa_spraochnika

Появится группа Справочники, в которую будет добавлен элемент Справочник_1:

sozd_tipa_spraochnika_1

Имя добавленного элемента можно изменить в его панели свойств.

Важно! Имя Справочника должно совпадать с именем таблицы в базе данных.

Далее в Справочник нужно добавить Поля. После выполнения пункта Добавить.Поле контекстного меню Справочника откроется диалоговое окно, в котором нужно выбрать тип данных для этого поля:

sozd_tipa_spraochnika_2

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

После выбора типа данных появится новый элемент в справочнике:

sozd_tipa_spraochnika_3

Набор полей справочника и их свойства (имя, тип данных и др.) должны совпадать с  набором полей в реальной таблице базы данных, с которой необходимо обмениваться данными.

Вид панели свойств Поля справочника:

sozd_tipa_spraochnika_4

Кроме стандартных свойств категория Общие содержит дополнительные свойства:

Название

Тип

Назначение

Ключевое поле

BOOL

Определяет является ли данное поле ключом для справочника. Если флаг установлен, то через это поле идут ссылки на данный справочник из других справочников, а также из обычных параметров. Если ни у одного поля не установлен флаг Ключевое поле, то в таблице необходимо создать дополнительное числовое поле Id, которое будет являться ключом.

Отображаемое имя

BOOL

Определяет будет ли  значение данного поля  использовано в отображении значений полей других справочников, ссылающихся на данный.

Описание других свойств находятся в соответствующих разделах.

Далее необходимо перетащить Справочник на элемент дерева системы БД справочников.

Параметр типа Справочник

Параметр объекта или программы может иметь тип Справочник. После добавления типа Справочник в библиотеку в окне настройки параметра появится дополнительная вкладка Справочники:

sozd_tipa_spraochnika_5

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

Нельзя изменять отдельные поля справочника

Отдельные поля можно перетаскивать в окна, передавать в другие параметры. Будет браться значение поля выбранной записи

Если параметр экземпляра объекта имеет тип справочник, то в режиме разработки можно из комбобокса выбрать нужную запись (в случае, если доступно подключение к БД, где хранятся справочники этого типа). В этом случае в режиме исполнения в этот параметр записывается ссылка на выбранный экземпляр

Период обновления значений полей выбранной записи задается в настройке БД справочников Период обновления параметров из справочника.