Получение реквизитов и идентификаторов документов в 1С

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

В этой статье мы детально разберем способы получения основных идентификаторов и реквизитов документов. Мы рассмотрим как стандартные свойства, предоставляемые платформой, так и специфические методы работы со ссылками. Особое внимание уделим различиям между версией платформы 8.2 и более современными версиями 8.3.

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

Уникальный идентификатор документа (GUID)

Каждый объект в базе данных 1С имеет свой уникальный глобальный идентификатор, часто называемый GUID или УникальныйИдентификатор. Это значение присваивается объекту при его создании и никогда не меняется в течение всего жизненного цикла ссылки. Даже если документ будет проведен, помечен на удаление или переименован, этот код останется неизменным.

Для получения этого значения в коде используется встроенное свойство объекта. Однако есть нюанс: если вы работаете с формой или временным объектом, который еще не был записан в информационную базу, свойство может вернуть временный идентификатор. Только после выполнения метода Записать объекту присваивается постоянный UUID.

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

⚠️ Внимание: Не пытайтесь использовать УникальныйИдентификатор нового, еще не записанного документа для связи с другими объектами в базе. До момента записи этот идентификатор является временным и может измениться при сохранении.

Получение ссылки на объект документа

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

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

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

Извлечение номера и даты документа

Номер и дата являются ключевыми реквизитами любого документа, определяющими его место в хронологии бизнес-процессов. Эти данные хранятся в стандартных полях таблицы документа и доступны для чтения сразу после создания объекта, даже до его записи в базу (хотя номер может быть еще не присвоен).

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

Особое внимание следует уделить формату вывода. Платформа позволяет гибко настраивать отображение даты и времени. Вы можете использовать функцию Формат для приведения даты к нужному виду, например, для выгрузки в XML или JSON, где требуется строгое соответствие стандарту.

• 📅 Свойство Дата возвращает значение типа Дата, которое включает время с точностью до секунды.
• 🔢 Свойство Номер может быть строкой или числом в зависимости от настроек нумерации в конфигураторе.
• 🔄 Автоматическая нумерация срабатывает только в момент записи документа, если это предусмотрено алгоритмом.

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

Доступ к дополнительным реквизитам и измерениям

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

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

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

Как работать с динамическими реквизитами?

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

Получение реквизитов через запросы

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

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

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

Метод доступа	Производительность	Тип данных	Возможность записи
Объектный режим	Низкая	Объект 1С	Да
Запрос (Чтение)	Высокая	Строка результата	Нет
Запрос (Данные)	Средняя	Таблица значений	Да (в память)
Прямой SQL	Максимальная	Массив/Строка	Нет (не рекомендуется)

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

Обработка ошибок и исключительных ситуаций

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

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

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

Часто задаваемые вопросы (FAQ)

Как получить GUID документа, если он еще не записан в базу?

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

Почему запрос не видит реквизит документа?

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

Можно ли изменить номер документа программно?

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

Как узнать тип документа по ссылке?

Используйте метод ТипЗначения или свойство Метаданные у объекта ссылки. Это позволит определить, к какому именно виду документов относится ссылка, что полезно при обработке разнородных списков объектов.