Под источником данных в информационной модели PowerM™ понимается некий объект предопределенного класса, в результате обращения к которому могут быть получены как его данные, так и вся необходимая информация об этом источнике. При этом описание атрибутов и ключевых методов такого объекта хранится в словаре метаданных.
Ключевыми свойствами объекта-источника, кроме его имени, являются свойства typeof, url и dataformat которые содержат описание типа, физическое местонахождение источника, а также формат данных соответственно. Тип источника может принимать одно из следующих значений:
- базовая таблица БД
- временная таблица БД
- мета-таблица
- хранимая процедура БД (если поддерживается СУБД)
- функция языка PowerBuilder
- web-сервис (метод)
- внешний файл в формате TXT, CSV, DBASE2, DBASE3, XML, JSON
- отдельное поле таблицы в формате TXT, CSV, XML, JSON
Значения некоторых свойств источника данных могут быть записаны в виде выражений (expressions), которые будут вычислены во время исполнения на стороне клиента (PowerBuilder computes), SQL-сервера, либо интерпретированы виртуальной машиной ядра PowerM™.
Права доступа к источникам данных для конкретных ролей (профилей) пользователей описывается в следующих разрезах:
- просмотр (SELECT)
- модификация (UPDATE)
- добавление (INSERT)
- удаление (DELETE)
В дополнение к привилегиям, назначаемым на источник данных в целом, более детальную защиту для выбранной роли можно настроить вплоть до видимости конкретного столбца, а также отдельных строк данных, удовлетворяющих заданному условию фильтра.
В следующей таблице приведены основные свойства объекта источник данных, а также их описание
Свойство | Описание |
Код (Code) | Уникальный код (обозначение) источника данных |
Квалификатор (Qualifier) |
Имя владельца таблицы или схемы базы данных. |
Наименование (Name) | Полное наименование источника данных |
Тип (TypeOf) | Тип источника (выбирается из справочника). Возможные варианты описаны выше |
Путь (URL) | Путь к источнику данных, тип у которого выбран как Внешний файл или Web-сервис (метод). Для файлового источника в пути могут быть задействованы как специальные переменные среды PowerM™, так переменные системного окружения в формате %ИмяПеременной%. |
Формат (DataFmt) | Формат данных, возвращаемый источником: SQL, TXT, CSV, DBASE2, DBASE3, XML, JSON |
Содержание (Content) | Смысловое содержание информации, для хранения которой предназначен данный источник (выбирается из справочника) |
Главная иконка (MainIcon) | Имя иконки (ресурса), отображаемой в подзаголовке Query-модели, главная таблица которой совпадает с данным источником |
Иконка для формы (FormIcon) | Имя иконки (ресурса), отображаемой в подзаголовке Query-модели со стилем FORM, главная таблица которой совпадает с данным источником |
Выражения | |
PKEY | Список полей через запятую, образующих первичный ключ для строк источника |
IDENTITY | Имя колонки, значение полей у которой присваивается автоматически самой СУБД, и являющейся одновременно первичным ключом данных |
Название строки (RowName) | Список колонок через запятую, которые будут участвовать при формировании имени текущей записи таблицы |
Описание строки (RowDesc) | Список колонок через запятую, которые будут участвовать при формировании дополнительной информации для текущей записи и выводиться в специально отведенной строке экранной таблицы |
АвтоКолонки (MagicCols) | Список колонок через запятую, значения полей у которых автоматически присваиваются самой СУБД (декларативно или с помощью триггеров) |
Действия | |
List | Спецификация визуальной модели, отображаемая при необходимости вывода данных источника в табличном виде |
DropDown | Спецификация визуальной модели, которая отображается на экране при необходимости вывода данных в виде выпадающего списка |
Edit | Модель, вызываемая для редактирования свойств текущей записи |
View | Модель, вызываемая для отображения свойств текущей записи в режиме READONLY |
Модель, отображаемая при вызове команды Главого меню Функции>Печатные формы. Данное действие может быть переопределено в событии showDocument класса контроллера родительской визуальной модели | |