Разработка внешних отчетов в конфигурациях 1С:Предприятие — это мощный инструмент, позволяющий расширить функционал системы без изменения основной структуры базы данных. Внешний отчет представляет собой файл с расширением .erf (для отчетов) или .epf (для обработок), который выполняется в контексте информационной базы. Часто такие отчеты создаются для выгрузки специфических данных в Excel, формирования уникальных печатных форм или проведения сложных расчетов, которые не предусмотрены в стандартной конфигурации.
Для начала работы вам потребуется режим конфигуратора или возможность запуска внешней обработки в режиме предприятия. Важно понимать, что создание внешнего отчета требует базовых знаний встроенного языка 1С и понимания объектной модели метаданных. В этой статье мы подробно разберем процесс от создания пустого модуля до сохранения готового файла, который можно будет передать любому пользователю системы.
Подготовка окружения и выбор типа объекта
Первым шагом является запуск платформы 1С:Предприятие в режиме конфигуратора. Вам необходимо открыть базу данных, в которой планируется тестирование отчета, или любую тестовую базу с аналогичной конфигурацией. Внешние отчеты создаются независимо от конфигурации, но для корректной работы им часто нужны ссылки на объекты метаданных (справочники, документы), поэтому наличие подключенной базы обязательно.
В меню конфигуратора следует выбрать пункт Файл → Новый. Откроется окно создания нового объекта внешней обработки. Здесь критически важно правильно выбрать тип объекта. Для формирования табличных данных и графиков выбирается тип «Внешний отчет». Если же ваша задача — выполнить действие (например, провести группу документов), то выбирается «Внешняя обработка». В нашем случае мы фокусируемся именно на внешнем отчете.
После выбора типа открывается конструктор или пустое окно объекта. На этом этапе вы определяете основные свойства будущего файла. Особое внимание уделите свойству «Вид отчета», так как оно определяет, как система будет интерпретировать полученный результат. Также здесь задается имя объекта в коде, которое будет использоваться при программном вызове.
⚠️ Внимание: Если вы создаете отчет для передачи заказчику, убедитесь, что версия платформы, на которой он разрабатывается, не значительно новее версии платформы у пользователя. Обратная совместимость обычно работает, но использование новейших функций языка может вызвать ошибку «Модуль не может быть выполнен» на старых релизах.
Сохраняйте исходный код внешнего отчета в отдельном файле или системе контроля версий (Git), даже если сам отчет выгружается в .erf. Это позволит легко восстанавливать логику при потере файла обработки.
Настройка макетов и формы отчета
Интерфейс внешнего отчета формируется через вкладку «Макеты». Именно здесь создается визуальная часть, с которой будет взаимодействовать пользователь. Существует два основных типа макетов: макет формы (для ввода параметров) и макет результата (табличный документ). Для стандартных отчетов чаще всего используется автоматическая генерация формы на основе параметров, но для сложных случаев требуется ручная верстка.
Чтобы добавить параметры отчета, такие как «Период», «Контрагент» или «Организация», необходимо перейти на вкладку «Параметры» или использовать конструктор запроса. Параметры автоматически создадут поля ввода на форме отчета. Типы данных параметров должны строго соответствовать типам полей в базе данных, чтобы избежать ошибок преобразования типов при выполнении запроса.
Для отображения результатов используется объект ТабличныйДокумент. В макете результата вы можете заранее подготовить шапку таблицы, настроить ширину колонок и стили ячеек. Это особенно полезно, если отчет должен выглядеть как строгая бухгалтерская форма. Использование областей макета позволяет динамически заполнять строки данными из запроса, копируя структуру из подготовленного шаблона.
- 📊 Используйте
ТабличныйДокументдля вывода детализированных списков с возможностью группировки и итогов. - 🎨 Настраивайте условное оформление в макете, чтобы подсвечивать отрицательные значения или просроченные долги.
- 📑 Разбивайте сложные отчеты на несколько макетов, если требуется вывод разных разделов на отдельные листы Excel.
Написание программного кода модуля
Сердцем любого внешнего отчета является его модуль. Перейдите на вкладку «Модуль объекта». Здесь пишется код на встроенном языке 1С, который управляет логикой формирования данных. Основной точкой входа для внешнего отчета является процедура Сформировать(). Именно она вызывается пользователем при нажатии кнопки формирования в интерфейсе программы.
Внутри процедуры Сформировать() обычно происходит получение значений параметров формы, построение объекта запроса и заполнение табличного документа. Для работы с данными используется объект Запрос. Текст запроса можно хранить непосредственно в коде или выносить в макет типа «Текст» для удобства редактирования без открытия модуля.
Процедура Сформировать()
ТабДок = ЭлементыФормы.Результат;
ТабДок.Очистить();
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ...";
Запрос.УстановитьПараметр("НачалоПериода", НачалоПериода);
РезультатЗапроса = Запрос.Выполнить();
// Дальнейшая обработка результата
КонецПроцедуры
Важно правильно обрабатывать ситуации, когда данные не найдены. Пользователь должен видеть понятное сообщение, а не пустую форму или ошибку выполнения. Для этого используйте конструкцию ЕСЛИ ... ТОГДА для проверки пустоты выборки перед выводом на экран. Также не забывайте про транзакции, если ваш отчет не только читает, но и изменяет данные (хотя для отчетов это редкость).
Использование Системы Компоновки Данных (СКД)
Для сложных аналитических отчетов ручной вывод в табличный документ может быть слишком трудоемким. В таких случаях рекомендуется использовать СКД (Систему Компоновки Данных). Это механизм 1С, который позволяет описывать структуру отчета, настройки и запросы в декларативном виде, а платформа сама формирует результат.
Чтобы использовать СКД во внешнем отчете, необходимо создать макет типа «СхемаКомпоновкиДанных». В конструкторе СКД вы описываете наборы данных, поля, отборы и параметры. Преимущество этого подхода в том, что пользователь получает стандартный интерфейс настройки отчета: возможность менять группировки, сортировки и отборы прямо в режиме предприятия без изменения кода.
В модуле объекта при использовании СКД код существенно упрощается. Вам нужно лишь создать объект КомпоновщикНастроек, загрузить настройки из макета и скомпоновать результат. Платформа сама сформирует табличный документ, учитывая все выбранные пользователем опции. Это делает внешний отчет более гибким и удобным в эксплуатации.
| Характеристика | Ручной вывод (ТабличныйДокумент) | СКД (Схема компоновки) |
|---|---|---|
| Сложность разработки | Высокая (нужен код) | Средняя (конструктор) |
| Гибкость для пользователя | Низкая (фиксированная форма) | Высокая (настройка полей) |
| Производительность | Зависит от кода программиста | Оптимизирована платформой |
| Возможность вывода графиков | Требует доп. кода | Встроено в настройки |
Сохранение и выгрузка внешнего отчета
После написания кода и проверки работы отчета в режиме отладки необходимо сохранить его в файл для распространения. В конфигураторе выберите пункт меню Файл → Сохранить как.... В диалоговом окне укажите имя файла и выберите тип файла «Внешний отчет (*.erf)». Система предложит сжать файл, что рекомендуется делать для уменьшения размера.
Обратите внимание на настройки сохранения. Если вы использовали общие модули или специфические библиотеки, убедитесь, что они доступны в той базе, где будет запускаться отчет. Внешний отчет не содержит в себе всю конфигурацию, он ссылается на объекты основной базы. Если в отчете есть жесткие привязки к конкретным именам объектов, которых нет у пользователя, возникнет ошибка.
Что делать, если файл не сохраняется?
Если кнопка «Сохранить» неактивна, проверьте, открыт ли объект в окне редактирования. Также убедитесь, что у вас есть права на запись в папку назначения и что файл не открыт в другой программе.
Готовый файл .erf можно передавать пользователю любым способом: по электронной почте, через мессенджер или размещать в общей папке сети. Для запуска пользователю не нужен конфигуратор, достаточно режима предприятия. В интерфейсе 1С отчет открывается через меню Файл → Открыть или перетаскиванием файла в окно программы.
Подключение и запуск в режиме предприятия
Запуск внешнего отчета происходит в режиме предприятия. Пользователь выбирает в меню Файл → Открыть и указывает путь к сохраненному файлу .erf. После открытия отчет появляется как новая вкладка или окно. Если отчет требует параметров (период, организация), система автоматически запросит их ввод перед формированием.
Для частого использования внешний отчет можно добавить в панель навигации или в меню «Отчеты». Это делается через режим «Изменение формы» или администрирование интерфейса. Вы можете создать команду, которая будет ссылаться на внешний файл, лежащий в общей папке, что позволит обновлять отчет централизованно без рассылки новых файлов каждому сотруднику.
⚠️ Внимание: При запуске внешнего отчета из непроверенного источника платформа 1С может выдать предупреждение о безопасности. Это нормальная реакция системы на запуск исполняемого кода. Запускайте только те файлы, происхождение которых вам известно.
Внешний отчет работает в той информационной базе, из которой он был вызван. Он не «переносит» данные из одной базы в другую, а лишь обрабатывает данные текущей открытой базы.
Частые ошибки и способы их устранения
При разработке внешних отчетов новички часто сталкиваются с рядом типовых проблем. Одна из самых распространенных — ошибка «Объект не найден». Это происходит, когда в коде отчета используется имя справочника или документа, которое отличается в рабочей базе от того, что было при разработке (например, из-за разных версий конфигурации или синонимов).
Еще одна проблема связана с правами доступа. Даже если код написан верно, у пользователя может не быть прав на чтение конкретных регистров или документов, которые использует отчет. В этом случае отчет сформируется пустым или выдаст ошибку прав доступа. Решение заключается в проверке прав пользователя или использовании специального режима выполнения отчета от имени администратора (если это допустимо политикой безопасности).
- ❌ Ошибка типов данных: попытка записать строку в числовое поле табличного документа.
- ❌ Ошибка запроса: синтаксическая ошибка в тексте запроса, часто из-за опечаток в именах полей.
- ❌ Проблема с кодировкой: при выгрузке в CSV данные могут отображаться некорректно, если не указана кодировка UTF-8.
☑️ Проверка перед сдачей отчета
Можно ли защитить внешний отчет от копирования или изменения кода?
Стандартными средствами 1С полностью защитить код внешнего отчета от просмотра невозможно, так как файл .erf по сути является архивом с текстовыми файлами модулей. Однако можно использовать обфускацию имен переменных и усложнение логики, чтобы затруднить понимание кода. Для серьезной защиты требуется использование механизмов лицензирования внутри кода отчета, проверяющих наличие ключа защиты.
В чем разница между .erf и .epf файлами?
Файлы .erf предназначены для внешних отчетов, которые формируют результаты для просмотра или печати. Файлы .epf — это внешние обработки, предназначенные для выполнения действий (изменение данных, проведение документов, обмен). Технически структура файлов схожа, но платформа по-разному их интерпретирует и размещает в интерфейсе.
Как обновить внешний отчет у всех пользователей сразу?
Если вы разместите файл отчета в общей сетевой папке и создадите в базе команду, ссылающуюся на этот файл по пути, то при запуске отчета пользователи всегда будут получать актуальную версию. При изменении логики вам нужно просто заменить файл в папке, и все пользователи при следующем запуске увидят изменения.
Может ли внешний отчет замедлить работу базы данных?
Да, неоптимизированный запрос во внешнем отчете может создать нагрузку на сервер баз данных (SQL), заблокировать таблицы или занять много оперативной памяти клиента. Всегда тестируйте отчеты на производственных объемах данных и используйте индексы при построении запросов.