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

Другое · 8 мин

Добавление СКД в расширение конфигурации 1С

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

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

Объект СКД обычно создаётся как конфигурационный объект «Отчёт» или «Обработка», у которого заполнена схема компоновки данных. После этого объект добавляется в состав расширения, настраивается его видимость для пользователей и проверяется работа в обычном приложении, а не только в режиме конфигуратора.

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

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

Когда добавление СКД в расширение оправдано

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

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

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

Подготовка объекта отчёта или обработки с СКД

В конфигураторе создайте объект «Отчёт» или «Обработка» и укажите у него схему компоновки данных. В схеме настройте наборы данных, параметры, ресурсы и макеты. Параметры отчёта должны быть явно описаны, чтобы расширение могло передавать их в форму без привязки к объектам базовой конфигурации.

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

Схема компоновки данныхЗаполнена и сохранена

Проверьте, что наборы данных и параметры не ссылаются на удалённые объекты базы

Объект конфигурацииОтчёт или обработка

Убедитесь, что у объекта есть имя и синоним, понятные пользователю

Доступ к даннымОбщие или включённые в расширение

Проверьте, что все таблицы схемы доступны в целевой информационной базе

Особенности работы со схемой компоновки данных

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

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

Перенос объекта в расширение и настройка видимости

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

После добавления объекта выполните компиляцию расширения. Убедитесь, что в окне ошибок нет сообщений о нехватке объектов, неправильных типах параметров или отсутствующих схемах компоновки данных.

Порядок добавления СКД в расширение
  1. 1
    Создать отчёт или обработку со схемой компоновки данных в конфигураторе
  2. 2
    Добавить объект в состав расширения
  3. 3
    Настроить видимость и команду вызова в обычном приложении
  4. 4
    Скомпилировать расширение и устранить ошибки
  5. 5
    Проверить открытие отчёта на копии информационной базы

Проверка прав и ролей

Даже после компиляции отчёт может быть невидим для пользователя, если не настроены права доступа. Проверьте role-доступ к объекту и к данным, которые использует схема. Для конфиденциальных отчётов создайте отдельную роль и выдавайте её только нужным сотрудникам.

Если отчёт вызывается из формы документа или справочника, убедитесь, что команда добавлена в нужную команду интерфейса и доступна в клиентском приложении. В веб-клиенте и тонком клиенте поведение может отличаться, поэтому проверяйте оба варианта.

Параметры, наборы данных и ресурсы в расширении

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

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

Проверка работы и распространённые ошибки

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

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

Типичные ошибки
01
Объект добавлен в расширение, но не включён в состав для обычного приложения, поэтому отчёт не виден пользователям
02
Схема СКД ссылается на регистр или справочник, отсутствующий в расширении, что вызывает ошибку при выполнении
03
Права доступа не настроены, и отчёт открывается только у администратора

Признаки корректной работы

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

Также проверьте поведение при повторном открытии и после перезапуска сеанса. Настройки схемы не должны сбрасываться, а права не должны пропадать после обновления сеанса.

Ограничения и альтернативы

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

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

Итог

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

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

Нужно ли регистрировать отчёт в командном интерфейсе вручную?

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

Можно ли использовать один отчёт в нескольких расширениях?

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

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

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

Нужно ли отдельное тестирование для тонкого и веб-клиента?

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