Вызывается при получении представления объекта или ссылки.
Синтаксис
ОбработкаПолученияПредставления(<Данные>, <Представление>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ВнешнийИсточникДанныхТаблицаМенеджер.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>.ОбработкаПолученияПредставления (ExternalDataSourceTableManager.<External source name>.<External data source table name>.PresentationGetProcessing)
ВнешнийИсточникДанныхТаблицаМенеджер.<Имя внешнего источника>.<Имя таблицы внешнего источника данных> (ExternalDataSourceTableManager.<External source name>.<External data source table name>)
ОбработкаПолученияПредставления (PresentationGetProcessing)
Доступен, начиная с версии 8.3.1.
Синтаксис:
ОбработкаПолученияПредставления(<Данные>, <Представление>, <СтандартнаяОбработка>)
Параметры:
<Данные>
Тип: Структура.
Содержит значения полей, из которых формируется представление.
<Представление>
Тип: Строка.
Строка, в которую нужно поместить представление объекта или ссылки.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак формирования стандартного представления объекта или ссылки.
Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Вызывается при получении представления объекта или ссылки.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:
Доступен, начиная с версии 8.3.1.
Методическая информация
Практические примеры
Разобрать событие собственной внешней таблицы: поля и строковое представление
Обработчик находится в точно названном модуле своей таблицы УчебныеКниги. Подготовленные поля, ключи и действие пользователя задают реальный источник события.
Где и как запускать
Названный модуль собственной внешней таблицы Карточки / Строки; подключение только к подготовленной GuideExternalBooks.
Подготовка
Только собственный локальный SQL Server и отдельная учебная база 1С без рабочих внешних источников. SQL-блок выполните вручную в SSMS своего экземпляра: он создаёт новую GuideExternalBooks и две собственные таблицы. Если имя уже занято, существующую базу не удаляйте и не заменяйте.
В ODBC Data Sources разрядности серверного процесса 1С создайте собственный System DSN GuideOwnBooks: ваш localhost SQL Server, база GuideExternalBooks, Windows-аутентификация. Пользователь серверного процесса 1С должен иметь доступ только к этой учебной базе. Настройте нормальное доверие сертификату драйвера, проверку TLS не отключайте.
В Конфигураторе создайте ВнешниеИсточникиДанных → УчебныеКниги, автоматическое управление блокировками. Таблица Карточки: имя dbo.lesson_items, тип ОбъектныеДанные, ТолькоЧтение Ложь; Код=book_id Строка20, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, ПоляКлюча и ПоляБлокировкиДанных — Код, представление — Название.
Таблица Строки: имя dbo.lesson_lines, тип НеобъектныеДанные, ТолькоЧтение Ложь; Урок=lesson_id Строка20, Номер=line_no Число9.0, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, поля ключа / блокировки — Урок и Номер именно в этом порядке.
Оба обработчика представления поместите в модуль менеджера внешней таблицы Карточки, не в модуль формы.
Перезапустите только свой учебный сеанс после изменения обработчиков: состав полей представления кэшируется. Затем откройте свою BOOK-1 / запросите её строковое представление.
Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Представление = Данные.Название + " (" + Строка(Данные.Количество) + " шт.)";
Сообщить("Сформировано представление собственной карточки");
КонецПроцедурыВручную в своём SSMS: новая собственная SQL-база, не BSL
CREATE DATABASE GuideExternalBooks;
GO
USE GuideExternalBooks;
GO
CREATE TABLE dbo.lesson_items (
book_id nvarchar(20) NOT NULL PRIMARY KEY,
title nvarchar(100) NOT NULL,
quantity numeric(9,0) NOT NULL
);
CREATE TABLE dbo.lesson_lines (
lesson_id nvarchar(20) NOT NULL,
line_no numeric(9,0) NOT NULL,
title nvarchar(100) NOT NULL,
quantity numeric(9,0) NOT NULL,
PRIMARY KEY (lesson_id, line_no)
);
INSERT INTO dbo.lesson_items VALUES (N'BOOK-1', N'Учебная книга', 3);
INSERT INTO dbo.lesson_lines VALUES (N'LESSON-1', 1, N'Учебная строка книги', 3);Тот же модуль менеджера Карточки: сначала запросить два действительных поля
Процедура ОбработкаПолученияПолейПредставления(Поля, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Поля.Добавить("Название");
Поля.Добавить("Количество");
КонецПроцедурыРазбор по шагам
Подготовьте только собственный SQL-источник с точными полями и ключами.
Назначьте обработчик нужному модулю объекта / набора / менеджера, не произвольной форме.
Выполните указанное действие на своей строке и отличайте изменение в памяти от записи и завершения транзакции.
Как проверить результат
Поля Название и Количество реально существуют в собственной SQL-схеме и запрашиваются перед формированием представления.
Для BOOK-1 получается Учебная книга (3 шт.) при исходных данных. Представление не изменяет TITLE / quantity в SQL.
Ожидаемый результат
Событие связано с собственной существующей внешней таблицей и конкретным пользовательским / программным вызовом.
На что обратить внимание
Рабочие SQL-источники не используются; копия закрывается без сохранения, демонстрационное удаление своей строки с положительным количеством должно быть отклонено.
Модуль менеджера, модуль объекта, модуль набора и модуль формы имеют разные события; их сигнатуры не смешиваются.
SQL и BSL здесь не запускались, соединения к SQL агентом не открывались; факт исполнения 1С не подтверждён.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.