При разработке современных интеграций на базе старых конфигураций, таких как 1С:Управление торговлей 10.3 или УПП 1.3, программисты часто сталкиваются с трудностями при использовании HTTP-сервисов. Типичная ситуация: вы создаете HTTP-сервис, получаете данные, находите нужную ссылку на документ, но при попытке выполнить метод ПолучитьОбъект() выполнение кода просто прерывается без явных сообщений об ошибках, или возвращается стандартная ошибка 500 Internal Server Error. В этой статье мы подробно разберем, почему это происходит и как адаптировать "старый" код под требования серверного контекста.
Рассмотрим механику работы системы. HTTP-сервисы в 1С всегда выполняются на стороне сервера в неинтерактивном режиме. Когда мы вызываем метод ПолучитьОбъект() для ссылки ДокументСсылка, платформа 1С обязана скомпилировать Модуль объекта этого документа. Если в модуле объекта (или в общих модулях, к которым он обращается) содержится код, который не может быть исполнен на сервере, компиляция завершается неудачей.
В старых конфигурациях, написанных под "Обычное приложение", модули объектов часто перегружены вызовами клиентских функций, работой с формами или интерактивными диалогами (например, Вопрос(), Предупреждение()). Даже если этот код не выполняется в данный момент, само его наличие без специальных инструкций препроцессора делает модуль "невалидным" для сервера.
Первое, что мы должны сделать, — это запустить встроенную проверку синтаксиса, но с правильными настройками. По умолчанию конфигуратор проверяет код для текущего режима запуска, но HTTP-сервис работает иначе.
После запуска этой проверки система выдаст список мест, где код "не видит" нужные процедуры или функции. Именно эти ошибки блокируют инициализацию объекта в вашем HTTP-сервисе.
Проанализируем ситуацию: наш HTTP-сервис вызывает процедуру из общего модуля, которая пытается получить объект документа. Если этот общий модуль имеет только флаг Клиент (обычное приложение), то сервер его просто не увидит. Однако, просто добавить флаг Сервер бывает недостаточно.
Как показывает практика, для корректной работы через HTTP-протокол или COM-соединение, общие модули, в которых описана логика работы с документами, должны иметь установленные флаги:
Разберем пример кода, который может использоваться в обработчике HTTP-сервиса для получения объекта:
// Пример получения объекта в серверном модуле
Функция ОбработатьЗапрос(ДанныеЗапроса) Экспорт
СсылкаНаДокумент = Документы.РеализацияТоваровУслуг.НайтиПоНомеру(ДанныеЗапроса.Номер, ДанныеЗапроса.Дата);
Если СсылкаНаДокумент.Пустая() Тогда
Возврат Ложь;
КонецЕсли;
Попытка
// Именно здесь часто происходит "вылет"
ОбъектДокумента = СсылкаНаДокумент.ПолучитьОбъект();
Исключение
ЗаписьЖурналаРегистрации("HTTP-Сервис", УровеньЖурналаРегистрации.Ошибка, , , ОписаниеОшибки());
Возврат Ложь;
КонецПопытки;
// Дальнейшая логика заполнения ТЧ
НоваяСтрока = ОбъектДокумента.Товары.Добавить();
// Заполнение реквизитов...
ОбъектДокумента.Записать(РежимЗаписиДокумента.Запись);
Возврат Истина;
КонецФункции
Если проверка конфигурации указала на ошибки в модуле объекта документа (например, Документ.КомплектационныйЛист.МодульОбъекта), нам необходимо "спрятать" клиентские вызовы от сервера. Для этого используются директивы препроцессора.
Выясним причину ошибки: если в модуле объекта есть вызовы процедур из модулей с флагом только Клиент, или используются методы типа Предупреждение(), нам нужно обернуть их следующим образом:
#Если Клиент Тогда
// Этот код будет виден только при работе пользователя в интерфейсе
Предупреждение("Документ успешно оформлен!");
#КонецЕсли
Проанализируем типичную ошибку в УТ 10.3 — использование глобальных переменных или функций, доступных только в интерактивном режиме. Если в модуле объекта есть подписки на события или вызовы функций печати, которые обращаются к интерфейсу, их также нужно ограничивать проверкой контекста.
Часто выполнение HTTP-запроса происходит под технической учетной записью с ограниченными правами. При попытке выполнить ПолучитьОбъект() система может проверять права доступа (RLS), что в контексте сервера иногда приводит к непредсказуемым результатам.
Рассмотрим вариант решения через установку привилегированного режима. Это позволит выполнить код без проверки прав доступа пользователя, под которым запущен процесс веб-сервера:
Процедура ДобавитьСтрокуВТЧ(СсылкаНаДокумент, СтруктураДанных) Экспорт
УстановитьПривилегированныйРежим(Истина);
// В этом режиме 1С игнорирует ограничения RLS
ДокОбъект = СсылкаНаДокумент.ПолучитьОбъект();
Если ДокОбъект <> Неопределено Тогда
// Логика добавления строки
ЗаполнитьЗначенияСвойств(ДокОбъект.Товары.Добавить(), СтруктураДанных);
ДокОбъект.Записать();
КонецЕсли;
УстановитьПривилегированныйРежим(Ложь);
КонецПроцедуры
Если вы все еще не понимаете, почему объект не получается, применим метод изоляции. Создадим простую внешнюю обработку с одной кнопкой, код которой полностью дублирует получение объекта. Запустим ее в том же режиме (например, на сервере через консоль заданий или просто открыв в обычном приложении).
Если во внешней обработке код Ссылка.ПолучитьОбъект() работает, а в HTTP-сервисе — нет, значит, проблема 100% заключается в доступности общих модулей для контекста "Внешнее соединение" или "Сервер". Проверьте еще раз цепочку вызовов: не обращается ли модуль объекта к какому-нибудь РаботаСДиалогами или УниверсальныеМеханизмы, у которых нет серверных флагов.
Важный нюанс: После внесения изменений в настройки общих модулей или код модулей объектов, базу на веб-сервере (Apache или IIS) крайне желательно переопубликовать или как минимум перезапустить службу веб-сервера, чтобы кэш скомпилированных модулей обновился.
Для успешного добавления строк в табличную часть документа через HTTP-запрос в УТ 10.3 необходимо:
#Если Клиент Тогда.