← На главную

Приветствуем вас, уважаемые разработчики 1С и те, кто только начинает свой путь в этой увлекательной сфере! Сегодня мы разберем очень частую ошибку, с которой сталкиваются новички, особенно те, кто приходит в 1С из других IT-областей. Ситуация следующая: запрос, который прекрасно работает в консоли запросов, не дает никакого результата при выполнении в коде. Вы хотите, чтобы поля документа автоматически заполнялись данными из справочника по определенному параметру, но вместо ожидаемых значений получаете "нет владельца" или пустые поля. Давайте выясним причину и найдем правильное решение.

Суть проблемы: Запрос работает в консоли, но не в коде

Представим, что вы разрабатываете конфигурацию, например, для "Парковки автотранспорта". Ваша задача — при вводе номера машины в документ ДокументыВводПарковки автоматически подтягивать информацию о ВладельцеМашины и ТипеМашины из справочника Автотранспорт. Вы составляете запрос, который ищет машину по ее наименованию (номеру), и этот запрос прекрасно работает в консоли запросов, возвращая нужные данные. Однако, когда вы переносите этот же запрос в код и выполняете его, например, в процедуре обработки события "ПриИзменении" поля "НомерМашины", вы сталкиваетесь с неожиданным результатом: запрос ничего не возвращает, и поля остаются пустыми или выдают сообщение вроде "нет владельца".

Разбираем причину: Несоответствие типов данных параметра запроса

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

1. Представление на клиенте vs. Тип на сервере: На Клиенте, в форме документа или справочника, мы часто видим "представление" объекта. Например, если в поле НомерМашины документа мы выбираем элемент справочника Автотранспорт, визуально отображается его Наименование (т.е. номер машины). Это удобно для пользователя. Однако, на самом деле, в поле хранится не строковое наименование, а **ссылка** на элемент справочника (например, тип СправочникСсылка.Автотранспорт).
2. Как работает запрос: Когда вы передаете параметр в запрос с помощью метода Запрос.УстановитьПараметр(), 1С ожидает, что тип переданного значения будет соответствовать типу поля, с которым производится сравнение в условии ГДЕ запроса.
3. Типичная ошибка: Если ваш запрос содержит условие вида ГДЕ Автотранспорт.Наименование = &ПараметрМашины, то запрос ожидает, что &ПараметрМашины будет **строкой**. Но если в коде вы передаете в этот параметр саму ссылку на элемент справочника (которая была выбрана в поле НомерМашины), происходит несоответствие типов. Ссылка и строка — это разные типы данных. Запрос пытается сравнить ссылку со строкой, что всегда будет ложным, и, соответственно, не найдет ни одной записи.
4. Отладчик как помощник: Если бы мы посмотрели в отладчике на переменную, которую вы передаете в Запрос.УстановитьПараметр() (например, Параметр1 из вашего примера), мы бы увидели, что ее тип — это СправочникСсылка.Автотранспорт, то есть ссылка на объект, а не его строковое наименование.

Именно это несоответствие типов — попытка сравнить объект-ссылку со строковым реквизитом — является корнем проблемы.

Решение проблемы: Явное указание наименования для параметра запроса

Для того чтобы запрос начал корректно работать, нам необходимо обеспечить соответствие типов. Если в запросе вы сравниваете по наименованию, то и в параметр запроса должна быть передана строка с наименованием. Рассмотрим основные способы решения:

1. Извлекаем наименование из ссылки

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

   Скопировать код

   
   // Предполагается, что ПереданныйПараметр это ссылка на элемент справочника "Автотранспорт"
   Запрос.УстановитьПараметр("Ссылка", ПереданныйПараметр.Наименование);
   

   Пояснение: Здесь ПереданныйПараметр (в вашем случае, возможно, Параметр1) — это ваша ссылка на элемент справочника Автотранспорт. Мы обращаемся к ее свойству .Наименование, которое является строкой, и передаем именно эту строку в параметр запроса &Ссылка. Теперь, если ваш запрос выглядит как-то так:

   Скопировать код

   
   ВЫБРАТЬ
       Автотранспорт.ВладелецМашины,
       Автотранспорт.ТипМашины
   ИЗ
       Справочник.Автотранспорт КАК Автотранспорт
   ГДЕ
       Автотранспорт.Наименование = &Ссылка
   

   то условие ГДЕ Автотранспорт.Наименование = &Ссылка будет сравнивать строку со строкой, что является корректным сравнением и приведет к нахождению нужных данных.

2. Альтернативный подход: Передача строки напрямую или преобразование

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

   Скопировать код

   
   // Предположим, что Строка.НомерМашины - это поле документа, хранящее ссылку
   // и мы хотим получить ее строковое представление для запроса
   Строка.Владелец = ПолучитьВладельцаМашины(Строка(Строка.НомерМашины));
   

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

   Важно понимать, что в большинстве случаев, когда вы сравниваете по текстовым реквизитам (наименование, код и т.п.), именно явное извлечение этого реквизита из ссылки (через точку .Наименование или .Код) является наиболее надежным и понятным решением.

Почему важно соответствие типов в запросах 1С?

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

• Строгая типизация параметров: Каждый параметр, который вы передаете в запрос через Запрос.УстановитьПараметр(), имеет определенный тип (строка, число, дата, булево, ссылка и т.д.).
• Строгая типизация полей базы данных: Каждое поле таблицы в базе данных 1С также имеет свой определенный тип.
• Необходимость соответствия: При выполнении условия ГДЕ в запросе (например, ПолеБазыДанных = &Параметр) 1С ожидает, что типы ПолеБазыДанных и &Параметр будут совместимы или идентичны. Попытка сравнить, например, строковое поле с параметром типа "ссылка" приведет к логической ошибке (всегда ложь) или, в некоторых случаях, к ошибке выполнения, если типы абсолютно несовместимы.

Понимание различий между ссылкой (уникальным внутренним идентификатором объекта) и его строковым представлением (например, наименованием или кодом) критически важно для корректной работы с данными в 1С. На клиенте мы видим удобные для человека представления, но на сервере и в запросах оперируем строгими типами.

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

Для успешной работы с запросами в 1С и предотвращения подобных ошибок рекомендуем активно использовать следующие инструменты и подходы:

1. Консоль запросов 1С: Это ваш лучший друг при работе с запросами. Всегда сначала проверяйте запрос в консоли. Убедитесь, что он возвращает ожидаемые данные с нужными параметрами. Если запрос работает в консоли, но не в коде, это почти всегда указывает на проблему с тем, как вы формируете или передаете параметры из кода.
2. Отладчик 1С: При возникновении проблем с запросами в коде, используйте отладчик. Установите точку останова непосредственно перед вызовом Запрос.Выполнить(). В отладчике проверьте:
   • Какое значение и какой тип имеет переменная, которую вы передаете в Запрос.УстановитьПараметр(). Убедитесь, что это именно та строка, ссылка или число, которое вы ожидаете.
   • Какой текст запроса сформировался в переменной Запрос.Текст.

   Это позволит вам точно увидеть, что получает запрос, и выявить несоответствие.

3. Сравнение по ссылке: Если в вашем запросе нужно сравнивать поля именно по ссылке (то есть, найти объект, который **равен** переданной ссылке, а не его наименованию), то условие в запросе должно быть вида ГДЕ Автотранспорт = &Ссылка. В этом случае в параметр &Ссылка следует передавать **саму ссылку** на элемент справочника, без обращения к .Наименование.
   Скопировать код

   
   // В запросе
   ВЫБРАТЬ
       Автотранспорт.ВладелецМашины,
       Автотранспорт.ТипМашины
   ИЗ
       Справочник.Автотранспорт КАК Автотранспорт
   ГДЕ
       Автотранспорт.Ссылка = &СсылкаНаАвтотранспорт
   
   // В коде
   Запрос.УстановитьПараметр("СсылкаНаАвтотранспорт", ПереданнаяСсылкаНаАвто);
   

4. Функция ВЫРАЗИТЬ() в запросах: В некоторых более сложных случаях, когда поле имеет составной тип (например, может быть ссылкой на разные справочники) и вам нужно сравнить его с определенным типом или получить его строковое представление внутри самого запроса, можно использовать функцию ВЫРАЗИТЬ(). Например: ВЫРАЗИТЬ(МоеПоле КАК Справочник.Контрагенты).Наименование = &Параметр. Однако использование ВЫРАЗИТЬ() может влиять на производительность запроса и требует внимательного анализа, так как может приводить к неявным соединениям с дополнительными таблицами.
5. Избегайте избыточности составных типов: Если это возможно, старайтесь избегать избыточных составных типов в полях, если вы планируете сравнивать их по определенному типу. Иногда более производительным решением является хранение нужных данных в исходной таблице или использование отдельных полей для каждого типа ссылки.

Итак, друзья, главное в 1С — это понимание типов данных и строгое следование правилам их использования, особенно при работе с запросами. Надеемся, что этот разбор поможет вам избежать подобных ошибок и ускорит ваш прогресс в освоении платформы!