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

Другое · 5 мин

Как создать свой нумератор в 1C

Как создать собственный нумератор в 1C: порядок действий, регистр сведений, уникальность номера и проверка результата без риска для данных пользователя.

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

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

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

Когда стандартной нумерации недостаточно

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

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

Основные способы реализации

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

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

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

Нумерация по году и серии

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

Создание регистра сведений для последнего номера

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

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

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

Код получения номера обычно размещают в модуле документа в обработчике «ПередЗаписью» или при заполнении, перед проведением. Номер присваивается реквизиту объекта непосредственно перед сохранением в базу.

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

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

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

Номер нового документа
Норма

Соответствует заданному правилу и не повторяет существующий

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

Повторяется или отсутствует после сохранения

Защита от дублей и параллельная работа

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

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

Типичные ошибки
01
Отсутствие блокировки при одновременной работе приводит к одинаковым номерам
02
Запись номера после проведения документа ломает последовательность
03
Изменение типа номера без теста на копии базы

Проверка результата и частые ошибки

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

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

Итог

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

Свой нумератор оправдан, когда стандартные серии не подходят; ключевые условия — хранение последнего значения, транзакция и проверка на копии базы.

Нужно ли программировать собственный нумератор в любом случае?

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

Где лучше хранить последний номер?

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

Как избежать дублей при работе нескольких пользователей?

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

Можно ли менять номера у уже проведённых документов?

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