Функция № 587

Универсальный парсер Excel файлов (.xls/.xlsx) для извлечения структурированных данных. Поддерживает извлечение статических данных из конкретных ячеек и табличных данных по колонкам.

Доступно на тарифе:

Бизнес 2025
Профи 2025

Научитесь правильно использовать функцию:

Описание

Универсальный парсер Excel файлов (.xls/.xlsx) для извлечения структурированных данных. Поддерживает извлечение статических данных из конкретных ячеек и табличных данных по колонкам.

Параметры функции

Параметры, которые можно передать в функцию xls_data_extractor:
xls_file_url – URL файла Excel (http:// или https://) для загрузки и парсинга. Указывает прямую ссылку на Excel файл.
params – параметры парсинга Excel файла:
- sheet_name – имя листа или его индекс в виде строки ('0' = первый лист, '1' = второй лист). По умолчанию '0'
- data_start_row – номер строки с которой начинаются табличные данные (нумерация с 1). По умолчанию 1
- static_cells – статические данные из конкретных ячеек. Формат: {'название_поля': 'адрес_ячейки'}. Пример: {'lzk_number': 'J1', 'card_number': 'G3'}
- columns_map – ОБЯЗАТЕЛЬНЫЙ параметр. Колонки для извлечения табличных данных. Формат: {'название_поля': 'буква_колонки'}. Пример: {'material': 'C', 'quantity': 'E', 'date': 'P'}
- id_column – колонка-индикатор наличия строки. Чтение останавливается при пустой ячейке в этой колонке. По умолчанию 'A'
- skip_values – массив значений для пропуска строк. Поиск без учета регистра. Пример: ['по мере необх', 'итого', 'всего']
- output_format – формат выходных данных. 'json' - массив объектов, 'delimited' - массив строк с разделителем. По умолчанию 'json'
- delimiter – разделитель для формата 'delimited'. Для Google Sheets используйте ';;'. По умолчанию ';;'

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

Примеры использования:
"Извлеки данные из Excel файла по ссылке [URL] с листа 'Отчет', начиная с 3 строки, колонки: товар - 'B', количество - 'D', цена - 'F'."
"Парси файл Excel [URL], извлеки статические данные: номер документа из ячейки 'A1', дата из 'B1', и табличные данные: наименование - 'C', единица измерения - 'E'."
"Обработай Excel файл [URL], пропуская строки со значениями ['итого', 'всего'], формат вывода - разделенный текст."

Кейсы