Описание
Получает значение диапазона из файла Excel.
Studio Pro поддерживает работу с форматами документов Microsoft Excel .xls и .xlsx.
Начиная с обновления 8.3, Studio Pro поддерживает два способа работы с MS Excel — Microsoft Native и Generic.
Чтобы выбрать способ работы, перейдите в меню «Settings» → «Microsoft activities».
Microsoft Native использует для работы с MS Excel стандартные методы Microsoft. При этом необходимо, чтобы Excel был установлен на машине. Этот способ обеспечивает большую эффективность и стабильность работы с разными типами файлов.
Generic не требует утсановленного Excel, однако, он может быть менее эффективен и стабилен.
Параметры
-
Задать значение: позволяет в явном виде задать путь к файлу, в котором необходимо считать диапазон значений. При нажатии на кнопку "Выбрать" можно указать путь вручную.
-
Сохранить результат предыдущего шага: в качестве пути берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания пути.
Позволяет указать стартовую строку считываемого диапазона.
-
Задать значение: позволяет в явном виде задать номер начальной строки.
-
Сохранить результат предыдущего шага: в качестве номера начальной строки берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания номера начальной строки.
Позволяет указать конечную строку считываемого диапазона.
-
Задать значение: позволяет в явном виде задать номер конечной строки.
-
Сохранить результат предыдущего шага: в качестве номера конечной строки берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания номера конечной строки.
Позволяет указать начальный столбец считываемого диапазона.
-
Задать значение: позволяет в явном виде задать индекс начального столбца.
-
Сохранить результат предыдущего шага: в качестве индекса начального столбца берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания индекса начального столбца.
Позволяет указать конечный столбец считываемого диапазона.
-
Задать значение: позволяет в явном виде задать индекс конечного столбца.
-
Сохранить результат предыдущего шага: в качестве индекса конечного столбца берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания индекса конечного столбца.
По умолчанию используется первый лист в Excel файле.
-
Задать значение: позволяет в явном виде задать имя листа, в котором необходимо считать диапазон значений, например,
Сотрудники
. -
Сохранить результат предыдущего шага: в качестве имени листа берет результат действия из предыдущего шага workflow.
-
Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания имени листа.
По умолчанию используется способ "Из заголовков таблиц".
-
Из заголовков таблиц: выберите эту опцию, если заголовками таблицы являются пользовательские слова.
-
Из букв колонок: выберите эту опцию, если заголовками таблицы являются стандартные наименования колонок в "Excel": "A", "B", "C" и т.д.
Позволяет добавить поясняющий текст к блоку. Текст будет отображаться внутри блока сверху от названия действия.
Результат
По умолчанию считанные данные хранятся в переменной excel_range_content
. Данная переменная представляет из себя массив объектов "ключ-значение". Каждый объект из массива представляет собой одну строку таблицы.
Например, если считать диапазон между первыми тремя строками (1-3) и столбцами (A-C) мы можем получить такую запись:
[
{
"Колонка 1": "Значение (1,1)",
"Колонка 2": "Значение (1,2)",
"Колонка 3": "Значение (1,3)"
},
{
"Колонка 1": "Значение (2,1)",
"Колонка 2": "Значение (2,2)",
"Колонка 3": "Значение (2,3)"
}
]
Эта запись представляет собой следующую таблицу:
Колонка 1 |
Колонка 2 |
Колонка 3 |
Значение (1,1) |
Значение (1,2) |
Значение (1,3) |
Значение (2,1) |
Значение (2,2) |
Значение (2,3) |