IDtUnpivotProvider

Сборка: Dt;

Пространство имен: Prognoz.Platform.Interop.Dt;

Описание

Интерфейс IDtUnpivotProvider предназначен для работы с табличным источником данных, разделенным на области.

Иерархия наследования

          IDtObject

          IDtProvider

          IDtUnpivotProvider

Комментарии

Интерфейс IDtUnpivotProvider позволяет получить данные из табличного источника данных, разделенного на следующие области:

Стрелками на схеме показано какие размеры могут задаваться, цветом - для каких областей.

Условные обозначения:

• A1, A2, A3, A4. Формальные области, на которые могут быть разделены данные в табличном источнике данных;

• A1. Уголок таблицы. Размеры уголка не задаются;

• A2. Область данных. Могут быть заданы:

• Ht. Строка, определяющий верхнюю границу области;

• Hb. Строка, определяющий нижнюю границу области;

• Hc. Столбец в области A2, соответствующий блоку данных, по которому будут формироваться столбцы результирующей таблицы. На схеме выбран второй столбец;

• А3. Область данных. Могут быть заданы:

• Ll. Столбец, определяющий левую границу области;

• Lr. Столбец, определяющий правую границу области;

• A4. Область данных. Могут быть заданы:

• Dt. Строка, определяющая начало данных. Начиная с данной строки будут считываться данные в результирующую таблицу;

• Dr. Столбец, определяющий правую границу области;

• Db. Строка, определяющая нижнюю границу области;

• D. Количество столбцов в блоке данных. Относительно данного блока будет происходить формирование столбцов и заполнение строк в результирующей таблице. На схеме указано два блока данных размером три столбца.

Примечание. Между А3 и A4 не должно быть промежутков.

Все значения размеров должны быть заданы в абсолютных единицах.

Дополнительно могут быть заданы фиксированные ячейки. Каждая ячейка должна быть задана отдельно. Фиксированные ячейки могут быть расположены только выше области A4.

Результирующая таблица будет состоять из следующей последовательности столбцов:

1. Столбцы с данными из области A3. Количество столбцов совпадает с количеством столбцов в A3. В качестве заголовков будет использована строка, расположенная выше A3.

2. Столбцы с данными из области A2. Количество столбцов вычисляется по формуле:

• если Hc задано: Hb-Ht+1;

• если Hc не задано: (Hb-Ht+1)*D.

В качестве заголовков будет использован столбец, расположенный левее A2.

3. Столбцы, соответствующие фиксированным ячейкам. Заголовки будут сгенерированы автоматически.

4. Столбцы, соответствующие блоку данных 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 определяет табличный источник данных, содержащий области.

Свойства, унаследованные от IDtProvider

	Имя свойства	Краткое описание
	AutoFillFieldsMode	Свойство AutoFillFieldsMode определяет режим распознавания типа полей источника данных.
	CalcFieldsErrors	Свойство CalcFieldsErrors возвращает коллекцию ошибок, возникших при расчете вычисляемых полей.
	Eof	Свойство Eof возвращает признак расположения курсора в источнике данных на последней записи.
	FetchErrors	Свойство FetchErrors возвращает ошибки, возникшие при импорте данных.
	FilterIf	Свойство FilterIf возвращает условие загрузки записей из источника данных.
	StringDataFormat	Свойство StringDataFormat возвращает настройки, используемые при идентификации данных.
	TypeGuessRows	Свойство TypeGuessRows определяет количество строк, по которым будет определяться тип данных каждого поля.

Свойства, унаследованные от IDtObject

	Имя свойства	Краткое описание
	Active	Свойство Active возвращает состояние источника/приемника данных.
	Fields	Свойство Fields возвращает описание полей источника/приемника данных.
	GetType	Свойство GetType возвращает тип источника/приемника данных.
	Metabase	Свойство Metabase определяет репозиторий, в котором выполняется импорт или экспорт данных.

Методы

	Имя метода	Краткое описание
	FromSource	Метод FromSource позволяет определить координаты ячейки в исходной таблице по координатам ячейки в итоговой таблице.
	SourceCellPosition	Метод SourceCellPosition определяет место расположение ячейки в исходной кросс-таблице по расположению в полученной преобразованной таблице.
	ToSource	Метод ToSource позволяет определить координаты ячейки в исходной таблице по координатам ячейки в итоговой таблице.

Методы, унаследованные от IDtProvider

	Имя метода	Краткое описание
	Fetch	Метод Fetch осуществляет чтение данных текущей записи из источника данных.
	FetchRows	Метод FetchRows осуществляет чтение данных указанного количества записей из источника данных и возвращает количество фактически считанных записей.
	ReadingRowsCount	Метод ReadingRowsCount возвращает количество записей, считанных из источника данных с учетом условия загрузки.
	ReadingRowsTotalCount	Метод ReadingRowsTotalCount возвращает количество записей, считанных из источника данных без учета условия загрузки.

Методы, унаследованные от IDtObject

	Имя метода	Краткое описание
	ClearFields	Метод ClearFields очищает список полей приемника/источника данных.
	Close	Метод Close закрывает источник/приемник данных.
	FieldsFromFile	Метод FieldsFromFile осуществляет чтение списка полей из файла-источника.
	Load	Метод Load загружает параметры источника/приемника данных из XML.
	Open	Метод Open открывает источник/приемник данных.
	Save	Метод Save сохраняет параметры источника/приемника данных в формате XML.

См. также:

Интерфейсы сборки Dt