Описывает форму, которая будет вызвана системой для просмотра и редактирования объекта документа, в случае если основная форма не установлена или не может быть использована в конкретном варианте использования 1С:Предприятия.
Полное описание, параметры и ограничения
ОбъектМетаданных: Документ.ДополнительнаяФормаОбъекта (MetadataObject: Document.AuxiliaryObjectForm)
ОбъектМетаданных: Документ (MetadataObject: Document)
ДополнительнаяФормаОбъекта (AuxiliaryObjectForm)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Описывает форму, которая будет вызвана системой для просмотра и редактирования объекта документа, в случае если основная форма не установлена или не может быть использована в конкретном варианте использования 1С:Предприятия.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Примечание:
Если данное свойство не было задано на этапе конфигурирования, то оно имеет значение Неопределено, и система генерирует форму по умолчанию.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Проверить документ без собственных форм
В маленькой учебной заявке формы не добавлены. Проверяем отсутствие шести назначений и объясняем, почему платформа всё равно может показать сгенерированную форму.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Создайте серверный общий модуль УчебныеЗадачи и команду учебной обработки, вызывающую ВыполнитьПример() Экспорт. Каждый фрагмент выполняйте отдельно, не склеивайте их в одну процедуру.
Документы → Добавить: имя УчебнаяЗаявка, тип номера Строка, длина 9, автонумерация включена. Проведение запретите: это только учебный документ без движений.
Добавьте реквизит Комментарий (Строка, длина 100) и табличную часть Товары: Товар (СправочникСсылка.УчебныеТовары), Количество (Число, 9 цифр, 0 дробных, неотрицательное), Цена (Число, 12 цифр, 2 дробных, неотрицательное). Модуль документа пустой.
Обновите конфигурацию базы данных. Эти имена существуют только в созданной учебной конфигурации, не подразумеваются в типовой базе.
Выполняйте только в новой базе Учебная85. Проверки читают настройки УчебнаяЗаявка; документы не создаются, не записываются и не проводятся.
Не добавляйте документу свои команды, макеты, характеристики, дополнительные индексы или основания ввода. Расширения в учебную базу не устанавливайте.
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если Метаданные.Документы.Найти("УчебнаяЗаявка") = Неопределено Тогда
ВызватьИсключение "Сначала создайте УчебнаяЗаявка по подготовке";
КонецЕсли;
Описание = Метаданные.Документы.УчебнаяЗаявка;
Сообщить(Описание.Формы.Количество() = 0);
Сообщить(Описание.ОсновнаяФормаОбъекта = Неопределено);
Сообщить(Описание.ОсновнаяФормаСписка = Неопределено);
Сообщить(Описание.ОсновнаяФормаДляВыбора = Неопределено);
Сообщить(Описание.ДополнительнаяФормаОбъекта = Неопределено);
Сообщить(Описание.ДополнительнаяФормаСписка = Неопределено);
Сообщить(Описание.ДополнительнаяФормаДляВыбора = Неопределено);
Сообщить("Стандартные команды документа: " + Строка(Описание.ИспользоватьСтандартныеКоманды));Разбор по шагам
У УчебнаяЗаявка не создаём формы вручную. Формы — коллекция определений, а основные/дополнительные назначения — ссылки на определения или Неопределено.
Неопределено обрабатываем сравнением, не обращаемся к .Имя отсутствующей формы.
Отсутствие назначенной основной формы не означает запрета стандартного открытия: платформа может генерировать форму по правилам клиентского режима.
ИспользоватьСтандартныеКоманды отдельно влияет на стандартные действия. Сам код окно не открывает и не тестирует кнопки реального документа.
Как проверить результат
Семь проверок дают Истина; последнее сообщение показывает настройку стандартных команд.
Если вы ранее создали форму заявки, ожидание нуля не подходит: используйте отдельную свежую учебную конфигурацию или пересмотрите проверки.
Ожидаемый результат
Разбор пустых назначений без ошибочного вывода о невозможности открытия документа.
На что обратить внимание
Сгенерированная форма — не новый объект метаданных, добавленный в коллекцию Формы.
Этот урок не удаляет существующие формы и не запускает ОткрытьФорму для рабочего документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.