Определяет, является ли ссылка пустой или нет.
Синтаксис
Пустая()Примеры платформы
ВидКонтрагента = Контрагент.Вид;
Если ВидКонтрагента.Пустая() Тогда
Сообщить("" +Контрагент + ". Неизвестный вид контрагента!");
КонецЕсли;Полное описание, параметры и ограничения
ПеречислениеСсылка.<Имя перечисления>.Пустая (EnumRef.<Enumeration name>.IsEmpty)
ПеречислениеСсылка.<Имя перечисления> (EnumRef.<Enumeration name>)
Пустая (IsEmpty)
Доступен, начиная с версии 8.0.
Синтаксис:
Пустая()
Возвращаемое значение:
Тип: Булево.
Истина - ссылка не указывает ни на какой объект (пустая ссылка); Ложь - в противном случае.
Описание:
Определяет, является ли ссылка пустой или нет.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Пример:
ВидКонтрагента = Контрагент.Вид;
Если ВидКонтрагента.Пустая() Тогда
Сообщить("" +Контрагент + ". Неизвестный вид контрагента!");
КонецЕсли;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Выбрать типизированный статус в полностью созданном поле формы
Список для выбора получаем от менеджера перечисления с обязательными параметрами. В реквизите формы хранится значение перечисления, не подпись.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу с именем корня конфигурации Учебная85. Не меняйте рабочие конфигурации ради этого примера.
Перечисления → Добавить: УчебныйСтатус, синоним Учебный статус. Значения в порядке Черновик, Готов, Отменен; синонимы соответственно Черновик, Готов к проверке, Отменён.
Модуль менеджера оставьте пустым, формы/макеты не добавляйте. Обновите конфигурацию базы данных.
Код без директив вставляется в тело ВыполнитьПример() Экспорт серверного общего модуля УчебныеЗадачи. Полный модуль формы вставляется отдельно по подготовке формы.
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Метаданные.Перечисления.Найти("УчебныйСтатус") = Неопределено Тогда
ВызватьИсключение "Подготовьте собственное перечисление УчебныйСтатус";
КонецЕсли;
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("ПеречислениеСсылка.УчебныйСтатус");
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = Перечисления.УчебныйСтатус.Черновик;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебный статус";
Поле.КнопкаОчистки = Истина;
Поле.РежимВыбораИзСписка = Истина;
ПараметрыВыбора = Новый Структура("Отбор,СтрокаПоиска", Новый Структура, Неопределено);
Список = Перечисления.УчебныйСтатус.ПолучитьДанныеВыбора(ПараметрыВыбора);
Для Каждого Элемент Из Список Цикл
Поле.СписокВыбора.Добавить(Элемент.Значение, Элемент.Представление);
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить статус";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера.Пустая() Тогда
Сообщить("Учебный статус не выбран; ничего не записано.");
Возврат;
КонецЕсли;
Сообщить(ТипЗнч(ЗначениеПримера) = Тип("ПеречислениеСсылка.УчебныйСтатус"));
Сообщить(ЗначениеПримера = Перечисления.УчебныйСтатус.Готов);
Сообщить("Представление: " + Строка(ЗначениеПримера));
КонецПроцедуры
Разбор по шагам
До создания реквизита проверяем собственную учебную конфигурацию и наличие перечисления.
ПолучитьДанныеВыбора получает структуру с Отбор и СтрокаПоиска, даже когда поиск и отбор пустые.
СписокВыбора наполняем типизированными значениями и их представлениями. Начальное значение Черновик задано явно.
КнопкаОчистки возвращает пустое значение перечисления, которое обрабатывается отдельной веткой.
Проверяем тип и сравниваем с конкретным значением Готов, не с текстом подписи.
Как проверить результат
Выберите Готов к проверке: оба сравнения Истина, представление Готов к проверке.
Выберите Черновик: проверка типа Истина, сравнение с Готов Ложь — это ожидаемо.
Очистите поле: сообщение о невыбранном статусе, обращений к базе записи нет.
Ожидаемый результат
Рабочее поле выбора с реальным типом перечисления и корректной обработкой пустого состояния.
На что обратить внимание
Это не универсальная строковая выпадающая коллекция: реквизит имеет конкретный тип учебной конфигурации.
Представления списка могут зависеть от языка интерфейса.
Изменение поля относится только к памяти формы, не к статусам рабочих заказов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Перебрать учебные статусы и отличить значение от его позиции
Перечисление хранит значения метаданных, а не произвольные строки. Пустая ссылка — отдельное состояние, не Черновик.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу с именем корня конфигурации Учебная85. Не меняйте рабочие конфигурации ради этого примера.
Перечисления → Добавить: УчебныйСтатус, синоним Учебный статус. Значения в порядке Черновик, Готов, Отменен; синонимы соответственно Черновик, Готов к проверке, Отменён.
Модуль менеджера оставьте пустым, формы/макеты не добавляйте. Обновите конфигурацию базы данных.
Код без директив вставляется в тело ВыполнитьПример() Экспорт серверного общего модуля УчебныеЗадачи. Полный модуль формы вставляется отдельно по подготовке формы.
Если Метаданные.Перечисления.Найти("УчебныйСтатус") = Неопределено Тогда
ВызватьИсключение "Подготовьте собственное перечисление УчебныйСтатус";
КонецЕсли;
Менеджер = Перечисления.УчебныйСтатус;
Сообщить(Менеджер.Количество() = 3);
Готов = Менеджер.Готов;
Сообщить(Менеджер.Индекс(Готов) = 1);
Сообщить(Менеджер.Получить(1) = Готов);
Сообщить(Не Готов.Пустая());
Сообщить(Менеджер.ПустаяСсылка().Пустая());
Сообщить(Готов.Метаданные().Имя = "УчебныйСтатус");
Для Каждого Значение Из Менеджер Цикл
Сообщить("Позиция " + Строка(Менеджер.Индекс(Значение)) + ": " + Строка(Значение));
КонецЦикла;
Сообщить(Готов = Перечисления.УчебныйСтатус.Готов);Разбор по шагам
Количество/Получить/Индекс работают с порядком значений, заданным в Конфигураторе.
Индекс начинается с нуля, поэтому Готов в подготовленном порядке имеет позицию 1.
Строка(Готов) показывает представление Готов к проверке, а само значение имеет тип ПеречислениеСсылка.УчебныйСтатус.
ПустаяСсылка не равна автоматически Черновику. Проверять заполнение нужно через Пустая.
Сравниваем типизированные значения перечисления, не строки их изменяемых синонимов.
Как проверить результат
Все семь булевых проверок Истина.
Выводятся три позиции и синонимы в порядке подготовки.
В рабочих документах и регистрах ничего не меняется.
Ожидаемый результат
Показаны реальные значения перечисления, их позиции и пустое состояние.
На что обратить внимание
Позиция 1 может измениться при изменении порядка метаданных. Не храните индекс как долговременный внешний код.
Синоним можно перевести/переименовать, поэтому сравнение Строка(Статус) = "Готов к проверке" хрупкое.
УчебныйСтатус существует только в специально созданной схеме.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.