Датасет

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

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

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

Примеры операций с датасетом.

Копирование датасета в другой датасет:

OpenDataSet(`copy:`, `DataSet1`, `DataSet2`)

или

Assign(`DataSet2.*`, DataSet1)

Сортировка:

Gb_SetProp(`DataSet`,`IndexFieldNames`,`Имена полей через ;`)

Загрузка датасета из файла:

OpenDataSet(`file:`,`FileName,S="c:\DataSet.cds"`,`DataSet`)

Сохранить датасет в файл:

SaveDataSet(`DataSet` ,:file)

Вывод датасета в диалоге:

QueryParams(`Grid=DataSet`)

Получить датасет данные из другого документа:

CreateDataSet(`LinksDs`, `ID,I=""),

Assign(`LinksDs.*`, GB_GET( 11, :id, `Links` ))

Очистить датасет:

IIF(RecordCount( `DataSet` ) > 0,  DELETE( `DataSet.*` ))

Закрыть датасет:

Assign(`DataSet.*`, 1/0)