Сборка: Dt;
Интерфейс IDtUnpivotProvider предназначен для работы с табличным источником данных, разделенным на области.
IDtUnpivotProvider
Интерфейс IDtUnpivotProvider позволяет получить данные из табличного источника данных, разделенного на следующие области:
Стрелками на схеме показано какие размеры могут задаваться, цветом - для каких областей.
Условные обозначения:
A1, A2, A3, A4. Формальные области, на которые могут быть разделены данные в табличном источнике данных;
A1. Уголок таблицы. Размеры уголка не задаются;
A2. Область данных. Могут быть заданы:
Ht. Строка, определяющий верхнюю границу области;
Hb. Строка, определяющий нижнюю границу области;
Hc. Столбец в области A2, соответствующий блоку данных, по которому будут формироваться столбцы результирующей таблицы. На схеме выбран второй столбец;
А3. Область данных. Могут быть заданы:
Ll. Столбец, определяющий левую границу области;
Lr. Столбец, определяющий правую границу области;
A4. Область данных. Могут быть заданы:
Dt. Строка, определяющая начало данных. Начиная с данной строки будут считываться данные в результирующую таблицу;
Dr. Столбец, определяющий правую границу области;
Db. Строка, определяющая нижнюю границу области;
D. Количество столбцов в блоке данных. Относительно данного блока будет происходить формирование столбцов и заполнение строк в результирующей таблице. На схеме указано два блока данных размером три столбца.
Примечание. Между А3 и A4 не должно быть промежутков.
Все значения размеров должны быть заданы в абсолютных единицах.
Дополнительно могут быть заданы фиксированные ячейки. Каждая ячейка должна быть задана отдельно. Фиксированные ячейки могут быть расположены только выше области A4.
Результирующая таблица будет состоять из следующей последовательности столбцов:
Столбцы с данными из области A3. Количество столбцов совпадает с количеством столбцов в A3. В качестве заголовков будет использована строка, расположенная выше A3.
Столбцы с данными из области A2. Количество столбцов вычисляется по формуле:
если Hc задано: Hb-Ht+1;
если Hc не задано: (Hb-Ht+1)*D.
В качестве заголовков будет использован столбец, расположенный левее A2.
Столбцы, соответствующие фиксированным ячейкам. Заголовки будут сгенерированы автоматически.
Столбцы, соответствующие блоку данных D. Количество столбцов совпадает с количеством столбцов в D. В качестве заголовков будет использована строка, расположенная выше A4.
Количество строк в результирующей таблице будет равно количеству блоков данных D, которые умещаются в A4.
Автоматическая генерация заголовков выполняется в следующем формате: «FIELD0», «FIELD1» и так далее. Нумерация заголовков сквозная в пределах одной таблицы.
| Имя свойства | Краткое описание | |
 |
DataBottom | Свойство DataBottom определяет строку, задающую нижнюю границу области A4. |
|
DataRight | Свойство DataRight определяет столбец, задающий правую границу области A4. |
|
DataTop | Свойство DataTop определяет строку, задающую начало данных в области A4. |
|
DataWidth | Свойство DataWidth определяет количество столбцов в блоке данных, расположенном в области A4. |
|
FixedCells | Свойство FixedCells определяет двумерный массив с координатами фиксированных ячеек. |
|
HeadBottom | Свойство HeadBottom определяет строку, задающую нижнюю границу области A2. |
|
HeadColumn | Свойство HeadColumn определяет столбец в области A2, соответствующий блоку данных, по которому будут формироваться столбцы результирующей таблицы. |
|
HeadTop | Свойство HeadTop определяет строку, задающую верхнюю границу области A2. |
|
LeftBegin | Свойство LeftBegin определяет первый столбец с данными, задающий левую границу области A3. |
|
LeftEnd | Свойство LeftEnd определяет столбец, задающий правую границу области A3. |
|
Provider | Свойство Provider определяет табличный источник данных, содержащий области. |
| Имя свойства | Краткое описание | |
|
AutoFillFieldsMode | Свойство AutoFillFieldsMode определяет режим распознавания типа полей источника данных. |
|
CalcFieldsErrors | Свойство CalcFieldsErrors возвращает коллекцию ошибок, возникших при расчете вычисляемых полей. |
|
Eof | Свойство Eof возвращает признак расположения курсора в источнике данных на последней записи. |
|
FetchErrors | Свойство FetchErrors возвращает ошибки, возникшие при импорте данных. |
|
FilterIf | Свойство FilterIf возвращает условие загрузки записей из источника данных. |
|
StringDataFormat | Свойство StringDataFormat возвращает настройки, используемые при идентификации данных. |
|
TypeGuessRows | Свойство TypeGuessRows определяет количество строк, по которым будет определяться тип данных каждого поля. |
| Имя свойства | Краткое описание | |
|
Active | Свойство Active возвращает состояние источника/приёмника данных. |
|
Fields | Свойство Fields возвращает описание полей источника/приёмника данных. |
|
GetType | Свойство GetType возвращает тип источника/приёмника данных. |
|
Metabase | Свойство Metabase определяет репозиторий, в котором выполняется импорт или экспорт данных. |
| Имя метода | Краткое описание | |
 |
FromSource | Метод FromSource позволяет определить координаты ячейки в исходной таблице по координатам ячейки в итоговой таблице. |
|
SourceCellPosition | Метод SourceCellPosition определяет место расположение ячейки в исходной кросс-таблице по расположению в полученной преобразованной таблице. |
|
ToSource | Метод ToSource позволяет определить координаты ячейки в исходной таблице по координатам ячейки в итоговой таблице. |
| Имя метода | Краткое описание | |
|
Fetch | Метод Fetch осуществляет чтение данных текущей записи из источника данных. |
|
FetchRows | Метод FetchRows осуществляет чтение данных указанного количества записей из источника данных и возвращает количество фактически считанных записей. |
|
ReadingRowsCount | Метод ReadingRowsCount возвращает количество записей, считанных из источника данных с учетом условия загрузки. |
|
ReadingRowsTotalCount | Метод ReadingRowsTotalCount возвращает количество записей, считанных из источника данных без учета условия загрузки. |
| Имя метода | Краткое описание | |
|
ClearFields | Метод ClearFields очищает список полей приёмника/источника данных. |
|
Close | Метод Close закрывает источник/приёмник данных. |
|
FieldsFromFile | Метод FieldsFromFile осуществляет чтение списка полей из файла-источника. |
|
Load | Метод Load загружает параметры источника/приёмника данных из XML. |
|
Open | Метод Open открывает источник/приёмник данных. |
|
Save | Метод Save сохраняет параметры источника/приёмника данных в формате XML. |
См. также:
Пример
