Другое · 7 мин
Обращение к форме списка документа в 1С
Как открыть форму списка документа в 1С: через команды интерфейса и программно, с учётом прав доступа, проверкой результата и ограничениями управляемого приложения.
Форма списка документа в 1С предназначена для просмотра экземпляров документа, фильтрации, сортировки и перехода к карточке конкретной записи. Доступ к ней определяется не только наличием формы в конфигурации, но и типом приложения, набором прав и видимостью команды в интерфейсе.
Различают управляемые и обычные формы. В управляемом приложении имя формы обычно имеет вид «Документ.ИмяДокумента.ФормаСписка», а открытие выполняется стандартной платформенной командой или методом ОткрытьФорму. В обычном приложении порядок открытия может зависеть от типа клиента и способа вызова, поэтому универсальная инструкция без уточнения конфигурации невозможна.
Программное обращение к форме списка не отменяет проверки прав доступа. Даже если форма откроется, пользователь может видеть пустой список или ограниченный набор записей из-за правил ограничения доступа к данным. Перед изменением конфигурации или ролей рекомендуется проверять поведение на отдельной базе или копии рабочей информации.
От чего зависит доступ к форме списка
Первым делом нужно определить, какая форма используется: управляемая или обычная. Управляемые формы чаще встречаются в современных конфигурациях и открываются через унифицированный механизм платформы. Обычные формы могут требовать иного контекста вызова и ведут себя по-разному в тонком и толстом клиенте.
Второй фактор — права пользователя. Открытие формы списка не даёт автоматически права на просмотр документов. Если права ограничены, форма может открыться, но список окажется пустым или содержать только доступные записи. Также команда «Список» или «Все» может отсутствовать в панели навигации, если она скрыта настройками интерфейса или правами на раздел.
Управляемое приложение
В управляемом приложении форма списка чаще всего открывается стандартной командой из раздела «Документы» или из карточки документа. Имя формы в конфигураторе можно посмотреть в ветке документа, подраздел «Формы», объект «ФормаСписка». Если команда не отображается, проверьте состав навигации и права на открытие раздела.
Обычное приложение
В обычном приложении открытие может выполняться через меню, панель команд или программный вызов с указанием владельца и контекста. Поведение зависит от версии платформы и типа клиента, поэтому перед внедрением изменения стоит проверить открытие формы в том же клиенте, где работают пользователи.
- 1Перейдите в раздел «Документы» и выберите нужный документ
- 2Нажмите команду «Список» или «Все» в панели команд
- 3Убедитесь, что открылась форма списка, а не карточка одного документа
- 4Если команда отсутствует, проверьте навигацию и права доступа
Программное обращение к форме списка
Для открытия формы из кода используется метод ОткрытьФорму с указанием полного имени формы. Примерное имя для управляемой формы: «Документ.Продажи.ФормаСписка», где Продажи — имя документа в конфигурации. Точное имя нужно брать из свойств формы в конфигураторе, а не предполагать по названию документа.
Можно передать параметры открытия, если форма списка поддерживает параметры, например для установки начального фильтра или контекста. Владелец формы и режим открытия выбираются в зависимости от того, из какого модуля выполняется вызов: из модуля объекта, команды, общей формы или внешнего обработки.
После вызова ОткрытьФорму платформа пытается отобразить форму. Если форма не найдена, возникнет ошибка при выполнении. Если форма открыта, но данные не отображаются, причиной обычно становятся права доступа или фильтры, а не ошибка самого открытия формы.
Параметры и контекст открытия
При программном открытии важно уточнить, откуда выполняется вызов. Из модуля документа контекст часто понятен сам по себе, из общего модуля может потребоваться явно указать параметры формы или владельца. Неправильный контекст может привести к открытию формы без связи с текущим документом или к ошибке выполнения.
Если форма списка принимает параметры, их значения должны соответствовать типам, описанным в свойствах формы. Передача неверного типа или отсутствие обязательного параметра может привести к тому, что форма не откроется или откроется с некорректным начальным состоянием.
Проверка результата и ограничения
Успешным результатом считается открытие окна формы списка с заголовком документа и отображением записей, доступных пользователю. Если открылась карточка одного документа, значит вызвана форма объекта, а не форма списка. Если список пустой, проверьте фильтры, права и отбор, а не только сам факт открытия формы.
Как проверить результат
Виден заголовок документа и таблица записей
Открыта карточка документа или ошибка при выполнении
Отображаются доступные документы
Пустой список или сообщение об отсутствии прав
Ограничение: программное открытие формы не заменяет настройку прав и не даёт возможности обойти ограничение доступа к данным. Также форма может быть недоступна в веб-клиенте или мобильном приложении, если конфигурация не поддерживает соответствующий тип клиента для этой формы.
Частые ошибки и способы их исправления
Ошибка использования неполного или выдуманного имени формы. Нужно брать точное имя из конфигуратора, а не составлять его вручную по названию документа. Ошибка игнорирования прав: форма открыта, но данные не видны, поэтому проверка прав обязательна. Ошибка вызова из неподходящего контекста: без владельца или параметров форма может открыться не в том режиме.
Если команда списка отсутствует в интерфейсе, не стоит сразу программировать новую кнопку. Сначала проверьте настройку навигации, права на раздел и видимость команды для текущего пользователя. Часто достаточно добавить команду в панель действий или выдать роль на просмотр раздела.
Альтернативы и границы самостоятельной работы
Если стандартная команда списка не подходит, можно создать внешнюю обработку с формой списка или отчётом, но это требует разработки и тестирования. Альтернативой может быть настройка существующего отчёта или динамического списка без изменения конфигурации. Самостоятельно безопасно менять права и навигацию только в тестовой базе; изменение форм и модулей лучше доверять разработчику 1С.
Что важно запомнить
Открывайте форму по точному имени из конфигуратора, проверяйте тип приложения, права и видимость команды, а пустой список интерпретируйте как вопрос прав или фильтров, а не только ошибки открытия.
Часто задаваемые вопросы
Можно ли открыть форму списка документа без программирования?
Да, если в конфигурации существует форма списка и команда её открытия доступна в разделе «Документы». Достаточно выбрать документ и нажать «Список» или «Все». Если команда скрыта, настройте навигацию или проверьте права на раздел.
Почему форма открывается, но список пустой?
Скорее всего, пользователь не имеет прав на просмотр документов этого вида или действуют фильтры и отбор. Открытие формы не отменяет ограничение доступа к данным, поэтому проверьте роли, права и текущие фильтры формы.
Какое имя формы указывать в коде?
Указывайте точное имя из свойств формы в конфигураторе, например в формате «Документ.ИмяДокумента.ФормаСписка» для управляемых форм. Не составляйте имя вручную по названию документа, иначе метод ОткрытьФорму не найдёт форму.
Нужно ли резервное копирование перед настройкой прав?
Рекомендуется проверять изменения прав и навигации на копии базы, а затем переносить проверенные настройки в рабочую. Прямые изменения в рабочей базе без копии могут ограничить доступ пользователей к документам.