Как добавить идентификатор в 1С: Пошаговая инструкция

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

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

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

Подготовка структуры метаданных в Конфигураторе

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

Критически важно правильно выбрать тип данных для нового поля. Для хранения глобального уникального идентификатора наиболее подходящим типом является Строка. Длина такой строки должна быть достаточной для размещения стандартного формата GUID, который обычно состоит из 36 символов (с учетом дефисов) или 32 символов в шестнадцатеричном формате без разделителей. Рекомендуется устанавливать длину поля с запасом, например, 40 или 50 символов, чтобы избежать усечения данных при возможных изменениях форматов в будущем.

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

⚠️ Внимание: Перед внесением любых изменений в конфигурацию обязательно создайте резервную копию базы данных (файл.dt). Restoration структуры метаданных после ошибки может быть невозможна без отката к предыдущей версии.

☑️ Подготовка к изменению метаданных

Запустить 1С в режиме КонфигураторСоздать резервную копию базы (.dt)Найти нужный объект в дереве метаданныхПроверить права доступа на изменение

Выполнено: 0 / 4

Настройка свойств и индексации нового поля

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

В окне свойств реквизита найдите параметр, отвечающий за индексацию, и установите значение Индексировать. Это действие создаст служебную структуру в базе данных (SQL Server, PostgreSQL или файловую), которая позволит системе мгновенно находить запись по значению вашего идентификатора. Без индекса поиск по строковому полю в таблице с миллионами строк может занимать недопустимо много времени.

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

Параметр настройки	Рекомендуемое значение	Цель настройки
Тип данных	Строка (40)	Вместимость стандартного GUID
Индекс	Индексировать	Ускорение поиска и отборов
Заполнение	Проверять заполнение	Контроль целостности данных
Использование в запросах	Разрешено	Доступность для отчетов и обработок

💡

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

Автоматическая генерация идентификатора при создании

Ручной ввод уникальных кодов неэффективен и чреват ошибками, поэтому логичнее автоматизировать этот процесс. Для генерации уникальной строки в языке 1С существует встроенная функция Новый Уникальный Идентификатор. Она возвращает объект типа Уникальный Идентификатор, который необходимо преобразовать в строку перед записью в наш реквизит.

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) // Генерация нового GUID и преобразование в строку Объект.ВнешнийИдентификатор = Строка(Новый Уникальный Идентификатор);

КонецПроцедуры

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

Почему именно Строка(Новый Уникальный Идентификатор)

Функция Новый Уникальный Идентификатор возвращает специальный объект. Для записи в поле типа"Строка" необходимо явное преобразование типов. Без функции Строка возникнет ошибка типов при попытке записать объект в текстовое поле базы данных.

Обработка существующих данных и миграция

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

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

🔍 Откройте обработку «Групповое изменение реквизитов» (если доступна в вашей конфигурации).
📝 Выберите объект метаданных, который нужно обновить.
⚙️ Укажите реквизит ВнешнийИдентификатор в качестве целевого поля.
🚀 Запустите процесс заполнения, используя выражение генерации УИД.

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

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

Интеграция и использование во внешних системах

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

При настройке обмена данными через HTTP-сервисы или обработку XML/JSON, используйте созданное поле как ключевой атрибут. Это позволит внешней системе однозначно идентифицировать объект при повторной передаче данных. Например, при обновлении статуса заказа интернет-магазин будет передавать именно этот ВнешнийИдентификатор, а 1С по нему найдет нужный документ.

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

Типичные ошибки и способы их устранения

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

Другая частая проблема связана с длиной строки. Если вы выбрали тип «Строка» длиной 10 символов, а функция генерации выдает 36, произойдет усечение. В результате разные объекты могут получить одинаковые усеченные идентификаторы, что нарушит принцип уникальности. Всегда проверяйте длину поля и формат выводимой строки.

❌ Ошибка: Генерация нового ID при каждом изменении документа.
❌ Ошибка: Усечение строки из-за малой длины реквизита.
❌ Ошибка: Отсутствие индекса, приводящее к тормозам при поиске.
❌ Ошибка: Попытка записать объект типа УИД в строковое поле без преобразования.

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

💡

Главное правило: Идентификатор должен присваиваться один раз в момент создания объекта и никогда не изменяться в процессе его жизни.

Можно ли использовать поле"Код" справочника вместо создания нового реквизита?

Технически можно, но не рекомендуется. Поле"Код" часто имеет ограничения по длине (обычно до 10-20 символов), может требовать уникальности в рамках иерархии или подчиняться правилам нумерации, заданным в конфигурации. Отдельный реквизит дает полную свободу по типу данных и логике заполнения.

Как проверить уникальность сгенерированного идентификатора?

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

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

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

Что делать, если конфигурация защищена от изменений?

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

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