Рассмотрим ситуацию, когда мы находимся в форме документа и нам нужно получить какой-либо его реквизит. Например, номер документа или значение реквизита Поставщик.
Данные объекта, которые отображаются в форме (в нашем случае данные документа), находятся всегда в основном реквизите формы. В подавляющем большинстве случаев этот реквизит имеет имя Объект. По крайней мере именно такое имя дает ему платформа, когда с помощью конструктора создает форму объекта. В нашем случае это именно так:
Основной реквизит формы содержит набор подчиненных реквизитов, соответствующих реквизитам прикладного объекта. Поэтому для того, чтобы обратиться, например, к поставщику, указанному в документе, нужно указать имя основного реквизита формы и через точку – имя подчиненного реквизита, хранящего ссылку на поставщика.
В нашем случае, для того чтобы получить ссылку на поставщика, нужно будет выполнить следующий код:
ПоставщикДокумента = Объект.Поставщик;
Как получить доступ к реквизитам формы?
Если реквизит объекта «вытащен» на форму, то реквизит формы можно получить через объект ЭлементыФормы, который содержит коллекцию элементов формы, сканируя ее в цикле:
ДокСсылка = СсылкаНаДокумент(ТипДокумента, НомерДок);
ДокОбъект = ДокСсылка.ПолучитьОбъект();
ФормаОбъекта = ДокОбъект.ПолучитьФорму();
Для Каждого Элемент Из ФормаОбъекта.ЭлементыФормы Цикл
Сообщить(Элемент);
КонецЦикла;
Этот цикл позволяет просмотреть имена а так же типы всех реквизитов формы, в том числе такие реквизиты как надписи, командные панели и тд.
Реквизиты формы могут быть различных типов. Поставив фильтр в виде типа реквизита мы можем просмотреть реквизиты определенного типа.
Если реквизит формы имеет тип «ТабличноеПоле», то можно такой элемент просканировать во вложенном цикле и узнать имена колонок таблицы:
Для Каждого Элемент Из ФормаОбъекта.ЭлементыФормы Цикл
Сообщить(Элемент.Имя);
Если Тип(Элемент) = Тип("ТабличноеПоле") Тогда
Сообщить(" Это табличное поле! " + Элемент.Имя );
Для Каждого Колонка Из Элемент.Колонки Цикл
ИмяКолонки = Колонка.Имя;
Сообщить(ИмяКолонки);
КонецЦикла;
КонецЕсли;
КонецЦикла;
Как получить значение отдельного реквизита формы?
Чаще требуется получать не массив реквизитов формы, а значение отдельных конкретных реквизитов формы. Например реквизиты «Шапки» или «Подвала» формы документа.
Пример:
ФормаОбъекта = ДокОбъект.ПолучитьФорму("ФормаДокумента");
Поставщик = ФормаОбъекта.ЭлементыФормы.Поставщик;
Поставщик = ФормаОбъекта.ЭлементыФормы.Получатель;
Сообщить(ФормаОбъекта.ЭлементыФормы.ТаблПоле.Колонки.Количество());
Реквизиты шапки могут иметь различные типы: Дата, СправочникСсылка, ЧекБокс, элемент раскрывающегося списка и др.
Как получить значение элементов табличной части формы?
Доступ к табличной части формы через объект
Доступ к табличной части формы (например: Товары) можно получить через объект:
ДокОбъект = Док.ПолучитьОбъект(); //здесь Док - ссылка на объект
//просканируем построчно таб часть документа
Для Каждого Стр из ДокОбъект.Товары Цикл
Номенклатура = Стр.Номенклатура;
Стр.Коэффициент = 1;
КонецЦикла;
Здесь ДокОбъект.Товары — это табличная часть «Товары» объекта. Далее в цикле табличная часть построчно сканируется!
В каждой итерации цикла можно получить доступ к любому полю строки указав через точку имя этого поля:
Номенклатура = Стр.Номенклатура;
Доступ к табличной части формы через ЭлементыФормы
Табличная часть объекта и табличная часть формы объекта — это не одно и то же!
Для того, чтобы код работал правильно, надо чтобы колонка формы табчасти объекта в свойстве данные ссылалась на реквизит табличной части объекта. Этим определяется тип колонки таб части формы.
То есть должна быть установлена связь между реквизитом табчасти объекта и реквизитом табчасти формы. Форм у объекта метаданных может быть много мы знаем. Табличную часть формы объекта можно получить через объект ЭлементыФормы:
Объект ЭлементыФормы используется для доступа к элементам управления, расположенным на форме, в частности к таб части документа.
ДокСсылка = СсылкаНаДокумент(ТипДокумента, НомерДок);
ДокОбъект = ДокСсылка.ПолучитьОбъект();
ФормаОбъекта = ДокОбъект.ПолучитьФорму();
Для Каждого Элемент Из ФормаОбъекта.ЭлементыФормы Цикл
Если Тип(Элемент) = Тип("ТабличноеПоле") Тогда //элемент формы - табличное поле
Если Элемент.Имя = "Товары" Тогда
Сообщить("Это табличное поле!! " + Элемент.Имя );
//ТабПоле = ФормаОбъекта.ЭлементыФормы.Товары.Значение;
ТабПоле = Элемент.Значение;
Колво = ТабПоле.Количество();
Сообщить("Количество строк: " + Колво);
Для Каждого ТекущаяСтрока Из ТабПоле Цикл
Имя = ТекущаяСтрока.Номенклатура;
Сообщить(Имя);
КонецЦикла;
КонецЕсли;
КонецЕсли;
КонецЦикла;
Результат для документа Авансовый отчет:
Это табличное поле!! Товары
Количество строк: 4
Женские ботфорты коричневые
Ботинки женские демисезонные
Ботинки женские натуральная кожа
Женские босоножки
Если надо получить значение всех колонок всех строк, то организуем дважды вложенный цикл:
Во внешнем цикле сканируются строки, во внутреннем — колонки:
ДокСсылка = СсылкаНаДокумент(ТипДокумента, НомерДок);
ДокОбъект = ДокСсылка.ПолучитьОбъект();
ФормаОбъекта = ДокОбъект.ПолучитьФорму("ФормаДокумента");
Для Каждого Элемент Из ФормаОбъекта.ЭлементыФормы Цикл
Если Тип(Элемент) = Тип("ТабличноеПоле") Тогда
Если Элемент.Имя = "ВыданныеАвансы" Тогда //таб часть объекта
Сообщить(" Это табличное поле!! " + Элемент.Имя );
ТабПоле = Элемент.Значение;
Индекс = 0;
Для Каждого ТекущаяСтрока Из ТабПоле Цикл
Сообщить("=======================");
Для Каждого Колонка Из Элемент.Колонки Цикл
ИмяКолонки = Строка(Колонка.Имя);
Сообщить(ИмяКолонки);
Имя = ТекущаяСтрока[ИмяКолонки];//сработает только если есть такое поле таб части объекта
Сообщить("=== " + Имя);
КонецЦикла;
Индекс = Индекс + 1;
Если Индекс > 0 Тогда break КонецЕсли; //только первая строка
КонецЦикла;
КонецЕсли;
КонецЕсли;
КонецЦикла;
Результат для документа Авансовый отчет:
Это табличное поле!! ВыданныеАвансы
=======================
НомерСтроки 1
ДокументАванса Расходный кассовый ордер ТК000000004 от 15.02.2007 19:24:03
СуммаДокументаАванса 300
ВалютаДокументаАванса USD
Выдано 300
Сумма 174
Такое двойное сканирование удобно использовать для быстрой проверки того, что все колонки таб части формы имеют связь с реквизитами таб части объекта. Если такой связи у какой-либо колонки нет, система сгенерирует ошибку.
Обращение к реквизитам формы в УФ |
Я |
26.06.17 — 17:20
Господа! Как правильно обращаться к реквизитам формы в режиме управляемых форм?
Создал реквизит формы обработки (в «общих» реквизитах). В модуле объекта обращаюсь к нему «ЭтотОбъект.<ИмяРеквизита>». Ошибки не возникает.
В модуле формы обращаюсь «Объект.<ИмяРеквизита>». Пусто.
Делаю реквизит конкретной формы (в правом разделе дизайнера формы). В модуле объекта обращаться к этому реквизиту оно не желает.
Задача-то собственно лишь отображать в форме обработки то, чем сейчас она занимается в модуле объекта, чтобы не скучно было, блин.
1 — 26.06.17 — 17:25
(0) реквизит формы не должен быть виден в модуле объекта
2 — 26.06.17 — 17:32
(0) после того, как что-то сделал в модуле объекта, сделай
ОбновитьОтображениеДанных
на форме.
3 — 26.06.17 — 19:20
(0) Для начала научиться различать реквизит формы и реквизит объекта.
4 — 27.06.17 — 09:42
> после того, как что-то сделал в модуле объекта, сделай
> ОбновитьОтображениеДанных
> на форме.
В первом случае (реквизит объекта, если быть точнее) — не обновляется. Вообще может ли быть реквизит объекта доступен на клиенте в модуле формы?
И подскажите pls, можно ли передавать от клиента к серверу ЭлементDOM (парсинг XML). На клиенте ведь может в принципе выполняться парсинг XML, на сервере тоже.
Но когда верхний цикл парсинга делаю сначала на клиенте в модуле формы, потом передаю ЭлементDOM в модуль объекта, генерит ошибку отображения. Цель — отображать на форме текущее состояние, что он на данный момент парсит.
5 — 27.06.17 — 10:00
Или может я в принципе выбрал не тот подход.
Может, стоило весь парсинг начиная от пути файла делать на сервере в модуле объекта, а клиенту передавать лишь алерты, чтобы он отображал текущее состояние выполнения процедуры на форме? Как?
6 — 27.06.17 — 12:28
Еще попробовал реквизиты объекта (обработка) заюзать для хранения промежуточных данных, необходимых для модуля объекта. Фиг. Оказывается, их значения между вызовами не сохраняются. Напрашивается резонный вопрос: а зачем они тогда нужны?
7 — 27.06.17 — 12:34
(6) Если я правильно понял, ты каждый раз при вызове процедуры из модуля объекта делаешь РеквитиФормыВОбъект?
Чтобы потом сохранить их, надо еще обратно ЗначениеВДанныеФормы делать
8 — 27.06.17 — 12:39
а ты посмотри в сторону фоновых заданий…может они тебе помогут с этим делом справиться…
9 — 27.06.17 — 15:22
>зове процедуры из модуля объекта делаешь РеквитиФормыВОбъект?
Нет, так делал. ЭтотОбъект.<ИмяРеквизита>
Позволяло.
Бум иметь в виду. Спасибо. Что получиццо, нопейшу.
10 — 27.06.17 — 15:25
(9) Может не надо?
11 — 27.06.17 — 16:44
Не получается.
Объявил реквизит объекта с именем КонтекстДанных тип СписокЗначений.
В модуле объекта пишем:
_КонтекстДанных=ДанныеФормыВЗначение(КонтекстДанных,Тип(«СписокЗначений»));
либо
_КонтекстДанных=ДанныеФормыВЗначение(ЭтотОбъект.КонтекстДанных,Тип(«СписокЗначений»));
ругается на несоответствие типов (параметр номер 1).
Аналогичная ошибка возникает при
ЗначениеВДанныеФормы(_КонтекстДанных,ЭтотОбъект.КонтекстДанных);
Как первый параметр преобразовать?
12 — 27.06.17 — 16:49
(11) Погоди, если у тебя управляемые формы, то к модулю объекта ты можешь получить доступ только с объектом
То-есть как-то так, если я не путаю:
РеквизитОбъект = РеквизитФормыВЗначение(«Объект»);
РеквизитОбъект.ТвояПроцедураИлиФункция();
ЗначениеВРеквизитФормы(РеквизитОбъект, «Объект»);
13 — 27.06.17 — 16:49
прогресс выполнения делается совсем не так.
Если встроенный в конфу — то через задание. если внешняя, то
https://github.com/a-sitnikov/ExtForms-grdok/blob/master/Admin/ОбработкаНаСервереСИндикатором.epf
14 — 27.06.17 — 20:42
>РеквизитОбъект = РеквизитФормыВЗначение(«Объект»);
>РеквизитОбъект.ТвояПроцедураИлиФункция();
>ЗначениеВРеквизитФормы(РеквизитОбъект, «Объект»);
Так вроде работает, но при возврате возникает ошибка отображения на некоторых типах, в частности ЭлементDOM.
Всё понял. Дохлый номер. Прогресс бум делать по другому.
Спасибо откликнувшимся. Тему можно считать закрытой.
15 — 28.06.17 — 01:15
(0) Платформу 8.2 придумали 150 лет назад вместе с её управляемыми формами и прочими плюшками, а народ до сих пор её готовить не научился. Стыдно должно быть, господа.
(14) Не используйте в таких случаях модуль объекта в управляемом приложении. Просто переносите его методы в модуль формы или модуль менеджера с передачей всех необходимых параметров.
y-soft
16 — 28.06.17 — 10:47
>вместе с её управляемыми формами
Кому нужны по сути эти управляемые формы? WEB-интерфейс это редкость с учетом тормозов интернета, а так просто досадное недоразумение, очередная стена, через которую перепрыгивать.
>Не используйте в таких случаях модуль объекта в управляемом приложении
Принципиальной разницы не вижу. Все обращения к базе данных идут с директивой &НаСервере, даже в модуле формы. То есть все равно возникнут проблемы при передаче параметров от процедуры &НаКлиенте к процедуре &НаСервере — будет та же ошибка отображения.
Содержание:
1. Реквизиты объекта и реквизиты формы в 1С
2. Как получить значения из элементов формы 1С
1. Реквизиты объекта и реквизиты формы в 1С
В обычном приложении у элемента формы 1С 8.3 было свойство «Значение», доступное как для чтения, так и для записи. Какой аналог в управляемом приложении?
Элементы формы 1С 8.3 могут содержать реквизиты двух видов: реквизиты объекта 1С и реквизиты формы.
Красным помечен реквизит объекта 1С Контрагент, а зеленым – реквизит формы в 1С.
Интерактивно выберем эти элементы в пользовательском режиме 1С и попробуем прочитать их «программно» кнопкой «Прочитать».
Если читать значения реквизитов в клиентской процедуре, то код для 1С Предприятия будет следующий:
Все бы хорошо: мы получили на клиенте значения реквизитов объекта 1С и формы, но – не значения элементов формы 1С. На клиенте значение элементов формы 1С получить нельзя.
2. Как получить значения из элементов формы 1С
Чтобы получить значения из элементов формы 1С, нам потребуется серверный вызов:
Именно на сервере у элемента формы 1С 8.3 становится доступно свойство ПутьКДанным, по которому его можно извлечь либо из Объекта, который имеет тип ДанныеФормыСтруктура:
…либо из Формы, которая имеет тип ФормаКлиентскогоПриложения:
Форма и ее элементы не видны на сервере без контекста. То есть код для 1С:Предприятия выдаст множество ошибок.
Также Форму нельзя передать как параметр в процедуру и функцию на сервер или в общий модуль.
Еще хочется разобрать момент, когда нам возможно увидеть состояние различающихся значений в элементе форме 1С и в объекте. Это возможно в событии элемента ОбработкаВыбора.
Например, при значении поля Контрагент — Ассоль, мы выбрали контрагента Бакалея:
Новое значение доступно как параметр процедуры ВыбранноеЗначение.
Система дает шанс что-то сделать в этой ситуации.
Специалист компании ООО «Кодерлайн»
Добрыгин Михаил
Ниже перечислены основные объекты 1С, которые используются при работе с управляемыми формами. Даны краткие примеры кода, демонстрирующие традиционное использование данных объектов при написании конфигураций 1С.
ЭтаФорма
Используется в модуле формы, в процедурах &НаКлиенте и &НаСервере.
Позволяет обращаться и к элементам формы и к реквизитам.
Обращение к элементу формы происходит через объект Элементы и выглядит так:
ЭтаФорма.Элементы.НомерВерсии.Заголовок = «v.»+ВерсияПрограммы;
Обращение к реквизиту, существующему на форме, происходит так:
ЭтаФорма.ТекстОбъявления=»Здравствуйте, товарищи!»;
Упрощенное обращение к элементам формы и реквизитам
В модуле формы, в принципе, можно не указывать ключевое слово ЭтаФорма. Можно обращаться к элементам формы и к реквизитам упрощенно:
// Элемент формы
Элементы.НомерВерсии.Заголовок = «v.»+ВерсияПрограммы;
// Реквизит формы
ТекстОбъявления=»Здравствуйте, товарищи!»;
Особенности получения реквизитов форм (важно!)
Если реквизит формы имеет простой тип — Строка, Число, Дата… то получить (установить) значение реквизита можно просто по имени:
Текст=НаименованиеТовара; // Наименование товара — это реквизит формы
Однако, таким образом невозможно получить реквизиты «сложного» типа — ТаблицаЗначений, ДеревоЗначений. При попытке получить реквизит с таким типом по наименованию, будет возвращен объект типа ДанныеФормыКоллекция.
Чтобы получить значение реквизита со «сложным» типом, нужно воспользоваться функцией РеквизитФормыВЗначение():
ТекущаяТаблица=РеквизитФормыВЗначение(«ВыбранныеОбъектыСтроительства»);
Для установки значения «сложного» реквизита, можно воспользоваться функцией ЗначениеВРеквизитФормы(<Значение>, <ИмяРеквизита>), оба параметра обязательны.
Функции РеквизитФормыВЗначение() и ЗначениеВРеквизитФормы() доступны только на Сервере.
Объект
Строго говоря, такого ключевого слова в пределах формы нет. Просто, когда создается форма, например, форма элемента, 1С автоматически создает на форме реквизит с именем Объект. Через данный реквизит доступны свойства текущего объекта, который редактируется на форме.
Например, можно получать ссылку на текущий открытый элемент справочника:
СсылкаНаТекущийЭлемент=Объект.Ссылка;
или, более полная запись:
СсылкаНаТекущийЭлемент=ЭтаФорма.Объект.Ссылка;
ЭтотОбъект
Содержит сам объект. Предназначено для получения объекта в модуле объекта или модуле формы.
Использование: Только чтение.
Доступность: Сервер, толстый клиент, внешнее соединение.
Знаете ли вы, что:
Платформа 1С — это не только бухгалтерский учет! В интернете давно зарекомендавала себя платформа для создания сайтов 1С-Битрикс. На портале https://hrustalev.com можно заказать готовый сайт для любого направления бизнеса, созданный на платформе 1С-Битрикс. Совместимость с 1С гарантирована.
Знакомство с управляемой формой 1С лучше всего начинать с реквизитов. Что такое реквизит управляемой формы? По своей сути, это данные, которые привязаны именно к форме: они создаются, хранятся, отображаются (по возможности) и редактируются на форме. Вне контекста формы эти данные не могут существовать. Сам по себе реквизит не может отображаться на форме. Для этого служат элементы формы, которые связаны с реквизитами форм.
Научимся создавать простые реквизиты формы и размещать их на форме.
Для этого в конфигураторе 1С создадим пустую форму. Пусть это будет форма некой внешней обработки. В этой форме нас интересует закладка Реквизиты
В этой закладке сейчас только один реквизит – основной. Он нас пока не интересует, работа с основным реквизитом эта тема отдельной статьи. Пока разберемся с простыми реквизитами.
Для того, чтобы добавить реквизит необходимо нажать на кнопку «Добавить реквизит» командной панели закладки «Реквизиты»
После этого будет добавлен реквизит управляемой формы 1С с типом по умолчанию (строка) и справа откроется палитра свойств этого реквизита.
В этой палитре мы можем установить имя, заголовок, а так же тип реквизита управляемой формы.
Для тренировки создадим четыре реквизита с типом строка: Фамилия, Имя, Отчество и ФИО. И один реквизит с типом дата: ДатаРождения.
Разместим реквизиты на форме. Сделать это просто: необходимо нужный реквизит мышкой «перетащить» из закладки «Реквизиты» на закладку «Элементы»
Перетащим все реквизиты на формы, и с помощью кнопок «Вверх», «Вниз» удобно расположим их на форме.
Сейчас мы сделали такую примитивную форму, на которой расположили реквизиты. После того, как мы «перетащили» реквизит в элементы, то на форме был создан элемент формы. В нашем случае это поле формы. Если мы сейчас зайдем в палитру свойств поля ввода, то увидим, что он связан с реквизитом посредством свойства ПутьКДанным.
Если нажать на кнопку «…» свойства ПутьКДанным, то у разработчика есть возможность поменять привязанный к этому элементу реквизит формы.
Сейчас научимся использовать реквизиты в программном коде. Из статьи, посвященной архитектуре управляемой формы 1С 8.3 Вы знаете, что выполнение кода на форме возможно под директивами &НаКлиенте &НаСервере и &НаСервереБезКонтекста. Доступ к реквизитам формы возможен только в процедурах и функциях, которые выполняются на &НаКлиенте и &НаСервере.
Для наглядности выполним небольшую задачу: создадим команду, при выполнении которой Фамилия, Имя, Отчество и дата Рождения будут складываться в ФИО + Дата рождения.
Создадим локальную команду формы. Для этого на закладке «Команды» в подзакладке «Команды формы» необходимо нажать на кнопку «Добавить»
После создания команды, справа откроется палитра свойств новой команды, где мы зададим её название.
Но команда – это выполнение некоторых действий на форме. Чтобы действия осуществились необходимо создать обработчик команды. Для создания обработчика команды нужно нажать на кнопку «Лупа» свойства действия. После этого откроется окно выбора места размещения обработчика.
Мы выберем расположение НаКлиенте, поскольку для тех действий, которые мы хотим осуществить вполне хватит клиентского контекста.
После выбора места расположения обработчика, в модуле формы будет создана процедура под директивой &НаКлиенте, в которой мы напишем несложный код. В этом коде к реквизитам формы мы будем обращаться просто как к переменным. Мы можем это делать в клиентском и серверном контексте.
&НаКлиенте Процедура СформироватьФИО(Команда) ФИО = Фамилия + " " + Имя + " " + Отчество + ", д.р. " + Формат(ДатаРождения, "ДЛФ=D"); КонецПроцедуры
В этом коде, я преобразовал дату в строку при помощи функции формат.
Обратите внимание, после создание процедуры в палитре свойств команды свойство Действие заполнилось названием нашей новой процедуры.
И последним шагом нам осталось нашу команду разместить на управляемой форме. Просто перетащим её мышкой в закладку Элементы
При этом на форме появится кнопка.
Сохраним обработку и попробуем выполнить нашу команду.
Как видите, к реквизитам формы в модуле формы можно обращаться напрямую, как к переменным, но только если процедура или функция выполняется под директивами &НаКлиенте и &НаСервере.
Подробно вопросы работы с управляемыми формами в частности и с управляемым приложением в целом рассмотрены в книге «Основы разработки в 1С: Такси. Разработка управляемого приложения за 12 шагов». Эта книга станет настоящим подспорьем для тех, кто только начал знакомится с разработкой управляемого приложения.
Книга «Основы разработки в 1С: Такси»
Книга «Основы разработки в 1С: Такси» отлично подойдёт тем, кто уже начал программировать и испытывает определенные сложности с этой темой и тем, кто уже давно программирует, но ни разу еще не работал с управляемыми формами 1С
- Без сложных технических терминов;
- Более 600 страниц практического материала;
- Каждый пример сопровождается рисунком (скриншот);
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
Промо-код на скидку в 15% — 48PVXHeYu
Изучайте основы конфигурирования в 1С и учитесь программировать в «1С: Предприятии» с помощью моих книг: «Программировать в 1С за 11 шагов» и «Основы разработки в 1С: Такси»
Книга «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
- Книга написана понятным и простым языком — для новичка.
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Научитесь понимать архитектуру 1С;
- Станете писать код на языке 1С;
- Освоите основные приемы программирования;
- Закрепите полученные знания при помощи задачника;
Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму:
можно оплатить вручную:
Яндекс.Деньги — 410012882996301
Web Money — R955262494655
Вступайте в мои группы в соцсетях, и будьте в курсе всех новостей
Вконтакте: https://vk.com/1c_prosto
Фейсбуке: https://www.facebook.com/groups/922972144448119/
ОК: http://ok.ru/group/52970839015518
Твиттер: https://twitter.com/signum2009