Что такое предопределенные элементы
Использование предопределенных элементов
Область применения: управляемое приложение, мобильное приложение, обычное приложение.
Действует для версии платформы 1С:Предприятие 8.3.3 и выше без режима совместимости с версией 8.2
1.1. В справочниках, планах счетов, планах видов характеристик и планах видов расчета имеется возможность создавать предопределенные элементы автоматически или программно.
Область применения (уточнение): управляемое приложение, обычное приложение.
1.3. Исключение составляют дочерние узлы РИБ, в котором предопределенные элементы автоматически не создаются (и не обновляются при изменении в метаданных), а должны быть переданы из главного узла вместе с изменениями конфигурации.
а) конфигурация должна обеспечивать загрузку сообщения обмена в подчиненный узел РИБ до выполнения другого прикладного кода, который обращается к получаемым из главного узла предопределенным элементам;
в) код обработчиков обновления ИБ, который обрабатывает предопределенные элементы, не должен выполняться в подчиненных узлах РИБ:
При использовании в конфигурации подсистемы «Обмен данными» Библиотеки стандартных подсистем (БСП) версии 2.1.4 и выше требования (а) и (б) снимаются.
При включенном режиме совместимости с версией 8.3.3 также необходимо при первом запуске подчиненного узла РИБ (сразу после того, как была обновлена его конфигурация) устанавливать автоматическое обновление в данных с помощью вызова:
2. В некоторых случаях, предопределенные элементы не требуется создавать автоматически, если их наличие зависит от какого-либо условия: включенной функциональной опции, режима работы программы и т.п.
Предопределенные элементы в 1С 8.3
Предопределенные элементы
Предопределенные элементы — это элементы справочников, планов видов характеристик, планов счетов или планов видов расчета, которые создаются в конфигураторе.
Чтобы создать предопределенный элемент в справочнике нужно на закладке Прочее нажать на кнопку Предопределенные:
Или в дереве метаданных выбрать в контекстном меню пункт Открыть предопределенные данные:
В списке предопределенных данных можно добавлять новые элементы или группы (если справочник иерархический). При создании нужно указать имя предопределенного элемента:
В пользовательском режиме у предопределенного элемента отличается значок:
Основное предназначение предопределенных элементов это возможность обращаться к ним в алгоритмах на встроенном языке:
Связь с предопределенным элементом
В таблице справочника есть два стандартных реквизита: Предопределенный и ИмяПредопределенныхДанных. Если элемент предопределенный, то у него реквизит Предопределенный = Истина, а в реквизите ИмяПредопределенныхДанных находится имя предопределенного элемента из конфигуратора. Именно через реквизит ИмяПредопределенныхДанных выполняется связь предопределенного элемента в конфигураторе и элемента справочника в базе данных.
Для того чтобы элемент справочника перестал быть предопределенным, нужно в реквизит ИмяПредопределенныхДанных записать пустую строку:
После этого элемент «Доставка» будет отображаться с обычным значком:
Если сейчас в коде выполнить:
То мы получим ошибку «Предопределенный элемент отсутствует в данных», потому что на данный момент ни один из элементов справочника не связан с предопределенным элементом.
Чтобы исправить нужно у одного из элементов справочника заполнить реквизит ИмяПредопределенныхДанных. Например, сделаем это у бинокля:
Теперь бинокль отображается в списке с другим значком:
И если обратиться к предопределенному элементу Доставка, то будет получена ссылка на бинокль.
В одном справочнике не может быть более одного элемента с одним значением реквизита ИмяПредопределенныхДанных. Если попробовать присвоить реквизиту ИмяПредопределенныхДанных для элемента Доставка значение Доставка, то будет выброшено исключение «Предопределенный элемент не уникален».
Для получения списка всех предопределенных элементов можно воспользоваться методом ПолучитьИменаПредопределенных, который вернет массив строк со всеми именами предопределенных элементов:
Удаление предопределенного элемента
Если позволяют права доступа, то в пользовательском режиме можно удалить предопределенный элемент справочника. Тогда нельзя будет обращаться в коде к связанному предопределенному элементу.
Если удалить предопределенный элемент в конфигураторе, то связанный с ним элемент справочника будет помечен на удаление.
Восстановление предопределенных элементов
Может так случиться, что какой-то предопределенный элемент был случайно удален из базы в пользовательском режиме. А обращения к нему программно остались. Тогда будет возникать ошибка «Предопределенный элемент отсутствует в данных». Для восстановления предопределенных элементов можно выполнить следующий код:
Или нужно вручную связать уже имеющийся элемент через заполнение реквизита ИмяПредопределенныхДанных.
Предопределенное значение на клиенте
Для получения предопределенного элемента на клиенте нужно использовать функцию ПредопределенноеЗначение:
Также есть обратная функция ПолучитьПолноеИмяПредопределенногоЗначения, которая доступна как на клиенте, так и на сервере. Она возвращает полное имя предопределенного элемента по ссылке на предопределенный элемент:
Обновление предопределенных данных
На закладке Прочее есть настройка Обновление предопределенных данных:
Данная настройка может принимать 3 значения:
Обновлять автоматически означает, что при создании нового предопределенного элемента в конфигураторе автоматически будет создан связанный элемент в справочнике.
Если выбрано Не обновлять автоматически, то связанный элемент не будет создаваться автоматически, его нужно будет создать и связать с предопределенным вручную.
При этом если предопределенный элемент был создан при настройке Обновлять автоматически, то у связанного с ним элемента справочника будет автоматически обновляться реквизит ИмяПредопределенныхДанных. То есть если изначально был создан предопределенный элемент с именем «Доставка» и для него автоматически был создан связанный элемент справочника, то если в конфигураторе переименовать предопределенный элемент в «ДоставкаТовара», то реквизит ИмяПредопределенныхДанных у связанного элемента обновится автоматически (даже если сейчас выбрано Не обновлять автоматически).
Авто означает, что используется системная настройка.
Данную настройку можно указать в трех местах: для таблицы базы данных, для объекта метаданных в конфигураторе и для всей информационной базы. Порядок определения значения следующий:
Для установки данной настройки для таблицы базы данных используется метод УстановитьОбновлениеПредопределенныхДанных:
Программирование в 1С для всех
У любого справочника 1С (кроме подчиненных) можно создавать предопределенный элемент или предопределенную группу этого справочника (если справочник иерархический). Предопределенные элементы справочника это элементы созданные разработчиком в конфигураторе, с которыми пользователь может работать. Пользователю уже не нужно самостоятельно создавать этот элемент справочника, он уже будет создан в базе по умолчанию при установке. Также разработчикам очень удобство работать с предопределенными элементами в том, что разработчик к ним может обращаться напрямую, используя менеджер справочника. В этой статье мы научимся работать с предопределенными элементами.
При разработке справочников, рекомендую, первым делом подумать будут ли предопределенные элементы у этих справочников, и создать их заранее, до того как этот справочник будет внедрен в опытную эксплуатацию.
К примеру, мы в нашей конфигурации для целей учета создали справочник Валюты, поскольку мы живем в Российской федерации, то валюта Рубль всегда будет в нашей конфигурации, которая используется на территории РФ. Поэтому наиболее логичнее её сделать в виде предопределенного элемента. Поэтому создадим для справочника Валюты предопределенный элемент Рубль. Для того, чтобы добавить предопределенный элемент необходимо выделить нужный справочник, вызвать контекстное меню и выбрать в этом меню команду «Открыть предопределенные данные».
Откроется список предопределенных элементов (и групп, если справочник иерархический), в котором можно добавлять новые элементы. Причем заметьте, при добавлении мы можем указать только наименование элемента и его код, если у справочника есть реквизиты, то мы эти реквизиты мы сможем заполнить только в пользовательском режиме.
Обращаю внимание на имя предопределенного элемента. Имя должно быть уникально в пределах этого справочника, и к нему применяются правила установки имен для объектов метаданных (отсутствие пробелов, спецсимволов кроме подчеркивания и т.д.). Пользователь не видит имени предопределенного элемента, он работает только с наименованием. С именем может работать разработчик, получая ссылку на конкретный предопределенный элемент, используя менеджер справочника.
Если справочник иерархический, то можно также создать и предопределенные группы, для этого в командной панели формы списка предопределенных элементов имеется команда «Добавить группу».
Если мы зайдем в форму списка справочника Страны в пользовательском режиме «1С: Предприятия», то обнаружим, что уже имеются группы и элементы с точкой внизу. Так платформа помечает предопределенные элементы и группы.
Замечу, что все реквизиты у предопределенных элементов присутствуют также как и у обычных, и в них можно записывать какие-либо значения.
Получить предопределенный элемент справочника 1С
Используя менеджер справочника, можно обратиться к предопределенному элементу. Делается это следующим образом.
Обращаю Ваше внимание, что получить ссылку на предопределенный элемент можно только в серверном контексте. Чтобы получить ссылку на предопределенный элемент в клиентском контексте управляемой формы необходимо использовать метод ПредопределенноеЗначение, где в кавычках нужно указать путь к этому элементу.
Имейте в виду, что и при помощи метода ПредопределенноеЗначение и при помощи прямого обращения посредством менеджера объекта мы получим ссылку на элемент, с которой можем работать как с обычной ссылкой на элемент справочника: присваивать её какому-нибудь реквизиту, получать объект из этой ссылки и т.д.
Создать предопределенный элемент справочника 1С
Мы уже научились создавать предопределенные элементы справочника в конфигураторе, но можно ли создать предопределенный элемент программно? И да, и нет.
Мы можем из простого элемента сделать предопределенный, и наоборот предопределенный элемент сделать простым.
Для этих целей у справочников имеется стандартный реквизит ИмяПредопределенныхДанных.
Если мы получим ссылку на предопределенный элемент, то этот реквизит заполнен.
Если же мы возьмем какой-то не предопределенный элемент, то этот реквизит будет пустой.
Если мы этому реквизиту присвоим какое-нибудь имя (помня об уникальности имен предопределенных элементов в контексте конкретного справочника), то мы программно «создадим» предопределенный элемент, но только в том случае если это имя уже существует в списке предопределенных элементов справочника, которые были заданы в конфигураторе 1С!
Например, тот же элемент «Тунис» справочника «Страны» у нас простой.
В какой-нибудь обработке напишем код, в котором попробуем сделать из этого элемента предопределенный элемент.
Если мы попытаемся его сейчас выполнить, то у нас возникнет ошибка «Предопределенный элемент не существует».
Такая ошибка возникла потому, что мы пытаемся указать имя предопределенного элемента, которого нет.
Если же мы у предопределенного элемента реквизиту ИмяПредопределенныхДанных присвоим пустую строку, то такой элемент станет простым, если же этому реквизиту обратно присвоим имя предопределенного элемента, то простой элемент станет предопределенным.
Сделаем на обработке две команды. Первая будет снимать предопределенность у элемента справочника с именем «Китай», а вторая устанавливать.
Теперь обратно установим.
Заметьте, что имя предопределенного элемента может быть только из списка имен предопределенных элементов справочника.
У нас до снятия элемент «Китай» был предопределенным.
А после снятия это стал простой элемент.
Удалить предопределенный элемент справочника 1С
Начиная с платформы 1С 8.3 предопределенные элементы можно удалять в пользовательском режиме.
Если сейчас этот элемент удалить через стандартную обработку «Удаление помеченных объектов», то он исчезнет из базы.
Для того, чтобы пользователь мог удалить (поставить пометку на удаление) предопределенный элемент, хотя бы у одной роли, которая есть в профиле пользователя должно быть установлено соответствующее право.
Что делать, если мы ошиблись и хотим опять «вернуть» предопределенный элемент? Есть несколько способов. Но самый простой это создать новый элемент справочника в пользовательском режиме и присвоить ему имя удаленного предопределенного элемента, как мы это уже делали.
Остальные статьи по теме конфигурирования:
Более подробно и основательно работа со справочниками, документами и другими объектами метаданных дается в моей книге:
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Вступайте в мои группы:
2 thoughts on “ Предопределенные элементы справочников 1С 8.3 ”
У любого справочника 1С можно создавать предопределенный элемент или предопределенную группу — если у справочника есть владелец, то создать предопределенный элемент нельзя.
Предопределенные элементы в «1С:Предприятие 8.3»
(бесплатная статья по Программированию в 1С)
из цикла статей «Первые шаги в разработке на 1С»
О чем эта статья
Эта статья продолжает цикл статей «Первые шаги в разработке на 1С». В ней на практических примерах рассматривается механизм предопределенных данных, в т.ч. и в распределенной информационной базе.
Применимость
В статье рассматривается платформа 1С:Предприятие версии 8.3.4.465. Материал актуален и для текущих релизов платформы.
Предопределенные элементы в «1С:Предприятие 8.3»
При реализации алгоритмов разработчики часто опираются на определенные данные – элементы справочников, планов счетов, планов видов расчета и т.д.
Во встроенном языке существуют методы для поиска данных, например, НайтиПоКоду() или НайтиПоНаименованию().
Однако алгоритмы, опирающиеся на код или наименование, зачастую являются ненадежными.
Поскольку в пользовательском режиме код или наименование элемента справочника могут быть изменены, что может привести к неработоспособности алгоритмов.
Именно для решения этой проблемы и предназначены предопределенные данные – данные, созданные в конфигураторе, обратиться к которым возможно по имени, не прибегая к предварительному поиску элемента.
Таким образом, у предопределенных данных есть две “стороны”: во-первых, существует список предопределенных элементов, созданный в конфигураторе, а, во-вторых, для данных информационной базы указывается, является ли конкретный элемент предопределенным.
Предопределенные элементы могут быть созданы у:
В статье рассмотрены новшества, касающиеся предопределенных данных на платформе 8.3, а также особенности работы с ними в распределенных базах (как центральных, так и периферийных) и в информационных базах в режиме разделения данных.
Для примера, создадим в справочнике Организации предопределенный элемент ОсновнаяОрганизация: 
Для увеличения нажмите на изображение.
Обращение к этому элементу из программного кода будет следующим:
В платформе 8.3 реализована возможность связать предопределенные данные с элементами соответствующего типа.
Для этого у объектов, которые могут иметь предопределенные элементы (они указаны выше), добавлено новое свойство ИмяПредопределенныхДанных. Оно отображается в списке стандартных реквизитов:
Выберем при помощи запроса все поля из справочника Организации:
Для увеличения нажмите на изображение.
На рисунке видно, что в поле ИмяПредопределенныхДанных указан именно тот идентификатор, который мы ввели в режиме конфигуратора.
Предопределенный элемент в списке отображается специальной пиктограммой:
Чтобы “отсоединить” элемент данных от элемента предопределенных данных, нужно присвоить свойству ИмяПредопределенныхДанных пустую строку и записать элемент:
Пиктограмма в списке изменилась:
Теперь предопределенный элемент существует только в конфигурации и в данных нет элемента, привязанного к идентификатору ОсновнаяОрганизация:
Для увеличения нажмите на изображение.
Обращение из программного кода к предопределенному элементу вызовет исключение:
Чтобы связать предопределенный элемент с новой записью, нужно присвоить свойству ИмяПредопределенныхДанных имя предопределенного элемента:
Работа с предопределенными элементами справочников в 1С
Все мы не раз работали с предопределенными элементами справочников в 1С, но мало кто задавался вопросом, что это и зачем.
1. Что такое Предопределенный элемент в 1С
Предопределенный элемент в 1С – это уже готовый элемент справочника, с которым можно работать в режиме предприятия. Для примера возьмем справочник «Подразделения» или «Склады» (в других конфигурациях он может называться «Структурные единицы»).
Когда мы только заполняем базу данными и заходим в справочники, то видим, что там уже есть один элемент. И этот элемент необходимо будет подправить под Ваши требования.
Предопределенный элемент в 1С – это та самая «Ваша запись» в этом справочнике, но наперед созданная разработчиками купленного Вами программного продукта. Потому и лучше всего использовать эти элементы для работы в программе.
На скриншоте Вы видите, как выглядит предопределенный элемент в 1С. Его легко узнать по особенной картинке записи.
2. Польза для разработчиков от предопределенных элементов в 1С
Итак, какая же польза разработчикам от этих от предопределенных элементов в 1С? Скажу Вам, как разработчик, огромная польза. Использование этих элементов улучшает качество формы кода в 1С и позволяет ускорить его выполнение.
К примеру, возьмем запись в регистр сведений «Цены номенклатуры». И нам необходимо записать в этот регистр цену по определенному виду цен. Данная задача не займет много времени, но необходимо учесть, что чем лучше Вы напишите свой код, тем быстрее он выполнится, и тем меньше пользователь будет волноваться о результате. Итак, вот наш код:
Приведенный мною пример один из самых простых вариантов использования предопределенных элементов в 1С.
Как Вы видите, обращение к предопределенному элементу в 1С происходит просто «Справочники.ВидыЦен.Закупочная». Это и весь код обращения к нему.
Но такое работает только, когда предприятие использует обычные формы кода в 1С или когда в управляемой форме код в 1С выполняется на сервере. В этом случае этот код будет работать отлично.
На «клиенте» нужно немного по-другому писать обращение к элементу. Вот так: «ПредопределенноеЗначение(«Справочник.ВидыЦен.Закупочная»)». Если использовать именно такую форму кода в 1С, он будет корректно выполняться. В ином случае, просто будет выдаваться сообщение об ошибке и будет прекращено выполнение Вашего кода.
Вариантов использования предопределенных элементов в 1С масса. Например, на обычных формах они могут еще использоваться как дополнительные значения настроек пользователя или как дополнительное право для работы с документом, справочником.
В управляемых формах уже отошли от дополнительных прав и настроек, поэтому в них Вы такого функционала не увидите. Но зато появился новый функционал и доступ к нему дают как раз эти элементы. К примеру, предопределенный элемент в 1С используется для того чтобы знать, какие справочники имеют право работать с дополнительными реквизитами объектов в 1С.
Еще один момент хочу сказать, предопределенные элементы в 1С есть не только у справочников, но и в некоторых других объектах конфигурации в 1С.
Предопределенные элементы в 1С – это чудесный инструмент, который нам помогает очень быстро и качественно выполнять свою работу.