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