1С 8.x : Функция Представление(), Поле Представление

Функция Представление()
Функция представление предназначена для получения текстового представления любого значения, которое может быть получено при помощи языка запросов. Функция Представление() работает как для ссылочных, так и для примитивных типов. Для ссылочных типов результат функции полностью аналогичен получению поля «Представление» от ссылки, переданной в качестве параметра функции. Для примитивных типов, результатом работы функции является строка, в которую было преобразовано значение, переданное в качестве параметра. Особенностью данной функции является то, что ее результат не может быть использован в выражении. Такая особенность связана с тем фактом, что преобразование значений в строку осуществляется уже при получении данных из результата запроса, т.к. преобразование произвольного значения в строку при исполнении запроса на сервере, не осуществляется, в силу того, что при преобразовании значений в строку необходимо учитывать локальные настройки.

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

Применение функции Представление() также может быть полезным при получении представления поля — перечисления, в случае исполнения запроса через COM-соединение

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

Как следствие, результат запроса не рекомендуется упорядочивать по полю «Представление», т.к. это не приведет к желаемому результату — результат запроса будет упорядочен в порядке возрастания ссылок объектов. Подробнее об этом можно прочитать в разделе «Особенности упорядочивания по ссылочным полям».

Источник

Представление справочника, документа в 1C

Программирование системы 17.08.2016 09:34 13327

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

Когда срабатывает представление ?
Представление формируется при выводе на экран ссылок (объектов) документов или справочников.

Программное изменение представления в «Управляемом приложении»

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

1) ОбработкаПолученияПолейПредставления( , ) Вызывается при получении состава полей, из кторых формируется представление объекта. Эта процедура вызывается один раз, при первом формировании представления. Результат обработки события кэшируется для сеанса.

2) ОбработкаПолученияПредставления( , , )Вызывается при получении представления. В параметре «Данные» содержатся значения полей объекта, которые были заданы в событии ОбработкаПолученияПолейПредставления().

Для того чтобы добавить сообщение, необходимо Войти или Зарегистрироваться

Источник

Обработчики событий ОбработкаПолученияПредставления и ОбработкаПолученияПолейПредставления

Область применения: управляемое приложение, мобильное приложение.

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

Процедура ОбработкаПолученияПолейПредставления(Поля, СтандартнаяОбработка)
Поля.Добавить(«Наименование»);
Поля.Добавить(«Дата»);
СтандартнаяОбработка = Ложь;
КонецПроцедуры

Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
Наименование = ?(ПустаяСтрока(Данные.Наименование), НСтр(«ru = ‘Без описания'»), Данные.Наименование);
Дата = Формат(Данные.Дата, ?(ПолучитьФункциональнуюОпцию(«ИспользоватьДатуИВремяВСрокахЗадач»), «ДЛФ=DT», «ДЛФ=D»));
Представление = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(НСтр(«ru = ‘%1 от %2′»), Наименование, Дата);
СтандартнаяОбработка = Ложь;
КонецПроцедуры

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

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

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

Эти требования также справедливы при разработке планов обмена для синхронизации с другими программами (не РИБ, по правилам конвертации) с помощью подсистемы «Обмен данными» Библиотеки стандартных подсистем.
Например, недопустимо обращаться к предопределенным элементам, которые еще могли быть не загружены в базу или, наоборот, уже удалены в ходе обмена данными:

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

СтандартнаяОбработка = Ложь;
Если Данные.ВидОбразования = Справочники.ВидыОбразованияФизическихЛиц.ПослевузовскоеОбразование Тогда
Представление = НСтр(«ru = ‘Послевузовское образование'»);
Иначе
.

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

Источник

1С Произвольное представление документа

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

Задача

Для документа Реализация товаров и услуг организовать формирование представления документа в зависимости от значения реквизита Вид:

• Товары — «Реализация товаров » + + » от » + ;
• Услуги — «Акт выполненных работ » + + » от » + .

Решение

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

ОбработкаПолученияПолейПредставления() — Определяет состав полей для формирования представления. По умолчанию содержит Дата и Номер, если необходимо определить свой состав полей, то необходимо переменной СтандартнаяОбработка присвоить значение Ложь, при этом Дата и Номер в состав полей не войдут — необходимо добавить самому.

ОбработкаПолученияПредставления() — Определяет само представление, если переменной СтандартнаяОбработка присвоить значение Ложь, то будет выполняться произвольный алгоритм формирования представления. Данные описанные в обработчике ОбработкаПолученияПолейПредставления(), будут преданны структурой Данные.

Источник

Представление справочника и документа

В данной статье речь пойдёт о том, как выводить, создавать и управлять представлением документа либо представлением справочника в системе 1С.

1. Представление при помощи свойства «Основное представление»

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

Рис. 1 Представление справочника в виде кода и наименования

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

2. Изменение представления справочника или документа программным путем

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

1. «ОбработкаПолученияПолейПредставления(Поля, СтандартнаяОбработка)» – данная процедура может быть вызвана для получения составляющих в полях, при помощи которых и можно получить представление документа. Данную процедуру достаточно вызвать один раз во время формировки первоначального представления документа либо справочника. Результатом будет то, что после обработки все события будут кэшированы для конкретного сеанса. Пример данной процедуры с её общим видом можно увидеть на скриншоте с кодом ниже:

Рис. 2 Обработка, позволяющая получить представление документа

2. «ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)» – данную процедуру вызывают, чтобы получить представление необходимого документа. Внутри параметра «Данные» находятся все значения по полям в нужном нам объекте, которые задавались в событии «ОбработкаПолученияПолейПредставления()», как демонстрируется на скриншоте ниже:

Рис. 3 Процедура, применяемая для того, чтобы получить представление документа

3. Пример представления документа в 1С

Выше было представлено как стандартно менять способы представления документа. Теперь рассмотрим, как это работает на практике. Пусть нужно изменить представление документа «Реализация товаров, услуг» на «Реализация т/у №150 от 20.05.2016 (Контрагент: ООО Альфа)». Чтобы произвести данную процедуру нужно внутри менеджерского модуля по объекту внутри документа создать обработчики по событиям по получению нового представления, а также его возможных полей. Процедура в данном случае будет выглядеть, как продемонстрировано на скриншоте с кодом ниже:

Рис.4 Получение нового представления документа в 1С

В данной статье было рассмотрено понятие представления документов в 1С. Были представлены два возможных стандартных варианта для изменения, две возможные процедуры в модуле менеджера, а также режимы представления документа.

Источник