Описание встроенного языка системы 1С Предприятие

       

Функция


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

Синтаксис:

Функция <ИмяФункции> = <ТипФункции> (<Параметр>|<УточненныйПараметр>)

                 [Когда (<Условие>)];

Англоязычный синоним:

Function <ИмяФункции>= <ТипФункции> (<Параметр>|<УточненныйПараметр>)

                 [When (<Условие>)];

Параметры:

<ИмяФункции>



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

<TипФyнкции>

Ключевое слово одной из встроенных функ­ций языка. Может быть одним из приведен­ных ниже.

<Параметр>

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

<УточненныйПараметр>

Конкретизация объявленной ранее внутренней переменной, значение которой используется как аргумент встроенной функции < ТипФункции>.

Когда

Необязательное добавочное ключевое слово, использование которого в команде означает, что вычисление функции следует производить только при условии, когда заданное логиче­ское выражение <Условие> истинно.

<Условие>

Логическое выражение встроенного языка 1С:Предприятие. В логическом выражении могут участвовать как внутренние, так и внешние переменные запроса (см. описание метода Условие). Используется только после ключевого слова Когда.

Описание:

Оператор Функция вычисляет функцию <ТипФункции> и присваивает ее значение внутренней переменной <ИмяФункции>.

Типы применяемых функций предопределены и могут быть следующими:

Тип

Функции

Англояз. Синоним

Выполняемое действие

Сумма

Sum

Вычисляет сумму выбранных по запросу зна­чений параметра.1

Среднее

Avg

Вычисляет среднее из выбранных по запросу значений параметра.

Минимум

Min

Вычисляет минимум из выбранных по запросу значений параметра.

Максимум

Мах

Вычисляет максимум из выбранных по запро­су значений параметра.

Счётчик

Count

Подсчитывает количество записей, вошедших в выборку.

НачОст

BegRest

Вычисляет начальный остаток для выбранных по запросу значений параметра.2

КонОст

EndRest

Вычисляет конечный остаток для выбранных по запросу значений параметра.2

Приход

Debit

Вычисляет приход для выбранных но запросу значений параметра.2

Расход

Credit

Вычисляет расход для выбранных по запросу значений параметра.2

СНД

IDB

Вычисляет сальдо начальное дебетовое для выбранных по запросу значений параметра.3

СКД

FDB

Вычисляет сальдо конечное дебетовое для выбранных по запросу значений параметра.3

СНК

ICD

Вычисляет сальдо начальное кредитовое для выбранных по запросу значений параметра.3

СКК

FCD

Вычисляет сальдо конечное кредитовое для выбранных по запросу значений параметра.3

ДО

TD

Вычисляет дебетовые обороты для выбранных по запросу значений параметра.

КО

TC

Вычисляет кредитовые обороты для выбран­ных по запросу значений параметра.3

КорДО

CorTD

Вычисляет дебетовые обороты между коррес­пондирующим счетам или субконто для вы­бранных по запросу значений параметра.3, 4

КорКО

CorTC

Вычисляет кредитовые обороты между кор­респондирующим счетам или субконто для выбранных по запросу значений параметра.3, 4




1Замечание: Для ресурсов оборотных регистров допускается вызывать только тип функции "Сумма".

2Замечание: Типы функций НачОст, КонОст, Приход, Расход можно ис­пользовать только с параметрами, указывающими на ресурсы регистров остатков. Для ресурсов регистров остатков другие типы функций вызы­вать нельзя.

3Замечание: Функции СНД, СНК, СКД, СКК, ДО, КО, КорДО, КорКО можно использовать только с реквизитами проводки: Сумма, Количество или ВалСумма.

4Замечание: Функции КорДО и КорКО накапливают значения только тогда когда в запросе есть обращение к реквизитам проводок Счет, КорСчет Субконто или КорСубконто.

Замечание: В программном модуле, где используется запрос, <ИмяФункции> будет являться атрибутом запроса. При помощи данного атрибута можно обращаться к значению вычисленной в запросе функции.

Замечание: В функциях: Сумма, Среднее, Максимум, Минимум в качест­ве аргумента возможно использование арифметического выражения в терминах встроенного языка.

Пример:

...

|КолВо = Документ.ВидДокумента.Количество;

|Цена = Документ.ВидДокумента.Цена;

|Функция Сум = Сумма(КолВо * Цена);

|Функция Макс = Максимум(Окр(КолВо) * Окр(Цена));

|Функция Средн = Среднее(ФункцияОпределеннаяВМодуле(КолВо, Цена));

...

Пример:

// Создание объекта типа Запрос

Запрос = СоздатьОбъект("Запрос");

ТекстЗапроса =

"//{{ЗАПРОС(Функции)

|Период с ДатаНач по ДатаКон;

|Оклад = Справочник.Сотрудники.Оклад;

|Подр = Справочник.Сотрудники.Подразделение;

|Ктг = Справочник.Сотрудники.Категория;

|Группировка Подр без групп;

|Группировка Ктг без групп;

|Функция Всего = Сумма(Оклад);

|Условие((Ктг.Выбран() = 1) И (Подр.Выбран() = 1));

|"//}}ЗАПРОС

;

Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

   Возврат;

КонецЕсли;

// ...

Итог = Запрос.Всего;

// ...

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

Кроме того, при формировании временного набора данных запрос специ­ально формирует итоговые записи, в которые заносит накопленные значения вычисленных функций для каждой вложенной Группировки (подробнее об этом см. главу данной книги «Структура запросов и методика их использова­ния»).


Содержание раздела