Импорт из Excel-файла

Используется для импорта данных из файлов Microsoft Excel.

Примечание: Поддерживается форматы *.xls, *.xlsx, *.xlsm.

Входные порты

Выходные порты

  • Импортированная таблица.

Мастер настройки

Мастер содержит несколько этапов настройки.

Шаг 1. Импорт из Excel файла

На первом этапе настройки указываются следующие параметры:

  • Имя файла/URL — путь к файлу, содержащему необходимые данные, или URL-ссылка для получения файла (поддерживаются протоколы http/https, а также HTTP Basic Authentication https://login:password@hostname.com/path/file.xlsx, http://hostname.com/path/file.xlsx).

    Кнопка вызывает диалог выбора файла.

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

    Для разделения файлов в строке используется специальный символ разделитель |, например: Имя Файла 1.xls|Имя Файла 2.xls.

    Имя файла может содержать маску, которая позволяет системе выполнять поиск файлов соответствующих ей. Для маски применяется специальный символ *. Пример: Путь до файла/М*ска.xls или Путь до файла/*.xls. При задании маски нельзя использовать символ ?, так как он может являться частью URL-ссылки. Чтобы сохранить возможность множественного импорта с использованием URL-ссылок, данный символ не воспринимается как маска.

  • Группа параметров Область данных.

    • Выбор объекта — предлагается выбрать один из вариантов выбора объекта Excel, содержащего импортируемые данные.
      • По номеру — по порядковому номеру листа книги.
      • По имени — по наименованию листа книги.
      • Именованный диапазон — по наименованию созданного в книге именованного диапазона.
    • Весь лист — область листа, содержащего данные для импорта, определяется автоматически.
    • Стиль ссылок — предлагается выбрать один из вариантов обозначения ячеек листа Excel.
      • A1 — в формате, в котором строка ячейки обозначается латинскими буквами, а столбец — цифрами.
      • R1C1 — в формате R[x]C[y], где x — номер строки ячейки, y — номер столбца ячейки.
    • Диапазон — диапазон импортируемых ячеек, заданных в формате [адрес верхней левой ячейки]:[адрес правой нижней ячейки].
    • До последней строки — при выборе этой опции диапазон ячеек, заданный в параметре Диапазон, будет расширен до последней строки.
  • Информация о файле — выпадающий список, добавляет дополнительные поля, содержащие информацию о файле:
    • Нет — без дополнительных полей.
    • Имя файла — дополнительное поле с именем файла: Товары.xls.
    • Относительный путь — дополнительное поле содержит относительный путь до файла: Пользователь/Downloads/Товары.xls.
    • Абсолютный путь — дополнительное поле содержит абсолютный путь до файла: C:Users/Пользователь/Downloads/Товары.xls.
    • Имя файла, время модификации — дополнительные поля, содержащие имя файла (поле Строкового типа) и время модификации файла (поле типа Дата/время).
    • Относительный путь, время модификации — дополнительные поля, содержащие относительный путь (поле Строкового типа) и время модификации файла (поле типа Дата/время).
    • Абсолютный путь, время модификации — дополнительные поля, содержащие абсолютный путь (поле Строкового типа) и время модификации файла (поле типа Дата/время).
  • Пустые строки — поскольку диапазон ячеек, заданный предыдущими параметрами, может содержать пустые строки, то предлагается выбрать один из вариантов их обработки.
    • Импортировать — пустые строки будут импортированы.
    • Исключить — пустые строки не будут импортированы.
    • До первой пустой строки — строки будут импортированы до первой пустой строки.
  • Количество строк заголовка — количество верхних строк заданного предыдущими параметрами диапазона, которые не будут импортированы.

Табличная часть мастера предназначена для отображения исходных данных и диапазона импортируемых ячеек. Значение параметра Диапазон можно задать при помощи выделения мышью ячеек таблицы.

Шаг 2. Настройка полей

На этапе настройки указываются следующие параметры:

  • Отобразить:
    • Результат — в табличной части окна мастера будет показан результат преобразования данных с учетом установленных параметров полей.
    • Исходные данные — в табличной части окна мастера будет показан исходный вариант загружаемых данных.

Табличная часть окна мастера предназначена для настройки параметров импорта для каждого поля набора данных.

  • Кол-во строк для анализа — задает количество строк данных, которые будут представлены в таблице для анализа (от 1 до 200);
  • Обновить все Обновить все — перечитывает указанное количество строк в таблицу и производит автоматическое формирование результирующего набора данных;
  • Обновить данные Обновить данные — только перечитывает указанное количество строк в таблицу.

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

  • Имя — задается уникальное имя поля.
  • Метка — задает пользовательское описание поля.
  • Тип данных — тип данных , в который будет преобразовано текстовое значение поля.
  • Вид данных — вид данных, задается списком значений:
    • Неопределенный.
    • Непрерывный.
    • Дискретный.
  • Использовать — флаг включения поля в результирующий набор данных.

Особенности множественного импорта

На первой странице мастера настроек пользователь может выбрать несколько файлов для импорта, но в табличной части на первом шаге всегда будет отображаться только первый найденный файл. Такое ограничение введено из-за особенностей импорта данных из Excel. Если в файле есть именованные диапазоны, а также возможность самостоятельно указать читаемую область, то нельзя будет добавить данные из нескольких файлов.

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

Чтение имени файла выполняется либо до разделителя, либо до конца строки. Из этого следует, что если в конце строки Имя файла/URL оставить разделитель, то программа выполнит пустое чтение в конце обработки строки. В связи с этим пустое чтение не воспринимается как ошибка. Таким образом, ситуация имя1||имя2 и имя3| не считается ошибочной.

При множественном импорте на второй странице мастера настройки отображаются строки из нескольких файлов пока их общий диапазон строк не превысит указанный лимит (по умолчанию для импорта из Excel файла это 200 строк).

При определении типов столбцов в учёт берутся строки из нескольких файлов.

Статьи в разделе: