Перейти к содержимому
Puzzle RPA

Прочитать диапазон из Excel

image_1

Описание

Блок позволяет прочитать содержимое диапазона таблицы Excel.

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

Блок имеет несколько основных параметров:

  1. Путь к файлу - путь к Excel-файлу (доступные форматы: .xls, .xlsx, .xlsm, .xlsb);

    Тип данных: str (Строка)

    Пример: /home/Книга.xlsx

  2. Имя/номер листа в Excel (необязательный параметр) - имя или номер листа в Excel-файле;

    Тип данных: str (Строка) | int (Число)

    Пример: 3

    Комментарий: Если имя листа не указанно, то будет прочитана вся книга Excel.

  3. Прочитать столбцы - список столбцов для считывания;

    Тип данных: str (Строка)

    Пример: A,C,E:X

    Комментарий: Столбцы требуется указывать через запятую, либо указать диапазон (пример: E:X)

  4. Пропустить строки - строки, которые необходимо пропустить при считывании;

    Тип данных: int (Число) | list (Список)

    Пример: 3

    Если при чтении диапазона необходимо пропустить одну строку, ее номер указывается с помощью блока Число.

    image_2

    Если при чтении диапазона необходимо пропустить несколько строк, их индексы указываются в виде списка чисел.

    image_3

  5. Прочитать строк - количество прочитанных строк;

    Тип данных: int (Число)

    Пример: 10

  6. Заголовки таблиц - при выборе функции Заголовки таблиц = названиям колонок в качестве заголовков будут выбраны значения в первой строке таблицы.

  1. Типы данных колонок (необязательный параметр) - это параметр, который задаёт типы данных для столбцов при чтении Excel;

    Тип данных: dict (Словарь) | str (Строка) | None (Ничто)

    Пример: {'A': 'str', 'B': 'int', 'C': 'float'}

    Комментарий: Если типы данных не указаны, то будут использованы типы данных по умолчанию.

Самые популярные типы данных:

  • str — читать как строку (часто для артикулов/ID/телефонов, чтобы не терялись ведущие нули).
  • int — целые числа (если нет пропусков; при NaN лучше использовать pandas-тип Int64).
  • float/Float64 — числа с дробной частью (и вообще “числа с возможными NaN” по умолчанию).
  • bool — логический тип (True/False).

Возвращаемое значение

  1. Если указан лист, результат будет представлен в виде таблицы: 
        A      B
    0  улица      Мира
    1   село  Борковка
    2  город    Москва
    

    [3 rows x 2 columns]
  2. Если имя листа не указанно, результат будет представлен в виде словаря: 
    {'Лист1':   A      B
            0  улица      Мира
            1   село  Борковка
            2  город    Москва
    

            [3 rows x 2 columns],
    'Лист2':   A      B
            0  улица      Мира
            1   село  Борковка
            2  город    Москва
    

            [3 rows x 2 columns]}

Пример использования

В данном примере считывается диапазон таблицы Excel.

image_6
  • В первом случае считывается весь доступный диапазон;
  • Во втором блоке считываются столбцы “С,E” и пропускаются строки 1 и 3. Количество строк для считывания не ограничивается;
  • В третьем случае считываются столбцы “A,B,С,D”, пропускается строка номер 2, общее количество строк для считывания равно 4.
image_4

Результат

Вывод на экран строки:

image_5