Как в запросе указать вид движения регистра накопления 1С

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

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

В данной статье мы детально разберем синтаксические конструкции, позволяющие управлять выборкой данных. Мы рассмотрим нюансы работы с периодами, логические особенности фильтрации и распространенные ошибки, которые могут возникнуть при написании кода на встроенном языке. Особое внимание уделим тому, как платформа обрабатывает эти параметры на уровне SQL-сервера.

Основы работы с виртуальными таблицами регистров

Регистры накопления в конфигурациях 1С хранят данные в физических таблицах, однако для разработчика они представлены в виде удобных виртуальных таблиц. Эти таблицы динамически формируются системой в момент выполнения запроса. Самая распространенная виртуальная таблица — это РегистрНакопления.ИмяРегистра.Остатки или Обороты. Именно при обращении к ним необходимо указывать параметры среза.

Вид движения определяет направление потока ресурсов. В типовой конфигурации это обычно перечисление ВидДвиженияНакопления, содержащее значения Приход и Расход. Когда вы формируете запрос, вы должны явно сообщить системе, какие записи вас интересуют. Если параметр не указан явно в некоторых контекстах, система может использовать значения по умолчанию, что не всегда соответствует задаче разработчика.

Важно понимать разницу между физическими записями и виртуальным представлением. Физически в базе данных хранятся все движения с признаком вида. Виртуальная таблица Остатки агрегирует эти данные на конкретный момент времени. Указание вида движения в таком запросе позволяет отфильтровать только те ресурсы, которые пришли или ушли, игнорируя противоположные операции.

⚠️ Внимание: При работе с регистрами, имеющими измерения, forgetting указать вид движения может привести к получению остатков, которые математически верны, но логически бессмысленны для конкретной бизнес-задачи (например, отрицательный остаток товара из-за пересортицы).

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

Синтаксис указания параметров в запросе

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

Стандартная конструкция выглядит следующим образом: имя регистра, точка, имя виртуальной таблицы, и в скобках параметры. Если нам нужны остатки на конкретную дату только по приходу, мы передаем дату и ссылку на значение перечисления. Платформа автоматически подставит нужное значение в условие WHERE формируемого SQL-запроса.

ВЫБРАТЬ
Товары.Номенклатура,
Товары.КоличествоОстаток
ИЗ
РегистрНакопления.ТоварыНаСкладах.Остатки(&Период, ВидДвиженияНакопления.Приход) КАК Товары

В данном примере ВидДвиженияНакопления.Приход является жестко заданным значением. Однако в реальных задачах часто требуется передавать этот параметр динамически. Для этого используются параметры запроса, объявленные через символ амперсанда. Это позволяет одному и тому же тексту запроса работать для разных сценариев.

• 📌 Использование константы перечисления напрямую в тексте запроса.
• 📌 Передача значения через параметр запроса (например, &ВидДвижения).
• 📌 Фильтрация результата после выборки через оператор ГДЕ (менее производительно).

Использование параметров запроса является наиболее гибким подходом. Вы объявляете параметр в тексте запроса, а затем в коде 1С присваиваете ему нужное значение из перечисления. Такой метод позволяет избежать дублирования кода запроса и упрощает поддержку конфигурации.

Работа с периодами и срезами данных

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

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

Виртуальная таблица	Параметр 1	Параметр 2	Параметр 3 (опционально)
Остатки	Период (Дата)	Вид движения	-
Обороты	Начало периода	Конец периода	Вид движения
ОстаткиИОбороты	Начало периода	Конец периода	Вид движения

Обратите внимание, что для таблицы ОстаткиИОбороты указание вида движения влияет как на расчет начального остатка, так и на расчет оборотов и конечного остатка. Это мощный инструмент для анализа движения конкретных типов ресурсов. Например, можно увидеть, сколько товара только пришло, и сколько из этого пришедшего товара осталось на складе.

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

⚠️ Внимание: При передаче параметров периода убедитесь, что дата начала не позже даты конца. В противном случае виртуальная таблица вернет пустой набор данных, и ошибка не будет сгенерирована явно, что может запутать при отладке.

Динамическая передача значений из кода

В прикладном коде часто возникает необходимость формировать запрос в зависимости от действий пользователя. Например, в отчете может быть переключатель "Показывать только приход". В этом случае значение вида движения должно передаваться в запрос динамически. Для этого используется объект ПараметрыЗапроса.

Сначала в тексте запроса объявляется параметр, например, &МойВидДвижения. Затем в объекте запроса через метод Параметры этому имени присваивается значение. Значение должно быть строго типа ПеречислениеСсылка.ВидДвиженияНакопления. Попытка передать строку или число вызовет исключение.

ТекстЗапроса = "ВЫБРАТЬ ... ИЗ РегистрНакопления.Товары.Остатки(&Период, &ВидДвижения) КАК Т";
Запрос = Новый Запрос(ТекстЗапроса);
Запрос.Параметры.Вставить("Период", ТекущаяДата());
Запрос.Параметры.Вставить("ВидДвижения", Перечисления.ВидДвиженияНакопления.Расход);
Результат = Запрос.Выполнить();

Такой подход позволяет делать код универсальным. Вы можете написать одну функцию для получения остатков, которая будет принимать вид движения как аргумент. Это соответствует принципам DRY (Don't Repeat Yourself) и упрощает рефакторинг в будущем.

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

Особенности работы с Неопределено

Если передать Неопределено в параметр вида движения для виртуальной таблицы Обороты, система выберет записи и с приходом, и с расходом. Однако для таблицы Остатки поведение может быть неочевидным, поэтому лучше явно указывать нужное значение или использовать оператор ИЛИ в условии.

Оптимизация производительности запросов

Правильное указание вида движения влияет не только на корректность данных, но и на скорость работы системы. Когда вы фильтруете данные на уровне параметров виртуальной таблицы, платформа 1С может использовать специальные индексы. Это позволяет СУБД быстро отсечь лишние записи еще до передачи данных в приложение.

Если же вы выбираете все данные, а затем фильтруете их в секции ГДЕ запроса или в цикле на клиенте, производительность падает многократно. Особенно это заметно на больших объемах данных, где таблица регистра содержит миллионы записей. Использование параметров виртуальной таблицы — это способ "протолкнуть" фильтрацию на уровень базы данных.

• 🚀 Использование параметров виртуальной таблицы ускоряет выборку.
• 🚀 Избегание пост-фильтрации в коде 1С экономит оперативную память.
• 🚀 Правильные индексы снижают нагрузку на сервер 1С и СУБД.

Анализ плана выполнения запроса через консоль запросов или технологический журнал позволяет увидеть, используются ли индексы. Если вы видите полный скан таблицы (Table Scan), значит, условия выбраны неоптимально. Проверьте, правильно ли указаны типы параметров и используются ли виртуальные таблицы.

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

Типичные ошибки и методы отладки

Разработчики часто сталкиваются с ситуацией, когда запрос выполняется без ошибок, но возвращает пустой результат. Первая причина, которую стоит проверить — это соответствие вида движения реальным данным в базе. Возможно, по указанному товару не было прихода, а вы запрашиваете именно приход.

Вторая распространенная ошибка — путаница в порядке параметров. Виртуальная таблица Обороты требует три параметра: ДатаНачала, ДатаКонца, ВидДвижения. Если разработчик поставит вид движения вторым, система попытается интерпретировать его как дату конца периода, что приведет к логической ошибке или ошибке преобразования типов.

Для отладки рекомендуется использовать консоль запросов. В ней можно визуально проверить структуру виртуальной таблицы, нажав кнопку "Помощник". Там отображаются имена и типы всех обязательных параметров. Это спасает от опечаток в именах полей и параметров.

Также стоит помнить о правах доступа. Если у пользователя нет прав на чтение регистра накопления или на конкретное значение вида движения (если настроено RLS), запрос вернет пустую таблицу. Проверка прав через режим "Предприятие" под тестовым пользователем помогает исключить этот фактор.

Секрет отладки сложных запросов

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

Расширенные возможности и нюансы платформы

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

Также стоит упомянуть о возможности использования нескольких видов движения в одном запросе через объединение (ОБЪЕДИНИТЬ ВСЕ). Иногда требуется вывести в одну таблицу остатки прихода и остатки расхода раздельно. В этом случае создаются два запроса к одной виртуальной таблице с разными параметрами, которые затем объединяются.

При работе с иерархическими измерениями или сложными отборами, вид движения остается ключевым фильтром первого уровня. Он определяет контекст всей последующей выборки. Игнорирование этого параметра в сложных отчетах часто приводит к тому, что цифры "плывут" при изменении состава номенклатуры или складов.

Можно ли указать несколько видов движения одновременно в одном параметре?

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

Что будет, если передать в параметр неверный тип данных?

Система выдаст ошибку выполнения запроса с сообщением о несоответствии типов. Например, "Неверный тип значения аргумента". Запрос не будет выполнен, и транзакция (если она была открыта) может быть отклонена в зависимости от контекста вызова.

Влияет ли указание вида движения на блокировки записей?

Да, косвенно. Чем точнее условия выборки (включая вид движения), тем меньше записей сканирует СУБД и тем меньше вероятность конфликтов блокировок при записи в тот же регистр другими процессами. Точечная выборка безопаснее для многопользовательской работы.

Где посмотреть список всех доступных виртуальных таблиц для моего регистра?

Откройте конфигурацию в режиме Конфигуратор. Найдите нужный регистр накопления в дереве метаданных. Раскройте ветку регистра — там будут перечислены все доступные виртуальные таблицы (Остатки, Обороты и т.д.). При нажатии на них в нижней панели отображается список параметров.