Отчёты и обработки в конфигураторе 1С 8.3: подключение и создание

Программист прислал файл .epf или .erf, а он не открывается. Или наоборот — нужно самому в конфигураторе 1С настроить отчёты и обработки: подключить внешний файл, встроить его в дерево метаданных или собрать отчёт с нуля на СКД.

Разберём оба сценария по шагам: как в 1С подключить готовую внешнюю обработку через конфигуратор и через штатный механизм, как раздать права на открытие внешних файлов и как создать собственный отчёт в конфигураторе. Примеры — на платформе 8.3, но логика та же и для более ранних релизов.

Что такое отчёты и обработки в 1С

Это два разных объекта конфигурации, хоть их и ставят в один ряд.

• 📊 Отчёт — читает данные и показывает их в удобном виде: таблица, диаграмма, сводка. Ничего не меняет в базе.
• ⚙️ Обработка — выполняет действие: массово меняет документы, загружает данные из файла, перепроводит, чистит регистры.

По способу подключения к базе они бывают:

.epf — расширение файла внешней обработки, .erf — внешнего отчёта.

Какой способ подключения выбрать

Прежде чем лезть в конфигуратор, определитесь со способом. От этого зависит половина работы.

Коротко о выборе:

• Нужно быстро и без прав разработчика — механизм дополнительных обработок.
• Нужно навсегда и с полным контролем — дерево метаданных в конфигураторе.
• Нужно изменить типовую аккуратно — расширение.

Подготовка внешней обработки к подключению

Перед тем как подключать файл, проверьте три вещи.

1. Совместимость версии платформы. Обработка, собранная под 8.3.20, обычно откроется и в более новом релизе, а вот наоборот — не всегда.
2. Режим совместимости конфигурации не должен быть выше, чем у файла.
3. Для механизма дополнительных обработок у файла должен быть заполнен модуль СведенияОВнешнейОбработке() — без него база не примет файл.

Как добавить внешнюю обработку в конфигураторе

Классический способ — встроить объект прямо в дерево метаданных. Так делают, когда функциональность нужна навсегда и во всех сеансах.

После обновления обработка появится в интерфейсе «Предприятия» — в той подсистеме, к которой вы её привязали.

Настройка свойств и команд

Чтобы объект был виден и удобен, задайте:

• Подсистемы — в каких разделах интерфейса показывать команду.
• Права ролей — иначе пользователь без нужной роли команду не увидит.
• Картинку команды — необязательно, но помогает не потерять кнопку.

Подключение через «Дополнительные отчёты и обработки»

Способ без конфигуратора. База остаётся на поддержке, подключение делает администратор в режиме «Предприятие».

1. Включите механизм: «Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки» (галочка).
2. Откройте одноимённый список и нажмите «Создать».
3. Загрузите файл .epf или .erf из папки.
4. Укажите размещение — разделы, где команда будет доступна.
5. Настройте права: кому из пользователей видна обработка.

Права на интерактивное открытие внешних файлов

Частая причина «файл не открывается» — не сама обработка, а профиль безопасности и права.

• В файловой базе за это отвечает роль пользователя: право «Интерактивное открытие внешних отчётов» и «Интерактивное открытие внешних обработок».
• В клиент-серверной базе дополнительно работают профили безопасности на уровне кластера — они могут блокировать запуск внешнего кода полностью.

Если у пользователя нет права — пункт «Файл → Открыть» для .epf/.erf будет недоступен или выдаст отказ. Права правятся в конфигураторе в ролях либо через настройки профилей пользователей.

Как сделать отчёт в конфигураторе через СКД

Теперь вторая половина темы — создать отчёт с нуля. Основной инструмент — система компоновки данных (СКД). Писать код формирования вручную почти никогда не нужно.

Создание объекта и схемы

1. В дереве (или в новом внешнем отчёте) добавьте отчёт, задайте имя.
2. Откройте «Основную схему компоновки данных» — создастся макет со схемой.
3. В схеме нажмите «Добавить набор данных → Запрос».

Написание запроса для СКД

Внутри набора данных откройте конструктор запроса и соберите выборку: таблицы, поля, связи, условия. Пример скелета запроса:

ВЫБРАТЬ
    Продажи.Номенклатура КАК Номенклатура,
    Продажи.Количество КАК Количество,
    Продажи.Сумма КАК Сумма
ИЗ
    РегистрНакопления.Продажи.Обороты КАК Продажи

Настройка полей, ресурсов и параметров

• Поля набора — проверьте заголовки, они уйдут в шапку отчёта.
• Ресурсы — числовые поля, которые надо суммировать (Количество, Сумма). Без ресурсов не будет итогов.
• Параметры — период, организация. Через них пользователь фильтрует данные.

Структура и настройки вывода

На вкладке «Настройки» соберите структуру отчёта:

• 📋 Группировка — по какому полю строить строки (по номенклатуре, по контрагенту).
• 📊 Таблица — строки и колонки одновременно (кросс-таблица).
• 📈 Диаграмма — если нужна графика.

Перетащите поля в выбранные, добавьте отборы и условное оформление. СКД сам сформирует итоговую таблицу — процесс формирования отчёта в 1С полностью на движке компоновки.

Макет вместо СКД

Иногда нужен жёсткий печатный бланк — тогда вместо СКД делают отчёт на макете: рисуют табличный документ с именованными областями и заполняют их кодом в модуле объекта. Способ трудоёмкий, оправдан для строгих форм документов, где СКД неудобна.

Тестирование и отладка

Перед раздачей пользователям обработку и отчёт нужно прогнать.

• Запустите в режиме «Предприятие» из конфигуратора через отладку (F5).
• Поставьте точку останова в модуле, проверьте значения переменных в «Табло».
• Для отчёта проверьте итоги: суммы ресурсов должны сходиться с оборотами регистра.
• Прогоните на копии рабочей базы, а не на боевой.

Расширения конфигурации как альтернатива

Если нужно доработать типовую конфигурацию, но не ломать поддержку — используйте расширение (.cfe). Оно живёт поверх основной конфигурации: добавляет свои объекты и меняет существующие, а типовая при этом штатно обновляется.

Расширение подключают в «Предприятии» через «Администрирование → Печатные формы, отчёты и обработки → Расширения» либо в конфигураторе. Для добавления пары отчётов это часто аккуратнее, чем снимать конфигурацию с поддержки.

Запуск обработок по расписанию

Обработку можно запускать не руками, а автоматически — через регламентное задание.

1. В конфигураторе создайте регламентное задание и укажите метод-обработчик.
2. В обработчике вызовите нужный код обработки.
3. В «Предприятии» задайте расписание: интервал, время, дни.

Для дополнительных обработок есть готовый вид «Создание связанных объектов» и запуск по расписанию прямо из карточки — без конфигуратора.

Типичные ошибки при подключении

Частые вопросы