Использование плейсхолдера [month] для месячных отчётов

> Медиадисплей > Интеграции > Интеграция с Google
Дата обновления: 12 июня 2026 г. Дата публикации: 11 июня 2026 г. Автор: Жапов Ананда

Задача

Автоматически подставлять номер или название текущего месяца в ListRange (диапазон таблицы) и source (адрес ячейки). Это позволяет иметь в Google Таблице отдельные листы для каждого месяца (например, 1, 2, …, 12 или Январь, Февраль, …) и переключаться на актуальный лист без правки конфигурации каждый месяц.

Доступные плейсхолдеры

Плейсхолдер	Подставляемое значение	Пример (в июне)
[month]	Номер месяца (1–12)	[month]!A2:C10 → 6!A2:C10
[monthName]	Название месяца на русском	[monthName]!A1 → Июнь!A1
[monthEN]	Название месяца на английском	[monthEN]!A1 → June!A1

Как подготовить Google Таблицу

1. Создайте в таблице отдельные листы для каждого месяца, которые планируете использовать.
2. Для [month] – назовите листы числами: 1, 2, 3, …, 12.
3. Для [monthName] – назовите листы на русском: Январь, Февраль, …, Декабрь.

4. Для [monthEN] – назовите листы на английском: January, February, …, December.

5. Заполните листы одинаковой структурой (одинаковые колонки и диапазоны), но разными данными.

Примеры использования в конфигурации

Пример 1: таблица с месячными продажами

[TableSales]
enable=1
type=table
name=Продажи
ListRange=[month]!A2:D10
columns=Товар,Количество,Цена,Сумма

В июне утилита автоматически будет читать данные из листа 6!A2:D10. В июле – из 7!A2:D10.

Пример 2: текстовая ячейка с заголовком месяца

[MonthTitle]
enable=1
type=text
name=ЗаголовокМесяца
source=[monthName]!A1

В июне утилита возьмёт значение из ячейки A1 листа Июнь.

Пример 3: диаграмма помесячной динамики

[ChartMonthly]
enable=1
type=chart
charttype=line
name=ДинамикаПродаж
ListRange=[month]!B2:E13   ; строки 2-13, колонки B,C,D,E

Что произойдёт, если лист с текущим месяцем отсутствует?

Утилита вызовет ошибку 3 – GoogleApiError и запишет в лог, что диапазон не найден. Рекомендуется заранее создать листы для всех месяцев, которые могут понадобиться.

Как отладить подстановку?

1. Временно добавьте OutputFileName=debug.json в секцию [Default].
2. Запустите утилиту с вашим конфигом.
3. Откройте debug.json – в нём будут уже подставленные фактические диапазоны (например, 6!A2:D10).
4. Убедитесь, что такие листы существуют в таблице.

Примечание для службы

Если вы используете Windows-службу, плейсхолдеры работают так же. При смене месяца служба автоматически начнёт использовать новый лист (после перезапуска или по таймеру). Никаких дополнительных действий не требуется.

Вывод

Плейсхолдеры [month], [monthName], [monthEN] позволяют создавать одну конфигурацию на весь год, без необходимости править INI-файл каждый месяц. Достаточно один раз подготовить листы в Google Таблице и использовать динамические диапазоны.