Система компоновки данных позволяет работать с характеристиками — дополнительными свойствами объектов, определяемыми вне конфигурации. В данной статье описываются особенности работы с данным механизмом.
Содержание
Описание характеристик
Характеристики в системе компоновки данных описываются в тексте запроса набора данных специальной инструкцией системы компоновки данных, начинающейся с ключевого слова ХАРАКТЕРИСТИКИ .
В данном примере описываются характеристики для полей типа Справочник.Номенклатура .
В описании характеристики указывается:
- Тип, для которого определяются характеристики
- Описание списка характеристик
- Описание значений характеристик
Тип, для которого определяются характеристики
Характеристики описываются для определенного типа. Например, можно описать характеристики для типа Справочник.Номенклатура , при этом система автоматически будет использовать эти характеристики для всех полей запроса, которые имеют тип Справочник.Номенклатура , включая и реквизиты полей.
Возможно описание характеристики для составного типа. При этом характеристики будут применяться ко всем полям, в типе значений которых есть хотя бы один из типов, для которых описаны характеристики.
В предложении ХАРАКТЕРИСТИКИ тип указывается в скобках после ключевого слова ТИП . Синтаксис описания типа такой же, как в описании типа конструкции ВЫРАЗИТЬ языка запроса. Типы, входящие в составной тип перечисляются через запятую.
Описание списка характеристик
Для того чтобы система компоновки данных выдала пользователю список полей — характеристик, необходимо описать, откуда получать список характеристик.
О каждой характеристике системе необходимо знать следующую информацию:
- Идентификатор — внутренний идентификатор характеристики — по данному свойству характеристика будет находиться в списке значений характеристик. Идентификатор может иметь любой тип, для которого может использоваться сравнение в языке запросов.
- Имя характеристики — имя, под которым пользователь вводил характеристику. Например, масса, длина, рост и т.п. Значение этого свойства будет использоваться в качестве имени поля, создаваемого для характеристики.
- Тип значения характеристики — значения какого типа могут содержаться в характеристике. Данная информация используется, в отборе для фильтрации по полю — характеристике. Может иметь тип ОписаниеТипов , либо произвольное значение. В случае если тип значения содержит описание типов, то данное описание типов будет использовано как тип значения характеристики. Если тип значения содержит произвольное значение, то типом характеристики будет тип данного значения. Например, если в качестве типа значения используется числовое значение, то типом характеристики будет Число . Если тип значения характеристики не указан, то типом будет считаться тип Булево .
Описание списка характеристик используется на этапе редактирования настроек, для получения списка характеристик для создания полей — реквизитов. Для каждой характеристики из списка будет создан новый реквизит для поля определенного типа.
Рассмотрим пример. Будем описывать характеристики для поля типа Справочник.Номенклатура .
Допустим, в нашей конфигурации есть план видов характеристик ВидыДопСвойств , содержащий следующие записи:
| Ссылка | ПометкаУдаления | Предопределенный | Код | Наименование | ТипЗначения | |
|---|---|---|---|---|---|---|
| Масса | ложь | ложь | 000000001 | Масса | Число | |
| Ширина | ложь | ложь | 000000003 | Ширина | Число | |
| Высота | ложь | ложь | 000000004 | Высота | Число | |
В качестве идентификатора характеристики будем использовать поле Ссылка . В качестве имени характеристик — Наименование . А в качестве типа значения — поле ТипЗначения .
Таким образом, система получит следующий список характеристик:
| Идентификатор | Имя | ТипЗначения | |
|---|---|---|---|
| Масса | Масса | Число | |
| Ширина | Ширина | Число | |
| Высота | Высота | Число | |
Пусть в отчете имеется поле Номенклатура , типа Справочник.Номенклатура . На основе списка характеристик система автоматически создаст для этого поля три поля: Масса , Ширина , Высота . Тип всех полей будет Число .
Как видно, данные поля отображаются в списке реквизитов поля Номенклатура и ничем не отличаются от обычных реквизитов.
Результат отчета, в который выводятся поля — характеристики, может выглядеть так:
| Номенклатура | Код | Масса |
|---|---|---|
| Лазерный принтер 5250197-203 Minolta-QMS | 0000031 | 5 800 |
| Лазерный принтер Canon LBP-810 | 0000030 | 4 300 |
| Лазерный принтер HP LaserJet 2200 | 0000032 |
В данном примере в отчет выводится характеристика Масса .
При описании списка характеристик можно указать, из какой таблицы информационной базы получать характеристики, либо указать запрос, результат исполнения которого будет использоваться для построения списка характеристик. В приведенном выше примере список характеристик можно напрямую получать из плана видов характеристик, т.к. данный план видов характеристик содержит только характеристики для номенклатуры. Однако, если бы в таблице содержались характеристики и для других справочников, то следовало бы воспользоваться запросом, в котором получать только характеристики номенклатуры.
Список характеристик описывается при помощи ключевых слов СПИСОК , ИДЕНТИФИКАТОР , ИМЯ , ТИПЗНАЧЕНИЯ . После ключевого слова СПИСОК идет имя таблицы, из которой получается список характеристик, либо в скобках текст запроса, при помощи которого получается список характеристик. После ключевых слов ИДЕНТИФИКАТОР , ИМЯ , ТИПЗНАЧЕНИЯ указываются имена полей для получения идентификатора, имени и типа значений характеристики соответственно.
В данном примере список характеристик получается из таблицы ПланВидовХарактеристик.ВидыДопСвойств . В качестве идентификатора характеристики используется поле Ссылка , в качестве имени характеристики используется поле Наименование , в качестве типа — поле ТипЗначения .
Пример с получением списка характеристик из запроса:
В конструкторе запросов характеристики описываются на закладке Характеристики .
На данном рисунке описаны характеристики для типа Справочник.Номенклатура . Список характеристик получается из таблицы ПланВидовХарактеристик.ВидыДопСвойств , в качестве идентификатора характеристики используется поле Ссылка , в качестве имени характеристики используется поле Наименование , в качестве типа — поле ТипЗначения .
При необходимости получения списка характеристик при помощи запроса, в конструкторе следует указать в качестве источника Запрос и создать запрос.
На данном рисунке список характеристик получается при помощи запроса, в котором получаются только записи, у которых не установлена пометка удаления. Указание полей происходит также как и в случае с таблицей, только используются не поля таблицы, а поля запроса.
Описание значений характеристик
При выполнении отчета системе компоновки необходимо получать значения выбранных пользователем характеристик.
Для получения характеристик системе необходима следующая информация:
- Из какой таблицы или запроса получать значения характеристик
- Поле — идентификатор характеристики. В данном поле будет искаться значение идентификатора, полученного в списке характеристик.
- Поле — идентификатор объекта. С данным полем будет осуществляться связь поля исходного запроса, для которого требуется получить значение характеристики.
- Поле — значение характеристики. Из данного поля будет получаться значение характеристики. Если поле — значение не указано, то значение характеристики будет иметь значение Истина , в случае, если в таблице будет найдена запись для характеристики объекта и Ложь в противном случае.
Рассмотрим пример. Пусть значения характеристик хранятся в регистре сведений ДопСвойства , который содержит следующие данные:
| Номенклатура | ВидСвойства | Свойство |
|---|---|---|
| Лазерный принтер 5250197-203 Minolta-QMS | Ширина | 630 |
| Лазерный принтер 5250197-203 Minolta-QMS | Высота | 320 |
| Лазерный принтер 5250197-203 Minolta-QMS | Масса | 5 800 |
| Лазерный принтер Canon LBP-810 | Масса | 4 300 |
| Лазерный принтер Canon LBP-810 | Ширина | 470 |
| Лазерный принтер Canon LBP-810 | Высота | 310 |
Идентификатором характеристики в данной таблице является поле ВидСвойства . Объектом — поле Номенклатура . А значение находится в поле Свойство . В запросе описание получения значений характеристик будет выглядеть так:
После ключевого слова ЗНАЧЕНИЯ указывается имя таблицы, из которой будут получаться значения характеристики, или, в скобках, текст запроса, при помощи которого будут получаться значения. После ключевого слова ОБЪЕКТ указывается имя поля, в котором содержится объект. После слова ХАРАКТЕРИСТИКА указывается поле — идентификатор характеристики, а поле ЗНАЧЕНИЕ — имя поля, из которого будут получаться значения характеристики.
При генерации макета компоновки данных компоновщик макета, для используемых в настройках полей — характеристик, создаст в результирующем запросе соединения с таблицей значений характеристик.
Пример. Пусть исходный запрос набора данных схемы компоновки данных содержал следующий запрос:
Пользователь указал, что в отчет нужно выводить поля Номенклатура , Номенклатура.Масса и Номенклатура.Высота .
Запрос, который сгенерирует компоновщик макета компоновки данных, будет выглядеть следующим образом:
Значения параметров: П = Масса, П2 = Высота
Видно, что в результирующий запрос, для каждой использованной характеристики, было добавлено соединение с таблицей, из которой получается значения характеристик. При этом, поле, описанное как идентификатор объекта ( ДопСвойства.Номенклатура ) связано с полем, для которого получаются значения характеристик ( РасходнаяНакладнаяСостав.Номенклатура ). Значение же поля — идентификатора характеристики ( ДопСвойства.ВидСвойства ) фильтруется по идентификатору характеристики, полученному из списка характеристик ( Масса, Высота ). В качестве значения характеристики, выдаваемого в результат запроса, используется поле, описанное как значение свойства: ДопСвойства.Свойство .
Использование категорий
При помощи механизма характеристик системы компоновки данных можно описывать и категории — характеристики, не имеющие значений, а имеющие лишь признак наличия/отсутствия.
Допустим, список категорий хранится в справочнике Категории , содержащей следующие записи:
| Ссылка | ПометкаУдаления | Предопределенный | Код | Наименование | |
|---|---|---|---|---|---|
| Импортные | ложь | ложь | 000000001 | Импортные | |
| Бухгалтерия | ложь | ложь | 000000002 | Бухгалтерия | |
В регистре сведений КатегорииНоменклатуры содержатся установленные категории номенклатуры:
| Номенклатура | Категория | |
|---|---|---|
| Принтер HP DeskJet 1500 | Импортные | |
| 1С:Бухгалтерия 7.7 Базовая версия | Бухгалтерия | |
| 1С:Бухгалтерия 7.7 Стандартная версия | Бухгалтерия | |
| 1С:Бухгалтерия ПРОФ версия 7.7 | Бухгалтерия | |
Тогда описание характеристик может выглядеть так:
Как видно, в описании характеристик не указано поле ТипЗначения , а в таком случае, считается, что характеристика имеет логический тип. Кроме того, не указано поле, из которого будет получаться значение характеристики. В таком случае считается, что значение характеристики Истина в случае, если характеристика для объекта присутствует в таблице значений характеристик и Ложь в противном случае.
При таких условиях в полях — реквизитах поля Номенклатура появятся дополнительные поля:
Если пользователь укажет, что поле Номенклатура.Бухгалтерия необходимо выводить в результат, то запрос в макете компоновки данных будет выглядеть следующим образом:
Как видно, запрос аналогичен запросу, формируемому для обычных характеристик. Исключение составляет получение значения характеристики. В данном случае это следующая конструкция:
Как видно, результатом данного выражения будет Истина , в случае если связь выполнилась, т.е. категория установлена, и Ложь в противном случае.
Значения типа Тип в запросах 1С могут использоваться при наложении условий, в сравнениях, упорядочивании и группировках. Для работы с типами предусмотрено несколько механизмов, которые покрывают все потребности разработчика. Рассмотрим их.
Функция ТИПЗНАЧЕНИЯ
Функция ТИПЗНАЧЕНИЯ имеет единственный параметр, куда передается значение, для которого требуется определить тип. Функция возвращает значения типа Тип. Чаще всего функция используется совместно с литералом ТИП в условиях запроса.
Рассмотрим примеры использования. Вывод в результат запроса типа Регистратора:
Закупки.Регистратор КАК Регистратор ,
ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) КАК ТипРегистратора
РегистрНакопления.Закупки КАК Закупки
Использование функции ТИПЗНАЧЕНИЯ в операции сравнения:
Закупки.Регистратор КАК Регистратор
РегистрНакопления.Закупки КАК Закупки
ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) = ТИП( Документ.ПриобретениеТоваровУслуг )
Литерал ТИП
В литерал ТИП передается имя примитивного типа или таблицы ссылочного типа. Результатом конструкции будет значение типа Тип.
Примеры имен типов:
ТИП(Строка)
ТИП(Число)
ТИП( Перечисление.СтавкиНДС )
ТИП( Справочник.Номенклатура )
ТИП( Документ.ПриобретениеТоваровУслуг )
ТИП( ПланСчетов.Хозрасчетный )
ТИП( ПланОбмена.Полный )
Использование в запросе:
Закупки.Регистратор КАК Регистратор ,
КОГДА ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) = ТИП( Документ.ПриобретениеТоваровУслуг )
ТОГДА «Приобретение товаров»
КОНЕЦ КАК ТипИсточника
РегистрНакопления.Закупки КАК Закупки
Оператор ССЫЛКА
Оператор позволяет проверить, является ли значение выражения, указанного справа от него, ссылкой на таблицу, указанную слева. Результат оператора — значение типа Булево.
Закупки.Регистратор КАК Регистратор
РегистрНакопления.Закупки КАК Закупки
Закупки.Регистратор ССЫЛКА Документ.ПриобретениеТоваровУслуг
Для ссылочных таблиц оператор ССЫЛКА является эквивалентом сравнения
Остались вопросы?
Спросите в комментариях к статье.
1 комментарий
Скажите, пжст, для оптимальной производительности что лучше использовать:
ТипЗначения() ИЛИ «Регистартор Ссылка Документ…»?
В конструкторе запросов, когда он вызывается из формы настройки источника данных, для схемы компоновки данных. Есть закладка «Характеристики», использование которой не вполне ясно описано в документации. В этой статье я постараюсь объяснить, как и для чего используются характеристики в СКД.
В типовых конфигурациях активно используется механизм свойств и значений свойств доступный практически для любых объектов. Примитивно, на справочниках, этот механизм реализовывался еще в конфигурациях 7.7. Сейчас этот механизм реализован с использованием плана видов характеристик и регистра сведений, но идея осталась прежней.
Когда я впервые столкнулся с необходимостью использования этого механизма, в схеме СКД, я очень долго мучился, организовывал вложенные запросы, присоединял к основной выборке и ломал голову над тем, как учесть возможность появления новых видов свойств, которых нет на момент разработки отчета. Весь механизм свойств, будучи простым и логичным с точки зрения пользователя, не поддавался никакой нормальной обработке, пока я не разобрался с закладкой «Характеристики».
Таблица на закладке очень капризная, либо вы введете всю строку корректно, либо откажетесь от ввода строки совсем, оставить «на потом» не до конца заполненную строку система не даст.
Итак, перейдем к конкретике. Первая колонка: Тип — здесь выбираем тип объекта, к которому привяжутся характеристики, например СправочникСсылка.Номенклатура . Это означает, что теперь для всех объектов указанного типа можно будет получить значения свойств.
Далее в следующей колонке Источник видов мы должны задать параметры источника видов свойств. Возможны варианты таблица и запрос , зачем нужен вариант запрос расскажу позже, сейчас выберем пункт таблица .
В колонке Виды характеристик мы должны выбрать таблицу информационной базы, в которой хранятся нужные виды характеристик, в нашем примере это будет ПланВидовХарактеристик.СвойстваОбъектов .
Далее, значения доступные нам для выбора в колонках Поле ключа , Поле имени и Поле типа значения , непосредственно зависят от полей выбранной нами таблицы. В Поле ключа мы выбираем Ссылка , в Поле имени — Представление (именно его пользователь увидит в качестве имени реквизита), а в Поле типа соответственно ТипЗначения .
Теперь перейдем к источнику значений. Источником значений у нас будет регистр сведений ЗначенияСвойствОбъектов , поэтому мы выбираем в колонке Источник значений — таблица , а в колонке Значения характеристик — РегистрСведений.ЗначенияСвойствОбъектов . В колонках Объект , Свойство , Значение , выбираем соответствующие поля регистра Объект , Свойство , Значение .
Казалось бы, на этом все. Заходим в настройки схемы, добавляем группировку по товарам, и добавляем подчиненную ей группировку, допустим по брендам, есть у нас такое свойство. Разворачиваем список реквизитов группировки Номенклатура и … не видим там никаких свойств:
Дело в том, что мы находимся в конфигураторе, откуда нет доступа к данным. Как же сделать нужную настройку? Удобнее всего для этого использовать консоль компоновки данных, ту что на диске ИТС, или ту что входит в подсистему «Инструменты разработчика». Но можно и просто открыть настройку отчета в режиме предприятия.
Итак, откроем ту же настройку, но в режиме предприятия:
Как видите, у нас добавились новые Реквизиты , при этом свойство Бренд внешне не отличается от обычных реквизитов справочника. А свойство Вид товара взято в квадратные скобки, это связано с тем, что представление свойства содержит пробел.
Однако, у нас появилось и свойство Вид договора которое привязано к справочнику Договора и никакого отношения не имеет к Номенклатуре . Если не использовать в настройке Вид договор то все будет работать корректно, если же его выбрать, то в результате оно окажется не заполненным, потому что ни у одного элемента номенклатуры это свойство действительно не заполнено. Но как же отфильтровать лишние свойства, чтобы они не путались под ногами?
Для этого нам нужно изменить настройку источника видов, в конструкторе запроса, на закладке «Характеристики». Помните, я в начале статьи обещал рассказать, для чего нужен тип источника видов запрос ? Сейчас как раз такой случай. Меняем тип источника видов на запрос . В колонке виды характеристик нажимаем кнопочку […] и открывается новое окно конструктора запросов.
Вводим туда такой запрос:
В колонках Поле ключа , Поле имени и Поле типа значения , выберем соответствующие поля выборки: Ссылка , Наименование и ТипЗначения . Получится так:
Теперь, когда мы перейдем к настройке отчета, в списке реквизитов Номенклатуры картинка изменится:
Вот теперь у товара только те свойства, которые ему назначены, более того, они теперь заметно отличаются от обычных реквизитов, благодаря приписке (свойство), которую мы добавили к наименованию свойства в запросе.
На этом собственно и все, но многих может смутить невозможность настройки в конфигураторе. На самом деле ничего страшного нет. Достаточно сохранить настройку (или всю схему) в файл, а в конфигураторе восстановить.
Непонятные ему реквизиты конфигуратор отобразит красными крестами, как недоступные:
Но это уже не страшно, потому что отчет с такими настройками можно сохранить в конфигурации и он будет корректно работать при открытии пользователем.
