Синтаксис и применение Доступность объектов, их свойств и методов в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Доступность объектов, их свойств и методов
При исполнении встроенного языка на сервере 1С:Предприятия не все объекты, а также их свойства и методы могут быть доступны. Например, не доступны объекты глобального контекста, предназначенные для управления интерфейсом, за исключением функции Сообщить().
Также возможна ситуация, когда сам объект доступен для использования на сервере, а его свойства или методы нет. Например, свойство РабочаяДата изменяется конкретным пользователем в текущем сеансе и предназначено для удобства заполнения форм, поэтому его использование на сервере теряет смысл.
Для сессии внешнего соединения доступен весь глобальный контекст, за исключением объектов, жестко связанных с клиентским приложением (ТекстовыйДокумент, ТабличныйДокумент, ...).
Если объект, его свойство или метод не доступен на сервере, то специального упоминания об этом производиться не будет. Исключения составляют значения системных перечислений. В них возможность использования указывается только для самих объектов. Подразумевается, что значения перечислений "наследуют" эту возможность.
Аналогичное правило вводится для возможности использования объектов, их свойств и методов в сессии внешнего соединения.
Доступность объектов, их свойств, методов на тонком и веб-клиентах указывается в описании Синтакс-Помощника. Для показа описаний механизмов по определенным режимам запуска используйте настройку (пункт меню "Сервис - Параметры" закладка "Справка").
Практические примеры
Контекст: передать число с клиентской формы в серверный расчёт
Собственный реквизит формы хранит количество. Серверная функция без контекста получает только явно переданное число; текст для интерфейса собирается обратно на клиенте.
Где и как запускать
Полный модуль своей управляемой формы: создание реквизита на сервере с контекстом, команда на клиенте, расчёт на сервере без контекста.
Подготовка
Создайте отдельную внешнюю обработку с пустой управляемой основной формой в учебной базе 8.5.1.1343. Общий модуль для этого урока не нужен.
Создайте команду Выполнить и кнопку. Назначьте обработчик команды Выполнить(Команда), а событию ПриСозданииНаСервере — одноимённую процедуру из полного кода. Реквизит и поле вручную не создавайте.
Вставьте весь приведённый модуль формы. Запустите её в тонком управляемом клиенте Windows своей учебной базы; первоначальное количество 3 создаётся кодом.
Не заменяйте ЭтаФорма чужой формой. Все значения принадлежат собственному полю и собственным процедурам; базы товаров, файлы и сеть не читаются.
Запуск в 1С не проверялся. Клиентская/серверная доступность сверена со справкой; итоговую работу и отображение проверяйте только на своём учебном стенде.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Реквизиты = Новый Массив;
Реквизиты.Добавить(Новый РеквизитФормы("УчебноеКоличество", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный))));
ЭтаФорма.ИзменитьРеквизиты(Реквизиты);
ЭтаФорма.УчебноеКоличество = 3;
Поле = Элементы.Добавить("ПолеУчебногоКоличества", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "УчебноеКоличество";
Поле.Заголовок = "Количество своих книг от 1 до 10";
КонецПроцедуры
&НаКлиенте
Процедура Выполнить(Команда)
КоличествоДляРасчёта = ЭтаФорма.УчебноеКоличество;
ЦенаНаКлиенте = 999;
Сумма = СуммаСвоихКнигНаСервере(КоличествоДляРасчёта);
Сообщить(Сумма = КоличествоДляРасчёта * 250);
Сообщить(ЦенаНаКлиенте = 999);
Сообщить(ЭтаФорма.УчебноеКоличество = КоличествоДляРасчёта);
Сообщить(СтрШаблон("Своих книг: %1, серверная цена 250, сумма: %2", КоличествоДляРасчёта, Сумма));
КонецПроцедуры
&НаСервереБезКонтекста
Функция СуммаСвоихКнигНаСервере(Знач Количество)
Если ТипЗнч(Количество) <> Тип("Число") Тогда
ВызватьИсключение "Количество должно быть числом";
КонецЕсли;
Если Количество < 1 Или Количество > 10 Или Количество <> Цел(Количество) Тогда
ВызватьИсключение "Количество должно быть целым от 1 до 10";
КонецЕсли;
ЦенаНаКлиенте = 250;
Возврат Количество * ЦенаНаКлиенте;
КонецФункцииРазбор по шагам
ПриСозданииНаСервере имеет контекст формы: добавляет собственный реквизит и связывает с ним собственное поле ввода. Квалификатор отсекает отрицательные и дробные значения при вводе, но не заменяет серверную защиту диапазона.
Клиентский обработчик читает реквизит и сохраняет число в локальную переменную. Своя ЦенаНаКлиенте=999 находится только внутри этой процедуры.
Вызов СуммаСвоихКнигНаСервере передаёт число явно. Директива НаСервереБезКонтекста означает, что функция не получает ЭтаФорма и не читает УчебноеКоличество из клиентской памяти.
Сервер сначала проверяет число, затем целочисленность и границы. Собственная локальная ЦенаНаКлиенте=250 не имеет отношения к клиентской переменной с тем же именем.
Для количества 3 сервер возвращает 750. Клиент формирует сообщение и проверяет свой реквизит и цену 999: они не изменились от расчёта.
Разделение контекстов сохраняется и в файловой базе. Не переносите UI-вызовы в серверную функцию, не считайте любой объект/метод доступным в обоих местах только из-за одинакового имени.
Как проверить результат
Для исходных трёх книг три проверки Истина и сообщение о серверной цене 250, количестве 3, сумме 750.
Поставьте в поле 4: сумма 1000 и те же три проверки Истина. Для 0 или 11 функция выдаёт явную ошибку количества до возврата; последующие клиентские сообщения после вызова не исполняются. Это отрицательный опыт, а не успешный итог 0.
Ожидаемый результат
Полный собственный модуль демонстрирует реальную передачу аргумента, два разных локальных значения с одним именем и неизменность клиентского реквизита.
На что обратить внимание
Одинаковое имя ЦенаНаКлиенте в двух процедурах не делает переменную общей. Именование здесь намеренно учебное: серверная цена должна называться по своему смыслу в рабочем коде.
НаСервереБезКонтекста не даёт доступ к ЭтаФорма и Элементы. Они используются только в серверном обработчике с контекстом и клиентском обработчике формы.
Сообщить допускается на сервере, но доступность отдельного глобального метода не доказывает доступность клиентских диалогов и других UI-операций. Отдельная справка каждого метода важнее широкого общего описания режима.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.