Как работает автонумерация справочников в 1С

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

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

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

Как устроен механизм автонумерации в платформе 1С

Код справочника — это системный реквизит, который присутствует у любого справочника, если в конфигураторе не установлена нулевая длина кода. Когда свойство «Автонумерация» включено, платформа при записи нового элемента с пустым кодом сама генерирует значение. Если автонумерация выключена, код придётся вводить вручную или присваивать программно — иначе элемент запишется с пустым кодом.

Для числовых кодов платформа увеличивает максимальное значение на единицу. Для строковых кодов логика сложнее: система пытается интерпретировать код как число и увеличить его, сохраняя лидирующие нули. Именно поэтому код «000000125» корректно продолжается как «000000126», а код «АБВ-15» может «сломать» последовательность — буквенная часть не инкрементируется ожидаемым образом.

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

Где включается автонумерация и какие свойства на неё влияют

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

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

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

1. 1
   Откройте конфигуратор и найдите нужный справочник в дереве конфигурации
2. 2
   Откройте палитру свойств справочника, закладка «Нумерация»
3. 3
   Установите флажок «Автонумерация» и при необходимости «Контроль уникальности»
4. 4
   Проверьте тип и длину кода на закладке «Данные»
5. 5
   Обновите конфигурацию базы данных (F7) и проверьте создание нового элемента в режиме предприятия

Как платформа выбирает следующий код

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

Классический пример: в справочник «Номенклатура» загрузили элементы с кодами вида «УТ-00012345». Длина такого кода (11 символов) превышает типовые 9, и он содержит буквы. Следующий созданный вручную элемент получит код «000000001», потому что платформа не может продолжить «буквенную» последовательность и начинает отсчёт заново. Это не ошибка программы, а следствие формата загруженных данных.

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

Типичные сбои автонумерации и их причины

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

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

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

Как восстановить нумерацию после сбоя

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

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

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

Программное управление нумерацией: методы и события

Для разработчика доступны два основных инструмента. Метод УстановитьНовыйКод() объекта справочника принудительно присваивает следующий код по правилам автонумерации — его вызывают в обработчиках перед записью, когда нужен гарантированно уникальный код в нестандартной логике. Событие ПриУстановкеНовогоКода модуля объекта позволяет переопределить формирование кода: добавить префикс, изменить серию или отказаться от стандартного формирования.

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

Процедура ПриУстановкеНовогоКода(СтандартнаяОбработка, Префикс)
	Префикс = "НГ-";
КонецПроцедуры

Как проверить, что нумерация работает правильно

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

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

Частые вопросы об автонумерации справочников