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