Получает форму документа.
Синтаксис
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)Примеры платформы
ВыбДокумент.ПолучитьФорму().Открыть();Полное описание, параметры и ограничения
ДокументСсылка.<Имя документа>.ПолучитьФорму (DocumentRef.<Document name>.GetForm)
ДокументСсылка.<Имя документа> (DocumentRef.<Document name>)
ПолучитьФорму (GetForm)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)
Параметры:
<Форма> (необязательный)
Тип: Строка, ОбъектМетаданных: Форма.
Имя формы, как оно задано в конфигураторе, или объект описания метаданного требуемой формы. Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> (необязательный)
Тип: Форма; Элемент управления.
Объект, который будет являться владельцем открываемой формы.
<КлючУникальности> (необязательный)
Тип: Произвольный.
В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм.
При поиске учитываются значения свойств открытых форм соответствующим значениям параметров метода. Если найдена открытая форма (по совпадению всех параметров), то она будет возвращена вместо новой формы.
Если из некой формы (один и тот же владелец) требуется открывать новые экземпляры другой формы, то при каждом вызове метода значение данного параметра должно быть уникально (в рамках соответствующих значений свойств открытых форм).
Значение параметра присваивается свойству открываемой формы КлючУникальности.
Следует учитывать, что при получении формы из "объекта" система получает форму для конкретного экземпляра объекта с учетом совокупности переданных параметров, в то время как для "ссылки" всегда существует только один объект в базе данных и форма получается одна (для одинаковой совокупности параметров).
Возвращаемое значение:
Тип: Форма, Неопределено.
Неопределено - если в обработчике ПриСозданииНаСервере установлен признак отказа от создания формы.
Описание:
Получает форму документа.
Доступность:
Толстый клиент.
Пример:
ВыбДокумент.ПолучитьФорму().Открыть();
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Открыть обычную форму ссылки собственной заявки по номеру и интервалу
НайтиПоНомеру получает собственный номер и дату интервала. Дата, непроведённость и собственная метка проверяются до получения именованной обычной формы.
Где и как запускать
Полный модуль собственной ОБЫЧНОЙ формы обработки, толстый клиент с обычным приложением 8.5.1.1343. Собственная заявка FORM-85; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Документы → Добавить: имя УчебнаяЗаявка, тип номера Строка, длина 9, автонумерация включена. Проведение запретите: это только учебный документ без движений.
Добавьте реквизит Комментарий (Строка, длина 100) и табличную часть Товары: Товар (СправочникСсылка.УчебныеТовары), Количество (Число, 9 цифр, 0 дробных, неотрицательное), Цена (Число, 12 цифр, 2 дробных, неотрицательное). Модуль документа пустой.
Обновите конфигурацию базы данных. Эти имена существуют только в созданной учебной конфигурации, не подразумеваются в типовой базе.
У своего документа и товара модули пустые, подписок, расширений и внешних обработчиков нет. История данных выключена; проведение УчебнаяЗаявка запрещено, движения/регистры не создаются.
Номер заявки здесь строковый длиной 9, с автонумерацией. Для иной числовой нумерации нельзя копировать проверки Строка. Дата задаётся собственным литералом, не читается из рабочего документа.
Свойства ссылки readonly. Непустой UUID/ссылка не означает наличие записи, а ВерсияДанных — непрозрачная строка, не номер документа или версия конфигурации.
Примеры здесь не запускались в 1С. Только код и установленная справка 8.5.1.1343; ваши документы не создавались, не проводились и не удалялись.
В своей УчебнаяЗаявка создайте ОБЫЧНУЮ форму документа УчебнаяФормаСсылкиЗаявки с пустым модулем. Поля Номер/Дата/Комментарий недоступны для редактирования; кнопок Записать/Провести/ОК/Удалить нет.
Вручную создайте одну собственную непроведённую заявку: Номер FORM-85, Дата 06.10.2026 12:00:00, Комментарий Собственная заявка формы. Этот просмотр не требует строк Товары. Сохраните её заранее в своей учебной базе, не в рабочей.
Запускайте толстый клиент с обычным приложением. Создайте у своей обработки обычную форму с кнопкой ПоказатьУчебнуюЗаявку, вставьте весь модуль в её модуль формы. ЭтаФорма — настоящий владелец окна.
ДатаИнтервала определяет область поиска для периодической нумерации, не точное время искомого документа. Поэтому точная дата проверяется отдельно после поиска.
После просмотра закройте окно без сохранения; серверные транзакционные уроки сюда не вставляйте.
Процедура ПоказатьУчебнуюЗаявку(Кнопка)
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если Метаданные.Документы.Найти("УчебнаяЗаявка") = Неопределено Тогда
ВызватьИсключение "Сначала подготовьте собственную УчебнаяЗаявка";
КонецЕсли;
СсылкаЗаявки = Документы.УчебнаяЗаявка.НайтиПоНомеру("FORM-85", Дата(2026, 10, 6));
Если СсылкаЗаявки = Неопределено Тогда
ВызватьИсключение "Сначала подготовьте собственную заявку по указанному номеру";
КонецЕсли;
Если СсылкаЗаявки.Пустая() Тогда
ВызватьИсключение "Собственная подготовленная заявка в нужном интервале не найдена";
КонецЕсли;
Если СсылкаЗаявки.Дата <> Дата(2026, 10, 6, 12, 0, 0)
Или СсылкаЗаявки.Проведен Или СсылкаЗаявки.ПометкаУдаления Тогда
ВызватьИсключение "Дата или состояние не совпали с собственной подготовленной заявкой";
КонецЕсли;
СвояЗаявка = СсылкаЗаявки.ПолучитьОбъект();
Если СвояЗаявка = Неопределено Тогда
ВызватьИсключение "Собственная заявка отсутствует";
КонецЕсли;
Если СвояЗаявка.Комментарий <> "Собственная заявка формы" Тогда
ВызватьИсключение "Не совпала дополнительная собственная метка";
КонецЕсли;
КлючОкна = Новый УникальныйИдентификатор;
ФормаЗаявки = СсылкаЗаявки.ПолучитьФорму("УчебнаяФормаСсылкиЗаявки", ЭтаФорма, КлючОкна);
Если ФормаЗаявки = Неопределено Тогда
Сообщить("Создание формы отклонено, открытие не выполнено");
Возврат;
КонецЕсли;
ФормаЗаявки.Открыть();
Сообщить("Открыта только собственная обычная форма, документ не записывался кодом");
КонецПроцедурыРазбор по шагам
Проверить точную платформу, свою новую конфигурацию и подготовленные метаданные.
Найти только заданный номер в его интервале; отдельно проверить Неопределено и пустую ссылку.
Проверить точную дату, отсутствие проведения/пометки и собственный комментарий.
Получить именованную обычную форму с владельцем ЭтаФорма и новым ключом окна.
Обработать Неопределено до Открыть; код ничего не записывает и не держит транзакцию.
Как проверить результат
Открыта только собственная именованная обычная форма подготовленной заявки.
Отсутствующая/неподходящая заявка и отказ создания не объявляются успехом.
Записи, проведения, удаления и сетевых действий в коде нет.
Ожидаемый результат
Толстоклиентский контракт формы ссылки применён к проверенной собственной заявке с корректным поиском номера.
На что обратить внимание
ДатаИнтервала не является точным фильтром даты, точная проверка выполняется дополнительно.
Номер в этой подготовке Строка, не UUID и не гарантированно универсальный ключ обмена.
ПолучитьФорму — обычная Форма толстого клиента, не универсальное управляемое ОткрытьФорму.
HTML не запускает код; ручные действия оператора не входят в подтверждённый результат заполнения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.