Запрос

Типы

Синтаксис и применение Запрос в платформе 1С:Предприятие. Описание и примеры кода.

Полное описание, параметры и ограничения

Запрос

Запрос
В разделе описываются системные перечисления запроса.
Методическая информация

Практические примеры

Найти параметры запроса и проверить их перед выполнением

Не подставляем пользовательский текст в язык запросов. Сравниваем обнаруженные параметры с явным контрактом двух значений.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Никакие справочники не нужны: запрос выбирает только значения параметров.

  2. Контракт объявлен явно: непустая строка Название и целое неотрицательное Количество.


Запрос = Новый Запрос("ВЫБРАТЬ &Название КАК Название, &Количество КАК Количество");
ПараметрыТекста = Запрос.НайтиПараметры();
Сообщить(ПараметрыТекста.Количество() = 2);
Если Не ПараметрыТекста.Свойство("Название")
    Или Не ПараметрыТекста.Свойство("Количество") Тогда
    ВызватьИсключение "Текст запроса не соответствует учебному контракту";
КонецЕсли;
Название = "Книга";
Количество = 3;
Если ТипЗнч(Название) <> Тип("Строка") Или ПустаяСтрока(Название) Тогда
    ВызватьИсключение "Название должно быть непустой строкой";
КонецЕсли;
Если ТипЗнч(Количество) <> Тип("Число") Тогда
    ВызватьИсключение "Количество должно быть числом";
КонецЕсли;
Если Количество < 0 Или Количество <> Цел(Количество) Тогда
    ВызватьИсключение "Количество должно быть целым и неотрицательным";
КонецЕсли;
Запрос.УстановитьПараметр("Название", Название);
Запрос.УстановитьПараметр("Количество", Количество);
Сообщить(Запрос.Параметры.Название = "Книга");
Сообщить(Запрос.Параметры.Количество = 3);
Выборка = Запрос.Выполнить().Выбрать();
Если Не Выборка.Следующий() Тогда
    ВызватьИсключение "Ожидалась одна учебная строка";
КонецЕсли;
Сообщить(Выборка.Название = "Книга" И Выборка.Количество = 3);

Разбор по шагам

  1. НайтиПараметры анализирует текст и возвращает структуру имён, а не готовые значения из бизнес-данных.

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

  3. УстановитьПараметр передаёт типизированное значение без склейки текста. Параметры позволяет прочитать установленные значения.

  4. После Выполнить и Выбрать обязательно позиционируем выборку методом Следующий.

Как проверить результат

  1. Все сообщения дают Истина, запрос возвращает Книга и число 3.

  2. Измените &Количество в тексте на &Колво: проверка контракта останавливает выполнение.

  3. Количество = -1 отклоняется до выполнения запроса.

Ожидаемый результат

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

На что обратить внимание

  1. НайтиПараметры не проверяет бизнес-правила и не подбирает значения автоматически.

  2. Имя таблицы или поля не следует пытаться передать обычным параметром значения. Здесь параметры находятся в выражениях.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Получить свою памятку итогов как текстовый макет, не файл

ПолучитьМакет может возвращать разные типы. Здесь собственный макет заведомо ТекстовыйДокумент, тип результата проверяется до чтения текста.

Где и как запускать

Полный серверный модуль своей новой ПУСТОЙ УчебныеОстатки85, платформа 8.5.1.1343. Административные настройки собственного регистра; здесь не запускался.

Подготовка

  1. Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.

  2. Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.

  3. Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.

  4. В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.

  5. Корневой режим совместимости Не использовать; платформа именно 8.5.1.1343. Единственный регистр — собственный УчебныеОстатки85 вида Остатки, единственный документ — УчебноеДвижение85. База новая пустая, не копия рабочей.

  6. Для этого блока никакие документы и движения не создавайте. Запрос проверяет отсутствие записей своего регистра до административного вызова. Других пользователей, обменов, расширений и фоновых заданий нет.

  7. Создайте серверный общий модуль УчебныеИтогиПримеры. Вставьте весь модуль одного урока, вызовите ВыполнитьПример() Экспорт из собственной серверной команды обработки; обновите конфигурацию БД.

  8. Это операции настройки/обслуживания регистра, не проведение документа. Откат движений не обещает восстановить все настройки/внутренние таблицы итогов.

  9. Урок с границами сознательно меняет диапазон в собственном одноразовом пустом стенде. Он не восстанавливает исходный диапазон и не предназначен для рабочего регистра. Перед таким ручным опытом сохраните резервную копию собственной учебной базы.

  10. При переключении булевых флагов исходное значение читается заранее и восстанавливается при успехе/ошибке. Если восстановление само завершилось ошибкой, код сообщает об этом явно; успешное восстановление не выдумывается.

  11. Примеры здесь не запускались в 1С. Ваши настройки, документы и итоги этим заполнением не изменялись.

  12. У своего УчебныеОстатки85 добавьте макет УчебнаяПамяткаИтогов типа Текстовый документ: первая строка OWN-TOTALS-85, вторая Пустой учебный регистр, не рабочая база. Обновите БД.

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

Разбор по шагам

  1. У собственного регистра добавить макет УчебнаяПамяткаИтогов типа Текстовый документ.

  2. Внести две свои строки-маркера из подготовки, обновить БД.

  3. Получить только именованный макет собственного регистра.

  4. Проверить тип, прочитать текст и проверить оба маркера.

  5. Ничего не сохранять в файлы и не печатать.

Как проверить результат

  1. Два сравнения наличия маркеров Истина.

  2. Другой тип макета останавливается до ПолучитьТекст.

  3. Ни файл, ни печать, ни рабочие данные не создаются.

Ожидаемый результат

Разобраны полиморфный результат ПолучитьМакет и собственная текстовая подготовка.

На что обратить внимание

  1. Свойства и методы относятся только к собственному пустому регистру. Нельзя менять проверку имени на рабочий регистр ради опыта.

  2. ПолучитьИспользованиеИтогов и ПолучитьИспользованиеТекущихИтогов — разные настройки. Текущие итоги применимы только к Остатки.

  3. Булево возвращаемое значение метода не объявляется исходным состоянием или измеренным ускорением без отдельного контракта.

  4. Типизированные даты/флаги и явные проверки не являются доказательством запуска в 1С; здесь выполнялись только статические проверки.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.