В практике разработчика 1С часто встречается ситуация: документ в журнале есть, номер виден отчетливо, но программный метод НайтиПоНомеру упорно возвращает пустую ссылку. Это может вызвать недоумение, особенно если для других типов документов аналогичный код работает безупречно. Давайте вместе разберем эту проблему, проанализируем механизмы платформы «1С:Предприятие 8» и выясним, как гарантированно находить нужные объекты в базе данных.
Для начала рассмотрим, как выглядит стандартный вызов метода для поиска документа. Синтаксис метода следующий:
Документы.[ТипДокумента].НайтиПоНомеру(НомерДокумента, ДатаПериода)
Многие начинающие программисты допускают ошибку, передавая только первый параметр — номер. Разберем ситуацию на примере кода, который вызвал затруднение у автора темы:
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Попытка найти документ по номеру без указания даты
Объект.СсылкаНаОбъект = Документы.ПриобретениеУслугПрочихАктивов.НайтиПоНомеру("ДТ00-000109");
КонецПроцедуры
Проанализируем этот фрагмент. Проблема здесь кроется в пропущенном втором параметре. Если в конфигураторе для данного типа документа установлена периодичность нумерации (например, «Год»), то платформа ожидает, что вы укажете, в каком именно периоде искать этот номер.
Рассмотрим подробнее механизм автонумерации. Большинство типовых конфигураций (таких как 1С:ERP, 1С:КА или 1С:УТ) используют периодическую нумерацию документов. Это означает, что в каждом новом году нумерация начинается заново. Таким образом, в базе может существовать несколько документов с номером «ДТ00-000109»: один за 2022 год, другой за 2023, и еще один за 2024.
Если мы не передаем дату вторым параметром, система ведет поиск в текущем периоде (исходя из текущей системной даты). Если искомый документ был создан в прошлом году, поиск закономерно вернет Неопределено или пустую ссылку. Чтобы исправить это, нам необходимо передать любую дату, попадающую в нужный интервал.
Посмотрим на исправленный вариант кода:
// Передаем дату, чтобы указать период (2022 год)
ДатаПоиска = '20220101'; // 1 января 2022 года
Объект.СсылкаНаОбъект = Документы.ПриобретениеУслугПрочихАктивов.НайтиПоНомеру("ДТ00-000109", ДатаПоиска);
Важный момент: не обязательно знать точную дату документа. Достаточно передать любую дату в пределах того года (или месяца/квартала, в зависимости от настроек периодичности), в котором документ был создан.
Другая распространенная причина неудачи при поиске — несоответствие формата строки. Метод НайтиПоНомеру выполняет поиск по точному строковому совпадению. Выясним, на что нужно обратить внимание:
Проанализируем ситуацию, когда код написан верно, дата периода указана, но документ все равно не находится. Здесь в игру вступают механизмы безопасности платформы. Если у текущего пользователя настроен RLS (Record Level Security) — ограничение прав на уровне записей, — и этот пользователь не имеет прав на просмотр документов конкретной организации, метод НайтиПоНомеру просто не «увидит» документ.
В этом случае платформа не выдает ошибку доступа, она просто возвращает пустую ссылку, имитируя отсутствие данных. Если вам необходимо найти документ вне зависимости от прав текущего пользователя (например, в регламентном задании или при выполнении привилегированной операции), поиск следует выполнять в модуле с установленным флажком Привилегированный или использовать конструкцию УстановитьПривилегированныйРежим(Истина).
Несмотря на наличие встроенного метода НайтиПоНомеру, использование механизма запросов считается более надежным и гибким подходом. Рассмотрим, почему это так:
ГДЕ Номер = &Номер, и система найдет все документы с таким номером за всю историю ведения учета.Номер работает максимально быстро.НайтиПоНомеру вернет лишь один (случайный) из них.Разберем пример поиска через запрос:
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Т.Ссылка КАК Ссылка
|ИЗ
| Документ.ПриобретениеУслугПрочихАктивов КАК Т
|ГДЕ
| Т.Номер = &Номер
| И Т.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания";
Запрос.УстановитьПараметр("Номер", "ДТ00-000109");
Запрос.УстановитьПараметр("ДатаНачала", НачалоГода('20220101'));
Запрос.УстановитьПараметр("ДатаОкончания", КонецГода('20220101'));
РезультатЗапроса = Запрос.Выполнить();
Если Не РезультатЗапроса.Пустой() Тогда
Выборка = РезультатЗапроса.Выбрать();
Выборка.Следующий();
Объект.СсылкаНаОбъект = Выборка.Ссылка;
КонецЕсли;
Для успешного поиска документа по номеру всегда придерживайтесь следующих правил:
НайтиПоНомеру.Изучение встроенного синтакс-помощника и понимание структуры метаданных документа позволят вам избежать подобных ошибок и писать более стабильный код.