Печать (Ctrl+P)

Работа с предопределенными значениями с помощью менеджера объекта

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

ТипПредопределенногоЗначения.ИмяОбъектаМетаданных.Значение

● ТипПредопределенногоЗначения – для получения предопределенных значений доступно указание следующих типов данных (написание во
множественном числе):
● Справочники,
● ПланыВидовХарактеристик,
● ПланыСчетов,
● ПланыВидовРасчета,
● Перечисления.
● ИмяОбъектаМетаданных

● Значение – может быть одним из следующих:
● для перечислений указывается имя значения перечисления;

● ТочкиМаршрута.ИмяТочки – точка маршрута бизнес-процесса.
В случае, если требуется получить точку маршрута бизнес-процесса, строка, описывающая получаемое значение, будет выглядеть следующим образом:

БизнесПроцессы.ИмяОбъектаМетаданных.ТочкиМаршрута.ИмяТочкиМаршрута
Пример:

Вид = Перечисления.ВидыТоваров.Товар;
// Получение предопределенных данных справочника.
Элемент = Справочники.Валюта.Рубль;
// Точка маршрута бизнес-процесса
Точка = БизнесПроцесс.Согласование.ТочкиМаршрута.Одобрение;

Работа с предопределенными значениями С помощью функции ПредопределенноеЗначение()

В связи с тем, что на стороне клиента недоступны прикладные объекты, получение предопределенных реквизитов с помощью менеджеров объектов становится невозможным. Поэтому для их получения существует метод глобального контекста ПредопределенноеЗначение(). Параметром этого метода является строка, описывающая то, какое предопределенное значение требуется получить. Синтаксис описания предопределенного значения совпадает с синтаксисом оператора ЗНАЧЕНИЕ языка запросов.
Строка, определяющая получаемый реквизит, имеет следующий вид:

Рассмотрим составляющие этой строки подробнее:
● ТипПредопределенногоЗначения – для получения предопределенных значений доступно указание следующих типов данных (написание в
единственном числе):
● Справочник ,
● ПланВидовХарактеристик ,
● ПланСчетов ,
● ПланВидовРасчета ,
● Перечисление,
● БизнесПроцесс .
● ИмяОбъектаМетаданных – указывается имя объекта метаданных так, как оно задано в конфигураторе.
● Значение – может быть одним из следующих

● для перечислений указывается имя значения перечисления;
● для получения предопределенного значения указывается его имя, как оно задано в конфигураторе;
● ТочкаМаршрута.ИмяТочки – точка маршрута бизнес-процесса;
● ПустаяСсылка – для получения пустой ссылки.
В случае необходимости получить значение системного перечисления параметр метода будет выглядеть следующим образом:
ИмяСистемногоПеречисления.ЗначениеСистемногоПеречисления.
Например:

ТипДиаграммы = ПредопределенноеЗначение(“ТипДиаграммы.ВогнутаяПоверхность “);
В случае если требуется получить точку маршрута бизнес-процесса, строка, описывающая получаемое значение, будет выглядеть следующим образом:
Пример:

// Получение значения перечисления.
Вид = ПредопределенноеЗначение (“Перечисление.ВидыТоваров.Товар”);
// Получение значения пустой ссылки.
ПустаяСсылка =
ПредопределенноеЗначение (“Документ.РасходнаяНакл.ПустаяСсылка”);
// Получение предопределенных данных справочника.
Элемент = ПредопределенноеЗначение (“Справочник.Валюта.Рубль”);
// Точка маршрута бизнес-процесса
Точка = ПредопределенноеЗначение (“БизнесПроцесс.Согласование. ТочкаМаршрута.Одобрение”);

На четвертом уроке нашего мы продолжим знакомиться с программой . Сегодня мы на практических примерах познакомимся с и ерархическими справочниками, а также научимся создавать предопределенные элементы .

Хронометраж 4 урока курса:

00:19 Изменения в справочнике Сотрудники после выполнения домашнего задания по 3 уроку курса
00:35 Редактирование порядка следования реквизитов в справочниках
02:54 Создание справочника Номенклатура
03:40 Создание и настройка иерархического справочника
05:10 Создание групп Услуги и Товары в справочнике Номенклатура
06:05 Заполнение справочника Номенклатура
07:14 3 способа переноса элемента справочника в другую группу
08:21 Создание справочника Склады
09:19 Создание предопределенных элементов справочника
11:25 Заполнение справочника Склады
12:20 Пройти тест по материалу 4 урока

Иерархический справочник – справочник с возможностью иерархического расположения его элементов. Например, в справочнике Номенклатура могут быть созданы группы: Товары, Услуги и т.д., в которых располагаются элементы, относящиеся к этим группам. Кроме того группы справочника могут включать в себя и другие группы, создавая тем самым многоуровневую иерархическую структуру.

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

Формы справочника – визуальное представление справочника. В зависимости от того, какие именно действия мы хотим выполнить с нашим справочником, нам требуется отображать справочник в «различных видах». Так, на 4 уроке курса мы с вами редактировали порядок следования реквизитов в форме списка и в форме элемента справочника.

Система создает (генерирует) формы автоматически, но, при необходимости, разработчик можем «рисовать» формы самостоятельно.

Всего для справочников существует 5 форм (типов форм):

• форма элемента – для создания или редактирования элемента справочника;
• форма группы - для создания или редактирования группы справочника;
• форма списка – для отображения списка элементов справочника;
• форма выбора - используется, чтобы в поле некой формы выбрать один из элементов данного справочника. Например, чтобы в документе Поступление товара в поле склад выбрать конкретный склад из справочника Склады;
• форма выбора групп – используется, чтобы в поле некой формы выбрать одну из групп данного справочника.

Предопределенные элементы справочника – элементы справочника, создаваемые разработчиком в режиме Конфигуратора, и к которым можно обращаться из встроенного языка 1с по Имени.

Между обычными и предопределенными элементами справочника существует принципиальная разница. Обычные элементы непостоянны в конфигурации. В процесс работы пользователя они могут создаваться, редактироваться и удаляться и, именно поэтому, на них не следует полагаться при выполнении каких-либо алгоритмов (код и наименование элемента может изменяться пользователем). Предопределенные элементы, напротив, постоянные. В процессе работы, даже если пользователь переименует такой элемент, к нему можно будет обращаться из встроенного языка 1с. Это достигается за счет того, что у предопределенного элемента есть реквизит Имя , который недоступен пользователю. У обычных элементов справочника такого реквизита нет.

Важно! Технически пользователь имет возможность удалить предопределенный элемент справочника, но, как правило, пользователям отключают права на удаление предопределенных элементов справочника.

Домашнее задание по 4 уроку курса

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

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

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

К тому же, если привязываться к наименованию или коду элементов справочника, то при получении ссылки на элемент всегда будет осуществляться поиска в таблице справочника. Не смотря на то, что стандартные реквизиты системы индексируются СУБД, поиск по ним в некоторых случаях может занимать значительные ресурсы. К тому же, рациональнее было бы не выполнять поисковой запрос по таблице справочника, если, скажем так, ссылка на элемент и так "заранее известна".

Как выход, можно хранить ссылку на каждый часто используемый элемент справочника "Типы цен номенклатуры" в отдельных константах и получать из них значения в запросе. Однако, в таком случае разработчику придется добавлять отдельную константу для каждого подобного элемента. Ситуация значительно усложнится, если такие элементы будут не только в справочнике "Типы цен номенклатуры", но и в других справочниках ("Категории объектов", "Качество", "Номенклатура" и другие). Тогда количество констант в системе может увеличиться в несколько раз!

Конечно можно было бы добавить предопределенные элементы в каждый из справочников и обращаться к ним стало бы намного проще. Однако изменение типовых объектов привело бы к усложнению процесса обновления конфигурации из пакетов поставщика.

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

Универсальное решение

Суть универсального решения будет заключаться в следующем: будет создан справочник, в который разработчиком будут добавляться предопределенные элементы. В справочник добавлен реквизит "Значение", тип которого зависит от значений, для которых будет создаваться соответствие "Предопределенный элемент справочника -> Связанной значение". Структура метаданных справочника выглядит следующем образом (см. следующий скриншот).

Для получения предопределенного элемента наилучшим вариантом является использование глобального метода "ПредопределенноеЗначение(<Имя>)" . В качестве параметра в метод передается полный путь к предопределенному элементу. Синтаксис похож на функцию языка запросов "ЗНАЧЕНИЕ()" .

Для удобства разработки рекомендую вынести функцию для получения связанного с предопределенным элементом значения в общий модуль. В тестовой конфигурации, доступной для скачивания по ссылке в конце статьи, создан общий модуль "ЗначенияПредопределенныхЭлементов" с экспортной функцией "ПолучитьЗначениеПредопределенногоЭлемента(<ИмяПредопределенногоЭлемента>)" . Программный код функции получает ссылку на предопределенный элемент, затем запросом получает значений реквизита "Значение". На следующем скриншоте приведен полный листинг функции.

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

Влияние на производительность

Проводил тест на скорость для обоих вариантов поиска: по наименованию и по ссылке из предопределенного элемента. Поиск проходил по справочнику "Товары" с 20000 записей. При проведении тестов на файловой базе были получены следующие результаты:

Результаты показали, что для файлового варианта работы использование предопределенных элементов для получения часто используемых элементов других справочников работает медленнее практически в 4 раза!

В клиент-серверном варианте работы результаты тестов показывают совсем другую картину. Скорость получения ссылка на нужный элемент не снизилась значительно (один из тестов показал 0.002 сек. для поиска по наименованию и 0.0008 сек. при работе через предопределенный элемент), однако надежность работы программы увеличилась в разы!

Выводы

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

За время работы с платформой не раз встречался с ситуациям, когда после изменения наименования, например у элемента справочника "ТипыЦенНоменклатуры", слетала работа у большинства не типовых отчетов.

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

Кроме того, данный подход позволят не изменять типовые объекты конфигурации, если необходимо добавить в них предопределенный элемент. В дальнейшем это сделает процесс обновления конфигурации несколько проще.

Файлы для загрузки:

1. Выгрузка тестовой базы с примерами из статьи.

Действует для версии платформы 1С:Предприятие 8.3.3 и выше без режима совместимости с версией 8.2

1.1. В справочниках, планах счетов, планах видов характеристик и планах видов расчета имеется возможность создавать предопределенные элементы автоматически или программно.

1.2. В большинстве случаев, предопределенные элементы рекомендуется создавать автоматически, поскольку они постоянно нужны и требуется упростить обращение к этим элементам из кода.
Например, предопределенная страна Россия в справочнике Страны мира , предопределенные профиль групп доступа Администратор и т.п.

Для этого

• в свойстве справочника, плана счетов , плана видов характеристик или плана видов расчета должно быть установлено значение Авто (по умолчанию), а также не следует допускать программных вызовов метода УстановитьОбновлениеПредопределенныхДанных этих объектов для переключения этого режима.
• запретить удаление предопределенных элементов пользователями, выключив во всех ролях следующие права (по умолчанию выключены):
  • ИнтерактивноеУдалениеПредопределенныхДанных
  • ИнтерактивнаяПометкаУдаленияПредопределенныхДанных
  • ИнтерактивноеСнятиеПометкиУдаленияПредопределенныхДанных
  • ИнтерактивноеУдалениеПомеченныхПредопределенныхДанных

1.3. Исключение составляют дочерние узлы РИБ, в котором предопределенные элементы автоматически не создаются (и не обновляются при изменении в метаданных), а должны быть переданы из главного узла вместе с изменениями конфигурации.

При этом:

а) конфигурация должна обеспечивать загрузку сообщения обмена в подчиненный узел РИБ до выполнения другого прикладного кода, который обращается к получаемым из главного узла предопределенным элементам;

б) в прикладной логике загрузки данных из главного узла (обработчик события ПриПолученииДанныхОтГлавного , правила регистрации объектов) следует избегать обращений к предопределенным элементам, поскольку нет гарантии, что они уже были загружены из сообщения обмена;

в) код обработчиков обновления ИБ, который обрабатывает предопределенные элементы, не должен выполняться в подчиненных узлах РИБ:

При использовании в конфигурации подсистемы "Обмен данными" Библиотеки стандартных подсистем (БСП) версии 2.1.4 и выше требования (а) и (б) снимаются.

1.4. Для таблиц с предопределенными элементами, которые не входят в состав плана обмена РИБ (и на которые не ссылаются другие таблицы, входящие в состав плана обмена РИБ) рекомендуется устанавливать свойство ОбновлениеПредопределенныхДанных в значение ОбновлятьАвтоматически , а также при первом запуске подчиненного узла РИБ устанавливать автоматическое обновление в данных с помощью вызова:

Справочники. ИмяСправочника> . УстановитьОбновлениеПредопределенныхДанных(ОбновлениеПредопределенныхДанных. ОбновлятьАвтоматически) ;

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

Например, те или иные предопределенные виды расчетов в плане видов расчета Начисления зависят от значений функциональных опций ИспользоватьУчетВремениСотрудниковВЧасах , ИспользоватьСдельныйЗаработок и др.

Для этого

• в свойстве ОбновлениеПредопределенныхДанных справочника, плана счетов, плана видов характеристик или плана видов расчета нужно установить в значение "Не обновлять автоматически"
• предусмотреть код создания (и пометки недействительным) предопределенного элемента в зависимости от бизнес-логики, например:

• учитывать в прикладном коде отсутствие предопределенных элементов в ИБ. В противном случае, при обращении к несуществующему предопределенному элементу из кода или текста запроса будет вызвано исключение:

При использовании в конфигурации Библиотеки стандартных подсистем (БСП) версии 2.1.4 и выше рекомендуется использовать функцию ПредопределенныйЭлемент общего модуля ОбщегоНазначенияКлиентСервер , которая возвращает Неопределено для несуществующих в ИБ предопределенных элементов.