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

Другое · 7 мин

Вызов экспортной процедуры в 1С: порядок и проверка

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

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

Если процедура предназначена для выгрузки данных, она может формировать файл XML, XLS, CSV, TXT или заполнять таблицу значений для последующей выгрузки. Некоторые конфигурации используют встроенный обмен данными, другие — собственные процедуры в общих модулях. Вызов из неподходящего места часто приводит к ошибке «Процедура не найдена» или к выполнению только на клиенте, когда требуется серверный контекст.

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

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

В конфигураторе откройте дерево конфигурации и найдите подходящий раздел: Общие модули, Модули объектов, Формы или Внешние обработки. Если процедура объявлена с ключевым словом Экспорт, она видна за пределами своего модуля. В обычном модуле вызов пишется просто по имени, в общем модуле — через имя модуля и точку.

В управляемом приложении форма имеет клиентский и серверный контексты. Процедура формы, помеченная &НаКлиенте, вызывается из клиентских событий, а процедура с &НаСервере — только на сервере. Из клиентского кода серверную процедуру вызывают через вызов серверного метода или обработчик, выполнение которого переносится на сервер платформой.

Где искать объявление экспортной процедуры

Начните с раздела Общие модули, если процедура общая для нескольких подсистем. Процедуры в общих модулях часто вызываются через конструкцию ИмяОбщегоМодуля.ИмяПроцедуры(Параметры). Если процедура относится к конкретному документу или справочнику, ищите в модуле объекта этого элемента конфигурации.

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

Вызов из формы и модуля объекта

В клиентском модуле формы достаточно написать ИмяПроцедуры(Параметры), если процедура объявлена в этом же модуле формы и доступна на клиенте. Для серверной процедуры формы используйте вызов в контексте сервера, например через процедуру с директивой &НаСервере, инициируемую клиентским событием.

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

Сравнение вариантов вызова

Из формы

Подходит для действий пользователя, ограничено контекстом формы

Из общего модуля

Удобно для переиспользования, требует правильного выбора клиент/сервер

Серверный код

Подходит для файлов и базы на сервере, не подходит для локального интерфейса клиента

Вызов из общего модуля и серверного кода

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

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

1c
&НаСервере Процедура ЭкспортДанные() КонецПроцедуры

Экспорт через внешнюю обработку и внешние подключения

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

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

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

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

Файл выгрузки
Норма

Файл создан в ожидаемой папке с нужным содержимым

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

Файл отсутствует или пустой

Данные в базе
Норма

Справочники и документы обновлены без ошибок

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

Данные не изменились или появились несоответствия

Права доступа
Норма

Пользователь может выполнять процедуру и записывать файлы

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

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

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

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

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

Итог

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

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

Нужно ли всегда помечать процедуру словом Экспорт?

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

Можно ли вызвать серверную процедуру напрямую из клиента?

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

Что делать, если файл выгрузки не появился?

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

Безопасно ли тестировать экспорт в рабочей базе?

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

Какие права нужны для вызова экспортной процедуры?

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