БД справочников

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево системы > Узел > Архивы >

БД справочников

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

Важно! Для возможности работы с БД справочников в исполнительную систему должна входить опция MSRT4D-Catalog. Данная опция включена в базовый функционал лицензии Enterprise.

Добавить элемент в проект можно при помощи контекстного меню самого узла или его  элемента Архивы:

bd_spravochnik

Вид панели свойств:

bd_spravochnik_1

Описание основных свойств:

Название

Тип

Назначение

Подключение к БД

Тип БД

 

База данных выбирается из списка. В комплект поставки входит база данных SQLITE.

Важно! Для возможности работы с базами данных PostgreSQL и MSSQL в исполнительную систему должна входить опция MSRT-DB. Данная опция включена в базовый функционал лицензий Standard, Professional и Enterprise.

Важно! Для хранения архивов в базе данных, ее необходимо предварительно установить. Среда исполнения может работать как c локально установленной базой данных, так и с удаленной. Прежде чем приступить к настройке связи с базой данной, необходимо создать пустую базу данных, и указать в её настройках имя пользователя и пароль.

Имя БД

STRING

Место хранения архива.

Если выбран Тип БД sqlite3 и это поле остается пустым, то архив пишется в папку того проекта, который загружается в исполнительную систему.

Для некоторых предопределенных узлов (контроллеров), по умолчанию задается место хранения архивов на выделенной SD/USB Flash-карте. Если во время работы контролера вытащить карту или  по каким-то другим причинам контроллер не будет распознавать её, то автоматически сформируется системное сообщение об ошибке подключения к БД, отсутствии карточки и остановке архивирования.  Просмотреть сообщение можно используя журнал сообщений, в соответствии с настройками журнала:

_Arhiv_dannwh_1

Так же сообщения об ошибках работы с архивом на SD/USB Flash-карте можно просматривать на выходах ErrorText функциональных блоков GetDataArchiveStatistic и GetEventsArchiveStatistic.

При компиляции проекта может отображаться ошибка в следующих случаях:

в проект добавлен узел, в котором присутствуют архивы с одинаковым значением свойства Имя БД;

если выбран Тип БД postgresql или msssql и не указано значение свойства Имя БД;

если в узле присутствуют два и более архива, у которых свойство Тип БД имеет значение sqlite3, а значения у свойства Имя БД отсутствуют.

osnovnoy_arhiv_dannyh_1

Сервер

STRING

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

Порт

DINT

Указывается ТСP/IP порт для работы с базой данных. При использовании брандмауэров и антивирусов необходимо разрешить использование данного порта.

Пользователь

STRING

Параметр подключения к БД, если БД требует аутентификацию.

Пароль

STRING

Пароль доступа к базе данных.

Параметры подключения

STRING

Указываются ключевые слова-параметры или атрибуты для подключения к БД.

Период обновления параметров из справочника

TIME

Период обновления значений полей, получаемых из базы данных.

Проверить соединение с БД

 

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

При успешном подключении откроется информационное окно Сообщение следующего вида:

_Arhiv_dannwh_3

Если при попытке проверить соединение возникнет ошибка, то откроется информационное окно Сообщение с описанием ошибки:

_Arhiv_dannwh_2

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

bd_spravochnik_2

Важно! Набор полей таблицы базы данных должна соответствовать набору полей в Справочнике. Если выбранный справочник ссылается на другие справочники , то в данной БД должны присутствовать таблицы для всех этих справочников

Рекомендации при использовании PostgreSQL

При создании таблиц не используйте графический конструктор, создавать нужно используя скрипты. Например:

 

CREATE TABLE sachetRecipe

 

(

   idSachetRecipe SERIAL PRIMARY KEY,

 

   recipeName character varying(50) NOT NULL,

 

   weight bigint,

 

   minWeight bigint

)