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

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

image_1

Описание

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

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

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

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

    Тип данных: строка

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

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

    Тип данных: строка | число

    Пример: 3

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

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

    Тип данных: строка

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

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

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

    Тип данных: число | список чисел

    Пример: 3

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

    image_2

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

    image_3

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

    Тип данных: число

    Пример: 10

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

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

  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