1с скд предопределенное значение параметра

Обновлено: 05.07.2024

Эта статья продолжает цикл статей «Первые шаги в разработке на 1С». В ней на практических примерах рассматривается механизм предопределенных данных, в т.ч. и в распределенной информационной базе.

Применимость

В статье рассматривается платформа 1С:Предприятие версии 8.3.4.465. Материал актуален и для текущих релизов платформы.

Предопределенные элементы в «1С:Предприятие 8.3»

При реализации алгоритмов разработчики часто опираются на определенные данные – элементы справочников, планов счетов, планов видов расчета и т.д.

Во встроенном языке существуют методы для поиска данных, например, НайтиПоКоду() или НайтиПоНаименованию().

Однако алгоритмы, опирающиеся на код или наименование, зачастую являются ненадежными.

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

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

Таким образом, у предопределенных данных есть две “стороны”: во-первых, существует список предопределенных элементов, созданный в конфигураторе, а, во-вторых, для данных информационной базы указывается, является ли конкретный элемент предопределенным.

Предопределенные элементы могут быть созданы у:

  • справочников;
  • планов счетов;
  • планов видов характеристик;
  • планов видов расчета.

В статье рассмотрены новшества, касающиеся предопределенных данных на платформе 8.3, а также особенности работы с ними в распределенных базах (как центральных, так и периферийных) и в информационных базах в режиме разделения данных.

Справочник организации - предопределенный элемент

Для примера, создадим в справочнике Организации предопределенный элемент ОсновнаяОрганизация:

Для увеличения нажмите на изображение.

Обращение к этому элементу из программного кода будет следующим:

Код обращения

В платформе 8.3 реализована возможность связать предопределенные данные с элементами соответствующего типа.

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

ИмяПредопрделенныхДанных

Выберем при помощи запроса все поля из справочника Организации:

Выбор полей

Для увеличения нажмите на изображение.

На рисунке видно, что в поле ИмяПредопределенныхДанных указан именно тот идентификатор, который мы ввели в режиме конфигуратора.

Предопределенный элемент в списке отображается специальной пиктограммой:

Предопределенный элемент

Чтобы “отсоединить” элемент данных от элемента предопределенных данных, нужно присвоить свойству ИмяПредопределенныхДанных пустую строку и записать элемент:

&НаКлиенте
Процедура Отсоединить ( Команда )
ОтсоединитьНаСервере ();
КонецПроцедуры

Пиктограмма в списке изменилась:

Отсоединенный элемент

Теперь предопределенный элемент существует только в конфигурации и в данных нет элемента, привязанного к идентификатору ОсновнаяОрганизация:

Идентификатор ОсновнаяОрганизация

Для увеличения нажмите на изображение.

Обращение из программного кода к предопределенному элементу вызовет исключение:

Предопределенный элемент отсутствует в данных

Чтобы связать предопределенный элемент с новой записью, нужно присвоить свойству ИмяПредопределенныхДанных имя предопределенного элемента:

&НаКлиенте
Процедура Привязать ( Команда )
ПривязатьНаСервере ();
КонецПроцедуры

Проблема следующая.
В отчете используется параметр, значение которого должно быть жестко задано до формирования отчета. Параметр должен быть невидим в пользовательских настройках отчета.
Если бы нужное значение было предопределенным - не было бы никакой проблемы. Это можно было бы сделать прямо при редактировании схемы в конфигураторе. Но значение не предопределенное и в конфигураторе его выбрать нельзя. Можно только в режиме предприятия. Но при редактировании варианта отчета в режиме предприятия изменения варианта сохраняются только для текущего пользователя. Можно ли эти изменения применить для всех пользователей? Если да, то как? Или проблема решается только программной установкой параметра?

Уточню вопрос - возможно ли редактирование в режиме предприятия общих для всех пользователей настроек отчета?

(3) Ты определись настроек или вариантов. И как настройки с вариантами хранятся (в типовом хранилище или созданном). Варианты из схемы не изменить - они в схему зашиты. Настройки для варианта менять можно и можно хранить их в хранилище настроек (созданным) сразу для всех пользователей. В типовом хранилище настройки для каждого пользователя свои.

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

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

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

(6) А можно ли, через выражение найти, скажем, элемент справочника по коду (или индексируемому полю примитивного типа)? В лоб вроде не получилось.

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

не. не получается по коду.
Пробовал и счет искать и элемент справочника - ругается одинаково (Функция не найдена "Справочники.ЦФО.НайтиПоКоду").

(15) Ты для отчета в режиме управляемого приложения на УФ проверял?

(18) Пользовался похожей консолью - не взлетает. Уиды сохраняются, но криво. В режиме предприятия обратно в ссылки не восстанавливаются. Как я понял, при загрузке схемы в конфигураторе они тупо как текст загружаются.

(15) Твой пример рабочий. Спасибо.
Но в моем случае НайтиПоКоду() не взлетает. Как я подозреваю, потому - что эти параметры у меня транслируются во вложенные схемы. Возможно их инициализация выполняется по умолчанию без разрешения использования функций общих модулей.

Так что, по-видимому, для меня только программная установка остается.

Во вложенной схеме НайтиПоКоду() работает, а вот если то же самое прописать в основной, то валится по ошибке. Наверно что-то с передачей параметров

Использование характеристик в системе компоновки данных

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

Описание характеристик

Характеристики в системе компоновки данных описываются в тексте запроса набора данных специальной инструкцией системы компоновки данных, начинающейся с ключевого слова ХАРАКТЕРИСТИКИ .

В данном примере описываются характеристики для полей типа Справочник.Номенклатура .

В описании характеристики указывается:

  1. Тип, для которого определяются характеристики
  2. Описание списка характеристик
  3. Описание значений характеристик

Тип, для которого определяются характеристики

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

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

В предложении ХАРАКТЕРИСТИКИ тип указывается в скобках после ключевого слова ТИП . Синтаксис описания типа такой же, как в описании типа конструкции ВЫРАЗИТЬ языка запроса. Типы, входящие в составной тип перечисляются через запятую.

Описание списка характеристик

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

О каждой характеристике системе необходимо знать следующую информацию:

  1. Идентификатор - внутренний идентификатор характеристики - по данному свойству характеристика будет находиться в списке значений характеристик. Идентификатор может иметь любой тип, для которого может использоваться сравнение в языке запросов.
  2. Имя характеристики - имя, под которым пользователь вводил характеристику. Например, масса, длина, рост и т.п. Значение этого свойства будет использоваться в качестве имени поля, создаваемого для характеристики.
  3. Тип значения характеристики - значения какого типа могут содержаться в характеристике. Данная информация используется, в отборе для фильтрации по полю - характеристике. Может иметь тип ОписаниеТипов , либо произвольное значение. В случае если тип значения содержит описание типов, то данное описание типов будет использовано как тип значения характеристики. Если тип значения содержит произвольное значение, то типом характеристики будет тип данного значения. Например, если в качестве типа значения используется числовое значение, то типом характеристики будет Число . Если тип значения характеристики не указан, то типом будет считаться тип Булево .

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

Рассмотрим пример. Будем описывать характеристики для поля типа Справочник.Номенклатура .

Допустим, в нашей конфигурации есть план видов характеристик ВидыДопСвойств , содержащий следующие записи:

Ссылка ПометкаУдаления Предопределенный Код Наименование ТипЗначения
Масса ложь ложь 000000001 Масса Число
Ширина ложь ложь 000000003 Ширина Число
Высота ложь ложь 000000004 Высота Число

В качестве идентификатора характеристики будем использовать поле Ссылка . В качестве имени характеристик - Наименование . А в качестве типа значения - поле ТипЗначения .

Таким образом, система получит следующий список характеристик:

Идентификатор Имя ТипЗначения
Масса Масса Число
Ширина Ширина Число
Высота Высота Число

Пусть в отчете имеется поле Номенклатура , типа Справочник.Номенклатура . На основе списка характеристик система автоматически создаст для этого поля три поля: Масса , Ширина , Высота . Тип всех полей будет Число .


Как видно, данные поля отображаются в списке реквизитов поля Номенклатура и ничем не отличаются от обычных реквизитов.

Результат отчета, в который выводятся поля - характеристики, может выглядеть так:

Номенклатура Код Масса
Лазерный принтер 5250197-203 Minolta-QMS 0000031 5 800
Лазерный принтер Canon LBP-810 0000030 4 300
Лазерный принтер HP LaserJet 2200 0000032

В данном примере в отчет выводится характеристика Масса .

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

Список характеристик описывается при помощи ключевых слов СПИСОК , ИДЕНТИФИКАТОР , ИМЯ , ТИПЗНАЧЕНИЯ . После ключевого слова СПИСОК идет имя таблицы, из которой получается список характеристик, либо в скобках текст запроса, при помощи которого получается список характеристик. После ключевых слов ИДЕНТИФИКАТОР , ИМЯ , ТИПЗНАЧЕНИЯ указываются имена полей для получения идентификатора, имени и типа значений характеристики соответственно.

В данном примере список характеристик получается из таблицы ПланВидовХарактеристик.ВидыДопСвойств . В качестве идентификатора характеристики используется поле Ссылка , в качестве имени характеристики используется поле Наименование , в качестве типа - поле ТипЗначения .

Пример с получением списка характеристик из запроса:

В конструкторе запросов характеристики описываются на закладке Характеристики .


На данном рисунке описаны характеристики для типа Справочник.Номенклатура . Список характеристик получается из таблицы ПланВидовХарактеристик.ВидыДопСвойств , в качестве идентификатора характеристики используется поле Ссылка , в качестве имени характеристики используется поле Наименование , в качестве типа - поле ТипЗначения .

При необходимости получения списка характеристик при помощи запроса, в конструкторе следует указать в качестве источника Запрос и создать запрос.


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

Описание значений характеристик

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

Для получения характеристик системе необходима следующая информация:

  1. Из какой таблицы или запроса получать значения характеристик
  2. Поле - идентификатор характеристики. В данном поле будет искаться значение идентификатора, полученного в списке характеристик.
  3. Поле - идентификатор объекта. С данным полем будет осуществляться связь поля исходного запроса, для которого требуется получить значение характеристики.
  4. Поле - значение характеристики. Из данного поля будет получаться значение характеристики. Если поле - значение не указано, то значение характеристики будет иметь значение Истина , в случае, если в таблице будет найдена запись для характеристики объекта и Ложь в противном случае.

Рассмотрим пример. Пусть значения характеристик хранятся в регистре сведений ДопСвойства , который содержит следующие данные:

Номенклатура ВидСвойства Свойство
Лазерный принтер 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с значениями по умолчанию, это можно сделать двумя способами.

Процедура ПриКомпоновкеРезультата ( ДокументРезультат , ДанныеРасшифровки , СтандартнаяОбработка )

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


Например у отчет есть следующие параметры:

Программно их задать можно следующим образом:
Код 1C v 8.х

Есть параметр, предопределенное при открытии отчета каждый раз. Как его правильно указать в СКД?
Можно делать так:
Код 1C v 8.х
или
Код 1C v 8.х

Для УП
Код 1C v 8.2 УП


Похожие FAQ

Еще в этой же категории

Ключевые слова и Изображения

Слова упорядочены по частоте использования в тексте

Изображения


Спасибо за СтандартнаяОбработка = Ложь; для УП! Целый час бился, не мог понять почему настройки слетают.

Все верно, только я предпочитаю искать по названию (лучше код потом читается, особенно если отчет сложный и много параметров:

Очень часто встречаю что программистов заводит в тупик такой момент как программная установка параметров системы компоновки данных (далее СКД). Сделать это можно через ‘КомпоновщикНастроек’ нашей СКД.

Если мы хотим этот параметр устанавливать программно, то важно убедиться что он доступен, иначе мы получим ошибку что параметр не найден (флаг стоять не должен):

И так что бы программно установить параметру СКД определенное значение, мы можем использовать процедуру модуля отчета ‘ПриКомпоновкеРезультата’ и компоновщиком настроек:

Читайте также: