Получает форму элемента справочника, которая содержит данный объект встроенного языка.
Синтаксис
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)Примеры платформы
Клиенты = Справочники.Контрагенты;
НовыйКлиент= Клиенты.СоздатьЭлемент();
НовыйКлиент.ПолучитьФорму().Открыть();Полное описание, параметры и ограничения
СправочникОбъект.<Имя справочника>.ПолучитьФорму (CatalogObject.<Catalog name>.GetForm)
СправочникОбъект.<Имя справочника> (CatalogObject.<Catalog name>)
ПолучитьФорму (GetForm)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)
Параметры:
<Форма> (необязательный)
Тип: Строка, ОбъектМетаданных: Форма.
Имя формы, как оно задано в конфигураторе, или объект описания метаданного требуемой формы. Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> (необязательный)
Тип: Форма; Элемент управления.
Объект, который будет являться владельцем открываемой формы.
<КлючУникальности> (необязательный)
Тип: Произвольный.
В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм.
При поиске учитываются значения свойств открытых форм соответствующим значениям параметров метода. Если найдена открытая форма (по совпадению всех параметров), то она будет возвращена вместо новой формы.
Если из некой формы (один и тот же владелец) требуется открывать новые экземпляры другой формы, то при каждом вызове метода значение данного параметра должно быть уникально (в рамках соответствующих значений свойств открытых форм).
Значение параметра присваивается свойству открываемой формы КлючУникальности.
Следует учитывать, что при получении формы из "объекта" система получает форму для конкретного экземпляра объекта с учетом совокупности переданных параметров, в то время как для "ссылки" всегда существует только один объект в базе данных и форма получается одна (для одинаковой совокупности параметров).
Возвращаемое значение:
Тип: Форма, Неопределено.
Неопределено - если в обработчике ПриСозданииНаСервере установлен признак отказа от создания формы.
Описание:
Получает форму элемента справочника, которая содержит данный объект встроенного языка.
Доступность:
Толстый клиент.
Примечание:
Перед выполнением метода производится анализ параметров вызова и, при необходимости, происходит переадресация вызова глобальному контексту.
Пример:
Клиенты = Справочники.Контрагенты;
НовыйКлиент= Клиенты.СоздатьЭлемент();
НовыйКлиент.ПолучитьФорму().Открыть();
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Изменить свой элемент с комментарием и открыть его обычную форму
Объект получается по существующей собственной ссылке; форма относится к этому объекту, не к новому менеджеру.
Где и как запускать
Толстый клиент, обычная форма.
Подготовка
Только собственная учебная конфигурация. Все указанные имена сначала создайте в Конфигураторе; объекты рабочей базы не заменяйте. Здесь код не запускается.
Толстый клиент в обычном приложении. Создайте свой товар 001, обычную форму элемента и включите историю данных справочника. Вставьте блок в обычную учебную обработку.
Процедура ОткрытьСвойУчебныйТовар()
Ссылка = Справочники.УчебныеТовары.НайтиПоКоду("001");
Если Не ЗначениеЗаполнено(Ссылка) Тогда
ВызватьИсключение "Учебный товар не найден";
КонецЕсли;
Объект = Ссылка.ПолучитьОбъект();
Объект.Наименование = "Собственный учебный товар";
Объект.УстановитьКомментарийВерсииИсторииДанных("Изменено учебное наименование");
Объект.Записать();
ФормаТовара = Объект.ПолучитьФорму();
Если ФормаТовара <> Неопределено Тогда
ФормаТовара.Открыть();
КонецЕсли;
КонецПроцедурыРазбор по шагам
Получите объект собственного элемента.
Измените его наименование и задайте комментарий перед записью.
Получите обычную форму этого же объекта.
Как проверить результат
Не изменяется чужой элемент или первая строка списка.
ПолучитьФорму вызывается на объекте элемента, не на справочнике целиком.
Ожидаемый результат
В будущем запуске сохранено собственное изменение и открыта его форма.
На что обратить внимание
Запись постоянная. Комментарий не включает историю автоматически; форма может вернуть Неопределено при отказе создания.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.