Добавить реквизит в документ через расширение

Как добавить, изменить реквизит формы через расширение

В новых версиях платформы, при изменении типовых форм, стандартные и новые реквизиты (добавленные в расширение) по умолчанию недоступны: их нельзя изменить, ни добавить в форму. Дело в том, что немного изменился механизм добавления реквизитов в расширение, для изменения типовых форм объектов.

Вам необходимо выполнить следующие действия:

• В дереве метаданных нажать правой кнопкой мыши на реквизит -> «Добавить в расширение» -> выбрать расширение;

• Перейти в расширение конфигурации, открыть форму, в которую планируем добавить (или изменить) реквизит -> в области справа выделить реквизит -> нажать правую кнопку мыши -> «Добавить реквизит»;

Почему в новой платформе изменился данный механизм?

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

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

Связанные статьи

Экспериментируем в тонком клиенте, Бухгалтерия предприятия, редакция 3.0 (3.0.51.25) .

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

Добавили в расширение документ УстановкаЦенНоменклатуры. Далее добавляем ФормуДокумента.

Ревизит1 и Реквизит4 создаем исключительно программно в форме документа в Расширении. Реквизит1 добавляем к форме документа, а Реквизит4 добавляем к табличной части документа.

Ревизит2 добавлен явно в форме документа в Расширении.

Реквизит3 явно добавлен в Форме документа в ветку реквизитов Объект / Табличная часть . Он будет появляться в таблице Товары.

В модуле ФормыДокументы добавляем Реквизит1 и Реквизит2 к имеющейся форме, и Реквизит3 к табличные :
• &НаСервере
• мм1 = Новый Массив;
• //здесь обычные реквизиты Реквизит1 , Реквизит2, …
• Реквизит1 = Новый РеквизитФормы(«Реквизит1», Новый ОписаниеТипов(«Строка»), , «Реквизит1», Истина);
• мм1.Добавить(Реквизит1);
• …..
• //здесь Реквизит4 — реквизит табличной части
• Реквизит4 = Новый РеквизитФормы(«Реквизит4», Новый ОписаниеТипов(«Строка»),»Объект.Товары» , «Реквизит4», Истина);
• мм1.Добавить(Реквизит4);
• ….
• ИзменитьРеквизиты(мм1);
• //———— связываем реквизиты с элементами формы——————————-
• Элемент = ЭтаФорма.Элементы.Добавить(«Реквизит1», Тип(«ПолеФормы»), ЭтаФорма);
• Элемент.Вид = ВидПоляФормы.ПолеВвода;
• Элемент.ПутьКДанным = «Реквизит1»;
• Элемент = ЭтаФорма.Элементы.Добавить(«Реквизит2», Тип(«ПолеФормы»), ЭтаФорма);
• Элемент.Вид = ВидПоляФормы.ПолеВвода;
• Элемент.ПутьКДанным = «Реквизит2»;
• …
• Элемент = ЭтаФорма.Элементы.Добавить(«Реквизит3», Тип(«ПолеФормы»), Этаформа.Элементы.Товары);
• Элемент.Вид = ВидПоляФормы.ПолеВвода;
• Элемент.ПутьКДанным = «Объект.Товары.Реквизит3»;

Теперь для заполнения колонки Реквизит3 достаточно на Сервере сделать так (без предварительного кода сразу ссылаемся на Объект.Товары :
Для каждого стр из Объект.Товары цикл
стр.Реквизит3 = 123;
КонецЦикла;

Для установки значения Реквизит1(или Реквизит2) делаем на Сервере так ЭтаФорма[«Реквизит1»]=»34231432432″ (эту возможность я искал 3 часа в интернете). ЗначениеВРеквизитФормы(«вопыорвоап»,»Реквизит1″) — не катит.
Создать изначально в Объекте Реквизит1 = Новый РеквизитФормы(«Реквизит1», Новый ОписаниеТипов(«Строка»),»Объект» , «Реквизит1», Истина) — тоже не проходит.

Новые реквизиты в расширении

Я

   Звездец

07.10.19 — 02:35

   seevkik

1 — 07.10.19 — 03:09

Как бы реализовано, ага, а режим совместимости какой?

   hhhh

2 — 07.10.19 — 03:10

(0) вы невнимательны. Выбрали вверху  ФормаДокумента. А надо наоборот, ту что внизу ФормаДокумента.

   pavig

3 — 07.10.19 — 03:15

(0)

Правой кнопкой на «Объект» (в области на которой ты указал знак вопроса) -> «Добавить в расширение» и всё получится

   pavig

4 — 07.10.19 — 03:16

   famnam

7 — 07.10.19 — 06:42

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

   Звездец

8 — 07.10.19 — 07:01

Специально создал демо без режима совместимости на последней платформе. Форма открыта правильно уже заимствованная

   Звездец

9 — 07.10.19 — 07:02

(4) ну так этим я создам реквизит формы в расширении и он не будет связан с новым реквизитом объекта в расширении

   Uzyf

10 — 07.10.19 — 08:44

Не стоит создавать реквизиты в расширении, чтобы потом не терять из них данные

   Звездец

11 — 07.10.19 — 09:00

(10) это тема для другой дискуссии. Сейчас не об этом

   AlvlSpb

12 — 07.10.19 — 09:56

(11) В (2) тебе четко назвали причину. Добавляешь реквизит в расширении, так и на форму выводи его в расширении, а не в основной форме

   Звездец

13 — 07.10.19 — 09:58

(12) тьфу ты блин. Спать надо ночью …

   Cyberhawk

14 — 07.10.19 — 10:00

Интересно, как тогда предполагается понимать по задумке ребяток из 1С надпись «Форма (расширение)» в конструкторе формы )

   Звездец

15 — 07.10.19 — 10:02

(14) ага, вот это и меня смутило. Вроде форма уже заимствована, реквизит добавлен, а оказывается его еще раз надо добавлять в форму

   Cyberhawk

16 — 07.10.19 — 10:04

(15) Так ты сначала добавил реквизит, а потом заимствовал?

   Звездец

17 — 07.10.19 — 10:05

(16) по разному пробовал. и сначала форму, потом реквизит. И сначала заимствовал объект, потом добавил реквизит, потом заимствовал форму. разницы никакой

   Cyberhawk

18 — 07.10.19 — 10:10

(17) Так ты открывал форму (конструктор формы) из дерева основной конфигурации, а не из дерева расширения, правильно понял?

   Звездец

19 — 07.10.19 — 10:14

нет, все из дерева расширения естественно

   Cyberhawk

20 — 07.10.19 — 10:14

Проверил: (14) не наблюдается.

Значит у тебя на твоей картинке открыта форма из расширения. Что тогда предлагают тебе делать (2) и (11) не ясно.

   Звездец

21 — 07.10.19 — 10:16

ну а у тебя добавить реквизит на форму получилось?

   Cyberhawk

22 — 07.10.19 — 10:21

(21) На 8.3.10 поведение не отличается от того, что ты описал

   Cyberhawk

23 — 07.10.19 — 10:21

Щас на конфе с режимом совместимости 8.3.12 проверю

   Звездец

24 — 07.10.19 — 10:23

(22) это 8.3.11 появилось

   Cyberhawk

25 — 07.10.19 — 10:23

+(23) Аналогично

   Cyberhawk

26 — 07.10.19 — 10:23

(24) Платформа 8.3.14 везде, в (22) вел речь о режиме совместимости конфы / расширения.

   Cyberhawk

27 — 07.10.19 — 10:25

Полагаю, в конструктор формы расширения добавляемые в объект реквизиты тупо не подвезли

   Cyberhawk

28 — 07.10.19 — 10:25

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

   RomanYS

29 — 07.10.19 — 10:27

(27) Проверил. Там реально крепкий маразм. В расширенной форме нужно объект (в реквизитах) добавить в расширение)))

   RomanYS

30 — 07.10.19 — 10:29

+(29) пытаюсь найти в этом хоть каплю здравого смысла, пока не получается

   Cyberhawk

31 — 07.10.19 — 10:31

+(29) Ага, помогло. Только после этого отображение формы сломалось.

А при вызове команды «Обновить расширение формы» все возвращается обратно, в т.ч. и добавленный реквизит исчезает.

   Cyberhawk

32 — 07.10.19 — 10:32

+(31) После этого действия добавленный реквизит в объект уже никак не добавить, команда «добавить в расширение» неактивна)

   Cyberhawk

33 — 07.10.19 — 10:32

*добавленный в объект реквизит в форму уже никак не добавить

   Звездец

34 — 07.10.19 — 10:33

(31) да вообще какой-то треш с обновлением расширений. Если сделал чего-то сложного — задолбешься потом переделывать. В общем какое-то уг пока. Попробую попользовать на паре реквизитов, ну а одну идею пока отложу до лучших времен

   Cyberhawk

35 — 07.10.19 — 10:34

(34) В 8.3.15 вроде это пофиксили, там форма в расширение приезжает сразу куцая

   RomanYS

36 — 07.10.19 — 10:34

(31) (32) (33) Жесть. Ну их в ж.. эти расширения. Где адепты этого волшебного инструмента?

   Звездец

37 — 07.10.19 — 10:35

(35) не, че-то ничего они толком не пофиксили

   RomanYS

38 — 07.10.19 — 10:35

(35) Это не лечит (31). Я тестил на 8.3.15.1656

   Cyberhawk

39 — 07.10.19 — 10:36

(38) А режим совместимосты конфы и расширения тоже 8.3.15?

   Звездец

40 — 07.10.19 — 10:37

(39) да, я ради этого как раз новую пустую демо и создавал. Тоже грешил на совместимость вначале

   Cyberhawk

41 — 07.10.19 — 10:37

(36) Используем только как патчи, и не для форм

   Звездец

42 — 07.10.19 — 10:39

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

   RomanYS

43 — 07.10.19 — 10:40

(31) Эта кнопка вроде должна обновлять сохраненную форму основной конфы в составе расширенной после изменения/обновления конфигурации. Почему она вообще доступна и что-то делает, если конфигурация не менялась?

   RomanYS

44 — 07.10.19 — 10:41

(39) было 8.3.13. Перепроверил (расширение создавал заново) без совместимости — всё также

   Cyberhawk

45 — 07.10.19 — 10:42

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

   Cyberhawk

46 — 07.10.19 — 10:42

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

   Cyberhawk

47 — 07.10.19 — 10:43

(40) (44) Ок, спс, запомнил что расширения для интерактивной работы с конструктором формы не подходят)

   RomanYS

48 — 07.10.19 — 10:44

(47) Подходят. Только нельзя нажимать «обновить форму», это запомнить нельзя, я себе запишу))

   AlvlSpb

49 — 07.10.19 — 11:22

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

   AlvlSpb

50 — 07.10.19 — 11:25

(49) Естественно Объект в форме расширения

   pavig

51 — 07.10.19 — 11:38

(47)

Нормально оно всё подходит

   RomanYS

52 — 07.10.19 — 11:43

   AlvlSpb

53 — 07.10.19 — 16:13

(52) Не для дискуссии, но у меня требовал. Вернее в конфигураторе сверху формы писал «Форма была изменена. Обновить форму?».

   Звездец

54 — 08.10.19 — 09:25

ну вроде разобрался с добавлением. Добавил. Запускаю, а на форме изменений нет. Что за … трава у разработчиков

   AlvlSpb

55 — 08.10.19 — 11:17

(54) расширение единственное в базе или еще есть?

   AlvlSpb

56 — 08.10.19 — 11:19

И безопасный режим расширения отключи, если включен

   unenu

57 — 08.10.19 — 11:32

(57) «Ну, братец, виноват: Слона-то я и не приметил» (с)

Содержание:

1. Добавляем реквизит
2. Добавление кнопки
3. Добавление группы
4. Добавляем табличную часть 1С

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

В этой статье я постараюсь собрать все основные методы создания реквизитов на форме. 

1.     Добавляем реквизит

Начнем с самого простого. Мы добавили реквизит «МоеРасширение_НаименованиеНаАнглийском» в справочник контрагентов.

                Для того, чтобы вывести его на форму програмно, пишем код процедуры «МоеРасширение_ПриСозданииНаСервереПосле» (Отказ, Стандартная Обработка).

                НовыйЭлемент = Элементы.Добавить («МоеРасширение_НаименованиеНаАнглийском», Тип(«ПолеФормы»));

                НовыйЭлемент.ПутьКДанным                = «Объект. МоеРасширение_НаименованиеНаАнглийском»;

                НовыйЭлемент.Вид                                     = ВидПоляФормы.ПолеВвода;

                НовыйЭлемент.ТолькоПросмотр         = Ложь;

                НовыйЭлемент.Видимость                      = Истина;

                НовыйЭлемент.Доступность                  = Истина.

Теперь мы добавим на форму реквизит, которого нет в конфигурации. Например, выведем на форму текущую задолженность: реквизит «МоеРасширение_ТекущаяЗадолженность».

Сначала создадим реквизит:

                ДобавляемыеРеквизиты           = Новый Массив;

                НовыйРеквизит = Новый РеквизитФормы(«МоеРасширение_ТекущаяЗадолженность»),      Новый ОписаниеТипов («Число», «Текущая задолженность»);

                ДобавляемыеРеквизиты.Добавить(НовыйРеквизит);

                ЭтаФорма.ИзменитьРеквизиты(ДобавляемыеРеквизиты).

Затем выведем его на форму таким же образом, как и добавленный в конфигурацию реквизит, разница только в поле «ПутьКДанным» – здесь мы пишем наименование только что созданного реквизита:

                НовыйЭлемент = Элементы.Добавить(«МоеРасширение_НаименованиеНаАнглийском», Тип(«ПолеФормы»));

                НовыйЭлемент.ПутьКДанным                = «МоеРасширение_ТекущаяЗадолженность»;

                НовыйЭлемент.Вид                                     = ВидПоляФормы.ПолеВвода;

                НовыйЭлемент.ТолькоПросмотр         = Истина;

                НовыйЭлемент.Видимость                      = Истина;

                НовыйЭлемент.Доступность                  = Истина.

Теперь переместим наши реквизиты под поле «Полное наименование». Для этого надо определить на форме место добавления, в нашем случаем – над группой «ГруппаКолонки»:

Элементы.Переместить(Элементы.МоеРасширение_НаименованиеНаАнглийском,Элементы.ГруппаКолонки.Родитель,Элементы.ГруппаКолонки);

Элементы.Переместить(Элементы.МоеРасширение_ТекущаяЗадолженность,Элементы.ГруппаКолонки.Родитель,Элементы.ГруппаКолонки).

Получаем результат:

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

                Элементы. МоеРасширение_ТекущаяЗадолженность.УстановитьДействие(«ПриИзменении», «МоеРасширение_РасшифроватьЗадолженность»). 

2.     Добавление кнопки

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

                НоваяКоманда = Команды.Добавить(«МоеРасширение_ПоказатьОСВ»);

                НоваяКоманда.Действие = «МоеРасширение_ПоказатьОСВ»;

                НоваяКоманда.Заголовок = «Показать ОСВ».

ВАЖНО!! В поле действие пишется имя процедуры.

Теперь добавляем саму кнопку:

                НоваяКнопка = Элементы.Добавить(«МоеРасширение_Кнопка_ПоказатьОСВ», Тип(«КнопкаФормы»));

                НоваяКнопка.ИмяКоманды = «МоеРасширение_ПоказатьОСВ». 

3.     Добавление группы

Для добавления группы переместим кнопку к полю «Текущая задолженность». На этом этапе нам надо создать группу и переместить в нее уже созданные наши элементы.

Создаем группу и помещаем ее под наименованием. Затем переносим в нее реквизит «Текущая задолженность» и кнопку «Показать ОСВ»:

                НоваяГруппа =Элементы.Добавить(«МоеРасширение_ГруппаЗадолженность», Тип(«ГруппаФормы»));

                НоваяГруппа.Вид = ВидГруппыФормы.ОбычнаяГруппа;

                НоваяГруппа.Заголовок = «»;

                НоваяГруппа.ОтображатьЗаголовок = Ложь;

                НоваяГруппа.Группировка = ГруппировкаПодчиненныхЭлементовФормы.ГоризонтальнаяВсегда;

                Элементы.Переместить(НоваяГруппа,Элементы.ГруппаКолонки.Родитель,Элементы.ГруппаКолонки);

                Элементы.Переместить(Элементы.МоеРасширение_ТекущаяЗадолженность,НоваяГруппа);

                Элементы.Переместить(Элементы.МоеРасширение_Кнопка_ПоказатьОСВ,НоваяГруппа). 

4.     Добавляем табличную часть 1С

Добавим к контрагенту табличную часть 1С «МоеРасширение_Номенклатура» с реквизитом «Номенклатура» и выведем ее на форму.

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

ВАЖНО! При создании реквизитов таблицы родителем указывается реквизит формы «Табличная часть».

                НоваяТабличнаяЧасть = Элементы.Добавить(«МоеРасширение_ТаблицаНоменклатура», Тип(«ТаблицаФормы»));

                НоваяТабличнаяЧасть.ПутьКДанным = «Объект.МоеРасширение_Номенклатура»;

                НовыйРеквизитТабличнойЧасти = Элементы.Добавить(«МоеРасширение_Номенклатура», Тип(«ПолеФормы»),НоваяТабличнаяЧасть);

                НовыйРеквизитТабличнойЧасти.Заголовок = «Номенклатура»;

                НовыйРеквизитТабличнойЧасти.Вид = ВидПоляФормы.ПолеВвода;

                НовыйРеквизитТабличнойЧасти.ПутьКДанным = «Объект.МоеРасширение_Номенклатура.Номенклатура».

 

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

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

Максим Федоров

Начиная с версии платформы 1С 7.7 одной из самых частых задач является доработка конфигурации под нужды организации или клиента. В версии платформы 8.2 в конфигурации для внесения изменений необходимо было включить возможность изменений или вовсе снять с поддержки. Это означает, что конфигурация не может обновляться автоматически и обновление нужно делать вручную. И чем больше и чем серьезней вносятся изменения в конфигурации, тем более сложной и трудоемкой становится дальнейшая поддержка и обновление. Поэтому начиная с версии 8.3.6 в платформе появился механизм расширений. Он позволяет вносить изменения, не затрагивая основную конфигурацию и не снимая ее с поддержки. В расширениях можно добавлять новые объекты, изменять поведение форм, переопределять типовые алгоритмы.

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

В самом начале мы добавим новое расширение в конфигурацию. Расширение назовем «ДоработкаФорм». В расширение добавим справочник «_ДемоКонтрагенты» и добавим этому справочнику новый реквизит «ДФ_КонтактноеЛицо». Также нам необходимо будет добавить в расширение форму элемента справочника, с которой мы будем дальше работать.

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

Доработка форм 1С в редакторе форм

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

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

Нажимаем правой кнопкой мыши на объекте и выбираем пункт «Добавить в расширение»:

После добавления объекта в расширение, реквизит «ДФ_КонтактноеЛицо» станет виден:

Теперь реквизит «ДФ_КонтактноеЛицо» мы можем вытащить на форму:

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

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

• 

Создадим обработчик события «ПриИзменении» реквизита «Видимость контактного лица» и добавим в него код:

Добавим новую страницу в группу страниц и перенесем на нее добавленные реквизиты. Для этого в дереве элементов найдем группу «Страницы», нажмем правую кнопку мыши на ней и добавим новую группу «Страница».

Страницу назовем просто «Новая страница» и после добавления переносим на нее наши добавленные реквизиты. После переноса форма примет вид:

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

В обработчике команды напишем следующий код:

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

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

Программное изменение форм 1С при помощи расширений

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

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

Для начала в расширении создадим общий модуль ДФ_РаботаСЭлементаФормы:

В общем модуле добавим функцию, которая будет возвращать нам новый элемент формы:

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

В качестве параметров передаются:

• Форма – управляемая форма;
• ИмяЭлемента – строковое представление элемента;
• ТипЭлемента – при помощи функции Тип() передать тип элемента. Например, Тип(”ПолеВвода”) или Тип(”ГруппаФормы”);
• РодительЭлемента – родитель добавляемого элемента. Это может быть как группа формы, так и сама форма;
• ЭлементПеред – элемент формы, перед которым будет добавлен новый элемент.

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

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

ЕслиСтруктураНеопределена

Данная процедура переопределяет входящий параметр. Если параметр будет равен «Неопределено», то процедура переопределит его на тип «Структура». Такая проверка довольно часто будет использоваться, поэтому была вынесена в отдельную процедуру.

Процедуры УстановитьСвойстваЭлемента и УстановитьСобытияЭлемента

Две весьма похожие процедуры. Процедура УстановитьСвойстваЭлемента устанавливает свойства элемента. Здесь в качестве параметров передаем элемент и структуру свойств. В структуре свойств ключ – это имя свойства, например, ТолькоПросмотр, Видимость, Доступность, а значение структуры – это значение свойства. Аналогично работает процедура УстановитьСобытияЭлемента, только структура в качестве ключа будет содержать имя события, например ПриИзменении, а значение структуры – имя обработчика, который определен в модуле формы, например «НаименованиеПриИзменении».

ВидыПолейФормы

Функция возвращает соответствие видов полей формы. Предназначена для определения вида поля. Потребуется при создании полей формы. Список видов полей формы весьма велик, поэтому возьмем часто используемые.

Добавление нового реквизита на форму

Допустим, есть задача: на форму элемента справочника «Контрагенты» необходимо добавить новый реквизит «Контактно лицо». Для этого добавляем форму элемента справочника в расширение. После добавляем реквизит «КонтактноеЛицо». На форму этот реквизит мы будем выводить в обработчике событий «ПриСозданииНаСервере» и вызывать его после основного обработчика.

Далее в общем модуле опишем функцию, которая добавит поле ввода, и свяжем ее с нашим новым реквизитом.

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

После запуска и отработки обработчика «ПриСозданииНаСервереПосле» форма элемента справочника примет вид:

Как видно, функция по созданию нового поля отработала, и наш реквизит появился на форме.

Создание реквизита формы

Для следующего примера добавим реквизит уже формы, который будет управлять видимостью нашего реквизита «Контактно лицо». Для создания реквизитов формы создадим пару новых процедур.

Процедура СоздатьРеквизиты создает реквизиты формы. В качестве параметров мы передаем саму форму и структуру реквизитов. Ключом структуры является имя реквизита формы, а значением структуры описание типа реквизита. Процедура СоздатьРеквизит создает структуру с одним значением и вызывает процедуру СоздатьРеквизиты. Добавляем новый реквизит формы «ВидимостьКонтактногоЛица». Для этого в обработчике «ПриСозданииНаСерверПосле» допишем следующий код:

Для начала мы создаем новый массив, добавляем в него тип булево и создаем новое описание типов. После этого вызываем нашу процедуру из общего модуля и создаем новый реквизит формы. Новый реквизит формы создан, но этого недостаточно. Теперь необходимо добавленный реквизит отобразить на форме. Воспользуемся функцией общего модуля СоздатьПоле, но вид у этого поля будет уже флажок. Также мы хотим, чтобы при изменении флажка изменялась видимость поля «Контактное лицо». Перед вызовом функции СоздатьПоле создадим структуру. Ключом структуры будет имя события «ПриИзменении», а значением структуры — имя обработчика. Ниже описываем процедуру обработчика. После добавления кода форма справочника примет следующий вид:

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

Создание группы формы

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

Первая функция создает обычную группу, вторая функция обычную группу без отображения.

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

Для нашего примера создадим обычную группу и переместим в нее наши ранее созданные элементы. Придется переработать код обработчика «ПриСозданииНаСервереПосле»:

Вначале мы получаем структуру свойств для группы. В этой структуре переопределяем два свойства: группировка и заголовок. Группировку укажем «ГоризонтальнаяВсегда», заголовок произвольный. Создаем обычную группу при помощи функции «СоздатьОбычнуюГруппу». В нее мы передаем форму, имя группы, родителя и структуру свойств. Функция вернет нам элемент группы формы. Далее остается все то же самое, кроме одного момента. В создаваемых элементах формы в качестве родителя мы будем указывать не саму форму, а ранее созданную группу. Также для флажка «ВидимостьКонтактногоЛица» в качестве параметра ЭлементПеред укажем созданное поле «КонтактноеЛицо». Это нужно для того, чтобы элементы выстроились друг за другом.

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

Создание страницы

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

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

Добавим новую страницу и перенесем в нее наши созданные элементы. Как и ранее будем дорабатывать обработчик «ПриСозданииНаСервереПосле».

Получим структуру свойств страницы. Заголовок, к примеру, укажем «Новая страница», а группировку оставим без изменений, т.е. вертикальная. Нашу новую страницу добавим в самое начало, т.е. перед страницей «Основное». Создаем станицу. Для того чтобы создаваемые элементы далее перенеслись на новую страницу, для группы элементов родителем укажем не форму, а созданную страницу. После доработки обработчика результат получится такой — как видно на рисунке, добавилась новая страница в начало группы страниц и на эту страницу перенесены все созданные элементы.

Создание команды и кнопки

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

Добавим в общий модуль пару функций. Первая будет создавать команду формы, вторая будет создавать элемент формы кнопка и связывать ее с командой формы.

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

Переходим к доработке обработчика «ПриСозданииНаСервереПосле». В конец обработчика сначала добавляем код создания команды формы. В качестве действия команды передадим имя обработчика, которое выведет в качестве сообщения содержимое поля контактное лицо. После создаем кнопку формы. Получаем структуру свойств кнопки и, при необходимости, переопределяем их. Создаем элемент формы кнопка и связываем ее с созданной командой. Для этого нужно передать имя команды, которое передавали в параметре ИмяКоманды функции СоздатьКоманду. После доработки код обработчика «ПриСозданииНаСервереПосле»:

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

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

Результат работы такого кода приведен на рисунке.

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