Доступность объектов, их свойств и методов

Встроенный язык

Синтаксис и применение Доступность объектов, их свойств и методов в платформе 1С:Предприятие. Описание и примеры кода.

Полное описание, параметры и ограничения

Доступность объектов, их свойств и методов

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

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

Для сессии внешнего соединения доступен весь глобальный контекст, за исключением объектов, жестко связанных с клиентским приложением (ТекстовыйДокумент, ТабличныйДокумент, ...).

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

Аналогичное правило вводится для возможности использования объектов, их свойств и методов в сессии внешнего соединения.

Доступность объектов, их свойств, методов на тонком и веб-клиентах указывается в описании Синтакс-Помощника. Для показа описаний механизмов по определенным режимам запуска используйте настройку (пункт меню "Сервис - Параметры" закладка "Справка").

Практические примеры

Контекст: передать число с клиентской формы в серверный расчёт

Собственный реквизит формы хранит количество. Серверная функция без контекста получает только явно переданное число; текст для интерфейса собирается обратно на клиенте.

Где и как запускать

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

Подготовка

  1. Создайте отдельную внешнюю обработку с пустой управляемой основной формой в учебной базе 8.5.1.1343. Общий модуль для этого урока не нужен.

  2. Создайте команду Выполнить и кнопку. Назначьте обработчик команды Выполнить(Команда), а событию ПриСозданииНаСервере — одноимённую процедуру из полного кода. Реквизит и поле вручную не создавайте.

  3. Вставьте весь приведённый модуль формы. Запустите её в тонком управляемом клиенте Windows своей учебной базы; первоначальное количество 3 создаётся кодом.

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

  5. Запуск в 1С не проверялся. Клиентская/серверная доступность сверена со справкой; итоговую работу и отображение проверяйте только на своём учебном стенде.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Реквизиты = Новый Массив;
    Реквизиты.Добавить(Новый РеквизитФормы("УчебноеКоличество", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный))));
    ЭтаФорма.ИзменитьРеквизиты(Реквизиты);
    ЭтаФорма.УчебноеКоличество = 3;
    Поле = Элементы.Добавить("ПолеУчебногоКоличества", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "УчебноеКоличество";
    Поле.Заголовок = "Количество своих книг от 1 до 10";
КонецПроцедуры

&НаКлиенте
Процедура Выполнить(Команда)
    КоличествоДляРасчёта = ЭтаФорма.УчебноеКоличество;
    ЦенаНаКлиенте = 999;
    Сумма = СуммаСвоихКнигНаСервере(КоличествоДляРасчёта);
    Сообщить(Сумма = КоличествоДляРасчёта * 250);
    Сообщить(ЦенаНаКлиенте = 999);
    Сообщить(ЭтаФорма.УчебноеКоличество = КоличествоДляРасчёта);
    Сообщить(СтрШаблон("Своих книг: %1, серверная цена 250, сумма: %2", КоличествоДляРасчёта, Сумма));
КонецПроцедуры

&НаСервереБезКонтекста
Функция СуммаСвоихКнигНаСервере(Знач Количество)
    Если ТипЗнч(Количество) <> Тип("Число") Тогда
        ВызватьИсключение "Количество должно быть числом";
    КонецЕсли;
    Если Количество < 1 Или Количество > 10 Или Количество <> Цел(Количество) Тогда
        ВызватьИсключение "Количество должно быть целым от 1 до 10";
    КонецЕсли;
    ЦенаНаКлиенте = 250;
    Возврат Количество * ЦенаНаКлиенте;
КонецФункции

Разбор по шагам

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

  2. Клиентский обработчик читает реквизит и сохраняет число в локальную переменную. Своя ЦенаНаКлиенте=999 находится только внутри этой процедуры.

  3. Вызов СуммаСвоихКнигНаСервере передаёт число явно. Директива НаСервереБезКонтекста означает, что функция не получает ЭтаФорма и не читает УчебноеКоличество из клиентской памяти.

  4. Сервер сначала проверяет число, затем целочисленность и границы. Собственная локальная ЦенаНаКлиенте=250 не имеет отношения к клиентской переменной с тем же именем.

  5. Для количества 3 сервер возвращает 750. Клиент формирует сообщение и проверяет свой реквизит и цену 999: они не изменились от расчёта.

  6. Разделение контекстов сохраняется и в файловой базе. Не переносите UI-вызовы в серверную функцию, не считайте любой объект/метод доступным в обоих местах только из-за одинакового имени.

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

  1. Для исходных трёх книг три проверки Истина и сообщение о серверной цене 250, количестве 3, сумме 750.

  2. Поставьте в поле 4: сумма 1000 и те же три проверки Истина. Для 0 или 11 функция выдаёт явную ошибку количества до возврата; последующие клиентские сообщения после вызова не исполняются. Это отрицательный опыт, а не успешный итог 0.

Ожидаемый результат

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

На что обратить внимание

  1. Одинаковое имя ЦенаНаКлиенте в двух процедурах не делает переменную общей. Именование здесь намеренно учебное: серверная цена должна называться по своему смыслу в рабочем коде.

  2. НаСервереБезКонтекста не даёт доступ к ЭтаФорма и Элементы. Они используются только в серверном обработчике с контекстом и клиентском обработчике формы.

  3. Сообщить допускается на сервере, но доступность отдельного глобального метода не доказывает доступность клиентских диалогов и других UI-операций. Отдельная справка каждого метода важнее широкого общего описания режима.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.