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

Другое · 6 мин

Как добавить справочник в 1С:Документооборот

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

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

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

Ниже описан общий порядок действий, условия применения и признаки того, что результат получен корректно. Инструкция не заменяет документацию разработчика и не претендует на описание конкретной редакции.

Когда справочник действительно нужен

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

Перед созданием объекта стоит убедиться, что задача не решается простым добавлением реквизита к существующему справочнику или использованием перечня значений. Лишние справочники усложняют поддержку и замедляют работу пользователей.

Подготовка и требования к конфигурации

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

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

Добавление справочника через конфигуратор

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

Порядок действий
  1. 1
    Открыть конфигурацию в режиме редактирования
  2. 2
    Создать объект типа Справочник в дереве метаданных
  3. 3
    Настроить реквизиты, представление и иерархию
  4. 4
    Сохранить и скомпилировать конфигурацию
  5. 5
    Обновить базу данных конфигурации
  6. 6
    Проверить появление справочника в интерфейсе

Важно корректно задать уникальное имя объекта, так как оно используется в программном коде и запросах. Синоним отображается пользователям и может быть изменён позже без потери связей.

Связь справочника с документами и карточками

Сам по себе созданный справочник не появляется в карточках документов автоматически. Нужно добавить реквизит нужного типа в форму документа или бизнес-процесса и связать его с новым справочником. Также настраиваются отбор, обязательность заполнения и права доступа.

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

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

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

Появление справочника в списке выбора
Норма

Значения отображаются и выбираются

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

Справочник отсутствует или выдаёт ошибку

Сохранение документа с новым реквизитом
Норма

Документ сохраняется и открывается повторно

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

Ошибка при записи или потеря значения

Доступ пользователей
Норма

Роли видят нужные значения

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

Права ограничивают доступ к справочнику

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

После обновления базы открывается карточка документа, в котором появился новый реквизит. Пользователь должен видеть справочник в списке, выбирать значения и сохранять документ без ошибок. Также проверяется работа на сервере и в тонком клиенте, если оба варианта используются.

Права на чтение и запись настраиваются через роли и профили доступа. Если пользователи не видят новые значения, причина часто кроется не в самом справочнике, а в отсутствии прав на объект или форму.

Типичные ошибки
01
Создание справочника без привязки к формам документов — объект не используется
02
Редактирование рабочей базы без резервной копии — риск потери данных
03
Игнорирование прав доступа — пользователи не видят новые значения

Ограничения и частые ошибки

Нельзя добавлять справочник с именем, совпадающим с существующим объектом конфигурации. Также не рекомендуется вносить изменения в рабочую базу в часы пик или без согласования с администратором информационной базы.

Частая ошибка — создание справочника без связки с формами документов. В результате объект существует в конфигурации, но не используется в бизнес-процессах. Другая ошибка — игнорирование обновлений типовых конфигураций, которые могут перезаписать ручные доработки.

Сравнение вариантов

Новый справочник

Подходит для самостоятельных классификаторов, требует доработки форм и прав

Реквизит существующего справочника

Быстрее внедрить, но ограничен структурой базового объекта

Перечисление или список значений

Удобно для небольшого фиксированного набора, не требует отдельного объекта

Альтернативы и когда не стоит добавлять справочник

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

Если конфигурация закрыта для изменений, безопасным вариантом может быть обращение к поставщику или использование общего модуля без изменения метаданных. Принятие решения зависит от условий лицензии и правил поддержки конфигурации.

Итог

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

Справочник создаётся в конфигураторе, связывается с документами и проверяется на копии базы с резервной копией перед изменениями.

Нужны ли права администратора для добавления справочника?

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

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

Технически возможно, но небезопасно. Рекомендуется сначала отработать процедуру на копии базы, сделать резервную копию и только потом переносить изменения в рабочую среду.

Почему новый справочник не появляется в карточке документа?

Создание объекта в конфигураторе не делает его видимым в форме автоматически. Нужно добавить реквизит нужного типа в форму документа, связать его со справочником и обновить базу конфигурации.

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

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