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

Другое · 6 мин

Добавление собственного документа в версионирование 1С

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

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

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

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

Когда документ можно взять под версионирование

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

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

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

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

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

Порядок включения версионирования для документа

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

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

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

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

Как проверить, что версионирование работает

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

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

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

История версий документа
Норма

Новые изменения отображаются в списке версий

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

История пуста или не открывается

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

Документ открывается и редактируется в обычном режиме

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

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

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

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

Включение версионирования увеличивает объём хранимой информации, так как система сохраняет копии изменений. На больших базах это может повлиять на размер резервных копий и скорость некоторых операций.

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

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

Типичные ошибки
01
Изменение типовой конфигурации без прав и без резервной копии
02
Пропуск обновления базы после сохранения конфигурации
03
Включение версионирования напрямую в рабочей базе без тестирования

Альтернативы и что делать, если включение недоступно

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

Для критически важных документов полезно сочетать версионирование с ограничением прав на редактирование и обязательным комментарием к каждому изменению. Это упростит поиск причины проблемы при откате.

Итог

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

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

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

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

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

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

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

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

Влияет ли версионирование на производительность базы?

Может влиять, так как система хранит дополнительные копии изменений. На больших базах стоит оценить рост объёма данных и размер резервных копий перед массовым включением.