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

Другое · 7 мин

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

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

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

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

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

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

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

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

Номер вводится вручнуюРиск дублей выше

Нужно добавить проверку перед записью и поиск существующих номеров

Номер присваивается автоматическиПлатформа или конфигурация контролирует выпуск

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

Документы разных организацийМогут иметь одинаковые номера

Уточните, распространяется ли уникальность на всю базу или только внутри организации

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

Где настраивается уникальность номера документа

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

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

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

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

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

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

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

Отдельные сценарии: управляемые и обычные формы

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

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

Особенности одновременной работы и блокировок

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

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

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

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

Попытка сохранить документ с существующим номером
Норма

Система отклоняет запись и показывает сообщение

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

Документ сохраняется с дублирующим номером

Отчет по существующим документам
Норма

Нет групп с одинаковыми номерами в выбранной области

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

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

Как проверить уже существующие дубликаты

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

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

Ограничения и риски самостоятельных изменений

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Могут ли два документа иметь одинаковый номер?

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

Что делать, если нашли дубли уже проведенных документов?

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

Безопасно ли менять настройки нумерации в рабочей базе?

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

Защищает ли проверка перед записью от одновременного создания дублей?

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