Расширение формы клиентского приложения для записи регистра сведений.Прочитать

Методы · Read

Считывает запись по установленным значениям ключевых атрибутов.

Синтаксис

Прочитать()
Полное описание, параметры и ограничения

Расширение формы клиентского приложения для записи регистра сведений.Прочитать (Client application form extension for information register records.Read)

Расширение формы клиентского приложения для записи регистра сведений (Client application form extension for information register records)

Прочитать (Read)

Доступен, начиная с версии 8.2.

Синтаксис:
Прочитать()
Описание:

Считывает запись по установленным значениям ключевых атрибутов.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Прочитать: форма собственной записи регистра сведений

Читаем свою запись по её настоящему ключу. Несохранённое изменение комментария намеренно заменяется сохранёнными данными.

Где и как запускать

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

Подготовка

  1. В отдельной учебной конфигурации создайте независимый непериодический регистр сведений УчебныеФормыНастроек. Измерение Ключ (Строка 50), ресурс Лимит (Число 12.2), реквизит Комментарий (Строка 100). Регистратора нет.

  2. Конструктором создайте управляемую форму записи УчебнаяЗапись с основным реквизитом Объект типа РегистрСведенийМенеджерЗаписи. Выведите Объект.Ключ, Объект.Лимит и Объект.Комментарий; ключ в опыте не меняйте.

  3. Это форма одной записи, не форма набора записей и не обычная форма. Основной клиентский обработчик метода находится в модуле УчебнаяЗапись и назначается её собственной команде.

  4. Внешняя учебная обработка имеет другую управляемую форму с кнопкой ОткрытьСвоюЗапись. Последние два дополнительных блока размещаются отдельно в её модуле.

  5. Серверный производитель действительно записывает одну новую собственную запись с уникальным ключом и возвращает РегистрСведенийКлючЗаписи, созданный штатным методом. Браузер справочника этот BSL не выполняет.

  6. В форме записи создайте команду ПеречитатьСвоюЗапись и её кнопку; назначьте основной обработчик из примера.

&НаКлиенте
Процедура ПеречитатьСвоюЗапись(Команда)
    Объект.Комментарий = "Несохранённая правка только в форме";
    ЭтаФорма.Прочитать();
    Сообщить(Объект.Комментарий);
    Сообщить("Лимит в прочитанной записи: " + Строка(Объект.Лимит));
КонецПроцедуры
Внешняя учебная форма: серверный производитель собственной записи и ключа
&НаСервереБезКонтекста
Функция СоздатьСвоюЗаписьИКлюч()
    ЗначениеКлюча = "УРОК-" + Строка(Новый УникальныйИдентификатор);
    Менеджер = РегистрыСведений.УчебныеФормыНастроек.СоздатьМенеджерЗаписи();
    Менеджер.Ключ = ЗначениеКлюча;
    Менеджер.Лимит = 25;
    Менеджер.Комментарий = "Собственная учебная запись";
    Менеджер.Записать();
    ПоляКлюча = Новый Структура("Ключ", ЗначениеКлюча);
    Возврат РегистрыСведений.УчебныеФормыНастроек.СоздатьКлючЗаписи(ПоляКлюча);
КонецФункции
Внешняя учебная форма: открыть именно свою запись по ключу
&НаКлиенте
Процедура ОткрытьСвоюЗапись(Команда)
    КлючЗаписи = СоздатьСвоюЗаписьИКлюч();
    ПараметрыОткрытия = Новый Структура("Ключ", КлючЗаписи);
    ОткрытьФорму("РегистрСведений.УчебныеФормыНастроек.Форма.УчебнаяЗапись", ПараметрыОткрытия);
КонецПроцедуры

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

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

  2. Клиентский дополнительный код открывает точную управляемую форму с этим ключом.

  3. Основная команда вызывается уже внутри формы записи.

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

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

  2. Не меняйте измерение Ключ перед чтением: метод читает по установленным ключевым атрибутам.

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

Метод применён к конкретной форме собственной записи, которая действительно подготовлена дополнительным кодом.

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

  1. Не заменяйте ключ записи на случайную строку или ссылку чужого объекта.

  2. Прочитать может отменить несохранённые правки формы. Проверяйте только свою созданную запись.

  3. Записать формы возвращает Булево. События и проверки регистра могут отменить операцию.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.