Как программно открыть форму журнала документов в 1С:Управление торговлей 11 и избежать ошибки «Неизвестное имя формы»?

← На главную

При программной работе с интерфейсом в среде «1С:Предприятие 8.3» разработчики нередко сталкиваются с ситуацией, когда попытка открыть форму объекта завершается ошибкой с сообщением «Неизвестное имя формы». Особенно часто это происходит при переходе от работы с обычными формами к управляемым или при обращении к объектам журналов документов. Разберем по шагам, почему возникает такая ошибка, как устроена адресация форм в платформе и как правильно открывать списки журналов в соответствии со стандартами разработки.

Анализ проблемы: почему возникает ошибка «Неизвестное имя формы»

Рассмотрим ситуацию, с которой столкнулся разработчик. При попытке выполнить следующий код система выдает исключение:


Форма = ПолучитьФорму("Журнал.ЧекиККМ.Форма.ФормаСписка");
Форма.Открыть();

При этом в дереве метаданных конфигурации журнал документов с именем ЧекиККМ присутствует, и у него действительно существует подчиненная форма ФормаСписка. Однако платформа выдает ошибку поиска имени формы.

Выясним причину такого поведения платформы. В объектной модели «1С:Предприятие 8» имя класса метаданных для журналов строго зафиксировано — ЖурналДокументов (в англоязычной нотации — DocumentJournal). Сокращение Журнал являлось синтаксической конструкцией старых платформ (в частности, 1С 7.7) и не поддерживается восьмой версией при адресации путей к формам. Любая строка вида "Журнал.<ИмяЖурнала>..." является некорректным путем, что и приводит к системному сообщению о неизвестной форме.

Правильный синтаксис указания пути к форме журнала

Проанализируем структуру строки пути к форме управляемого приложения. Платформа 1С поддерживает два варианта обращения к формам списков объектов конфигурации:

Обращение к стандартной (основной) форме списка: в этом случае достаточно указать класс метаданных, имя объекта и стандартное имя формы списка. Платформа автоматически откроет ту форму, которая назначена основной в свойствах журнала:Форма = ПолучитьФорму("ЖурналДокументов.ЧекиККМ.ФормаСписка");
Обращение к конкретной подчиненной форме объекта: если требуется открыть строго определенную форму журнала (например, если их создано несколько под разные сценарии), путь формируется с явным указанием ключевого слова Форма:Форма = ПолучитьФорму("ЖурналДокументов.ЧекиККМ.Форма.ФормаСписка");

Оптимизация кода для управляемых форм: переход на метод «ОткрытьФорму»

Рассмотрим важный нюанс архитектуры управляемого приложения (в частности, в конфигурации «1С:Управление торговлей 11»). Использование устаревшей связки ПолучитьФорму() и последующего вызова метода Форма.Открыть() не рекомендуется стандартом разработки 1С. Такой подход влечет за собой избыточные вызовы контекста и инициализацию объекта формы на клиенте еще до момента ее отображения.

В управляемом клиенте для открытия формы списка журнала документов следует применять стандартную процедуру ОткрытьФорму(). Посмотрим на правильный и современный пример реализации:

ОткрытьФорму("ЖурналДокументов.ЧекиККМ.ФормаСписка");

Если требуется открыть конкретную форму, не являющуюся основной, используем явное имя:

ОткрытьФорму("ЖурналДокументов.ЧекиККМ.Форма.ФормаСписка");

Передача параметров и установка отборов при открытии

Часто журнал требуется открыть не просто в исходном виде, а с определенными параметрами, например, установив фильтрацию или позиционирование на нужной строке. Метод ОткрытьФорму() позволяет передать структуру параметров вторым аргументом. Разберем практический пример:


ПараметрыФормы = Новый Структура;
// При необходимости передаем параметры открытия
ОткрытьФорму("ЖурналДокументов.ЧекиККМ.ФормаСписка", ПараметрыФормы);

Альтернативный вариант: навигационная ссылка

Иногда требуется открыть форму журнала так, как если бы пользователь нажал на пункт меню в интерфейсе или панели разделов. В этом случае полезно применить команду перехода по внутренней навигационной ссылке платформы:

ПерейтиПоНавигационнойСсылке("e1cib/list/ЖурналДокументов.ЧекиККМ");

Дополнительные причины возникновения ошибки

Если строка метаданных написана без ошибок (ЖурналДокументов.<Имя>.ФормаСписка), но ошибка «Неизвестное имя формы» все равно продолжает появляться, проанализируем сопутствующие факторы:

Права доступа (роли и RLS): если у текущего пользователя в назначенных ролях сняты права на «Просмотр» или «Интерактивное открытие» данного журнала документов или самой формы, платформа 1С в целях безопасности может блокировать доступ, выдавая сообщение об отсутствии или неизвестности формы.
Расширения конфигурации: если журнал документов или его форма переопределены в подключенном расширении, необходимо проверить корректность заимствования имени формы и соответствие режимов совместимости.