Описание
Это действие позволяет прочитать содержимое таблицы Excel. При добавлении этого действия в workflow также автоматически появляется соединенный с ним блок действия "Задать значение переменной", в который сохраняется результат операции чтения.
При этом использование действия "Задать значение переменной" в данном случае не является обязательным. Этот блок можно удалить, если требуется обработать результат каким-либо другим способом. Например, можно соединить действие "Прочитать из Excel" с действием "Сохранить таблицу" и в последнем выбрать опцию Сохранить результат предыдущего шага, чтобы сохранить таблицу в файл напрямую.
Также важно помнить, что если таблица, которую необходимо прочитать, открыта в приложении Excel, то Excel необходимо закрыть перед запуском бота, иначе Studio не сможет получить доступ к файлу, и workflow не запустится.
Studio Pro поддерживает работу с форматами документов Microsoft Excel .xls и .xlsx.
Параметры
Основной параметр - Путь к файлу. Он задает расположение файла Excel, который нужно прочитать. Является обязательным.
Параметр Путь к файлу
Следующий параметр - Имя листа в Excel. Здесь можно выбрать для прочтения определенные листы в таблице. Если требуется прочитать весь файл, то оставьте этот параметр пустым.
Параметр Имя листа в Excel
Последний параметр - Получить ключ словаря. Он определяет, как будут представлены заголовки таблицы.
При выбранной опции Из заголовков таблиц в качестве заголовков будут выбраны значения в первой строке таблицы.
При выбранной опции Из букв колонок будут использованы стандартные заголовки Excel (например, A, B, C и т.д.).
Параметр Получить ключ словаря
Результаты
Теперь рассмотрим, как представляются результаты работы этого действия. Для примера используем таблицу с двумя листами.
Исходная таблица с двумя листами
Вот как выглядят результаты, записанные в переменную в блоке "Задать значение переменной".
Переменная, содержащая данные прочитанной таблицы
Нажмите на кнопку "Открыть", чтобы увидеть подробности. Здесь показаны данные из прочитанной таблицы и две вкладки, соответствующие листам в таблице. В данном случае мы использовали опцию Из заголовков таблиц. Заголовки были скопированы из первой строки таблицы.
Сохраненные данные таблицы с опцией Из заголовков таблиц
Теперь рассмотрим другой вариант. Здесь была выбрана опция Из букв колонок. Здесь заголовки, которые были созданы в самой таблице, не учитываются, и вместо них подставлены буквы.
Сохраненные данные таблицы с опцией Из букв колонок