09. Виджеты и диаграммы

Виджеты и диаграммы используются для визуализации данных в отчётах и на дашбордах.

9.1. Диаграммы в отчётах

ОТЧЁТ ПродажиПоМесяцам
    ПАРАМЕТР Год ЧИСЛО ОБЯЗАТЕЛЬНЫЙ
    
    ЗАПРОС "
        SELECT 
            strftime('%m', Дата) as Месяц,
            SUM(ИтогоСумма) as СуммаПродаж
        FROM ЗаказНаряд
        WHERE strftime('%Y', Дата) = '{{Год}}'
        GROUP BY Месяц
        ORDER BY Месяц
    "
    
    КОЛОНКА Месяц СТРОКА
    КОЛОНКА СуммаПродаж ЧИСЛО
    
    ВЫВОД_ДИАГРАММА ТИП "столбчатая" ПОЛЯ Месяц, СуммаПродаж
КОНЕЦ

9.2. Типы диаграмм

9.3. Пример круговой диаграммы

ОТЧЁТ СтруктураПродаж
    ПАРАМЕТР ДатаС ДАТА
    ПАРАМЕТР ДатаПо ДАТА
    
    ЗАПРОС "
        SELECT 
            К.Наименование as Клиент,
            SUM(З.ИтогоСумма) as Сумма
        FROM ЗаказНаряд З
        JOIN Клиенты К ON З.Клиент = К.id
        WHERE З.Дата BETWEEN '{{ДатаС}}' AND '{{ДатаПо}}'
        GROUP BY К.id
    "
    
    КОЛОНКА Клиент СТРОКА
    КОЛОНКА Сумма ЧИСЛО
    
    ВЫВОД_ДИАГРАММА ТИП "круговая" ПОЛЯ Клиент, Сумма
КОНЕЦ

9.4. Виджеты на дашборде

Виджеты настраиваются через интерфейс администратора. Доступные типы виджетов:

• Числовой показатель — отображение одного числа (например, сумма продаж за сегодня)
• Список — последние документы или задачи
• График — диаграмма на основе отчёта
• Текст — произвольный HTML/текст

9.5. Пример SQL для виджета-показателя

-- Виджет "Продажи сегодня"
SELECT SUM(ИтогоСумма) as Значение 
FROM ЗаказНаряд 
WHERE Дата >= date('now', 'start of day')

9.6. Пример SQL для виджета-списка

-- Виджет "Последние заказы"
SELECT 
    Номер as Заголовок,
    Клиент as Описание,
    ИтогоСумма as Сумма
FROM ЗаказНаряд 
ORDER BY Дата DESC 
LIMIT 10

9.7. Настройка виджетов через UI

В интерфейсе администратора доступны следующие настройки виджета:

• Название виджета
• Тип (показатель, список, график, текст)
• SQL-запрос для получения данных
• Интервал обновления (в секундах)
• Размер и расположение на дашборде