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

Другое · 5 мин

Получение данных из функции в 1С: порядок и нюансы

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

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

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

Для вызова укажите имя функции и все обязательные параметры. Если параметров нет, скобки всё равно ставятся. Пример вызова: Результат = РасчетСкидки(Сумма, Дата);. После вызова убедитесь, что переменная не равна Неопределено, и при необходимости приведите тип к нужному.

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

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

Как вызвать функцию и получить результат

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

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

Где функции могут быть недоступны

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

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

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

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

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

Типичные ошибки
01
Вызов неэкспортируемой функции из другого модуля — ошибка доступа
02
Передача параметров в неправильном порядке — некорректный результат
03
Игнорирование проверки на Неопределено — ошибка при использовании результата

Частые ошибки при получении данных

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

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

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

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

Тип возвращаемого значения
Норма

Соответствует ожидаемому

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

Неопределено или несоответствующий тип

Доступ к функции
Норма

Экспорт и контекст подходят

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

Ошибка компиляции или доступа

Наличие данных
Норма

Таблица или набор не пуст

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

Пустой результат без обработки

Альтернативы прямому вызову функции

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

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

Итог

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

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

Можно ли вызвать любую функцию из любого места конфигурации?

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

Что делать, если функция возвращает Неопределено?

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

Нужно ли проверять тип возвращаемого значения?

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

Безопасно ли запускать функцию, которая изменяет данные?

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