Механизм заполнения реквизитов новых объектов

Инициализация реквизитов при создании нового объекта

Один из методов упрощения работы пользователя — это заполнение реквизитов нового объекта (элемент справочник, документ) значениями по умолчанию. Реализовать заполнение реквизитов можно двумя способами:

1. в обработчике события формы элемента — ПриСозданииНаСервере;
2. в обработчике события объекта — ОбработкаЗаполнения.

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


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Если ссылка у объекта пустая, значит он еще не записан,
// а следовательно он является новым объектом.
ЭтоНовыйОбъект = Объект.Ссылка.Пустая();

// Если объект новый, то выполняем заполнение реквизитов.
Если ЭтоНовыйОбъект Тогда
Объект.Ответственный = Пользователи.ТекущийПользователь();
Объект.Комментарий = "Документ создан " + Формат(ТекущаяДата(), "ДФ=dd.MM.yyyy");
КонецЕсли;

КонецПроцедуры

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


Процедура ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)

ЭтотОбъект.Ответственный = Пользователи.ТекущийПользователь();
ЭтотОбъект.Комментарий = "Документ создан " + Формат(ТекущаяДата(), "ДФ=dd.MM.yyyy");

КонецПроцедуры

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

1.    Создание на форме дополнительных реквизитов в 1С 8.3 и их функции

Механизм дополнительных реквизитов в 1С 8.3 позволяет пользователю самостоятельно добавлять реквизиты к объектам, не меняя при этом конфигурации. После добавления и настройки реквизит отобразится на форме, пользователь сможет заполнить его и значения будут сохраняться в базе.

Вывести реквизиты на форму можно динамически, при ее открытии. Если смотреть отладчиком, то видно, что после процедур ПриСозданииНаСервере и ПриОткрытии дополнительных реквизитов в 1С 8.3 еще нет. Появятся они, когда активизируется закладка «Дополнительно». При создании на форме, реквизитам присваиваются длинные, страшные, ни о чем не говорящие имена. Например:

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

Из-за этого возникают сложности с программным обращением к дополнительным реквизитам в 1С 8.3.

Дополнительные реквизиты на форме создаются типовой процедурой УправлениеСвойствами.ЗаполнитьДополнительныеРеквизитыВФорме:

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

Посмотрим отладчиком, как выглядит форма с созданными на ней дополнительными реквизитами для программного обращения:

Форма с созданными на ней дополнительными реквизитами в 1С 8.3  

2.     Установка значения дополнительного реквизита в 1С 8.3 с помощью обращения к нему по имени

Чтобы иметь возможность программного обращения к созданным дополнительным реквизитам, нужно знать их имена на форме. Помочь разработчику узнать имена дополнительных реквизитов может специальный реквизит Свойства_ОписаниеДополнительныхРеквизитов. Его автоматически создает система, когда используется механизм дополнительных реквизитов. Тип этого служебного реквизита ДанныеФормыКоллекция. Он содержит список всех дополнительных реквизитов объекта и все сведения о них. Теперь, мы сможем найти нужный дополнительный реквизит в 1С 8.3 по имени, или по соответствующему ему свойству плана видов характеристик. Итак, обращаясь по имени к доп.реквизиту можно присвоить ему нужное значение, либо, наоборот, получить его значение и, например, как-то проверить.

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

Раздел Для разработчиков в нижней части формы характеристики

Вот вариант процедуры, которая получает поле доп. реквизита по его имени:

Параметры функции: форма и имя дополнительного реквизита

Функция принимает два параметра – форма и имя дополнительного реквизита (имя для разработчиков). Сперва получим тот самый служебный реквизит, в котором содержатся данные о всех дополнительных реквизитах на форме. Затем по имени дополнительного реквизита в 1С 8.3 найдем свойство в плане видов характеристик. Теперь по этому свойству можем в списке реквизитов найти соответствующий реквизит.

Так может выглядеть код, вызывающий процедуру и устанавливающий значение дополнительному реквизиту:

Код, вызывающий процедуру и устанавливающий значение дополнительному реквизиту в 1С 8.3

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

Специалист компании «Кодерлайн»

Екатерина Редько

Опубликовано 19.03.2021 15:16

Автор: Administrator

Просмотров: 13408

Иногда у пользователя возникает необходимость внести дополнительную информацию об объекте в 1С и он, не зная всех возможностей программы, делает пометки в комментариях, в карточке объекта или приписывает что-то в наименовании. Комментарии в отчетах не видны, а «исковерканные» наименования выглядят не очень привлекательно. Как выйти из ситуации, когда пользователю не хватает стандартных реквизитов в 1С? В этом ему поможет подсистема «Дополнительные реквизиты и сведения». Рассмотрим пошагово на примерах, как работает этот механизм в программе 1С: Бухгалтерия ред. 3.0. 

                                                            Первичная настройка программы 1С 

Шаг 1. Перейдите в раздел «Администрирование» — «Общие настройки».

Для создания дополнительных реквизитов объекта перейдите по гиперссылке «Дополнительные реквизиты».

Настройка дополнительного реквизита 1С к справочнику «Договоры»

Рассмотрим пример: ИП Круглова О.А. оказывает несколько видов услуг: «Услуга №1», «Услуга №2». При поступлении оплаты по договорам хотелось бы видеть, какая из услуг оказанная контрагентом не оплачена, в разрезе договоров. При заполнении данных договора, в нем указана лишь дата и номер. Если изменить наименование договора, оно отобразится в печатных формах, что не очень удобно. Оптимальный вариант решения – это добавление к договору дополнительного реквизита.

Шаг 1. В левой стороне окна выберите нужный объект.

В нашем примере – это справочник «Договор». Нажав кнопку «Добавить», выберите команду – «Новый».

Шаг 2. Задайте наименование реквизита и установите настройки.

Пользователь может задать любой «Тип значения» из предложенного списка в зависимости от своей задумки.

«Строка» – это поле, в которое вносится информация в произвольном виде. Текстовая информация сохраняется для конкретного элемента;

«Булево» – это установка флажка, означающего «Да» или «Нет»;

«Дополнительное значение» — аналог дополнительного справочника, который хранит определенные значения – характеристики. Например, цвет, размер, плотность, вид материала и т.п. Это может быть любая характеристика, заданная пользователем для определенной номенклатуры.

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

В нашем примере выберите «Тип значения» – «Номенклатура».

Установите дополнительные настройки отображения, видимости и заполнения нового реквизита, при необходимости:

• «Выводить в виде гиперссылки» — установите галочку;

• «Видимость» и «Доступность» — перейдите для настройки по гиперссылке «Всегда»;

• «Заполнять всегда» — установите галочку.

Шаг 3. Сохраните настройку – «Записать и закрыть».

Справа в таблице отобразился созданный дополнительный реквизит к объекту «Договоры». У объекта в скобках появилась цифра «1» — т.е. у объекта имеется один дополнительный реквизит.

Шаг 4. Реализуем услугу контрагенту и создадим новый договор.

Обратите внимание: в разделе «Дополнительные реквизиты» появился добавленный нами реквизит – «Детализация договора», с возможностью выбора из справочника номенклатура.

Контрагенту ООО фирма «Меркурий» оказана услуга по доставке. К договору №12 от 02.02.2021 года закреплена детализация в виде номенклатуры «Доставка».

Выбрав нужный счет, нажмите кнопку «Показать настройки».

Шаг 7. Нажмите «Сформировать». В отчете отдельной строкой видны обороты в разрезе не только договора, но и введенного дополнительного реквизита. В нашем примере к договору закреплена номенклатура «Доставка».

Настройка текстового дополнительного реквизита
в виде комментария к договору

Пример: В течении месяца ИП Круглова О.А. оказывает услуги, которые суммируются за период и в конце месяца выставляется счет. Прикрепить отдельную номенклатуру к договору не получится. Но во избежание разногласий к договору делается «отметка»: перечень выполненной работы, отметки о дате и времени и т.п. Чтобы на вопрос контрагента: «А за что? А когда?» можно было сразу поднять детализацию и посмотреть.

Создайте еще один дополнительный реквизит к договору, как описывалось выше.

Шаг 1. В поле «Наименование» задайте «Описание услуг по договору».

Тип значения укажите – «Строка». Установите переключатель в положение «Многострочное поле ввода» и задайте количество возможны строк. В нашем примере – 10.

Если строки не заданы, то поле получится однострочное.

Шаг 2. Сформируйте документ оказания услуг, создайте договор с «отметками — описанием».

В разделе «Дополнительные реквизиты» появилось второе поле, для текстового ввода информации. Пользователь может задавать и использовать сразу несколько дополнительных реквизитов.

В поле «Описание услуг по договору» внесите дополнительную информацию.

Шаг 4. В настройках отчета («Показать настройки») добавьте группировку по созданному дополнительному реквизиту – закладка «Группировка» — кнопка «Добавить».

В окне «Выбор поля группировки» найдите созданный реквизит – «Описание услуг по договору».

В нашем примере отбор установлен по контрагенту «Методический центр Дружба».

Такие «эксперименты» с реквизитами можно проводить с любым объектом 1С.

Приведем еще один «ходовой» пример – справочник «Номенклатура».

Настройка дополнительных реквизитов к справочнику «Номенклатура»

У каждого объекта номенклатуры имеется множество различных характеристик, которые пользователь хочет отразить в карточке. Куда их поместить? Здесь также можно воспользоваться механизмом «Дополнительные реквизиты и сведения».

Шаг 1. Перейдите в настройку «Дополнительные реквизиты» раздела «Администрирование» — «Общие настройки».

Выберите пункт «Номенклатура» и нажмите «Добавить» — «Новый», для формирования нового реквизита справочника.

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

Для этого укажите «Тип значения» – «Дополнительное значение».

Перейдите на закладку «Значения» и перечислите возможные варианты значения реквизита «Цвет». В дальнейшем справочник можно пополнять.

Посмотрим настройку в действии.

Шаг 4. Откройте карточку элемента номенклатуры. В разделе «Дополнительные реквизиты» появилось новое поле «Цвет» с возможностью выбора варианта из справочника.

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

Пользователь может задать производителя товара, задав выбор из справочника «Контрагенты». Например, «Молоко, 3,2%» – производитель МКС – Молочный комбинат «Ставропольский».

Шаг 5. Для этого реквизита установите «Тип значения» – «Контрагент».

В таких примерах можно использовать условия.

Создадим новый реквизит, для отметки наличия функции «Газ-контроль».

Шаг 6. Укажите название реквизита и «Тип значения» задайте «Булево». Т.е. в карточке установится галочка, определяющая имеется в данной модели газ-контроль или нет.

«Входит в группу» — Равно – и укажите для каких групп номенклатуры актуален данный реквизит. В нашем примере – «Комплекты встраиваемой техники для кухни». В данной папке в справочнике сгруппированы газовые варочные панели, духовки и их комплекты.

Так, для блендера в разделе «Дополнительные реквизиты» видны лишь:

• «Цвет»;

• «Производитель».

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

Шаг 7. Сформируйте «Оборотно-сальдовую ведомость по счету» — 41 «Товары». В настройках отчета на закладке «Отбор» добавьте условие отбора «Газ-контроль (Номенклатура)» — Равно – и значение, которое хотите увидеть. В нашем примере – «Да» — наличие «Газ-контроля».

Механизм «Дополнительные реквизиты и сведения» имеет огромные возможности. Мы рассмотрели лишь некоторые примеры, чтобы показать, как пользователь может его использовать и получить представление об использовании данного механизма. Добавлять реквизиты можно как к справочникам, так и к документам. Принцип работы – аналогичен.

Автор статьи: Ольга Круглова

Понравилась статья? Подпишитесь на рассылку новых материалов

Частая задача — сделать так, чтобы форма нового объекта открывалась не «пустая», а уже заполненная некоторыми начальными данными. Для самых простых случаев можно использовать свойство ЗначениеЗаполнения, которое есть у реквизитов объектов конфигурации. В более сложных случаях можно использовать свойство ЗаполнятьИзДанныхЗаполнения. Если ни тот, ни другой способы не подходят, на встроенном языке можно описать собственный алгоритм начального заполнения данных нового объекта.

Свойство ЗначениеЗаполнения

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

У реквизитов объектов конфигурации существует свойство ЗначениеЗаполнения. Реквизит Склад имеет тип ссылки на справочник Склады, а в справочнике Склады существует предопределенный элемент ГлавныйСклад. Тогда прямо в конфигураторе можно указать, что в новых документах реквизит Склад будет сразу же заполнен ссылкой на ГлавныйСклад:

Cвойство ЗаполнятьИзДанныхЗаполнения

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

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

Собственный алгоритм заполнения реквизитов

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

Процедура ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)
                
     Если ДанныеЗаполнения = Неопределено Тогда 
          // «Простой» ввод нового объекта
                               
     ИначеЕсли ТипЗнч(ДанныеЗаполнения) = Тип("СправочникСсылка.Поставщики") Тогда 
          // Новый объект вводится на основании другого объекта. 
          // В этом случае в данные заполнения передается ссылка на объект, являющийся основанием.
          // В данном случае обрабатывается ввод на основании элемента справочника Поставщики.
                               
     ИначеЕсли ТипЗнч(ДанныеЗаполнения) = Тип("Структура") Тогда
          // Новый объект вводится командой из отобранного списка.
          // В данных заполнения будет структура, содержащая значения отбора:
          // «Поставщик» — СсылкаНаПоставщика
          // «Склад» — СсылкаНаСклад
                               
     КонецЕсли;
                               
КонецПроцедуры

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

Если же не менять стандартное значение этого параметра, то после выхода из этого обработчика платформа попытается самостоятельно заполнить реквизиты объекта, подлежащие заполнению. Незаполненными она будет считать те реквизиты, которые имеют стандартное значение своего типа. Например, для типа Число это значение 0, для типа Строка — пустая строка, а для типа Ссылка — пустая ссылка.

Для простоты предположим, что у объекта всего один реквизит, подлежащий заполнению. Тогда платформа будет действовать по следующему алгоритму:

• Реквизит заполнен — сразу будет вызван обработчик события ПриСозданииНаСервере.
• Реквизит не заполнен — платформа попытается заполнить его из ДанныеЗаполнения. После этого снова проверит, заполнен реквизит или нет:
  • Реквизит заполнен — сразу будет вызван обработчик события ПриСозданииНаСервере.
  • Реквизит не заполнен — платформа попытается заполнить его из ЗначениеЗаполнения. После этого будет вызван обработчик события ПриСозданииНаСервере.

Поиск:
1С:Предприятие • Документ • Заполнять из данных заполнения • Значение заполнения • Обработка заполнения