К статье
Практический материал

Другое · 5 мин

Как создать внешний отчет с помощью СКД в 1С

Создание внешнего отчета на СКД в 1С: порядок работы с наборами данных, параметрами, компоновкой и проверкой результата без изменения конфигурации.

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

Основа такого отчета часто строится на системе компоновки данных. СКД берет на себя получение данных, настройку параметров, группировку и вывод, а разработчику остается описать набор данных, параметры и макет.

Работать с внешним отчетом можно безопасно, если не менять объекты конфигурации напрямую и соблюдать права доступа. Ниже описан порядок создания и проверки.

Когда внешний отчет на СКД подходит

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

Ограничением является зависимость от прав доступа к регистрам и справочникам, задействованным в запросе. Если пользователь не видит исходные данные, отчет не покажет их, даже если настройки компоновки верные.

Подготовка объекта конфигурации

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

В модуле объекта укажите процедуру формирования отчета, где создается компоновщик данных, заполняются настройки и выводится макет. На этом этапе не нужно править общие модули конфигурации, если это не требуется задачей.

Порядок работы с данными
  1. 1
    Определить источник данных и поля для выборки
  2. 2
    Создать параметры отчета и связать их с запросом
  3. 3
    Проверить CompositionSettings и доступные наборы данных

Создание набора данных и параметров

Опишите запрос, который выбирает данные из регистров накопления, справочников или документов. Параметры отчета, такие как период, организация или контрагент, добавляются в набор параметров и связываются с условиями запроса.

Параметры делают отчет гибким: пользователь может менять даты или отбор без правки кода. Важно, чтобы имена параметров в запросе и настройках СКД совпадали, иначе данные не отобразятся.

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

В схеме компоновки данных настройте наборы данных, ресурсы, группировки и отборы. Добавьте поля в области «Заголовок», «Подвал» или «Тело» макета в зависимости от нужного вида таблицы или диаграммы.

Макет определяет внешний вид результата. Можно использовать табличный документ или макет компоновки данных; при изменении полей в схеме макет обновляется не всегда автоматически, поэтому проверяйте соответствие полей и колонок.

Вывод отчета и проверка результата

Запустите отчет из меню или команды, заполните параметры и дождитесь формирования. Убедитесь, что строки, суммы и группировки соответствуют ожидаемым значениям, а фильтры отрабатывают корректно.

Если отчет не открывается или выдает ошибку, проверьте текст запроса, права пользователя и доступность объектов базы. Часто причина кроется в отсутствии права на чтение регистра или в неверном имени параметра.

Типичные ошибки
01
Имена параметров в запросе и настройках не совпадают, данные не выводятся
02
Пользователь не имеет права на чтение регистра, отчет пуст или ошибка доступа
03
Без отбора выбирается слишком большой объем, отчет работает медленно

Права доступа, безопасность и частые ошибки

Назначьте роли, которым разрешено запускать внешний отчет, и проверьте права на просмотр используемых таблиц. Внешний отчет не обходит модель безопасности, поэтому скрытые данные останутся недоступными.

К типичным ошибкам относятся несоответствие параметров запроса и настроек, отсутствие прав на наборы данных и попытка вывести слишком большой объем без отбора. Это приводит к долгой работе или пустому результату.

Контрольные точки

Как проверить результат

Запуск отчета с разными параметрами
Норма

Данные меняются согласно отбору

Тревожный признак

Результат не меняется или пустой

Права пользователя
Норма

Отчет открывается и показывает доступные данные

Тревожный признак

Ошибка доступа или отсутствие строк

Альтернативы и когда не стоит использовать СКД

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

СКД подходит для большинства аналитических отчетов внутри 1С, но не заменяет полноценную разработку, если требуется интеграция с внешними системами или нестандартная логика расчетов вне платформы.

Итог

Что важно запомнить

Внешний отчет на СКД создается без изменения типовой конфигурации, проверяется по параметрам, правам и соответствию полей макета и схемы компоновки.

Можно ли создать отчет без программирования?

Базовый отчет на СКД можно настроить через конструктор компоновки данных, но для вызова и вывода обычно требуется небольшой код в модуле объекта. Полностью без кода обойтись сложно.

Что делать, если отчет не открывается?

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

Нужно ли изменять конфигурацию?

Внешний отчет создается отдельным объектом, поэтому прямые изменения типовой конфигурации не требуются. Изменения нужны только при встраивании в типовые формы или команды.

Как проверить, что данные верные?

Сравните результат отчета с данными в регистрах или справочниках при тех же отборах и периодах. Проверьте несколько комбинаций параметров и пустые случаи.