Получить перечисление на клиенте

Во время работы часто встречается ситуация, когда на клиенте нужно получить значение перечисления. Уходить на сервер ради одного этого действия не хочется, но получить как-то перечисление нужно.

&НаСервере
Функция ВернутьСтатусДоработка()
	Возврат Перечисления.СтатусыЗадач.Доработка;
КонецФункции

Это конечно решает задачу, но становится много лишнего кода, лишних функций и тяжело читать такой код.

На этот случай в 1с предусмотрена функция ПредопределенноеЗначение при программировании на английском он называется PredefinedValue.

Функция ПредопределенноеЗначение

Синтаксис:

ПредопределенноеЗначение(ПолныйПутьКДанным)
PredefinedValue(FullDataPath)

Возвращаемые значение: Ссылка на объект.

Параметры:

Описание: Возвращает ссылку на предопределенный элемент из предопределенных данных, прикладных перечислений и точек маршрута бизнес-процессов, а также значения системных перечислений.

Внимание! Функция доступна в платформе 8.2.9 и выше.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание. Вызов метода выполняет обращение к серверу.

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

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

Получить перечисление на клиенте

&НаКлиенте
Процедура СтатусПриИзменении(Элемент)
	Если Объект.Статус = ПредопределенноеЗначение("Перечисление.СтатусыЗадач.Доработка") Тогда
		// Код программы
	КонецЕсли;
КонецПроцедуры

Получить справочник на клиенте

ВалютаРубль = ПредопределенноеЗначение("Справочник.Валюта.Рубль");

Получить пустую ссылку на документ на клиенте

ПустаяСсылкаНаДокумент = ПредопределенноеЗначение("Документ.РасходнаяНакладная.ПустаяСсылка");

Получение точки маршрута бизнес процесса на клиенте

БПТочка_Отказ = ПредопределенноеЗначение("БизнесПроцесс.Согласование.ТочкаМаршрута.Отказ");

Теперь вы знаете не только как получить перечисление на клиенте, но и как получить документ, справочник или бизнес-процесс. Учите программирование, если есть какие-то вопросы добро пожаловать в комментарии.

Материалы по теме:

1. Как использовать перечисление в форме справочника? — заметка на итс
2. Руководство разработчика Работа с предопределенными значениями — книга на итс
3. Использование предопределенных документов — реализация прикладных систем
4. Учимся программировать — другие уроки на сайте