Язык выражений системы компоновки данных примеры

Содержание

Язык выражений системы компоновки данных (1Cv8)

Содержание

Язык выражений системы компоновки данных

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

Выражения используются в следующих подсистемах:

Литералы

В выражении могут присутствовать литералы. Возможны литералы следующих типов:

Строка

Строковый литерал записывается в символах «”», например:

При необходимости использования внутри строкового литерала символа «”», следует использовать два таких символов.

Число

Число записывается без пробелов, в десятичном формате. Дробная часть отделяется при помощи символа «.». Например:

Литерал типа дата записывается при помощи ключевого литерала ДАТАВРЕМЯ (DATETIME). После данного ключевого слова, в скобках, через запятую перечисляются год, месяц, день, часы, минуты, секунды. Указание времени не обязательно.

Булево

Булевы значения могут быть записаны при помощи литералов Истина (True), Ложь (False).

Значение

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

Операции над числами

Унарный –

Данная операция предназначена для изменения знака числа на обратный. Например:

Унарный +

Данная операция не выполняет над числом никаких действий. Например:

Данная операция предназначена для вычисления разности двух чисел. Например:

Бинарный +

Данная операция предназначена для вычисления суммы двух чисел. Например:

Произведение

Данная операция предназначена для вычисления произведения двух чисел. Например:

Деление

Данная операция предназначена для получения результата деления одного операнда на другой. Например:

Остаток от деления

Данная операция предназначена для получения остатка от деления одного операнда на другой. Например:

Операции над строками

Конкатенация (Бинарный +)

Данная операция предназначена для конкатенации двух строк. Например:

Подобно

Данная операция проверяет соответствие строки переданному шаблону.

Значением оператора ПОДОБНО является ИСТИНА, если значение удовлетворяет шаблону, и ЛОЖЬ в противном случае.

Следующие символы в имеют смысл, отличный от просто очередного символа строки:

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

Операции сравнения

Равно

Данная операция предназначена для сравнения двух операндов на равенство. Например:

Не равно

Данная операция предназначена для сравнения двух операндов на неравенство. Например:

Меньше

Данная операция предназначена для проверки того, что первый операнд меньше второго. Например:

Больше

Данная операция предназначена для проверки того, что первый операнд больше второго. Например:

Меньше или равно

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

Больше или равно

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

Операция В

Операция проверки наличия значения в наборе данных

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

Операция проверки значения на NULL

Данная операция возвращает значение Истина в случае, если значение является значением NULL. Например:

Операция проверки значения на неравенство NULL

Данная операция возвращает значение Истина в случае, если значение не является значением NULL. Например:

Логические операции

Логические операции принимают в качестве операндов выражения, имеющие тип Булево.

Операция НЕ

Операция НЕ возвращает значение Истина в случае, если ее операнд имеет значение Ложь, и значение Ложь в случае, если ее операнд имеет значение Истина. Например:

Операция И

Операция И возвращает значение Истина в случае, если оба операнда имеют значение Истина, и значение Ложь в случае, если один из операндов имеет значение Ложь. Например:

Операция ИЛИ

Операция ИЛИ возвращает значение Истина в случае, если один из операндов имеет значение Истина, и Ложь в случае, если оба операнда имеют значение Ложь. Например:

Агрегатные функции

Агрегатные функции осуществляют некоторое действие над набором данных.

Сумма

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

Количество

Функция Количество рассчитывает количество значений отличных от значения NULL. Например:

Количество различных

Эта функция рассчитывает количество различных значений. Например:

Максимум

Функция получает максимальное значение. Например:

Минимум

Функция получает минимальное значение. Например:

Среднее

Функция получает среднее значение для значений, отличных от NULL. Например:

Другие операции

Операция ВЫБОР

Операция Выбор предназначена для осуществления выбора одного из нескольких значений при выполнении некоторых условий. Например:

Правила сравнения двух значений

Если типы сравниваемых значений отличаются друг от друга, то отношения между значениями определяются на основании приоритета типов:

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

Если типы данных совпадают, то производится сравнение значений по следующим правилам:

Работа со значением NULL

Любая операция, в которой значение одного из операндов NULL, будет давать результат NULL.

Приоритеты операций

Операции имеют следующие приоритеты (первая строка имеет низший приоритет):

Функции языка выражений системы компоновки данных

Вычислить

Функция Вычислить предназначена для вычисления выражения в контексте некоторой группировки. Функция имеет следующие параметры:

В данном примере в результате получится отношение суммы по полю «Продажи.СуммаОборот» записи группировки к сумме того же поля во всей компоновке.

Уровень

Функция предназначена для получения текущего уровня записи.

НомерПоПорядку

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

НомерПоПорядкуВГруппировке

Возвращает следующий порядковый номер в текущей группировке.

Формат

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

Форматная строка задается в соответствии с форматной строкой 1С:Предприятие.

НачалоПериода

Функция предназначена для выделения определенной даты из заданной даты.

КонецПериода

Функция предназначена для выделения определенной даты из заданной даты.

ДобавитьКДате

Функция предназначена для прибавления к дате некоторой величины.

РазностьДат

Функция предназначена для получения разницы между двумя датами.

Подстрока

Данная функция предназначена для выделения подстроки из строки.

ДлинаСтроки

Функция предназначена для определения длины строки.

Данная функция предназначена для выделения года из значения типа Дата.

Квартал

Данная функция предназначена для выделения номера квартала из значения типа Дата. Номер квартала в норме находится в диапазоне от 1 до 4.

Месяц

Данная функция предназначена для выделения номера месяца из значения типа Дата. Номер месяца в норме находится в диапа-зоне от 1 до 12.

ДеньГода

Данная функция предназначена для получения дня года из значения типа Дата. День года в норме находится в диапазоне от 1 до 365(366).

Данная функция предназначена для получения дня месяца из значения типа Дата. День месяца в норме находится в диапазоне от 1 до 31.

Неделя

Данная функция предназначена для получения номера недели года из значения типа Дата. Недели года нумеруются, начиная с 1.

ДеньНедели

Данная функция предназначена для получения дня недели из значения типа Дата. День недели в норме находится в диапазоне от 1 (понедельник) до 7(воскресенье).

Данная функция предназначена для получения часа суток из значения типа Дата. Час суток находится в диапазоне от 0 до 23.

Минута

Данная функция предназначена для получения минуты часа из значения типа Дата. Минута часа находится в диапазоне от 0 до 59.

Секунда

Данная функция предназначена для получения секунды минуты из значения типа Дата. Секунда минуты находится в диапазоне от 0 до 59.

Выразить

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

ЕстьNull

Данная функция возвращает значение второго параметра в случае, если значение первого параметра NULL.

В противном случае будет возвращено значение первого параметра.

Функции общих модулей

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

В данном примере будет осуществлен вызов функции «СокращенноеНаименование» из общего модуля конфигурации.

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

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

Источник

1С 8.3 : Функции языка выражений системы компоновки данных (СКД) ВычислитьВыражениеСГруппировкойМассив, ВычислитьВыражениеСГруппировкойТаблицаЗначений

ВычислитьВыражениеСГруппировкойМассив (EvalExpressionWithGroupArray) – функция возвращает массив, каждый элемент которого содержит результат вычисления выражения для группировки по указанному полю.

Синтаксис:
ВычислитьВыражениеСГруппировкойМассив (Выражение, ВыраженияПолейГруппировки, ОтборЗаписей, ОтборГруппировок)

Пример:
Максимум(ВычислитьВыражениеСГруппировкойМассив («Сумма(СуммаОборот)», «Контрагент»));

Компоновщик макета при генерации макета преобразовывает параметры функции в термины полей макета компоновки данных. Например, поле Контрагент будет конвертировано в НаборДанных.Контрагент.
Компоновщик макета при генерации выражений для вывода пользовательского поля, в выражении которого присутствует только функция ВычислитьМассивСГруппировкой генерирует выводимое выражение таким образом, чтобы данные выводить представления и данные были упорядочены.
Например, для пользовательского поля с выражением:
ВычислитьВыражениеСГруппировкойМассив(«Сумма(СуммаОборот)», «Контрагент»)
компоновщик макета сгенерирует для вывода следующее выражение:
СоединитьСтроки(Массив(Упорядочить(ВычислитьВыражениеСГруппировкойТаблицаЗначений («Представление(Сумма(НаборДанных.СуммаОборот)), Сумма(НаборДанных.СуммаОборот)», «НаборДанных.Контрагент»), «2»)))

ВычислитьВыражениеСГруппировкойТаблицаЗначений (EvalExpressionWithGroupValueTable) – функция возвращает таблицу значений, каждый элемент которого содержит результат вычисления выражения для группировки по указанному полю.

Синтаксис:
ВычислитьВыражениеСГруппировкойТаблицаЗначений (Выражение, ВыраженияПолейГруппировки, ОтборЗаписей, ОтборГруппировок)

Пример:
ВычислитьВыражениеСГруппировкойТаблицаЗначений («Контрагент КАК Контрагент, Сумма(СуммаОборот) Как ОбъемПродаж», «Контрагент»)

Результатом работы данной функции будет таблица значений с колонками Контрагент и ОбъемПродаж, в которых будут находиться контрагенты с их объемами продаж.
Компоновщик макета при генерации макета преобразовывает параметры функции в термины полей макета компоновки данных. Например, поле Контрагент будет конвертировано в НаборДанных.Контрагент.
Например, пользовательского поля с выражением:
ВычислитьВыражениеСГруппировкойТаблицаЗначений («Контрагент, Сумма(СуммаОборот)», «Контрагент»)
Компоновщик макета сгенерирует для вывода следующее выражение:
СоединитьСтроки(ПолучитьЧасть(Упорядочить(ВычислитьВыражениеСГруппировкойТаблицаЗначений («НаборДанных.Контрагент, НаборДанных.КонтрагентПредставление, Сумма(НаборДанных.СуммаОборот), Представление(НаборДанных.СуммаОборот), НаборДанных.ПолеУпорядочивание», «НаборДанных.Контрагент»), «5, 1, 3»), «2, 4»))

Источник

1С 8.3 : Функции языка выражений системы компоновки данных (СКД)

Уровень (Level) – функция предназначена для получения текущего уровня записи.

НомерПоПорядку (SequenceNumber) – получить следующий порядковый номер.

НомерПоПорядкуВГруппировке (SequenceNumberInGrouping) – возвращает следующий порядковый номер в текущей группировке.

Формат (Format) – получить отформатированную строку переданного значения.

Синтаксис:
Формат(Значение, ФорматнаяСтрока)

Пример:
Формат(РасходныеНакладные.СуммаДок, «ЧДЦ=2»)

НачалоПериода (BeginOfPeriod) – функция предназначена для выделения определенной даты из заданной даты.

Синтаксис:
НачалоПериода(Дата, ТипПериода)

Пример:
НачалоПериода(ДатаВремя(2002, 10, 12, 10, 15, 34), «Месяц»)
Результат: 01.10.2002 0:00:00

КонецПериода (EndOfPeriod) – функция предназначена для выделения определенной даты из заданной даты.

Синтаксис:
КонецПериода(Дата, ТипПериода)

Пример:
КонецПериода(ДатаВремя(2002, 10, 12, 10, 15, 34), «Неделя»)
Результат: 13.10.2002 23:59:59

ДобавитьКДате (DateAdd) – функция предназначена для прибавления к дате некоторой величины.

Синтаксис:
ДобавитьКДате(Выражение, ТипУвеличения, Величина)

Пример:
ДобавитьКДате(ДатаВремя(2002, 10, 12, 10, 15, 34), «Месяц», 1)
Результат: 12.11.2002 10:15:34

РазностьДат (DateDifference) – функция предназначена для получения разницы между двумя датами.

Пример:
РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2002, 10, 12, 10, 15, 34),
ДАТАВРЕМЯ(2002, 10, 14, 9, 18, 06), «ДЕНЬ»)
Результат: 2

Подстрока (Substring) – данная функция предназначена для выделения подстроки из строки.

Синтаксис:
Подстрока(Строка, Позиция, Длина)

Пример:
ПОДСТРОКА(Контрагенты.Адрес, 1, 4)

ДлинаСтроки (StringLength) – функция предназначена для определения длины строки.

15. Год (Year) – данная функция предназначена для выделения года из значения типа Дата.

Квартал (Quarter) – данная функция предназначена для выделения номера квартала из значения типа Дата. Номер квартала в норме находится в диапазоне от 1 до 4.

Месяц (Month) – данная функция предназначена для выделения номера месяца из значения типа Дата. Номер месяца в норме находится в диапа-зоне от 1 до 12.

ДеньГода (DayOfYear) – данная функция предназначена для получения дня года из значения типа Дата. День года в норме находится в диапазоне от 1 до 365(366).

День (Day) – данная функция предназначена для получения дня месяца из значения типа Дата. День месяца в норме находится в диапазоне от 1 до 31.

Неделя (Week) – данная функция предназначена для получения номера недели года из значения типа Дата. Недели года нумеруются, начиная с 1.

ДеньНедели (WeekDay) – данная функция предназначена для получения дня недели из значения типа Дата. День недели в норме находится в диапазоне от 1 (понедельник) до 7(воскресенье).

Час (Hour) – данная функция предназначена для получения часа суток из значения типа Дата. Час суток находится в диапазоне от 0 до 23.

Минута (Minute) – данная функция предназначена для получения минуты часа из значения типа Дата. Минута часа находится в диапазоне от 0 до 59.

Секунда (Second) – данная функция предназначена для получения секунды минуты из значения типа Дата. Секунда минуты находится в диапазоне от 0 до 59.

Источник

Поделиться с друзьями
admin
Оцените автора
( Пока оценок нет )
Как переводится?
Adblock
detector