xlsx-cn

Обработка Excel-таблиц | Excel Spreadsheet Processing. Создание, чтение и редактирование файлов Excel. Поддержка формул, графиков и анализа данных. Ключевые триггеры: Excel, таблицы, xlsx.

Требования к результатам

Все Excel-файлы

Профессиональный шрифт

• Используйте единый профессиональный шрифт (например, Arial или Times New Roman), если пользователь не указал иное

Отсутствие ошибок в формулах

• Каждая Excel-модель должна быть без ошибок формул (#REF!, #DIV/0!, #VALUE!, #N/A, #NAME?)

Сохранение существующих шаблонов

• Точно соблюдайте формат, стиль и соглашения существующего файла
• Не навязывайте стандартизированное оформление при наличии устоявшегося шаблона
• Правила текущего шаблона всегда имеют приоритет

Финансовые модели

Цветовое кодирование

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

• Синий (RGB: 0,0,255) — вводимые значения
• Чёрный (RGB: 0,0,0) — формулы и расчёты
• Зелёный (RGB: 0,128,0) — ссылки на другие листы
• Красный (RGB: 255,0,0) — внешние ссылки
• Жёлтый фон (RGB: 255,255,0) — ключевые допущения

Форматирование чисел

• Годы — как текст (например, «2024»)
• Валюта — формат $#,##0 с указанием единиц
• Нули — отображать как «-«
• Проценты — формат 0.0%
• Мультипликаторы — формат 0.0x
• Отрицательные значения — в скобках (123)

Правила построения формул

Размещение допущений

• Все допущения размещайте в отдельных ячейках
• Используйте ссылки на ячейки вместо захардкоженных значений
• Пример: =B5*(1+$B$6) вместо =B5*1.05

Предотвращение ошибок

• Проверяйте корректность ссылок
• Избегайте ошибок диапазонов
• Соблюдайте единообразие формул
• Тестируйте крайние значения
• Исключайте циклические ссылки

Документирование данных

• Добавляйте источник данных рядом с ячейками
• Формат: Источник, дата, ссылка

Создание, редактирование и анализ XLSX

Обзор

Пользователь может попросить создать, изменить или проанализировать Excel-файл. Для этого доступны разные инструменты и сценарии.

Ключевые требования

Использование формул обязательно. Нельзя подставлять рассчитанные значения вручную — таблица должна оставаться динамической.

Неправильно

sheet['B10'] = 5000
sheet['C5'] = 0.15

Правильно

sheet['B10'] = '=SUM(B2:B9)'
sheet['C5'] = '=(C4-C2)/C2'

Это правило применяется ко всем вычислениям: суммам, процентам, коэффициентам и другим показателям.

Типовой рабочий процесс

• Выбор инструмента: pandas или openpyxl
• Создание или загрузка файла
• Редактирование данных и формул
• Сохранение файла
• Пересчёт формул (обязательно)
• Проверка и исправление ошибок

python scripts/recalc.py output.xlsx

Работа с Excel

Создание файла

from openpyxl import Workbook
wb = Workbook()
sheet = wb.active
sheet['B2'] = '=SUM(A1:A10)'
wb.save('output.xlsx')

Редактирование файла

from openpyxl import load_workbook
wb = load_workbook('file.xlsx')
sheet = wb.active
sheet['A1'] = 'New Value'
wb.save('modified.xlsx')

Пересчёт формул

Формулы сохраняются как строки и требуют пересчёта через LibreOffice:

python scripts/recalc.py file.xlsx

Скрипт проверяет ошибки (#REF!, #DIV/0! и др.) и возвращает отчёт в формате JSON.

Проверка формул

• Проверяйте корректность ссылок
• Учитывайте индексацию строк
• Обрабатывайте пустые значения
• Тестируйте крайние случаи

Лучшие практики

Выбор библиотеки

• pandas — для анализа данных
• openpyxl — для форматирования и формул

Работа с openpyxl

• Индексация начинается с 1
• Формулы не вычисляются автоматически
• Используйте recalc для обновления значений

Работа с pandas

• Указывайте типы данных
• Читайте только нужные столбцы
• Корректно обрабатывайте даты

Стиль кода

• Пишите краткий и чистый код
• Избегайте лишних комментариев
• Документируйте ключевые расчёты в Excel

---