К статье
Практический материал

Разработка и Конфигурация · 10 мин

Как включить документ в подсистему 1С

Как включить документ в подсистему 1С через конфигуратор: настройка состава подсистемы, командный интерфейс, проверка прав доступа и типичные ошибки.

Подсистема в 1С — это элемент конфигурации, который определяет, какие объекты видит пользователь в интерфейсе: в разделах меню, панелях функций и командном интерфейсе. Если документ создан, но не включён ни в одну подсистему, пользователь просто не найдёт его в программе, хотя объект существует и работает. Поэтому включение документа в подсистему — обязательный шаг после добавления нового документа в конфигурацию.

Работа выполняется в конфигураторе и занимает несколько минут, но у неё есть нюансы: порядок следования объектов в подсистеме, видимость по правам доступа, влияние на командный интерфейс раздела. Ниже разобран полный порядок действий — от открытия состава подсистемы до проверки результата в пользовательском режиме.

Что такое подсистема и зачем туда включать документ

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

Если документ не входит ни в одну подсистему, он остаётся доступен только через «Все функции» (при наличии соответствующего права) и не отображается в штатных разделах. Для пользователей такой объект фактически отсутствует. Кроме того, состав подсистем влияет на формирование начальной страницы и на варианты отчётов, привязанные к разделам.

Где найти подсистемы в конфигураторе

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

Найдите подсистему, в которую нужно включить документ. Если разделов много и вы не уверены в выборе, откройте пользовательский режим, посмотрите, в каком разделе логично должен находиться документ, и сопоставьте его с именем подсистемы. Учтите: один документ можно включить сразу в несколько подсистем — тогда он будет виден в нескольких разделах.

Пошаговое включение документа в подсистему

Основной способ — через свойства самой подсистемы. Откройте подсистему двойным щелчком или через контекстное меню «Открыть», перейдите на закладку «Состав». В списке отображаются все объекты конфигурации, сгруппированные по типам: справочники, документы, журналы, отчёты, обработки и так далее. Найдите нужный документ и установите у него флажок.

Альтернативный путь — через свойства самого документа: откройте документ, перейдите на закладку «Подсистемы» и отметьте нужные разделы галочками. Результат идентичен; этот способ удобнее, когда один документ нужно разместить сразу в нескольких разделах.

Порядок действий
  1. 1
    Откройте конфигуратор и дерево метаданных: Общие → Подсистемы
  2. 2
    Откройте нужную подсистему и перейдите на закладку «Состав»
  3. 3
    Найдите документ в ветке «Документы» и установите у него флажок
  4. 4
    Сохраните конфигурацию (Ctrl+S)
  5. 5
    Обновите конфигурацию базы данных (F7 или меню Конфигурация → Обновить конфигурацию базы данных)
  6. 6
    Запустите режим предприятия и проверьте наличие документа в разделе

После установки флажка обязательно обновите конфигурацию базы данных — без этого изменения не попадут в рабочую базу. Если обновление требует реструктуризации (при включении документа в подсистему обычно не требуется), платформа покажет список изменений.

Настройка командного интерфейса подсистемы

Простое включение документа в состав подсистемы добавляет его в командный интерфейс автоматически, но не всегда с нужным оформлением. Для тонкой настройки откройте подсистему и нажмите кнопку «Командный интерфейс» (или «Все команды»). Здесь задаётся, какие команды попадают в панель навигации раздела, какие — в панель действий, и в каком порядке они следуют.

Для документа обычно доступны команды создания («Документ: создать») и открытия списка. Проверьте, что видимость команд включена, и при необходимости переместите команды выше или ниже по списку, чтобы важные документы оказались на видном месте. Если команда отключена в командном интерфейсе, документ формально входит в подсистему, но пользователь его не увидит — это частая причина «пропавшего» документа.

Права доступа и видимость документа

Даже корректно включённый в подсистему документ не отобразится у пользователя, если у его роли нет прав на этот объект. Платформа автоматически скрывает из интерфейса команды, недоступные по правам. Поэтому после включения документа проверьте роли: у пользователя должно быть право «Чтение» (для просмотра списка) и «Добавление» с «Изменением» (для работы с документами).

Если вы создавали новый документ, он не включён ни в одну роль автоматически в ряде случаев — права нужно назначить вручную. Откройте нужную роль (Общие → Роли), найдите документ в списке объектов и установите необходимые права. Проверку всегда выполняйте под учётной записью реального пользователя, а не под администратором с полными правами — под полными правами объект виден всегда, и проблему вы не заметите.

Проверка результата в пользовательском режиме

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

Дополнительно проверьте начальную страницу (рабочий стол): если на ней настроены формы списков документов, новый документ может потребовать отдельного включения в настройки начальной страницы. Также полезно проверить поиск по «Все функции» — документ должен находиться там в любом случае.

Контрольные точки

Как проверить результат

Документ в разделе программы
Норма

Команда создания и список видны в нужном разделе

Тревожный признак

Раздел пуст или документа нет — проверьте состав подсистемы и командный интерфейс

Видимость под обычным пользователем
Норма

Документ доступен пользователю с целевой ролью

Тревожный признак

Виден только администратору — не назначены права в ролях

Создание и сохранение
Норма

Документ создаётся, проводится, попадает в список

Тревожный признак

Ошибки при записи — проверяйте модуль объекта и обязательные реквизиты

Типичные ошибки и ограничения

Самая распространённая ошибка — забыть обновить конфигурацию базы данных после изменения состава подсистемы. Конфигуратор сохраняет изменения в основной конфигурации, но рабочая база продолжает использовать старую версию, пока не выполнено обновление. Вторая частая ситуация — документ включён в подсистему, но его команды отключены в командном интерфейсе раздела.

Ещё три типичных просчёта: проверка видимости только под полными правами; включение документа не в ту подсистему (пользователь ищет его в другом разделе); попытка изменить типовую подсистему в конфигурации на поддержке без необходимости — в таком случае лучше создать собственную подсистему и включить документ в неё.

Типичные ошибки
01
Не обновлена конфигурация базы данных — изменения не видны пользователям
02
Команды документа отключены в командном интерфейсе подсистемы
03
Проверка только под полными правами — проблемы с ролями остаются незамеченными
04
Изменение типовой подсистемы на поддержке — сложности при обновлении конфигурации
05
Документ включён не в тот раздел — пользователи не находят его в привычном месте

Можно ли включить документ в подсистему без конфигуратора

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

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

Маршрут решения

Как выбрать действие

Конфигурация доработанная, снята с полной поддержкиВключайте документ в существующую подсистему через закладку «Состав»
Конфигурация типовая на полной поддержкеИспользуйте расширение конфигурации или создайте отдельную подсистему с минимальными изменениями
Документ виден администратору, но не пользователюНастройте права в ролях, а не состав подсистемы
Нужно только переставить команды местами для себяИспользуйте персональные настройки навигации раздела в режиме предприятия
Итог

Что важно запомнить

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

Частые вопросы

Документ включён в подсистему, но не виден в разделе. Что проверить?

Проверьте три вещи по порядку: обновлена ли конфигурация базы данных (F7 в конфигураторе); включены ли команды документа в командном интерфейсе подсистемы; есть ли у роли пользователя права «Чтение» и «Добавление» на этот документ. Чаще всего причина в правах.

Можно ли включить один документ в несколько подсистем?

Да. Установите флажки напротив документа в составе каждой нужной подсистемы или отметьте несколько подсистем на закладке «Подсистемы» в свойствах документа. Документ будет отображаться во всех выбранных разделах.

Чем включение в подсистему отличается от включения в журнал документов?

Подсистема определяет видимость документа в разделах интерфейса, а журнал — это список, объединяющий несколько видов документов для совместного просмотра. Это независимые настройки: документ может быть в подсистеме, но не входить ни в один журнал, и наоборот.

Нужно ли включать документ в подсистему, если он используется только программно?

Если документ создаётся и обрабатывается исключительно кодом (обменами, фоновыми заданиями) и пользователи не должны его видеть, включать его в подсистему не нужно. Доступность через «Все функции» сохраняется независимо от состава подсистем.

Как добавить документ в раздел типовой конфигурации, не снимая её с поддержки?

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

Почему после включения документа в подсистему он появился у всех пользователей, включая тех, кому не нужен?

Интерфейс раздела формируется единым для всех, но фактическая видимость команд зависит от прав. Если документ виден лишним пользователям, значит, у их ролей есть права на этот объект. Скорректируйте состав ролей или воспользуйтесь функциональными опциями для управляемого скрытия команды.