Прочитать из Excel

Описание

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

Параметры

Путь к файлу

  1. Задать значение: позволяет в явном виде задать путь к файлу, который нужно считать. При нажатии на кнопку "Выбрать" можно указать путь вручную.

  2. Сохранить результат предыдущего шага: в качестве пути берет результат функции из предыдущего шага алгоритма.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания пути.

Поддерживаемые форматы файлов:

  • xls

  • xlsx

  • csv

Имя листа в Excel

  1. Задать значение: позволяет в явном виде задать имя листа для считывания таблицы, например, Сотрудники.

  2. Сохранить результат предыдущего шага: в качестве имени листа берет результат функции из предыдущего шага алгоритма.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания имени листа.

Получить ключ словаря

  1. Из заголовков таблиц: заголовком считается колонки первой строки таблицы.

  2. Из букв колонок: заголовком таблицы считаются стандартные наименования колонок в "Excel": "A", "B", "C" и т.д.

Комментарий

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

Результат

По умолчанию считанные данные хранятся в переменной excel_content. Данная переменная представляет из себя объект "ключ-значение", где значениями являются массивы объектов "ключ-значение". Каждый объект из массива представляет собой одну строку таблицы. Например, запись

Формат переменной с данными Excel-таблицы (со включенной опцией "Из заголовков таблиц")
{
"Лист1": [
{
"Колонка 1": "Значение (1,1)",
"Колонка 2": "Значение (1,2)",
"Колонка 3": "Значение (1,3)"
},
{
"Колонка 1": "Значение (2,1)",
"Колонка 2": "Значение (2,2)",
"Колонка 3": "Значение (2,3)"
}
],
"Лист2": [
{
"Колонка 1": "Значение (1,1)",
"Колонка 2": "Значение (1,2)",
"Колонка 3": "Значение (1,3)"
},
{
"Колонка 1": "Значение (2,1)",
"Колонка 2": "Значение (2,2)",
"Колонка 3": "Значение (2,3)"
}
]
}

отображает следующую книгу "Excel":

Лист1
Лист2
Лист1

Колонка 1

Колонка 2

Колонка 3

Значение (1,1)

Значение (1,2)

Значение (1,3)

Значение (2,1)

Значение (2,2)

Значение (2,3)

Лист2

Колонка 1

Колонка 2

Колонка 3

Значение (1,1)

Значение (1,2)

Значение (1,3)

Значение (2,1)

Значение (2,2)

Значение (2,3)

Рекомендации к использованию

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