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

Другое · 8 мин

Обращение из расширения к основной конфигурации 1С

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

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

Порядок действий
  1. 1
    Убедитесь, что база предоставляет нужный экспортный интерфейс или событие
  2. 2
    Напишите код расширения, который вызывает этот интерфейс
  3. 3
    Проверьте синтаксис и сравнение конфигураций
  4. 4
    Проверьте работу на копии информационной базы
  5. 5
    Повторно проверьте после обновления платформы или базы

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

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

Типичные ошибки
01
Прямой вызов внутренних процедур базы без опубликованного интерфейса — ошибка может появиться после обновления.
02
Изменение объектов базы напрямую вместо вызова её процедур записи — нарушает целостность данных.
03
Отсутствие проверки на копии базы перед вводом в эксплуатацию — приводит к ошибкам у пользователей.

Что расширение видит в основной конфигурации

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

База предоставляет экспортную процедуруЕсть точка входа

Можно вызывать из расширения через общее модуль базы

Нет опубликованного интерфейсаПрямая зависимость

Требуется доработка базы или другой способ интеграции

Обновление конфигурации запланировано.Риск несовместимости

Проверьте работу расширения после обновления базы

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

Способы обращения через опубликованные интерфейсы

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

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

Итог

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

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

Серверный вызов общего модуля базы

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

Клиентская форма расширения вызывает процедуру базы

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

Работа с формами, командами и элементами управления

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

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

Добавление кнопки на форму базы

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

Метаданные, объекты и регистры

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

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

Чтение реквизита объекта базы

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

Проверка результата и ограничения

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

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

Нормальное состояние после изменений

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

Признак проблемы

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

Частые ошибки и безопасная работа

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

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

Может ли расширение изменить объект базы напрямую?

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

Что делать, если нужная процедура базы не доступна из расширения?

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

Нужно ли проверять расширение после обновления 1С:Предприятия?

Да. Изменения в платформе или базовой конфигурации могут закрыть ранее доступные интерфейсы или изменить порядок вызова. Проверку следует проводить на копии базы перед вводом обновления в работу.

Можно ли вызывать базовые процедуры из клиентской части расширения?

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

Какие риски при прямом доступе к метаданным базы?

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