Функции языка запросов 1с

Функции языка запросов 1с

1. Функция ДАТАВРЕМЯ - данная функция создает константное поле с типом "Дата".

Синтаксис:         ДАТАВРЕМЯ(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>)

Пример использования:
Запрос.Текст =
"ВЫБРАТЬ
|    ДАТАВРЕМЯ(2015, 3, 1) КАК ПервоеМарта"; // 1 марта 2015

2. Функция РАЗНОСТЬДАТ - возвращает разность двух дат в одном из измерений (год, месяц, день, час, минута, секунда). Измерение передается в параметре.

Синтаксис:         РАЗНОСТЬДАТ(<Дата1>, <Дата2>, <Тип>)

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|    РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2015, 4, 17), ДАТАВРЕМЯ(2015, 2, 1), ДЕНЬ)
|    КАК КолвоДней";

3. Функция ЗНАЧЕНИЕ -  задает константное поле с предопределенной записью из базы данных, также можно получить пустую ссылку любого типа.

Синтаксис:         ЗНАЧЕНИЕ(<Имя>)

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
//предопределенный элемент
|    ЗНАЧЕНИЕ(Справочник.Валюты.Доллар) КАК Доллар,
//пустая ссылка
|    ЗНАЧЕНИЕ(Документ.ПоступлениеТоваровУслуг.ПустаяСсылка) КАК Поступление,
//знач. перечисления
|    ЗНАЧЕНИЕ(Перечисление.ЮрФизЛицо.ФизЛицо) КАК ФизЛицо,
//предопределенный счет
|    ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Материалы) КАК Счет_10";

4. Функция ВЫБОР - перед нами аналог конструкции ЕСЛИ который используется в коде, только эта используется в запросах 1С.

Синтаксис:                ВЫБОР
КОГДА <Выражение> ТОГДА <Выражение>
ИНАЧЕ <Выражение>
КОНЕЦ

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
//если сумма больше 7500, тогда должна быть скидка 300 рублей,
//поэтому если условие срабатывает то функция
//возвращает Сумма - 300
//в противном случае запрос вернет просто Сумма
|    ВЫБОР
|        КОГДА ТЧПоступления.Сумма > 7500
|            ТОГДА ТЧПоступления.Сумма - 300
|        ИНАЧЕ ТЧПоступления.Сумма
|    КОНЕЦ КАК СуммаСоСкидкой
|ИЗ
|    Документ.ПоступлениеТоваровУслуг.Товары КАК ТЧПоступления";

5. Функция ВЫРАЗИТЬ - позволяет выразить константное поле определенным типом.

Синтаксис:        ВЫРАЗИТЬ(НазваниеПоля КАК НазваниеТипа)

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|  ВЫРАЗИТЬ(Номенклатура.Комментарий КАК Строка(300)) КАК Комментарий,
|  ВЫРАЗИТЬ(Номенклатура.Сумма КАК Число(15,2)) КАК Сумма
|ИЗ
|    Справочник.Номенклатура КАК Номенклатура";

Еще есть вариант использования функции ВЫРАЗИТЬ в полях смешанных типах, где такие встречаются? Самый простой пример это "Регистратор" у любого регистра. Так зачем нам может понадобиться уточнять тип в регистраторе? Давайте рассмотрим ситуацию когда мы из регистратора выбираем поле "Номер", из какой таблицы будет выбран номер? Правильный ответ из всех! Поэтому чтобы наш запрос работал быстро следует указывать явный тип с помощью функции ВЫРАЗИТЬ

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|  Продажи.Регистратор.Номер,
|         ВЫБОР
|     КОГДА Продажи.Регистратор ССЫЛКА Документ.Расходная
|       ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.Расходная)
|         ИНАЧЕ ВЫБОР
|         КОГДА Продажи.Регистратор ССЫЛКА Документ.Реализация
|             ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.Реализация)
|         КОНЕЦ
|           ...
|          КОНЕЦ КАК Номер
|  ИЗ
|     РегистрНакопления.Закупки КАК Закупки";

6. Функция ISNULL (альтернативное написание ЕСТЬNULL) - если поле имеет тип NULL, то оно заменяется на второй параметр функции.

Синтаксис:        ЕСТЬNULL(<Поле>, <ПодставляемоеЗначение>)

Пример использования:

Запрос.Текст =
//Выбираем всю номенклатуру и остатки по ней
//если остатокв но какой-то номенклатуре нет то будет поле
//NULL которое заменится значением 0
"ВЫБРАТЬ
|    Ном.Ссылка,
|    ЕСТЬNULL(ТоварыНаСкладахОстатки.ВНаличииОстаток, 0) КАК Остаток
|ИЗ
|    Справочник.Номенклатура КАК Ном
|     ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ТоварыНаСкладах.Остатки КАК ТоварыНаСкладахОстатки
|        ПО (ТоварыНаСкладахОстатки.Номенклатура = Ном.Ссылка)";
Также отмети что тип NULL желательно ВСЕГДА заменять на какое-то значение, т.к. сравнение с типом NULL всегда дает ЛОЖЬ даже если вы сравниваете NULL с NULL. Чаще всего значения NULL образуются в результате соединения таблиц (все виды соединений кроме внутреннего).

7. Функция ПРЕДСТАВЛЕНИЕ - позволяет получить представление поля запроса

Синтаксис:        ПРЕДСТАВЛЕНИЕ(<НаименованиеПоля>)

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|    ПРЕДСТАВЛЕНИЕ(СвободныеОстаткиОстатки.Номенклатура) КАК Номенклатура,
|    ПРЕДСТАВЛЕНИЕ(СвободныеОстаткиОстатки.Склад) КАК Склад,
|    СвободныеОстаткиОстатки.ВНаличииОстаток
|ИЗ
|    РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки";

Конструкции в языке запросов 1с

Выше мы рассмотрели с Вами функции языка запросов 1с, теперь пришло время рассмотреть конструкции в языке запросов 1с, они не менее важны и полезны, приступаем.

1. Конструкция ССЫЛКА - представляет из себя логический оператор проверки ссылочного типа. Наиболее часто встречается при проверки поля составного типа на конкретный тип.

Синтаксис:        ССЫЛКА <Имя таблицы>

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
//если тип значения регистратора документ Приходная,
//тогда запрос вернет "Поступление товаров", иначе "Реализация товаров"
|    ВЫБОР
|        КОГДА Остатки.Регистратор ССЫЛКА Документ.ПоступлениеТоваровУслуг
|            ТОГДА ""Приход""
|        ИНАЧЕ ""Расход""
|    КОНЕЦ КАК ВидДвижения
|ИЗ
|    РегистрНакопления.ОстаткиТоваровНаСкладах КАК Остатки";

2. Конструкция МЕЖДУ - данный оператор проверяет входит ли значение в указанный диапазон.

Синтаксис:        МЕЖДУ <Выражение> И <Выражение>

Пример использования:

Запрос.Текст =
//получим всю номенклатуру код которой лежит в диапазоне от 1 до 100
"ВЫБРАТЬ
|    Номенклатура.Ссылка
|ИЗ
|    Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|    Номенклатура.Код МЕЖДУ 1 И 100";

3. Конструкция В и В ИЕРАРХИИ - проверяют находится ли значение в передаваемом списке (в качестве списка могут передаваться массивы, таблицы значений и т.д.). Оператор В ИЕРАРХИИ позволяет просматривать иерархию (пример использования ПланСчетов).

Синтаксис:        В(<СписокЗначений>), В ИЕРАРХИИ(<СписокЗначений>)

Пример использования:

Запрос.Текст =
//выбираем все субсчета счета
"ВЫБРАТЬ
|    Хозрасчетный.Ссылка КАК Счет
|ИЗ
|    ПланСчетов.Хозрасчетный КАК Хозрасчетный
|ГДЕ
|    Хозрасчетный.Ссылка В ИЕРАРХИИ ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Товары)";

4. Конструкция ПОДОБНО - эта функция позволяет нам сравнивать строку с шаблоном строки.

Синтаксис:        ПОДОБНО "<ТекстШаблона>"

Варианты шаблона строки:

% - последовательность, содержащая любое количество произвольных символов
_ - один произвольный символ
[...] - любой одиночный символ, либо последовательность символов из перечисленных внутри квадратных скобок. В перечислении могут задаваться диапазоны, например a-z, означающие произвольный символ, входящий в диапазон, включая концы диапазона
[^...] - любой одиночный символ, либо последовательность символов из перечисленных внутри квадратных скобок кроме тех, которые перечислены следом за значком отрицания

Пример использования:

Запрос.Текст =
//найдем всю номенклатуру которая содержит корень ТАБУР и начинается
//либо с маленькой либо с большой буквы т
"ВЫБРАТЬ
|    Номенклатура.Ссылка
|ИЗ
|    Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|    Товары.Наименование ПОДОБНО ""[Тт]абур%""";

5. Конструкция РАЗРЕШЕННЫЕ - этот оператор позволяет выбрать только те записи из БД, на которые вызывающий имеет право чтения. Данные права настраиваются на уровне записей (RLS).

Синтаксис:       РАЗРЕШЕННЫЕ пишется после ключевого слова ВЫБРАТЬ

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ РАЗРЕШЕННЫЕ
|             Контрагенты.Ссылка
|ИЗ
|             Справочник.Контрагенты КАК Контрагенты";

6. Конструкция РАЗЛИЧНЫЕ - позволяет выбрать записи в которых отсутствуют повторные записи

Синтаксис:       РАЗЛИЧНЫЕ пишется после ключевого слова ВЫБРАТЬ

Пример использования:

Запрос.Текст =
//выбирает записи на которые есть права у читающего
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|             Контрагенты.Наименование
|ИЗ
|             Справочник.Контрагенты КАК Контрагенты";

Также Конструкция РАЗЛИЧНЫЕ может использоваться с оператором РАЗРЕШЕННЫЕ и другими операторами.

Пример использования:

Запрос.Текст =
//выбирает различные записи на которые есть права у читающего
"ВЫБРАТЬ РАЗРЕШЕННЫЕ РАЗЛИЧНЫЕ
|             Контрагенты.Наименование
|ИЗ
|             Справочник.Контрагенты КАК Контрагенты";

7. Конструкция ПЕРВЫЕ - выбирает указанное в параметре число записей из результата запроса

Синтаксис:        ПЕРВЫЕ  <число>

Пример использования:

Запрос.Текст =
//выбирают первые 4 номера ГТД из справочника
"ВЫБРАТЬ ПЕРВЫЕ 4
|             НомераГТД.Ссылка
|ИЗ
|             Справочник.НомераГТД КАК НомераГТД";

8. Конструкция ДЛЯ ИЗМЕНЕНИЯ - позволяет заблокировать таблицу, работает только в транзакциях (актуально только для автоматических блокировок)

Синтаксис:        ДЛЯ ИЗМЕНЕНИЯ <НаименованиеТаблицы>

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|             СвободныеОстаткиОстатки.Номенклатура,
|             СвободныеОстаткиОстатки.Склад,
|             СвободныеОстаткиОстатки.ВНаличииОстаток
|ИЗ
|             РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки
|ДЛЯ ИЗМЕНЕНИЯ
|   РегистрНакопления.СвободныеОстатки.Остатки";

9. Конструкция УПОРЯДОЧИТЬ ПО - упорядочивает данные по определенному полю. Если полем является ссылка то при установке флага АВТОУПОРЯДОЧИВАНИЕ будет происходить сортировка по представлению ссылки, если флаг выключен то ссылки сортируются по старшинству адреса ссылки в памяти

Синтаксис:        УПОРЯДОЧИТЬ ПО <НаименованиеПоля> АВТОУПОРЯДОЧИВАНИЕ

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|    СвободныеОстаткиОстатки.Номенклатура КАК Номенклатура,
|    СвободныеОстаткиОстатки.Склад КАК Склад,
|    СвободныеОстаткиОстатки.ВНаличииОстаток
|ИЗ
|    РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки
|
|УПОРЯДОЧИТЬ ПО
|    Номенклатура
|АВТОУПОРЯДОЧИВАНИЕ";

10. Конструкция СГРУППИРОВАТЬ ПО - используется для группировки строк запроса по определенным полям. Числовые поля должны использоваться с любой агрегатной функцией.

Синтаксис:        СГРУППИРОВАТЬ ПО <НаименованиеПоля1>, .... , <НаименованиеПоляN>

Пример использования:

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

11. Конструкция ИМЕЮЩИЕ - позволяет применить агрегатную функцию к условию выборки данных, похожа на конструкцию ГДЕ

Синтаксис:        ИМЕЮЩИЕ <агрегатная функция с условием>

Пример использования:

Запрос.Текст =
//выбирает сгруппированные записи где поле ВНаличии больше 3
"ВЫБРАТЬ
|             ТоварыНаСкладах.Номенклатура КАК Номенклатура,
|             ТоварыНаСкладах.Склад,
|             СУММА(ТоварыНаСкладах.ВНаличии) КАК ВНаличии
|ИЗ
|             РегистрНакопления.ТоварыНаСкладах КАК ТоварыНаСкладах
|
|СГРУППИРОВАТЬ ПО
|             ТоварыНаСкладах.Номенклатура,
|             ТоварыНаСкладах.Склад
|ИМЕЮЩИЕ СУММА(ТоварыНаСкладах.ВНаличии) > 3 ";

12. Конструкция ИНДЕКСИРОВАТЬ ПО - используется для индексации поле запроса. Запрос с индексацией дольше выполняется, но ускоряет поиск по индексированным полям. Можно использовать только в виртуальных таблицах.

Синтаксис:        ИНДЕКСИРОВАТЬ ПО <Поле1, ... , ПолеN>

Пример использования:

Запрос.Текст =
"ВЫБРАТЬ
|             Тз.НаименованиеОС,
|             Тз.НомерПапки,
|             Тз.КодОС,
|             Тз.Срок,
|             Тз.Тип
|ПОМЕСТИТЬ ДанныеТз
|ИЗ
|             &Тз КАК Тз
|ИНДЕКСИРОВАТЬ ПО
|             Тз.НаименованиеОС,
|             Тз.КодОС
|;
";

13. Конструкция ГДЕ - позволяет наложить условие на любые поля выборки. В результат попадут записи только удовлетворяющие условию.
Синтаксис:        ГДЕ <Условие1 ОператорЛогСоединения УсловиеN>

Пример использования:

Запрос.Текст =
//выбираются все записи у которых КомпенсацияОстаток <> 0 и
//СуммаДляРасчКомпОстаток > 100
"ВЫБРАТЬ
|             КомпенсацияРПОстатки.Контрагент,
|             КомпенсацияРПОстатки.Ребенок,
|             КомпенсацияРПОстатки.КомпенсацияОстаток,
|             КомпенсацияРПОстатки.СуммаДляРасчКомпОстаток
|ПОМЕСТИТЬ ДанныеТз
|ИЗ
|             РегистрНакопления.КомпенсацияРП.Остатки КАК КомпенсацияРПОстатки
|ГДЕ
|             КомпенсацияРПОстатки.КомпенсацияОстаток <> 0
|             И КомпенсацияРПОстатки.СуммаДляРасчКомпОстаток > 100";