ПриЧтенииНаСервере: собственная внешняя карточка

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

Подготовка

1. Только собственный локальный SQL Server и отдельная учебная база 1С без рабочих внешних источников. SQL-блок выполните вручную в SSMS своего экземпляра: он создаёт новую GuideExternalBooks и две собственные таблицы. Если имя уже занято, существующую базу не удаляйте и не заменяйте.

2. В ODBC Data Sources разрядности серверного процесса 1С создайте собственный System DSN GuideOwnBooks: ваш localhost SQL Server, база GuideExternalBooks, Windows-аутентификация. Пользователь серверного процесса 1С должен иметь доступ только к этой учебной базе. Настройте нормальное доверие сертификату драйвера, проверку TLS не отключайте.

3. В Конфигураторе создайте ВнешниеИсточникиДанных → УчебныеКниги, автоматическое управление блокировками. Таблица Карточки: имя dbo.lesson_items, тип ОбъектныеДанные, ТолькоЧтение Ложь; Код=book_id Строка20, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, ПоляКлюча и ПоляБлокировкиДанных — Код, представление — Название.

4. Таблица Строки: имя dbo.lesson_lines, тип НеобъектныеДанные, ТолькоЧтение Ложь; Урок=lesson_id Строка20, Номер=line_no Число9.0, Название=title Строка100, Количество=quantity Число9.0. Null запрещён, поля ключа / блокировки — Урок и Номер именно в этом порядке.

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

6. В своей обработке с управляемой формой создайте команду ПодготовитьУчебноеСоединение. Отдельный блок настройки соединения относится только к модулю этой обработки; пользователь имеет административные права на свой источник. Настраивается только сеанс, не общие параметры чужого подключения.

7. После подключения откройте собственную таблицу через Функции для технического специалиста → Внешние источники данных → УчебныеКниги. Выберите подготовленную строку и откройте её штатной командой редактирования: Карточки с Код BOOK-1 либо Строки с Урок LESSON-1 и Номер 1. Не создавайте новый объект вместо открытия существующего.

8. Основной блок — событие самой формы редактируемой строки / карточки, не команда произвольной общей формы. Добавьте СтатусУрока типа Строка200 и выведите его на эту форму; ключевые поля не меняйте.

9. Для этой страницы используйте только УчебнаяКарточка и ключ BOOK-1.

10. В той же форме внешней строки / карточки добавьте РазрешитьЗапись и ОтменитьВТранзакции (Булево), СчетчикСобытий (Число10.0). Выведите на форму, Количество должно допускать отрицательные числа для отдельного упражнения валидации.

11. Назначьте основному обработчику событие самой формы ПриЧтенииНаСервере. Элемент в сигнатуру не добавляется. Дополнительный инициализатор — модуль этой же формы.

12. Каждый урок самостоятельный. Откройте свою существующую строку и измените Количество; используйте штатную команду Записать. Для ПриЧтенииНаСервере откройте строку или перечитайте её без записи.

&НаСервере
Процедура ПриЧтенииНаСервере(ТекущийОбъект)
    СчетчикСобытий = СчетчикСобытий + 1;
    СтатусУрока = "Прочитана своя SQL-строка: " + ТекущийОбъект.Название;
    Сообщить(СтатусУрока);
КонецПроцедуры

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);

&НаКлиенте
Процедура ПодготовитьУчебноеСоединение(Команда)
    НастроитьСвойИсточник();
КонецПроцедуры
&НаСервереБезКонтекста
Процедура НастроитьСвойИсточник()
    Источник = ВнешниеИсточникиДанных.УчебныеКниги;
    Параметры = Источник.ПолучитьПараметрыСоединенияСеанса();
    Параметры.СУБД = "MSSQLServer";
    Параметры.СтрокаСоединения = "DSN=GuideOwnBooks;";
    Параметры.АутентификацияОС = Истина;
    Параметры.АутентификацияСтандартная = Ложь;
    Параметры.ИмяПользователя = "";
    Параметры.Пароль = "";
    Источник.УстановитьПараметрыСоединенияСеанса(Параметры);
    Источник.УстановитьСоединение();
КонецПроцедуры

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    РазрешитьЗапись = Ложь;
    ОтменитьВТранзакции = Ложь;
    СчетчикСобытий = 0;
    СтатусУрока = "Открыта собственная внешняя строка";
КонецПроцедуры

Разбор по шагам

1. Подготовьте ровно собственные SQL-таблицы и настоящую форму указанного вида данных.

2. Откройте свою существующую строку, назначьте обработчик событию самой формы.

3. Выполните действие и различайте фазу клиента, сервер до транзакции, внутри и после её завершения.

Как проверить результат

1. После открытия / чтения показано название своей подготовленной строки. Чтение не создаёт новую запись.

2. Обработчик не вызывает Записать и не меняет строку в SQL Server.

Ожидаемый результат

Обработчик связан с конкретной своей внешней строкой, реальным событием формы и точной фазой транзакции.

На что обратить внимание

1. Не запускайте подготовку / запись на рабочем SQL Server, не заменяйте DSN существующим чужим источником.

2. После урока закройте только своё соединение и оставьте собственные учебные данные для проверки. Удаление SQL-базы и таблиц примером не выполняется.

3. SQL и BSL здесь не запускались, соединения к 1С / SQL агентом не открывались; runtime-проверка отсутствует.

4. Установленная справка в описании ТекущийОбъект этих внешних форм местами содержит типы регистра сведений / справочника. Пример относится именно к фактическому расширению формы собственной внешней таблицы; запуск в 1С здесь не подтверждён.

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