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

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

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

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

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

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

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

Рассмотрим пример запроса, который выбирает только приходные движения по конкретному складу:

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

Использование оператора ЗНАЧЕНИЕ здесь является обязательным, если вы хотите явно сослаться на предопределенное значение перечисления внутри текста запроса. Это гарантирует, что система правильно интерпретирует константу независимо от настроек локали или синонимов в конфигурации.

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

Использование виртуальных таблиц для фильтрации движений

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

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

Таблица Обороты возвращает две колонки: ПриходКоличество и РасходКоличество. Это позволяет в одном запросе получить полную картину движения без необходимости делать два отдельных запроса или использовать UNION. Система сама оптимизирует выполнение, обращаясь к таблицам итогов, если они существуют.

• 📊 Остатки: Показывает сальдо на дату, игнорируя разделение на приход/расход в результирующей выборке (показывает разницу).
• 🔄 Обороты: Разделяет потоки на отдельные колонки, идеально подходит для анализа активности.
• ⏳ ОстаткиИОбороты: Комбинированная таблица, возвращающая и начальный остаток, и обороты, и конечный остаток в одной строке.

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

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

Параметризация запроса и динамическое формирование условий

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

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

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

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

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

Сравнение производительности: Движения против Виртуальных таблиц

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

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

Ниже приведена таблица, сравнивающая характеристики подходов в различных ситуациях:

Критерий	Таблица Движения	Виртуальная таблица Обороты	Виртуальная таблица Остатки
Детализация	Построчная (документы)	Агрегированная (по измерениям)	Агрегированная (Сальдо)
Скорость при больших данных	Низкая	Высокая	Очень высокая
Разделение Приход/Расход	Явное поле ВидДвижения	Разные колонки	Не применимо (разница)
Требования к настройкам	Нет	Желательны итоги	Обязательны итоги

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

⚠️ Внимание: Конфигурация регистров и доступные виртуальные таблицы могут отличаться в разных версиях типовых конфигураций (УТ, БП, ЗУП). Всегда проверяйте структуру метаданных в вашей конкретной базе перед написанием запроса.

Типичные ошибки при работе с видами движений

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

Еще одна ошибка связана с типами данных. Поле ВидДвижения имеет тип ПеречислениеСсылка.ВидыДвиженияНакопления. Попытка сравнить его со строкой"Приход" без использования оператора ЗНАЧЕНИЕ или предварительного приведения типа в коде вызовет ошибку выполнения или вернет пустой результат.

Также стоит упомянуть ошибку логического объединения. Часто новички пишут условие ИЛИ там, где нужно И, или наоборот, когда пытаются отфильтровать данные по нескольким регистрам в одном запросе. Это приводит к декартовому произведению или потере данных.

• ❌ Ошибка типов: Сравнение перечисления со строкой напрямую в запросе.
• ❌ Неверная таблица: Поиск поля ВидДвижения в таблице Остатки.
• ❌ Игнорирование NULL: Отсутствие проверки на неопределенное значение параметра фильтрации.

Что такое декартово произведение в запросах 1С?

Это ситуация, когда каждая строка одной таблицы соединяется с каждой строкой другой таблицы. Обычно возникает при отсутствии условия соединения (ПО) или ошибке в логике условий ГДЕ. Результат — огромный объем данных и зависание системы.

Оптимизация и лучшие практики разработки

Для обеспечения высокой производительности системы следует минимизировать объем данных, выбираемых из базы. Если вам нужны только итоговые цифры, никогда не используйте таблицу Движения. Используйте Обороты или Остатки. Это золотое правило разработки на платформе 1С:Предприятие.

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

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

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

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

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

Что делать, если запрос с ВидДвижения работает медленно?

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

Как получить список всех возможных видов движений в запросе?

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

Влияет ли вид движения на расчет себестоимости?

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