Импорт файлов Excel¶
Общий порядок действий¶
Перед началом импорта файла убедитесь, что у вас выбрана база данных, куда будет происходит сохранение данных из импортируемого файла Excel. Для этого включите опцию Включить сохранение excel в настройках соответствующей базы данных.
Импорт файла начинаем с нажатия кнопки Upload excel file, после чего произойдет переход на стартовую страницу с выбором режима импорта файла и кнопкой Загрузить файл.
После нажатия кнопки Загрузить файл в открывшемся стандартном диалоговом окне выбора файла выбираем нужный файл Excel.
После выбора импортируемого файла диалог открытия файла закрывается, и мы вновь возвращаемся на предыдущую страницу, на которой теперь добавилась кнопка Загрузить другой файл, функциональность которой следует из ее названия. Если вы осознали, что выбрали не тот файл, что надо - воспользуйтесь ею.
Повторное нажатие кнопки Загрузить файл приводит к импорту выбранного файла с учетом выбранного режима. Все имеющиеся в файле листы будут импортированы в виде отдельных таблиц с именами вида %ExcelFileName%/%SheetName%.
При успешной загрузке будет выведено диалоговое окно с текстом “Загрузка завершена успешно!” и двумя кнопками: Закрыть и Перейти на страницу базы данных. Нажатие кнопки Закрыть закрывает сообщение, переводя систему в п.1.
При нажатии на кнопку Перейти на страницу базы данных откроется список загруженных ранее таблиц. Найдем нужную, пролистав список, или воспользовавшись полем поиска в правом верхнем углу страницы.
Режимы импорта файлов¶
Импортировать файл можно одним из трех режимов:
“Перезаписать” - заменить ранее загруженный файл с тем же именем.
“Дополнить” – дописать данные в ранее загруженный файл с тем же именем.
“Создать новую БД с префиксом текущей даты” – добавить новый файл, при этом к именам таблиц будут добавлены дата и время импорта (пример см. на фото).
Особенности режимов импорта файлов¶
Таблица импортируется впервые - какой режим выбрать?¶
В случае с новой (впервые импортируемой под данным именем) таблицей можно использовать все 3 режима, результат будет одинаков.
В этом (и только этом) случае в режиме “Создать новую БД с префиксом текущей даты” к именам таблиц дата и время импорта добавлены не будут.
Режим “Создать новую БД с префиксом текущей даты” - важное отличие¶
В режиме “Создать новую БД с префиксом текущей даты” к имени импортированной таблицы будет добавлена дата и время импорта (кроме случая, когда эта таблица импортируется впервые).
Какие возможности и ограничения это налагает?
Дальнейшая модернизация или перезапись данных в этой таблице невозможна, для этого вам придется ее удалить и импортировать заново.
Вам как раз нужна таблица в режиме “только для чтения”? Это именно тот случай!
Данный режим позволяет импортировать одну и ту же таблицу неограниченное количество раз, создавая отдельные экземпляры таблиц, что позволит фиксировать содержимое данной таблицы в разные моменты времени.
При этом наличие вышеперечисленных неизменяемых копий таблицы никак не мешает вам импортировать эту же таблицу в другом режиме и редактировать в ней данные по своему усмотрению.
Требования к импортируемым файлам¶
Допустимые форматы файлов Excel¶
Основным Excel-форматом для импорта является стандартный формат XLSX.
Также возможен импорт файлов XLSM (Книга Excel с поддержкой макросов), но файлы этого формата в диалоге выбора файла не отображаются.
Файлы формата XLS (файлы Excel до версии 2003 включительно) и другие из числа форматов, создаваемых Excel’ем и аналогичными табличными редакторами, не импортируются.
Какие символы допустимы в именах файлов¶
В именах файлов разрешены любые символы, допускаемые операционной системой. Обратите внимание, что некоторые экзотичные символы могут быть проигнорированы и не попадут из имени файла в имя таблицы, при этом никаких сообщений об ошибке выдано не будет. В результате таблица окажется импортирована с именем, несколько отличающимся от ожидаемого.
Файлы с очень длинными именами - особенности обработки¶
Максимально допустимая длина имени файла (не считая расширения) - около 54 символов в зависимости от выбранного режима импорта. Ее превышение отдельно не отслеживается, и при превышении приводит к выдаче сообщения об ошибке:
В режимах “Перезаписать” и “Дополнить”: Загрузка завершена с ошибкой! Ошибка загрузки 500: Server Error;
В режиме “Создать новую БД с префиксом текущей даты”: Загрузка завершена с ошибкой! Ошибка: Некорректный формат данных на вкладке: %SheetName%.
В случае с очень длинным (но допустимым) именем импортированного файла может возникнуть ситуация, когда будут превышены возможности графического интерфейса GlarusBI по его отображению (33 символа максимум), в результате чего отобразится только часть длинного имени, и у пользователя может сложиться ошибочное мнение, что в списке импортированных таблиц присутствуют таблицы с одинаковыми именами.
Требования к названиям листов¶
Требования к именам листов соответствует таковым в Excel, дополнительных ограничений не накладывается.
Требования к именам столбцов таблицы¶
Имена столбцов создаваемой таблицы берутся из ячеек 1-й строки импортируемого файла, соответственно, ничего другого в этой строке быть не должно.
В названиях столбцов таблицы допускаются символы латинского и кириллического алфавита (в т.ч. символы расширенной кириллицы (”ё”, “ъ”, “ї” и т.п.)), цифры, знаки препинания и пр.
Если части названия столбца импортируемой таблицы разделены подчеркиваниями или тире, например, “Поле_АБВ-клмн”, то GlarusBI такое название рассматривает как набор слов и импортировано оно будет в виде “Поле Абв Клмн”, т.е. подчеркивания и тире заменяются пробелами; получившиеся части/слова начинаются с большой буквы, остальные буквы в каждом слове – маленькие.
Если в импортируемой таблице названия столбцов повторяются (например, несколько раз встречается “ПолеА”), то они будут импортированы в таком виде: “ПолеА”, “ПолеА 2”, “ПолеА 3” и т.д. При сравнении имен столбцов импортируемой таблицы регистр символов не учитывается.
Наличие объединенных ячеек в 1-й строке приводит к ошибке: файл импортируется без ошибок, но потом войти в эту таблицу, содержавшую такие ячейки, невозможно, выводится сообщение об ошибке: С вашим запросом возникла проблема. При этом импортированные с других листов этого файла таблицы открываются корректно.
Требования к импортируемым данным¶
Из ячеек с формулами импортируются значения.
При наличии хотя бы одной ячейки с ошибкой импорт всего файла не производится, выдается сообщение об ошибке: Загрузка завершена с ошибкой! Ошибка: Невозможно импортировать данные на вкладке: %SheetName%.
При несовпадении форматов столбцов импортируемой и уже существующей таблиц:
в режиме “Дописать” - импорт не производится, выдается сообщение об ошибке;
в режиме “Заменить” - производится замена структуры данных на новую без каких-либо предупреждений.
Пустых строки в импортируемом файле быть не должно. При их обработке не выдается никаких ошибок, но происходит потеря данных из последней/последних строк таблицы.
Наличие в импортируемом файле рисунков, графиков и т.п. допустимо и на процесс импорта не влияет.
Наличие в импортируемых данных объединенных ячеек допустимо, но они будут обработаны следующим образом: значение из объединенной ячейки будет размещено в левой верхней ячейке объединенной зоны, а остальные ячейки будут заполнены нулями/пустыми значениями.