Настройка автоматической генерации отчетов 1С-Битрикс

Настройка автоматической генерации отчётов 1С-Битрикс

Ручная выгрузка отчётов — потеря времени и источник ошибок. Автоматическая генерация решает это через агенты Битрикс и отправку по расписанию. Задача — настроить цикл: данные → файл → доставка получателю.

Агенты Битрикс как основа автоматизации

Агент (b_agent) — функция PHP, которую Битрикс вызывает по расписанию через механизм CAgent. Запуск происходит при HTTP-запросах к сайту (по умолчанию) или через cron (/bitrix/modules/main/include/cron_events.php).

Настройка cron вместо HTTP-триггера — обязательно для production:

# /etc/cron.d/bitrix
*/5 * * * * www-data /usr/bin/php /var/www/site/bitrix/modules/main/include/cron_events.php > /dev/null 2>&1

Создание агента программно:

\CAgent::AddAgent(
    'GenerateDailyReports();',  // Имя функции
    'local',                     // Модуль
    'N',                         // Переодический
    86400,                       // Интервал в секундах (раз в сутки)
    '',                          // Дата первого запуска (пусто = сразу)
    'Y',                         // Активен
    date('d.m.Y H:i:s', mktime(8, 0, 0)), // Время следующего запуска (8:00)
    30                           // Сортировка
);

Шаблон агента генерации отчётов

function GenerateDailyReports(): string
{
    $reports = [
        [
            'type'      => 'orders',
            'filename'  => 'orders_' . date('Y-m-d') . '.xlsx',
            'params'    => ['date_from' => date('Y-m-d', strtotime('-1 day')), 'status' => null],
            'recipient' => '[email protected]',
        ],
        [
            'type'      => 'low_stock',
            'filename'  => 'stock_' . date('Y-m-d') . '.xlsx',
            'params'    => ['threshold' => 5],
            'recipient' => '[email protected]',
        ],
    ];

    foreach ($reports as $reportConfig) {
        try {
            $generator = ReportGeneratorFactory::create($reportConfig['type']);
            $filePath  = $generator->generate($reportConfig['params']);

            $savedName = '/upload/reports/' . $reportConfig['filename'];
            rename($filePath, $_SERVER['DOCUMENT_ROOT'] . $savedName);

            sendReportEmail($reportConfig['recipient'], $savedName, $reportConfig['filename']);

            \Bitrix\Main\Diag\Debug::writeToFile(
                date('Y-m-d H:i:s') . ' Report generated: ' . $reportConfig['filename'],
                '',
                '/local/logs/reports.log'
            );
        } catch (\Throwable $e) {
            \Bitrix\Main\Diag\Debug::writeToFile(
                date('Y-m-d H:i:s') . ' ERROR: ' . $e->getMessage(),
                '',
                '/local/logs/reports_errors.log'
            );
        }
    }

    return 'GenerateDailyReports();';
}

Отправка отчётов по email

Отчёт отправляется через почтовое событие Битрикс с вложением:

function sendReportEmail(string $to, string $filePath, string $fileName): void
{
    $absolutePath = $_SERVER['DOCUMENT_ROOT'] . $filePath;

    // Прикрепляем файл через CFile и почтовое событие
    $event = new \Bitrix\Main\Mail\Event();
    $fields = [
        'TO'      => $to,
        'SUBJECT' => 'Автоотчёт: ' . $fileName . ' от ' . date('d.m.Y'),
        'BODY'    => 'Отчёт сформирован автоматически. Файл во вложении.',
    ];

    // Альтернатива — отправка через PHPMailer напрямую с вложением
    $mail = new \PHPMailer\PHPMailer\PHPMailer(true);
    $mail->CharSet = 'UTF-8';
    $mail->setFrom('[email protected]', 'Система отчётов');
    $mail->addAddress($to);
    $mail->Subject = $fields['SUBJECT'];
    $mail->Body    = $fields['BODY'];
    $mail->addAttachment($absolutePath, $fileName);
    $mail->send();
}

Хранение и доступ к архиву отчётов

Сгенерированные файлы сохраняются в /upload/reports/ с сохранением истории за 30 дней. Очистка старых файлов — отдельный агент:

function CleanOldReports(): string
{
    $dir = $_SERVER['DOCUMENT_ROOT'] . '/upload/reports/';
    foreach (glob($dir . '*.xlsx') as $file) {
        if (filemtime($file) < time() - 30 * 86400) {
            unlink($file);
        }
    }
    return 'CleanOldReports();';
}

Страница архива в ЛК менеджера — список файлов с датой и ссылкой на скачивание, с проверкой прав доступа.

Сроки