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