Модификатор в 1С: что это и как применять

Термин «модификатор» в 1С не относится к одному конкретному объекту: так называют несколько разных механизмов, которые изменяют стандартное поведение кода, запроса, типа данных или формы. В зависимости от контекста под модификатором понимают ключевые слова запроса (РАЗЛИЧНЫЕ, ПЕРВЫЕ), квалификаторы типов (длина строки, точность числа), модификаторы форматной строки и аннотации методов в расширениях конфигурации (&ИзменениеИКонтроль, &Вместо и другие).

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

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

Что обычно имеют в виду под модификатором в 1С

Чаще всего термин встречается в четырёх контекстах. Первый — язык запросов: модификаторы РАЗЛИЧНЫЕ, ПЕРВЫЕ, ДЛЯ ИЗМЕНЕНИЯ меняют логику выборки. Второй — описание типов: квалификаторы строки, числа и даты, которые иногда называют модификаторами типа. Третий — функция Формат() и форматная строка полей формы, где модификаторы задают представление данных. Четвёртый — расширения конфигурации, где аннотации &Вместо, &После, &Перед, &ИзменениеИКонтроль изменяют поведение типовых методов.

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

Модификаторы в языке запросов

Самая частая ситуация, где говорят о модификаторах, — запросы. Конструкция РАЗЛИЧНЫЕ убирает дубли строк из результата, ПЕРВЫЕ N ограничивает количество возвращаемых записей, ДЛЯ ИЗМЕНЕНИЯ блокирует выбранные данные в транзакции, чтобы другие сеансы не могли их изменить до завершения операции.

// Выборка без дублей, ограниченная 10 записями
ВЫБРАТЬ РАЗЛИЧНЫЕ ПЕРВЫЕ 10
Номенклатура.Ссылка КАК Товар
ИЗ
Документ.РеализацияТоваровУслуг.Товары КАК Товары

Практические правила: РАЗЛИЧНЫЕ увеличивает нагрузку на СУБД, поэтому его добавляют только когда дубли действительно возможны и недопустимы в результате. ПЕРВЫЕ без упорядочивания (УПОРЯДОЧИТЬ ПО) возвращает произвольный набор записей — порядок не гарантирован. ДЛЯ ИЗМЕНЕНИЯ используют только внутри явной транзакции, иначе блокировка бессмысленна.

Квалификаторы типов как разновидность модификаторов

При описании реквизита, переменной или параметра можно уточнить тип: длину строки, число знаков после запятой у числа, состав даты. Эти уточнения называют квалификаторами, но в обиходе — модификаторами типа. В коде их задают через объект ОписаниеТипов.

КвалификаторыСтроки = Новый КвалификаторыСтроки(50, ДопустимаяДлина.Переменная);
КвалификаторыЧисла  = Новый КвалификаторыЧисла(15, 2, ДопустимыйЗнак.Неотрицательный);
ОписаниеСтрока = Новый ОписаниеТипов("Строка", , КвалификаторыСтроки);
ОписаниеЧисло  = Новый ОписаниеТипов("Число", КвалификаторыЧисла);

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

Модификаторы форматной строки

Функция Формат() и свойство «Формат» полей ввода принимают строку с параметрами, которые иногда называют модификаторами представления. Они управляют тем, как значение выглядит пользователю, не меняя самих данных.

Формат(1234.5, "ЧЦ=15; ЧДЦ=2; ЧРД=,");   // " 1 234,50"
Формат(ТекущаяДата(), "ДЛФ=D");            // полная дата
Формат(0, "ЧН=0,00; БЛ=Нет; БИ=Да");       // представление нуля и булево

Типичные параметры: ЧЦ — общая ширина числа, ЧДЦ — знаки после запятой, ЧН — представление нуля, ДЛФ и ДФ — формат даты, БЛ/БИ — представление булево. Полный перечень доступен в синтакс-помощнике по функции Формат. Важно помнить: форматирование меняет только отображение, при выгрузке в файл или обмене данными используется исходное значение, если явно не применить Формат().

Модификаторы методов в расширениях конфигурации

В расширениях аннотации перед методом определяют, как он сочетается с типовым кодом. Их часто называют модификаторами метода. Основные варианты: &Вместо — полностью заменяет типовой метод, &Перед и &После — выполняются до или после типового, &ИзменениеИКонтроль — встраивает типовой код внутрь расширения с сохранением контроля соответствия.

Какую аннотацию выбрать

&Вместо

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

&Перед / &После

Дополнение типовой логики без её замены. Самый безопасный вариант, если не нужно менять сам типовой алгоритм.

&ИзменениеИКонтроль

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

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

1. 1
   Проверьте, можно ли обойтись подпиской на событие или обработчиком &Перед/&После
2. 2
   Если нет — создайте метод с аннотацией &ИзменениеИКонтроль и внесите точечную правку
3. 3
   Протестируйте сценарий на копии базы, включая граничные случаи
4. 4
   После обновления конфигурации выполните проверку применимости расширения

Модифицированность формы: частая путаница

Свойство формы Модифицированность и метод УстановитьМодифицированность() относятся к интерфейсной логике: они показывают, есть ли несохранённые изменения. Разработчики используют это, чтобы программно пометить форму как изменённую (например, после заполнения табличной части кодом) или, наоборот, сбросить признак после программной записи.

Ошибка новичков — пытаться «сохранить» объект через сброс модифицированности. Признак влияет только на вопрос о сохранении при закрытии; реальную запись выполняет метод Записать() объекта или команда формы.

Типичные ошибки и проверка результата

Контрольные точки

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

Запрос с РАЗЛИЧНЫЕ

Норма

Количество строк совпадает с ожидаемым, дублей нет, время выполнения приемлемое

Тревожный признак

Запрос выполняется заметно дольше без видимой пользы

Расширение после обновления

Норма

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

Тревожный признак

Сообщения о несоответствии типовых методов, ошибки при вызове

Форматная строка

Норма

Значение отображается в нужном виде на форме и в печати

Тревожный признак

В выгрузке или обмене виден 'сырой' формат значения

Частые вопросы

Чем модификатор запроса отличается от предложения ГДЕ?

ГДЕ фильтрует строки по условию до выборки, а модификаторы вроде РАЗЛИЧНЫЕ и ПЕРВЫЕ действуют на уже сформированный результат: убирают дубли или ограничивают количество записей. Они решают разные задачи и часто применяются вместе.

Что выбрать: &Вместо или &ИзменениеИКонтроль?

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

Влияет ли квалификатор длины строки на производительность?

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

Почему ПЕРВЫЕ 1 возвращает разные записи при повторном выполнении?

Без УПОРЯДОЧИТЬ ПО порядок выборки не определён и зависит от плана запроса на СУБД. Добавьте упорядочивание по уникальному полю (например, по дате и ссылке), чтобы результат был стабильным.

Можно ли изменить формат числа только для отображения, не трогая данные?

Да: задайте форматную строку в свойстве «Формат» поля ввода или используйте функцию Формат() при выводе. Само значение в базе останется неизменным — меняется только представление.

Как программно узнать, что форма изменена пользователем?

Проверьте свойство формы Модифицированность: значение Истина означает наличие несохранённых изменений. Перед закрытием на его основе можно задать пользователю вопрос о сохранении.