Другое · 7 мин
Вызов экспортной процедуры в 1С: порядок и проверка
Как вызвать экспортную процедуру в 1С: где искать процедуру, как вызывать из формы, общего и серверного модуля, проверить результат и избежать ошибок.
Экспортная процедура в 1С может означать как вызов специальной подпрограммы для выгрузки данных, так и вызов любой процедуры, помеченной ключевым словом Экспорт и доступной из других модулей. Перед тем как писать код, нужно определить, где процедура объявлена: в модуле формы, модуле объекта, общем модуле или внешней обработке. От места объявления зависит синтаксис вызова, права доступа и возможность выполнения на сервере или клиенте.
Если процедура предназначена для выгрузки данных, она может формировать файл XML, XLS, CSV, TXT или заполнять таблицу значений для последующей выгрузки. Некоторые конфигурации используют встроенный обмен данными, другие — собственные процедуры в общих модулях. Вызов из неподходящего места часто приводит к ошибке «Процедура не найдена» или к выполнению только на клиенте, когда требуется серверный контекст.
Безопасность вызова связана с записью файлов, изменением справочников и документов, блокировками и правами пользователя. Рекомендуется сначала протестировать на копии информационной базы, проверить права текущего пользователя и убедиться, что вызов не запустится параллельно в нескольких сеансах. Ниже приведен порядок действий и основные сценарии.
- 1Найти модуль с процедурой в конфигураторе
- 2Убедиться, что процедура помечена как Экспорт
- 3Выбрать контекст вызова: клиент, сервер или общий модуль
- 4Написать вызов с нужными параметрами
- 5Проверить результат и права доступа
В конфигураторе откройте дерево конфигурации и найдите подходящий раздел: Общие модули, Модули объектов, Формы или Внешние обработки. Если процедура объявлена с ключевым словом Экспорт, она видна за пределами своего модуля. В обычном модуле вызов пишется просто по имени, в общем модуле — через имя модуля и точку.
В управляемом приложении форма имеет клиентский и серверный контексты. Процедура формы, помеченная &НаКлиенте, вызывается из клиентских событий, а процедура с &НаСервере — только на сервере. Из клиентского кода серверную процедуру вызывают через вызов серверного метода или обработчик, выполнение которого переносится на сервер платформой.
Где искать объявление экспортной процедуры
Начните с раздела Общие модули, если процедура общая для нескольких подсистем. Процедуры в общих модулях часто вызываются через конструкцию ИмяОбщегоМодуля.ИмяПроцедуры(Параметры). Если процедура относится к конкретному документу или справочнику, ищите в модуле объекта этого элемента конфигурации.
Для процедур, привязанных к форме, проверьте модуль формы объекта или списка. Такие процедуры могут быть доступны только из этой формы, если не выводятся в общий модуль. Внешние обработки содержат свои модули, где экспортная процедура может быть объявлена для вызова из команды обработки.
Вызов из формы и модуля объекта
В клиентском модуле формы достаточно написать ИмяПроцедуры(Параметры), если процедура объявлена в этом же модуле формы и доступна на клиенте. Для серверной процедуры формы используйте вызов в контексте сервера, например через процедуру с директивой &НаСервере, инициируемую клиентским событием.
Из модуля объекта вызов зависит от того, где находится вызывающий код. Если процедура объявлена в модуле того же объекта, вызывайте по имени. Если в другом объекте, обычно потребуется ссылка на объект или общий модуль, так как прямое обращение к приватным процедурам другого модуля ограничено.
Сравнение вариантов вызова
Подходит для действий пользователя, ограничено контекстом формы
Удобно для переиспользования, требует правильного выбора клиент/сервер
Подходит для файлов и базы на сервере, не подходит для локального интерфейса клиента
Вызов из общего модуля и серверного кода
Общий модуль удобен для переиспользуемой логики выгрузки. Объявите процедуру с ключевым словом Экспорт, затем вызывайте из любого подходящего места через имя модуля. Проверьте свойства модуля: серверный, клиентский или общий, так как это определяет, на каком уровне может выполняться код.
Серверный код подходит для работы с файлами на сервере, базой данных и блокировками. Клиентский код подходит для взаимодействия с интерфейсом и локальным компьютером пользователя. В веб-клиенте клиентский код выполняется в браузере, поэтому доступ к локальным дисках ограничен и требует особых механизмов сохранения файлов.
&НаСервере Процедура ЭкспортДанные() КонецПроцедурыЭкспорт через внешнюю обработку и внешние подключения
Внешняя обработка позволяет вынести логику выгрузки за преде основной конфигурации. Создайте обработку, добавьте команду и в модуле команды реализуйте вызов экспортной процедуры. Такой подход удобен для разовых выгрузок, интеграций и переноса сценария между базами.
При вызове из внешних приложений через COM-соединение или веб-сервисы убедитесь, что процедура доступна в публичном интерфейсе конфигурации. Внешний вызов требует настройки прав, аутентификации и часто дополнительного тестирования, так как ошибки могут затрагивать сразу несколько сеансов пользователей.
Как проверить результат
Файл создан в ожидаемой папке с нужным содержимым
Файл отсутствует или пустой
Справочники и документы обновлены без ошибок
Данные не изменились или появились несоответствия
Пользователь может выполнять процедуру и записывать файлы
Ошибка доступа или запрета записи
Проверка результата и типичные ошибки
После вызова проверьте, появился ли ожидаемый файл, обновились ли данные и не остались ли необработанные ошибки. Если процедура возвращает значение, проанализируйте его: пустой результат может означать успешную обработку без данных или отмену выгрузки пользователем. Логи и сообщения платформы помогают найти причину сбоя.
Частые ошибки: вызов серверной процедуры из клиентского контекста, отсутствие ключевого слова Экспорт, неверный путь к файлу, недостаточные права на запись и одновременное выполнение выгрузки несколькими пользователями. Перед запуском в рабочей базе проверьте сценарий на копии и уточните порядок блокировки объектов.
Что важно запомнить
Найдите объявление процедуры, выберите правильный модуль и контекст выполнения, вызовите с параметрами и проверьте результат на копии базы.
Нужно ли всегда помечать процедуру словом Экспорт?
Нет, ключевое слово нужно только если процедура должна вызываться извне своего модуля. Внутри одного модуля процедуру можно вызывать по имени без Экспорт.
Можно ли вызвать серверную процедуру напрямую из клиента?
Прямой вызов серверной процедуры из клиентского кода не работает. Используйте серверный контекст формы, вызов серверного метода или механизм переноса выполнения на сервер.
Что делать, если файл выгрузки не появился?
Проверьте путь к файлу, права на запись, результат работы процедуры и сообщения платформы. В веб-клиенте локальный путь клиента может быть недоступен, поэтому используйте серверное хранение или специальные механизмы скачивания.
Безопасно ли тестировать экспорт в рабочей базе?
Не рекомендуется без резервной копии. Экспорт может изменять данные и создавать файлы, поэтому сначала отрабатывайте сценарий на копии информационной базы с теми же правами.
Какие права нужны для вызова экспортной процедуры?
Пользователь должен иметь права на объекты конфигурации, используемые процедурой, и на запись в целевую папку. Для серверных вызовов учитываются права учётной записи сервера 1С.