Рассмотрим весьма распространенную и неприятную ситуацию, с которой сталкиваются многие администраторы и разработчики 1С. У вас есть рабочая клиент-серверная база данных. Вы снимаете с нее актуальную копию средствами SQL и восстанавливаете (разворачиваете) эту копию поверх тестовой базы, чтобы проверить доработки на свежих данных. Процесс проходит успешно, вы заходите в тестовую базу, но при попытке создать и записать абсолютно ЛЮБОЙ новый документ или элемент справочника система выдает критическую ошибку: «Значение поля 'Код' (или 'Номер') не уникально». Для автоматизации регулярного резервного копирования и технического обслуживания баз перед проведением подобных работ часто используется программа для пакетного архивирования и тестирования 1С.
При этом, если мы посмотрим на оригинальную рабочую базу, то там все функционирует безупречно, никаких ошибок нумерации нет. Проанализируем ситуацию подробнее, выясним причину такого поведения платформы 1С:Предприятие и разберем по шагам все доступные способы решения этой проблемы.
Чтобы понять корень проблемы, давайте посмотрим на то, как сервер 1С:Предприятия управляет автоматической нумерацией объектов.
В платформе 1С информация о текущем состоянии нумераторов (какой номер был выдан последним, какие номера зарезервированы за текущими сеансами) не запрашивается из базы данных при создании каждого нового документа. Для обеспечения высокой производительности эти данные кэшируются и хранятся в оперативной памяти сервера приложений — то есть в рабочих процессах rphost. Сервер один раз высчитывает максимальные номера, а затем просто инкрементирует их в памяти, раздавая новым документам.
Когда вы восстанавливаете бэкап SQL напрямую поверх существующей тестовой базы, вы меняете данные на уровне СУБД. Однако сервер приложений 1С про то, что у него «из-под носа» увели одну физическую базу и подсунули другую, вообще не в курсе! В его оперативной памяти (в потрохах процессов сервера) остается кэш нумераторов от старого состояния тестовой базы.
В результате возникает конфликт: сервер 1С пытается присвоить новому документу номер из своего старого кэша, но этот номер либо уже существует в новых восстановленных данных, либо не соответствует текущей хронологии. Платформа делает попытку записи в базу данных, СУБД проверяет индекс уникальности по полю номера или кода, обнаруживает дубликат и возвращает ошибку «Значение поля 'Код' не уникально».
Проанализируем самый правильный и чистый способ переноса данных, который гарантированно предотвращает возникновение описанной проблемы. Суть заключается в том, чтобы заставить сервер 1С очистить кэш конкретной информационной базы.
Почему это работает? Когда вы удаляете информационную базу из кластера 1С, сервер полностью сбрасывает все связанные с ней внутренние кэши, сеансы и состояния нумераторов. При повторном создании база считается для сервера «новой», и при первом старте он честно перечитает актуальные данные напрямую из таблиц SQL.
Если вы уже накатили SQL-бэкап поверх существующей базы и столкнулись с ошибками, ситуацию можно спасти простым аппаратным сбросом памяти рабочих процессов.
Поскольку закэшированные значения нумераторов хранятся в оперативной памяти рабочих процессов rphost, их можно очистить перезапуском службы сервера 1С:Предприятие. После того как вы остановите и снова запустите службу, оперативная память очистится. При первом входе пользователей в базу и создании новых объектов, платформа будет вынуждена выполнить запросы к SQL-серверу, чтобы найти максимальные существующие номера в базе данных и инициализировать нумераторы корректно.
Важно: этот способ обрывает сеансы всех пользователей во всех базах, находящихся на данном сервере 1С. Применяйте его только в нерабочее время или на выделенных тестовых серверах.
Рассмотрим программный метод решения. В платформе 1С:Предприятие существует специальный глобаный метод, который принудительно заставляет сервер сбросить счетчики номеров и установить их на последний фактически использованный номер в таблицах базы данных. Этот метод — ОбновитьНумерациюОбъектов.
Его можно использовать во внешних обработках. Посмотрим на пример кода:
// Пример 1: Полное обновление нумерации для всей конфигурации.
// Внимание: может занять продолжительное время на больших базах.
ОбновитьНумерациюОбъектов();
// Пример 2: Точечное обновление нумерации для конкретного справочника.
// Этот вариант предпочтительнее, так как отрабатывает быстрее и не нагружает систему.
ОбновитьНумерациюОбъектов(Метаданные.Справочники.Номенклатура);
// Пример 3: Точечное обновление нумерации для конкретного документа.
ОбновитьНумерациюОбъектов(Метаданные.Документы.РеализацияТоваровУслуг);
Вызов этого метода заставляет платформу перечитать данные из СУБД, найдя максимальный текущий номер/код, и установить внутренний счетчик сервера 1С на следующее по порядку значение. Это снимает ошибку неуникальности. Чтобы выполнить эту процедуру без ручного написания кода, можно использовать готовую обработку для обновления нумерации объектов и сброса счетчиков.
Иногда ошибка «Значение поля 'Код' не уникально» возникает в рабочей базе без всяких переносов. Разберем по шагам основные причины таких инцидентов:
Если нумерация сбилась из-за ручного изменения кода пользователем или загрузки данных с ошибочными номерами, метод ОбновитьНумерациюОбъектов не поможет, так как максимальный номер в базе является некорректным. Разберем, как это исправить.
Шаг 1. Поиск «сбойного» элемента. Откройте проблемный справочник (в виде списка, без иерархии) или журнал документов. Отсортируйте колонку с кодом (или номером) по убыванию. Вам нужно визуально найти тот элемент, который выбивается из общей логики нумерации (например, номер «9999» среди номеров формата «0045»).
Шаг 2. Ручное исправление. Откройте найденный сбойный объект и вручную исправьте его номер или код на правильный, соответствующий хронологии (или просто очистите поле номера и запишите объект, чтобы 1С сама присвоила правильный следующий номер).
Шаг 3. Массовая перенумерация. Если сбойных документов слишком много, воспользуйтесь стандартной обработкой «Универсальные подбор и обработка объектов». В ней есть специальный раздел, позволяющий задать новый начальный номер, префикс и автоматически перенумеровать выбранный пул объектов в строгом хронологическом порядке, опираясь на даты создания документов. Для решения этой задачи также подойдёт инструмент для перенумерации документов и справочников с контролем префиксов и уникальности кодов.
Применяя эти знания и инструменты на практике, вы сможете легко устранять проблемы с уникальностью кодов и номеров, а также поддерживать порядок в базах 1С:Предприятия.