Синтаксис и применение Запрос в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Запрос
Запрос
В разделе описываются системные перечисления запроса.
Методическая информация
Практические примеры
Найти параметры запроса и проверить их перед выполнением
Не подставляем пользовательский текст в язык запросов. Сравниваем обнаруженные параметры с явным контрактом двух значений.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Никакие справочники не нужны: запрос выбирает только значения параметров.
Контракт объявлен явно: непустая строка Название и целое неотрицательное Количество.
Запрос = Новый Запрос("ВЫБРАТЬ &Название КАК Название, &Количество КАК Количество");
ПараметрыТекста = Запрос.НайтиПараметры();
Сообщить(ПараметрыТекста.Количество() = 2);
Если Не ПараметрыТекста.Свойство("Название")
Или Не ПараметрыТекста.Свойство("Количество") Тогда
ВызватьИсключение "Текст запроса не соответствует учебному контракту";
КонецЕсли;
Название = "Книга";
Количество = 3;
Если ТипЗнч(Название) <> Тип("Строка") Или ПустаяСтрока(Название) Тогда
ВызватьИсключение "Название должно быть непустой строкой";
КонецЕсли;
Если ТипЗнч(Количество) <> Тип("Число") Тогда
ВызватьИсключение "Количество должно быть числом";
КонецЕсли;
Если Количество < 0 Или Количество <> Цел(Количество) Тогда
ВызватьИсключение "Количество должно быть целым и неотрицательным";
КонецЕсли;
Запрос.УстановитьПараметр("Название", Название);
Запрос.УстановитьПараметр("Количество", Количество);
Сообщить(Запрос.Параметры.Название = "Книга");
Сообщить(Запрос.Параметры.Количество = 3);
Выборка = Запрос.Выполнить().Выбрать();
Если Не Выборка.Следующий() Тогда
ВызватьИсключение "Ожидалась одна учебная строка";
КонецЕсли;
Сообщить(Выборка.Название = "Книга" И Выборка.Количество = 3);Разбор по шагам
НайтиПараметры анализирует текст и возвращает структуру имён, а не готовые значения из бизнес-данных.
Проверяем ожидаемые два ключа и ограничения конкретных значений отдельно от синтаксиса запроса.
УстановитьПараметр передаёт типизированное значение без склейки текста. Параметры позволяет прочитать установленные значения.
После Выполнить и Выбрать обязательно позиционируем выборку методом Следующий.
Как проверить результат
Все сообщения дают Истина, запрос возвращает Книга и число 3.
Измените &Количество в тексте на &Колво: проверка контракта останавливает выполнение.
Количество = -1 отклоняется до выполнения запроса.
Ожидаемый результат
Параметризованный запрос проверен по собственному контракту до чтения результата.
На что обратить внимание
НайтиПараметры не проверяет бизнес-правила и не подбирает значения автоматически.
Имя таблицы или поля не следует пытаться передать обычным параметром значения. Здесь параметры находятся в выражениях.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Получить свою памятку итогов как текстовый макет, не файл
ПолучитьМакет может возвращать разные типы. Здесь собственный макет заведомо ТекстовыйДокумент, тип результата проверяется до чтения текста.
Где и как запускать
Полный серверный модуль своей новой ПУСТОЙ УчебныеОстатки85, платформа 8.5.1.1343. Административные настройки собственного регистра; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.
Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.
Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.
В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.
Корневой режим совместимости Не использовать; платформа именно 8.5.1.1343. Единственный регистр — собственный УчебныеОстатки85 вида Остатки, единственный документ — УчебноеДвижение85. База новая пустая, не копия рабочей.
Для этого блока никакие документы и движения не создавайте. Запрос проверяет отсутствие записей своего регистра до административного вызова. Других пользователей, обменов, расширений и фоновых заданий нет.
Создайте серверный общий модуль УчебныеИтогиПримеры. Вставьте весь модуль одного урока, вызовите ВыполнитьПример() Экспорт из собственной серверной команды обработки; обновите конфигурацию БД.
Это операции настройки/обслуживания регистра, не проведение документа. Откат движений не обещает восстановить все настройки/внутренние таблицы итогов.
Урок с границами сознательно меняет диапазон в собственном одноразовом пустом стенде. Он не восстанавливает исходный диапазон и не предназначен для рабочего регистра. Перед таким ручным опытом сохраните резервную копию собственной учебной базы.
При переключении булевых флагов исходное значение читается заранее и восстанавливается при успехе/ошибке. Если восстановление само завершилось ошибкой, код сообщает об этом явно; успешное восстановление не выдумывается.
Примеры здесь не запускались в 1С. Ваши настройки, документы и итоги этим заполнением не изменялись.
У своего УчебныеОстатки85 добавьте макет УчебнаяПамяткаИтогов типа Текстовый документ: первая строка OWN-TOTALS-85, вторая Пустой учебный регистр, не рабочая база. Обновите БД.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 1
Или Метаданные.Документы.Найти("УчебноеДвижение85") = Неопределено Тогда
ВызватьИсключение "Разрешены только собственный учебный документ и регистр";
КонецЕсли;
Описание = Метаданные.РегистрыНакопления.Найти("УчебныеОстатки85");
Если Описание = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный регистр";
КонецЕсли;
Если Описание.ВидРегистра <> Метаданные.СвойстваОбъектов.ВидРегистраНакопления.Остатки
Или Описание.Измерения.Количество() <> 1
Или Описание.Ресурсы.Количество() <> 1
Или Описание.Реквизиты.Количество() <> 0
Или Описание.Измерения.Найти("КодТовара") = Неопределено
Или Описание.Ресурсы.Найти("Количество") = Неопределено Тогда
ВызватьИсключение "Нужен регистр остатков с КодТовара и Количество";
КонецЕсли;
Менеджер = РегистрыНакопления.УчебныеОстатки85;
Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
ВызватьИсключение "Нужен собственный стенд без старого режима совместимости";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Не вызывайте административный опыт внутри чужой транзакции";
КонецЕсли;
Проверка = Новый Запрос;
Проверка.Текст = "ВЫБРАТЬ КОЛИЧЕСТВО(*) КАК Строк
|ИЗ РегистрНакопления.УчебныеОстатки85";
Данные = Проверка.Выполнить().Выгрузить();
Если Данные.Количество() <> 1 Тогда
ВызватьИсключение "Не получена собственная контрольная строка";
КонецЕсли;
Если Данные[0].Строк <> 0 Тогда
ВызватьИсключение "В собственном регистре уже есть движения: этот пустой административный опыт запрещён";
КонецЕсли;
Макет = Менеджер.ПолучитьМакет("УчебнаяПамяткаИтогов");
Если ТипЗнч(Макет) <> Тип("ТекстовыйДокумент") Тогда
ВызватьИсключение "Подготовлен собственный текстовый макет, другой тип не принимается";
КонецЕсли;
ТекстПамятки = Макет.ПолучитьТекст();
Сообщить(СтрНайти(ТекстПамятки, "OWN-TOTALS-85") > 0);
Сообщить(СтрНайти(ТекстПамятки, "Пустой учебный регистр, не рабочая база") > 0);
Сообщить("Получен только собственный макет, запись/печать/сохранение файла не выполнялись");
КонецПроцедурыРазбор по шагам
У собственного регистра добавить макет УчебнаяПамяткаИтогов типа Текстовый документ.
Внести две свои строки-маркера из подготовки, обновить БД.
Получить только именованный макет собственного регистра.
Проверить тип, прочитать текст и проверить оба маркера.
Ничего не сохранять в файлы и не печатать.
Как проверить результат
Два сравнения наличия маркеров Истина.
Другой тип макета останавливается до ПолучитьТекст.
Ни файл, ни печать, ни рабочие данные не создаются.
Ожидаемый результат
Разобраны полиморфный результат ПолучитьМакет и собственная текстовая подготовка.
На что обратить внимание
Свойства и методы относятся только к собственному пустому регистру. Нельзя менять проверку имени на рабочий регистр ради опыта.
ПолучитьИспользованиеИтогов и ПолучитьИспользованиеТекущихИтогов — разные настройки. Текущие итоги применимы только к Остатки.
Булево возвращаемое значение метода не объявляется исходным состоянием или измеренным ускорением без отдельного контракта.
Типизированные даты/флаги и явные проверки не являются доказательством запуска в 1С; здесь выполнялись только статические проверки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.