Условия и ограничения:
-
загружаемый файл с расширением .xls должен быть типа «xls» (создан в программе MS Excel или иной способной создавать файлы данного типа);
-
файл может содержать один или несколько листов – данные листы воспринимаются как независимые таблицы;
-
данные на каждом листе воспринимаются как одна плоская таблица. Варианты, когда на листе фактически несколько таблиц данных (разграничены пустыми столбцами или строками, линиями границ или цветовым выделением ячеек), не поддерживаются;
-
файл в ячейках может содержать формулы. Формулы должны корректно и без ошибок вычисляться при открытии в программе MS Excel. После загрузки в Систему ячейки с формулами будут восприняты как постоянные данные (полученные расчетом текущие значения);
-
объединение ячеек в строках при загрузке игнорируется. Значение из объединенных ячеек в строке присваивается первой ячейке по порядку слева направо, остальные заполняются пустыми значениями;
-
объединение ячеек в столбце при загрузке игнорируется. Значение из объединенных ячеек в столбце присваивается первой ячейке по порядку сверху вниз, остальные заполняются пустыми значениями;
-
одновременное объединение в ячейке строк и столбцов обрабатывается аналогично. Значение из объединенных ячеек присваивается первой ячейке по порядку сверху вниз и слева направо, остальные заполняются пустыми значениями;
-
первая строка на каждом листе (и только она) воспринимается как строка заголовков таблиц. Она должна содержать значения (будущие названия столбцов) во всех используемых столбцах. Сложные многострочные «шапки» таблиц, с объединениями строк и столбцов, не поддерживаются. Доступно определение позиции строки заголовков с помощью параметра «СтрокаЗаголовка» (см. п. Параметры);
-
для восприятия столбцов как определенных типов данных (целое и дробные числа, текст, дата и время) данные типы явно определите в файле у всех строк столбца, кроме первой (заголовка). Все строки столбца (кроме первой) должны иметь один тип данных – иначе столбец будет интерпретирован как текст и в дальнейшем к этим данным не будут применимы математические операции агрегирования;
-
рекомендуется четко понимать необходимое (загружаемое) количество строк и столбцов. Лишние строки и столбцы (даже если они в MS Excel выглядят пустыми) – необходимо выделить и удалить до загрузки файла;
-
тип значений по умолчанию – «строка». По умолчанию пустые столбцы и строки (пустые ячейки) в MS Excel создаются с типом «Общий». Такие столбцы воспринимаются как данные типа «Строка» (текст);
-
игнорируются настроенные в Excel группировки строк и столбцов, фильтры, ширина, высота, выделение ячеек;
-
сводные таблицы Excel воспринимаются, но игнорируются различного рода возможности визуализации сортировки и фильтрации, доступные для них в интерфейсе MS Excel (например, выделение отступами по уровням);
-
настроенное в MS Excel скрытие столбцов и строк игнорируется;
-
в загружаемом файле не должно быть столбцов с одинаковыми наименованиями (к одинаковым наименованиям также относятся поля типа «код» и «kod», т.к. при создании модели для поля «код» сформируется наименование на латинице – «kod», что приведет к дублированию полей в таблице);
-
значение типа «Дата» или «Время» в Excel определяется как тип datetime64[ns] (см. Рисунок «Соответствие форматов для значений типа «Дата», Рисунок «Соответствие форматов для значений типа «Время»);
-
значение типа «Текстовый» в Excel (в форматах, перечисленных в таблице ниже (см. Таблица «Форматы и примеры значений») определяется как тип datetime64[ns, UTC] (см. Рисунок «Соответствие форматов для значений типа «Текстовый»).