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

ЦветТекста


Получить/установить режим отображения цвета текста области.

Синтаксис 1:

ЦветТекста(<Цвет>}

Синтаксис 2:

ЦветТекста(<R>, <G>, <В>)

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

TextColor

Параметры:

<Цвет>

Необязательный параметр. Числовое выражение, зна­чение которого задает RGB цвет. Допустимые значения от 0 до 16777'215. Значение -1 (минус единица) задает цвет, заданный для всей области по умолчанию.

<R>



Числовое выражение, значение которого задает крас­ную компоненту цвета. Допустимые значения от 0 до 256.

<G>

Числовое выражение, значение которого задает зеле­ную компоненту цвета. Допустимые значения от 0 до 256.

<B>

Числовое выражение, значение которого задает синюю компоненту цвета. Допустимые значения от 0 до 256.

Возвращаемое значение:

Текущее числовое значение RGB-цвета текста области (на момент до ис­полнения метода).

Описание:

Метод ЦветТекста позволяет установить режим отображения цвета текста области.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.Открыть("tabl_l.mxl");

ВыбОбласть = Таб.Область("R8C4");

ВыбОбласть.Шрифт("Arial");

ВыбОбласть.РазмерШрифта(10);

ВыбОбласть.Подчеркнутый(1);

ВыбОбласть.ГоризонтальноеПоложение(3);

ВыбОбласть.Контроль(4);

ВыбОбласть.ЦветТекста(34, 126, 211);



Дата


Дата текущей строки календаря/праздника.

Синтаксис:

Дата

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

Date

Описание:

Атрибут Дата (только для чтения) содержит дату текущей (на которой по­зиционирована выборка) строки календаря/праздника.



Дата


Преобразовать параметр в дату.

Синтаксис 1:

Дата(<Параметр>)

Синтаксис 2:

Дата(<Год>, <Месяц>, <Число>)

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

Date

Параметры:

<Параметр>

Числовое выражение.

<Год>

Числовое выражение. Год указывается 4-х знач-ным числом (вместе с веком).

<Месяц>

Числовое выражение.

<Число>

Числовое выражение.

Возвращаемое значение:

Значение типа «дата».

Описание:

Функция Дата преобразует значение переданных параметров в дату, руко­водствуясь принятыми правилами преобразования типов и возвращает значе­ние даты.

Пример:

// преобразование из строки

ДатаРожд = Дата('06.03.1958');



ДатаЧисло


Определить день месяца указанной даты.

Синтаксис:

ДатаЧисло(<Дата>)

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

GetDay

Параметры:

<Дата>

Выражение со значением типа «дата».

Возвращаемое значение:

Число со значением определенного дня месяца.

Описание:

Функция ДатаЧисло определяет день месяца указанной даты.

Пример:

ЗначениеДняМесяца = ДатаЧисло(РабочаяДата());



ДатаДок


Дата документа

Синтаксис:

ДатаДок

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

DocDate

Описание:

Атрибут ДатаДок задает значение даты выбранного документа.

Пример:

Процедура ВводНового()

   // устанавливаем дату документа

   ДатаДок=РабочаяДата();

   Подразделение = Константа.АУП;

   Валюта = Константа.ДефВалютаЗакупки;

   Валюта.ИспользоватьДату(ДатаДок);

   Дата_Курса = ДатаДок;

   Курс = Валюта.Текущ_курс;

   Фирма = Константа.ДефФирма;

КонецПроцедуры



ДатаГод


Определить год указанной даты.

Синтаксис:

ДатаГод(<Дата>)

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

GetYear

Параметры:

<Дата>

Выражение со значением типа «дата».

Возвращаемое значение:

Число со значением определенного года.

Описание:

Функция ДатаГод определяет год указанной даты.

Пример:

ЗначениеГода = ДатаГод(РабочаяДата());



ДатаМесяц


Определить месяц указанной даты.

Синтаксис:

ДатаМесяц(<Дата>)

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

GetMonbh

Параметры:

<Дата>

Выражение со значением типа «дата».

Возвращаемое значение:

Число со значением номера месяца года.

Описание:

Функция ДатаМесяц определяет месяц указанной даты.

Пример:

ЗначениеМесяца = ДатаМесяц(РабочаяДата());



ДатаНачала


Дата начала периода журнала расчетов.

Синтаксис:

ДатаНачала

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

DateFrom

Описание:

Атрибут типа «дата» — дата начала периода журнала расчетов.

Пример:

Процедура ПриСменеРасчетногоПериода(ЖР, Период)

   Если ЖР.Вид() = "Зарплата" Тогда

      Предупреждение("Это смена текущего расчетного периода

               | для журнала Зарплата");

   КонецЕсли;

   Если Период.ДатаНачала <= ЖР.НачалоТекущегоПериода Тогда

      //не позволяем откатывать период назад

      СтатусВозврата(0);

   КонецЕсли;

КонецПроцедуры

См. также: ДатаОкончания



ДатаНачала


Дата начала действия записи журнала расчетов.

Синтаксис:

ДатаНачала

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

DateFrom

Описание:

Атрибут типа «дата» — дата начала действия текущего акта расчета (записи журнала расчетов). Эта дата может не совпадать с периодом регистрации Атрибут ДатаНачала предназначен только для чтения.

Пример:

// процедура выполняется в контексте журнала расчетов

// ДатаНачала и ДатаОкончания доступны непосредственно!

// календарь

Календ = Объект.Категория.Получить(ДатаНачала).Календарь;

// размер оклада

Тариф = Объект.Тариф.Получить(ДатаОкончания);

Часов = Календ.Часов(ДатаНачала.ДатаОкончания);

Результат = Окр(Тариф*Часов);

Часы = ?(Сторно = 1, -Часов, Часов);

См. также: ДатаОкончания, ПериодДействия, ПериодРегистрации



ДатаОкончания


Дата окончания периода журнала расчетов.

Синтаксис:

ДатаОкончания

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

DateTill

Описание:

Атрибут типа «дата» — дата окончания периода журнала расчетов.

См. также: ДатаНачала



ДатаОкончания


Дата окончания действия записи журнала расчетов.

Синтаксис:

ДатаОкончания

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

DateTill

Описание:

Атрибут типа «дата» — дата окончания действия текущего акта расчета (за­писи журнала расчетов).

Атрибут ДатаОкончания предназначен только для чтения.

Пример:

См. предыдущий пример.

См. также: ДатаНачала, ПериодДействия, ПериодРегистрации



ДатаОперации


Дата операции.

Синтаксис:

ДатаОперации

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

OperDate

Значение:

Значение типа «Дата».

Описание:

Атрибут ДатаОперации содержит дату бухгалтерской операции. Так как каждая бухгалтерская операция принадлежит документу (причем только одно­му, а операция введенная вручную также принадлежит специальному докумен­ту «Операция»), значение атрибута совпадает со значением атрибута ДатаДок документа, которому принедлежит операция. Наличие данного атрибута у оп-реации упрощает обращение к дате документа, которому принадлежит опера­ция.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Сообщить(Опер.ДатаОперации);



ДатаЗнач


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

Синтаксис:

ДатаЗнач

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

DateVal

Описание:

Атрибут ДатаЗнач предоставляет доступ к дате значения выбранного пе­риодического реквизита справочника или константы.

Пример:

См. предыдущий пример



Дебет


Обращение к дебету проводки (корреспонденции).

Синтаксис:

Дебет

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

Debit

Описание:

Атрибут Дебет служит для обращения к дебетовой части текущей проводки (корреспонденции) операции. Данный атрибут возвращает агрегатный объект специального типа «Дебет», который используется только для доступа к дан­ным дебетовой части конкретной проводки (корреспонденции) операции и не используется отдельно.

Перед обращением к атрибуту конкретной проводки эта проводка должна быть выбрана с помощью методов ВыбратьПроводки, ПолучитьПроводку или создана при помощи метода НоваяПроводка. В модулях форм «Опера­ции» и «Журнал проводок» текущая проводка определяется положением кур­сора.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Опер.ВыбратьПроводки();

Пока Опер.ПолучитьПроводку() = 1 Цикл

   Сообщить("Проводка " + Опер.Дебет.Счет + " - " + Опер.Кредит.Счет);

КонецЦикла;



ДлинаПредставленияЗначения


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

Синтаксис:

ДлинаПредставленияЗначения(<Мин>, <Макс>, <ДлПоУмолч>)

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

ValuePresentLen

Параметры:

<Мин>

Необязательный параметр. Метод не будет воз­вращать значение меньше указанной в данном параметре величины.

<Макс>

Необязательный параметр. Метод не будет воз­вращать значение больше указанной в данном параметре величины.

<ДлПоУмолч>

Необязательный параметр. Метод будет возвра­щать данную величину для метаданных, для которых длина представления не определена. Параметр задает длину для типов данных, таких как Справочник неопределенного типа и анало­гичных, у которых не определена длина.

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

Описание:

Метод ДлинаПредставленияЗначения для типизированных объектов ти­па Реквизит и аналогичных, выдает длину представления значения. Данный метод может использоваться, например, для определения ширины столбца в универсальных отчетах, выводящих данные объектов различных видов.

Пример:

Ширина =

   Метаданные.Документ(1).РеквизитШапки(2).ДлинаПредставленияЗначения(5, 50, 30)




Для


Оператор выполнения цикла.

Синтаксис:

Для <Имя_переменной> = <Выражение1> По <Выражение2> Цикл

   //Операторы;

КонецЦикла;

Англоязычный Синтаксис:

For <Имя_переменной> = <Выражение1> То <Выражение2> Do

   //Операторы;

EndDo;

Параметры:

<Имя_переменной>

Идентификатор переменной (счетчика цикла), значение которой автоматически увеличивается при каждом повторении цикла.

<Выражение 1>

Числовое выражение, которое задает на­чальное значение, присваиваемое счетчику цикла при первом проходе цикла.

По

Синтаксическая связка для параметра <Выражение2>.

<Выражение 2>

Максимальное значение счетчика цикла. Когда переменная Имя_переменной стано­вится больше чем <Выражение2>, выпол­нение оператора цикла Для прекращается. Величина приращения счетчика при каж­дом выполнении цикла равна 1.

Цикл

Операторы следующие за ключевым сло­вом Цикл выполняются, пока значение переменной Имя_переменной меньше зна­чения <Выражение2>.

//Операторы

Исполняемый оператор или последова­тельность таких операторов.

КонецЦикла

Ключевое слово, которое завершает струк­туру оператора цикла.

Описание:

Оператор цикла Для предназначен для циклического повторения операто­ров, находящиеся внутри конструкции Цикл ... КонецЦикла. Перед началом выполнения цикла значение <Выражение1> присваивается переменной <Имя_переменной>. Значение <Имя_переменной> автоматически увеличи­вается при каждом проходе цикла. Цикл выполняется пока значение перемен­ной <Имя_переменной> меньше или равно значению <Выражение2>. Вели­чина приращения счетчика при каждом выполнении цикла равна 1. Условие выполнения цикла всегда проверяется вначале, перед выполнением цикла.

Пример:

// Выведем все строки текста

Выв = СоздатьОбъект("Текст");

Выв.Открыть("ТТТ");

Для i = l по Выв.КоличествоСтрок() Цикл

   Сообщить(Выв.ПолучитьСтроку(i));

КонецЦикла;



Дней


Получить количество «ненулевых» дней за период.

Синтаксис:

Дней(<ДатаНачала>, <ДатаОкончания>)

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

Days

Параметры:

<ДатаНачала>

Дата начала периода, в котором определяется ко­личество дней.

<ДатаОкончания>

Дата окончания периода, в котором определяется количество дней.

Возвращаемое значение:

Целое положительное число — количество дней.

Описание:

Метод предназначен для определения количества календарных дней, кото­рым соответствует ненулевое числовое значение. <ДатаНачала> и <ДатаОкончания> включаются в рассматриваемый период. Следовательно, если даты начала и окончания совпадают, метод возвратит ноль или единицу в зависимости от значения числа, соответствующего заданной дате. Если <ДaтaHaчaлa> больше, чем <ДатаОкончания>, будет выведено сообщение об ошибке.

Пример:

// Расчет оплаты по окладу

// Календарь служащих

Календ = СоздатьОбъект("Календарь.Служащие");

// отработал...

Дни = Календ.Дней(ДатаНачала, ДатаОкончания);

// должен был бы работать...

Норма = Календ.Дней(НачалоПериодаПоДате(ДатаНачала),

                    КонецПериодаПоДате(ДатаНачала));

// получим оклад сотрудника на дату начала

// действия данного расчета

Оклад = Объект.Оклад.Получить(ДатаНачала);

// результат

Результат = Дни * Оклад / Норма;

См. также: Часов



Добавить


Добавить новую пустую запись.

Синтаксис:

Добавить()

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

Add

Описание:

Метод Добавить добавляет новую пустую запись. Атрибуты объекта обну­ляются (см. метод Очистить). Для записи изменений в базу данных необходи­мо инициировать запись (см. «Назначение агрегатного типа данных Xbase»).

Пример:

Процедура ДобЗап(Поле!, Поле2)

   ДБФ.Добавить();

   // Определяем поля новой записи

   ДБФ.FIELD1 = Поле1;

   ДБФ.FIELD2 = Поле2;

   ДБФ.Записать();

КонецПроцедуры



ДобавитьИндекс


Добавить индекс в структуру базы.

Синтаксис:

ДобавитьИндекс(<Название>, <Выражение>, <Уникальность>, <Убывание>, <Фильтр>)

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

AddIndex

Параметры:

<Название>

Строковое выражение — имя создаваемого индек­са.

<Выражение>

Строковое выражение — выражение индекса.

<Уникальность>

Числовое выражение — флаг уникальности ин­декса. 1 — уникальный. 0 — не уникальный.

<Убывание>

Числовое выражение — флаг направления убыва­ния индекса: 1 — индекс по убыванию значения ключа. 0 — по возрастанию значения ключа.

<Фильтр>

Строковое выражение — фильтр индекса.

Описание:

Метод ДобавитьИндекс добавляет индекс в описание структуры базы. Вы­ражение индекса и фильтр индекса описаны в разделе «Выражение и фильтр индекса».

Пример:

ДБФ = СоздатьОбъект("XBase");

ДБФ.ДобавитьПоле("CODE", 1, 19, 3);

ДБФ.ДобавитьПоле("NAME", 2, 25, 0);

ДБФ.ДобавитьИндекс("IDXCODE", "CODE", 1, 0, "");

ДБФ.ДобавитьИндекс("IDXNAME", "NAME", 0, 0, "");

ДБФ.СоздатьФайл("mydb.dbf", "mydb.cdx");

См. также: СоздатьФайл, ДобавитьПоле



ДобавитьКакПодчиненный


Добавляет вид расчета в список «подчиненных».

Синтаксис:

ДобавитьКакПодчиненный(<ВидРасчета>)

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

AddAsDependent

Параметры:

<ВидРасчета>

Вид расчета.

Описание:

Метод ДобавитьКакПодчиненный добавляет <ВидРасчета> в список «подчиненных».

Пример:

ПравилоПерерасчета.Доплаты.ДобавитьКакПодчиненный(ВидРасчета.Премия);



ДобавитьКакВедущий


Добавляет вид расчета в список «ведущих».

Синтаксис:

ДобавитьКакВедущий(<ВидРасчета>)

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

AddAsLeading

Параметры:

<ВидРасчета>

Вид расчета.

Описание:

Метод ДобавитьКакВедущий добавляет <ВидРасчета> в список «веду­щих».

Пример:

ПравилоПерерасчета.Доплаты.ДобавитьКакВедущий(ВидРасчета.Премия);



ДобавитьМесяц


Добавляет к указанной дате заданное число месяцев.

Синтаксис:

ДобавитьМесяц(<Дата>, <ЧислоМесяцев>)

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

AddMonth

Параметры:

<Дата>

Выражение со значением типа «дата».

<ЧислоМесяцев>

Числовое выражение, задающее число месяцев, до­бавляемое к дате.

Возвращаемое значение:

Результирующая дата.

Описание:

Функция ДобавитьМесяц добавляет к указанной дате заданное число ме­сяцев.

Пример:

ДатаЧерезТриМесяца = ДобавитьМесяц(РабочаяДата(), 3);



ДобавитьПоле


Добавить поле в структуру базы.

Синтаксис:

ДобавитьПоле(<Название>, <Тип>, <Длина>, <Точность>)

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

AddField

Параметры:

<Название>

Строковое выражение — имя создаваемого поля.

<Тип>

Строковое или числовое выражение — тип созда­ваемого поля. Допустимые значения:

1 или"N" — число;

2 или "S" — строка;

3 или "D" — дата;

4 или "L" — логическое;

5 или "F" — то же, что и 1, т. е. число;

6 или "М" — memo (не поддерживается).

<Длина>

Числовое выражение — общая длина создаваемого поля.

<Точность>

Числовое выражение — длина создаваемого поля после десятичной точки (только для числовых полей).

Описание:

Метод ДобавитьПоле добавляет поле в описание структуры базы. Данный метод можно использовать только перед созданием новой базы.

Пример:

ДБФ = СоздатьОбъект("XBase");

ДБФ.ДобавитьПоле("CODE", 1, 19, 3);

ДБФ.ДобавитьПоле("NAME", 2, 25, 0);

ДБФ.СоздатьФайл("mydb.dbf");

См. также: СоздатьФайл, ДобавитьИндекс



ДобавитьСтроку


Добавить строку в конец текста.

Синтаксис:

ДобавитьСтроку(<Строка>)

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

AddLine

Параметры:

<Строка>

Строковое выражение.

Описание:

Метод ДобавитьСтроку добавляет в конец текста строку <Строка>.

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");

ТекстДок.ДобавитьСтроку("Работы ..., 3056 ..75 000 руб.");

ТекстДок.ТолькоПросмотр(1).



ДобавитьЗначение


Добавить значение в список.

Синтаксис:

ДобавитьЗначение(<Значение>, <Строка>)

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

AddValue

Параметры:

<Значение>

Выражение со значением, которое добавляется в список.

<Строка>

Необязательный параметр. Строковое выражение, содержащее задаваемое символьное представление добавляемого значения. По умолчанию принимает стандартное в системе 1С:Предприятие символьное представление объекта.

Описание:

Метод ДобавитьЗначение добавляет значение и его символьное представ­ление в конец списка. Представление используется в дальнейшем для удобства сортировки и выбора значений из списка (отображается в диалоговом окне выбора).

Пример:

// Объявляем переменные

Перем Список;

Перем ВР;

// процедура выбора значения

Процедура ВыбратьВР()

   Если Список.ВыбратьЗначение(ВР, "Выбор дог: паты") = 1 Тогда

      Расчет = ВР;

      НазваниеВР = Расчет.Код;

   КонецЕсли;

КонецПроцедуры

// инициализация переменных

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

Список.ДобавитьЗначение(ВидРасчета.ДоплатаЛроцентом, "Процентом");

Список.ДобавитьЗначение(ВидРасчета.ДоплатаСуммой, "Суммой");

// первоначальное значение

НазваниеВР = Расчет.Код;



Документ


Документ, которому принадлежит операция.

Синтаксис:

Документ

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

Document

Значение:

Значение типа документ.

Описание:

Атрибут Документ является атрибутом «только для чтения», то есть ему нельзя присваивать никакого значения. Он служит для обращения к документу, котрому принадлежит операция. Так, как любая операция принадлежит доку­менту (операция введенная «вручную» принадлежит документу специального вида «Операция») доступ к некоторым свойствам операции, например, номеру возможен только посредством обращения к атрибуту Документ.

Атрибут Документ предназначен только для доступа к атрибутам и рекви­зитам документа, которому принадлежит операция. Для получения значения типа «Документ» используется метод ТекущийДокумент.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Сообщить(Опер.Документ.НомерДок);



Документ


Документ-основание текущей записи журнала расчетов.

Синтаксис:

Документ

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

Document

Описание:

Атрибут типа «Документ». Ссылка на документ, на основании которого данная запись (расчет) введена в журнал расчетов. Это может быть, например, документ «Больничный лист», породивший одну или несколько записей с ви­дом расчета «Оплата больничного листа».

Этот атрибут журнала расчетов заполняется в момент проведения докумен­та ссылкой на этот документ, в случае использования методов ВвестиРасчет, ВвестиПерерасчет, ЗаписатьРасчет, или ссылкой на другой документ, в случае использования методов ВвестиРасчетНаОсновании, ЗаписатьРасчетНаОсновании, ВвестиПерерасчетНаОсновании (см. ни­же).

Атрибут Документ предназначен только для чтения.

Пример:

Процедура ПровестиРасчет()

   Календ = Объект.Категория.Получить(ДатаНачала).Календарь;

   Дней = Календ.Дней(ДатаНачала, ДатаОкончания);

   Если ОткрытДок(Документ) = 0 Тогда

      РассчитатьСреднюю(Документ, Константа.МесСреднБЛ,

           ГруппаРасчетов.СредняяДляБЛ, 0);

   КонецЕсли;

   // среднюю зарплату берем из документа породившего расчет

   Результат =Окр(Дней * Документ.СрЗарплата);

   Дни = ?(Сторно = 1, -Дней, Дней);

КонецПроцедуры

См. также: ВвестиРасчет, ЗаписатьРасчет, ВвестиПерерасчет, ЗаписатьРасчетНаОсновании, ВестиРасчетНаОсновании, ВвестиПерерасчетНаОсновании



Доступность


Установка режима редактирования.

Синтаксис:

Доступность(<Режим>)

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

Enable

Параметры:

<Режим>

Необязательный параметр. Числовое выражение:

1 — разрешено редактирование элемента формы;

0 — запрещено редактирование.

Возвращаемое значение:

Текущее числовое значение режима редактирования элемента формы (на момент до исполнения метода).

Описание:

Метод Доступность позволяет установить режим редактирования выбран­ного элемента формы.

Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.НазвФирмы.Доступность(0);



Доступность


Установка режима редактирования.

Синтаксис:

Доступность(<Режим>)

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

Enable

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — разрешено редактирование элемента формы; 0 — запрещено редактирование.

Возвращаемое значение:

Текущее числовое значение режима редактирования области таблицы (на момент до исполнения метода).

Описание:

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

Пример:

ВыбОбласть.Доступность(0);



Движение


Выполнить запись движения в оборотный регистр по параметрам.

Синтаксис:

Движение(<Измерен1>, <Измерен2>..., <Ресурс1> , <Ресурс2>...)

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

Act

Параметры:

<Измерен1 >, <Измерен2>

Выражения со значениями измерений регистра.

<Ресурс1>, <Ресурс2>

Выражения со значениями ресурсов регистра.

Описание:

Метод Движение выполняет запись движения в оборотный регистр для те­кущего документа. Измерения регистра, по которым записывается движение передаются в параметрах <Измерен1>, <Измерен2>, .. Величины приращений ресурсов регистра передаются параметрами <Ресурс1>, <Ресурс2>...

Данный метод доступен только в контексте Модуля документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. «Работа с Документа­ми»).

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

Пример:

Процедура ОбработкаПроведения();

   ВыбратьСтроки();

   Пока ПолучитьСтроку() > 0 Цикл

      Регистр.ОборотыТоваров.Движение(Товар, Склад, ОборотТовара);

   КонецЦикла;

КонецПроцедуры

См. также: ОбработкаПроведения



ДвижениеПриход


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

Синтаксис:

ДвижениеПриход (<Измерен1>, <Измерен2> ... , <Ресурс1>, <Ресурс2> ...)

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

ActIncome

Параметры:

<Измерен1>, <Измерен2>

Выражения со значениями измерений регистра.

<Ресурс1>, <Ресурс2>

Выражения со значениями ресурсов регистра.

Описание:

Метод ДвижениеПриход выполняет запись прихода в регистр для текущего документа. Измерения регистра, по которым записывается приход передаются параметрами <Измерение1>, <Измерение2>, ... Величина приращений прихо­дуемых ресурсов регистра передаются параметрами <Ресурс1>, <Ресурс2>...

Данный метод доступен только в контексте Модуля документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. «Работа с Документа­ми»).

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

Пример:

Процедура ОбработкаПроведения();

   ВыбратьСтроки();

   Пока ПолучитьСтроку() > 0 Цикл

      Регистр.ТовЗап.ПривязыватьСтроку(НомерСтроки);

      Регистр.ТовЗап.ДвижениеПриход(Склад, Товар, Количество, Стоимость);

   КонецЦикла;

КонецПроцедуры;

См. также: ОбработкаПроведения



ДвижениеПриходВыполнить


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

Синтаксис:

ДвижениеПриходВыполнить()

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

DoActIncome

Описание:

Метод ДвижениеПриходВыполнить выполняет запись прихода в регистр для текущего документа. Значения измерений регистра, по которым записыва­ется приход, а также величины приращений приходуемых ресурсов регистра определяются текущими значениями атрибутов регистра.

Данный метод доступен только в контексте Модуля документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. «Работа с Документа­ми»).

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

Пример:

Процедура ОбработкаПроведения();

   Регистр.ТовЗап.Склад = Склад;

   ВыбратьСтроки();

   Пока(ПолучитьСтроку() > 0) Цикл

      Регистр.ТовЗап.Товар = Товар;

      Регистр.ТовЗап.Количество = Количество;

      Регистр.ТовЗап.Стоимость = Стоимость;

      Регистр.ТовЗап.ДвижениеПриходВыполнить();

   КонецЦикла;

КонецПроцедуры;

См. также: ОбработкаПроведения



ДвижениеРасход


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

Синтаксис:

ДвижениеРасход(<Измерен1>, <Измерен2>..., <Ресурс1>, <Ресурс2>...)

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

ActOutcome

Параметры:

<Измерен1>, <Измерен2>

Выражения со значениями измерений регистра.

<Ресурс1 >, <Ресурс2>

Выражения со значениями ресурсов регистра.

Описание:

Метод ДвижениеРасход выполняет запись расхода в регистр для текущего документа. Измерения регистра, по которым записывается расход передаются <Измервн1>, <Измерен2>, .. Величина приращений расходуемых ресурсов регистра передаются параметрами <Ресурс1>, <Ресурс2>...

Данный метод доступен только в контексте Модуля документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. «Работа с Документа­ми»).

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

Пример:

Процедура ОбработкаПроведения();

   ВыбратьСтроки();

   Пока( ПолучитьСтроку() > 0) Цикл

      Регистр.ТовЗап.ДвижениеРасход(Склад, Товар, Количество, Стоимость);

   КонецЦикла;

КонецПроцедуры

См. также: ОбработкаПроведения



ДвижениеРасходВыполнить


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

Синтаксис:

ДвижениеРасходВыполнить()

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

DoActOutcome

Описание:

Метод ДвижениеРасходВыполнить выполняет запись расхода в регистр для текущего документа. Значения измерений регистра, по которым записыва­ется приход, а также величины приращений приходуемых ресурсов регистра определяются текущими значениями атрибутов регистра.

Данный метод доступен только в контексте Модуле документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. «Работа с Документа­ми»).

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

Пример:

Процедура ОбработкаПроведения()

   Регистр.ТовЗап.Склад = Склад;

   ВыбратьСтроки();

   Пока(ПолучитьСтроку() > 0) Цикл

      Регистр.ТовЗап.Товар = Товар;

      Регистр.ТовЗап.Количество = Количество;

      Регистр.ТовЗап.Стоимость = Стоимость;

      Регистр.ТовЗап.ДвижениеРасходВыполнить();

   КонецЦикла;

КонецПроцедуры

См. также: ОбработкаПроведения



ДвижениеВыполнить


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

Синтаксис:

ДвижениеВыполнить()

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

DoAct

Описание:

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

Данный метод доступен только в контексте Модуля документа в предопре­деленной процедуре ОбработкаПроведения (см. Гл. "Работа с Документа­ми").

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

Пример:

Процедура ОбработкаПроведения();

   Регистр.ТовЗап.Склад = Склад;

   ВыбратьСтроки();

   Пока (ПолучитьСтроку() > 0) Цикл

      Регистр.ТовЗап.Товар = Товар;

      Регистр.ТовЗап.Оборот = Оборот;

      Регистр.ТовЗап.ДвижениеВыполнить();

   КонецЦикла;

КонецПроцедуры;

См. также: ОбработкаПроведения



Если


Оператор условного выполнения.

Синтаксис:

Если <Логическое_выражение> Тогда

   //операторы;

[ИначеЕсли <Логическое_выражение> Тогда]

   //операторы;

[Иначе]

   //операторы;

КонецЕсли;

Англоязычный Синтаксис:

If <Логическое_выражение> Then

   //операторы;

[Elsif <Логическое_выражение> Then]

   //операторы;

[Else]

   //операторы;

Endlf;

Параметры:

<Логическое_выражение>

Логическое выражение.

Тогда

Операторы следующие за Тогда вы­полняются, если результатом логиче­ского выражения

в конструкции Если является истина.

//операторы

Исполняемый оператор или последова­тельность таких операторов.

ИначеЕсли

Логическое выражение, следующее за ключевым словом ИначеЕсли вычис­ляется только тогда, когда условия в Если и всех предшествующих ИначеЕсли оказались ложными. Опе­раторы следующие за конструкцией ИначеЕсли — Тогда выполняются, если результатом логического выраже­ния

в данном ИначеЕсли является ис­тина.

Иначе

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

КонецЕсли

Ключевое слово, которое завершает структуру оператора условного выпол­нения.

Описание:

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

ИначеЕсли — Тогда.

Пример:

Если (РабочаяДата() > '01.01.95') И (Сег = "Понедельник") Тогда

   Сообщить("Сегодня" + " " + Сег + " " + РабочаяДата());

КонецЕсли;



EvalExpr


Вычислить выражение системы 1С:Предприятие.

Синтаксис:

EvalExpr(<СтрокаВыражения>)

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

EvalExpr

Параметры:

<СтрокаВыражения>

Строковое выражение — выражение, записанное на встроенном языке 1С:Предприятие.

Возвращаемое значение:

Результат вычисленного выражения.

Описание:

Метод EvalExpr вычисляет выражение, записанное в параметре <СтрокаВыражения> на встроенном языке 1С:Предприятие и возвращает ре­зультат вычисления. Результатом выражения может быть число, строка, дата или значение любого агрегатного типа данных. Результат с неопределенным типом данных преобразуются к строковому типу.

Пример:

* здесь пример приводится на языке MS Visual Basic:

Dim v7 As Object

Dim Товары As Object

Set v7 = CreateObject("V77.Application")

result = v7.Initialize(v7.RMTrade, "/DC:\V7\DB /M", "")

Set Товары = v7.EvalExpr("ОтдатьСправочникТоваров()");



ExecuteBatch


Выполнить последовательность операторов системы 1С:Предприятие.

Синтаксис:

ExecuteBatch(<СтрокаОператоров>)

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

ExecuteBatch

Параметры:

<СтрокаОператоров>

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

Возвращаемое значение:

Значение логического типа: TRUE, если последовательность операторов вы­полнены успешно, или FALSE, если нет.

Замечание: В OLE Automation TRUE и FALSE имеют соответственно значе­ния: -1 (минус единица) и 0.

Описание:

Метод ExecuteBatch выполняет последовательность операторов, запи­санную в параметре <СтрокаОператоров> на встроенном языке 1С:Предприятие.

Пример:

* здесь пример приводится на языке MS Visual Basic:

Sub Command1_Click ()

   Dim v7 As Object

   Dim Price As Object

   Set v7 = CreateObject("V77.Application")

   result = v7.Initialize(v7.RMTrade, "/DC:\V7\DB /M", "")

   Set Price = v7.EvalExpr("ОтдатьСправочникТоваров()")

   Price.New

   Price.Code = "112233"

   Price.Description = "Test string"

   Price.Write;

   BoolResult = v7.ExecuteBatch("ПроцедураРегл1();ПроцедураРегл2()")

End Sub

* Обращение к программе 1С:Предприятие из модуля MS Excel. В данном примере запускается и инициализируется конфигурация 1С:Предприятие с базой данных в каталоге C:\V7\DB в монопольном режиме. Далее в про­грамме 1С:Предприятие создается объект типа "Справочник.Товары", где создается новая группа элементов с названием "***** Экспорт из Excel ******". Во вновь созданную группу каталога записываются данные из таб­лицы MS Excel. Здесь пример приводится на языке MS Visual Basic.

Sub Excel_to_trade()

   Dim trade As Object

   Dim Товар As Object

   Set trade = CreateObject("V77 .Application")

   result = trade.Iinitialize(trade.RMTrade, "/DC:\V7\DB /M", "")

   Set Товар = trade.EvalExpr("CreateObject(""Справочник.Товары"")")

   Товар.НоваяГруппа

   Товар.Наименование = "***** Экспорт из Excel ******"

   Товар.Записать

   Товар.ИспользоватьРодителя Товар.ТекущийЭлемент

   N = 100 'Количество строк в документе

   For Count = 1 То N Товар.Новый

      Товар.Наименование = Application.Cells(Count, 2).Value

      Товар.Розн_Цена = Application.Cells(Count, 3).Value

      Товар.Мел_Опт_Цена = Application.Cells(Count, 4).Value

      Товар.Onт_Цена = Application.Cells(Count, 5).Value

      Товар.Записать

   Next Count

End Sub



Фиксирована


Признак того, что результат расчета записи защищен от исправления.

Синтаксис:

Фиксирована

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

Locked

Описание:

Атрибут типа «число», принимает два значения: 1 — для фиксированных записей журнала расчетов и 0 — для остальных записей.

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

После фиксации записи результат ее расчета не может быть изменен ника­ким, в том числе, программным способом.

Атрибут Фиксирована предназначен только для чтения.

Пример:

Если ЖрнЗарплата.Фиксирована = 1 Тогда

   Если ДатаДок > ЖрнЗарплата.НачалоТекущегоПериода() Тогда

      ОсвободитьЗапись();

   Иначе

      // отказ от расчета;

      // ....

   КонецЕсли;

КоненцЕсли;

См. также: ФиксироватьЗапись, ОсвободитьЗапись



Фиксировать


Фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.

Синтаксис:

Фиксировать(<КолСтрок>, <КолКолонок>)

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

Fix

Параметры:

<КолСтрок>

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

<КолКолонок>

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

Описание:

Метод Фиксировать позволяет фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.

Пример:

ТаблДиалога.Фиксировать(1, 1);



ФиксироватьЗапись


Фиксирует текущую запись журнала расчетов, предотвращая редак­тирование результата ее расчета.

Синтаксис:

ФиксироватьЗапись()

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

LockRecord

Возвращаемое значение:

Число: 1 — если операция успешно выполнена; 0 — в противном случае.

Описание:

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

Пример:

ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");

ЖЗ.ВыбратьЗаписиПоОбъекту(Сотрудник, ДН, ДО);

Пока ЖЗ.ПолучитьЗапись() = 1 Цикл

   Если (ЖЗ.Документ = ТекущийДокумент()) И

        (ЖЗ.ВидРасч = ВидРасчета.ПоТарифу) Тогда

      ЖЗ.ФиксироватьЗапись();

   КонецЕсли;

КонецЦикла;

См. также: атрибут Фиксирована, метод ОсвободитьЗапись



ФиксШаблон


Установить флаг добавления строк по фиксированному шаблону.

Синтаксис:

ФиксШаблон(<Флаг>)

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

FixTemplate

Параметры:

<Флаг>

Числовое выражение: 1 — установить флаг добавле­ния строк по фиксированному шаблону, 0 — снять флаг.

Возвращаемое значение:

Текущее числовое значение флага добавления строк по фиксированному шаблону (на момент до исполнения метода).

Описание:

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

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

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");

ТекстДок.ФиксШаблон(1);

ТекстДок.ЗаменитьСтроку(52, "[Услуга.Наименование],

                             арт.[Услуга.Код]......[Услуга.Цена]");

ТекстДок.Шаблон(0);

ТекстДок.ВставитьСтроку(53, "Вывоз мусора, 6321, 58.000");

ТекстДок.ТолькоПросмотр(1);

См. также: «Системные процедуры и функции», функция ФиксШаблон



ФиксШаблон


Сформировать строку по фиксированному шаблону.

Синтаксис:

ФиксШаблон(<Строка_шаблон>)

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

FixTemplate

Параметры:

<Строка_шаблон>

Строковое выражение, содержащее шаблон формирования результирующей строки.

Возвращаемое значение:

Строковое значение.

Описание:

Функция ФиксШаблон возвращает строковое значение, сформированное в соответствии с заданным параметром <Строка_шаблон>, заменив в ней все встроенные выражения, заключенные в квадратные скобки, на их значения. В отличие от функции Шаблон, поля замещаются значениями выражений с со­хранением своей длины в символах, то есть обрезаются, если поле короче ре­зультата вычисления выражения и дополняются пробелами если длиннее. Если результат числовой, то в границах поля строка прижимается к правой границе.

Строковое значение параметра <Строка_шаблон> обрабатывается сле­дующим образом: символы "[" , "]" (квадратные скобки) являются специаль­ными символами, которые выделяют поля, содержащие встроенные выражения. Выделенные поля фиксируют свою длину с учетом ограничивающих скобок. Например:

Имя Клиента [Имя], телефон: [Телефон]

После встроенного выражения может стоять символ "#", после которого следует Форматная_строка описанная в функции Формат. В этом случае в данное поле будет проставлен результат выражения, обработанный функцией Формат.

Пример:

// ниже - пример с дополнением пробелами

Стр = Шаблон("Это название услуги [Услуга.Наименование       ]");

//   выдает: "Это название услуги Вывоз мусора                "

// далее - с сокращением строки

Стр = Шаблон("Это название услуги [Услуга.Наименование]");

//   выдает: "Это название услуги Выполенние формирован"



Форма


Объект агрегатного типа «Форма».

Синтаксис:

Форма

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

Form

Описание:

Атрибут Форма представляет собой ссылку на объект типа «Форма». Атри­буты и методы объекта «Форма» позволяют в программном модуле изменять свойства визуального отображения диалога в целом (такие как Заголовок, Закладки и т. п.), а также свойства визуального отображения отдельных эле­ментов диалога.

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

Доступ к данному атрибуту возможен только в контексте Модуля формы.

Пример:

Форма.ТолькоПросмотр(0);

Форма.Prompt.Видимость(0);



Формат


Устанавливает формат для вывода всех выражений в ячейках облас­ти таблицы.

Синтаксис:

Формат(<СтрокаФормата>)

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

Format

Параметры:

<СтрокаФормата>

 Необязательный параметр. Строковое выражение, содержащее форматную строку (см. Формат).

Возвращаемое значение:

Строковое значение, содержащее текущую форматную строку по умолчанию для области таблицы (на момент до исполнения метода).

Описание:

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

Пример:

ВыбОбласть.Формат("415.2");




Если в форматной строке указано "(0)" перед всеми прочими специфика­циями, то все позиции в поле вывода числа, соответствующие незадействован­ным старшим разрядам будут заполнены символами "0". Например:

Формат(123.15, "Ч(0)10.2") = 0000123.15

Если в форматной строке проставить символ "-" перед длиной поля, то ну­левые значения при выводе будут отображаться прочерком. Пример: "4-17.2 ".

В форматной строке для числа можно использовать сдвиг разрядов при вы­воде. Это позволяет, например, отображать числовое значение в тысячах и т. п. В этом случае форматная строка должна заканчиваться символами ">Х" , где Х — количество сдвигаемых разрядов. Например, форматная строка: "Ч010>3" — означает вывод числа в тысячах (сдвиг на три разряда).

Строковое представление числа всегда является правоустановленным.

Кроме того, возможен вывод денежных величин и просто целых чисел про­писью. В этом случае форматная строка должна иметь вид "ЧПДС". Наличие буквы "П" (в английском варианте для аналогичной цели используется буква "S") определяет сам факт вывода числа прописью. Символ "Д" (в английском варианте — "M") обозначает вывод денежной величины и является необяза­тельным. Символ "С" (в английском варианте — "H") также необязателен и означает вывод с копейками.

Для форматирования строк используется следующая форматная строка:

"Сn", где n — положительное целое число определяющее ширину поля, в кото­ром будет размещаться строка. В случае, если ширина поля превосходит длину строки сформатированная строка будет дополнена справа пробелами, если же ширина поля меньше длины строки — строка будет усечена справа.

Для форматирования даты используется форматная строка вида "Д<ПодстрокаФормата>", где <Подстрока Формата> представляет собой строку, определяющую вид сформатированного представления даты:

DDMMYY (ДДММГГ)

 дата в виде ДД.ММ.ГГ
DDMMYYYY

(ДДММГГГГ)

 дата в виде ДД.ММ.ГГГГ
DDMMMMYYYY

(ДДММММГГГГ)

 дата в виде ДД месяц прописью ГГГГ
(0)DDMMMMYYYY

((0)ДДММММГГГГ)

 этот формат представляет собой вариант предыдущего формата с тем отличием, что число месяца всегда выводится двумя цифрами, т. е. для чисел меньших 10 спереди будет добавлен 0. Например: Формат('01.01.1999', ' 'Д(0)ДДММММГГГГ' ') = 01 Января 1999 г.
MMMMYYYY

(ММММГГГГ)

 дата в виде месяц прописью ГГГГ
MMMMYY (ММММГГ)

 дата в виде месяц прописью ГГ
ММММ (ММММ)

 дата в виде месяц прописью
QQQQYYYY

(ККККГГГГ)

 дата в виде N квартала ГГГГ
QQQQYY (ККККГГ)

 дата в виде N квартала ГГ
QQQQ

 дата в виде N квартала
YYYYMMDD

(ГГГГММДД)

 дата в виде ГГГГММДД, то есть дата '10.11.1998' будет представлена как стро­ка "19981110"
WWWW (HHHH)

 выводит наименование дня недели, соответст­вующее указанной дате. Наименования дней недели берутся из файла прописи.
Пример:

ДолгКлиента = Строка(Формат(-Долг(), "Ч12.2")) + " " + Валюта.Сокр_назв;


Формат


Форматировать переданный параметр.

Синтаксис:

Формат(<Параметр>, <Форматная_строка>)

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

Format

Параметры:

<Параметр>

Выражение.

<Форматная_строка>

Строковое выражение.

Возвращаемое значение:

Строковое значение.

Описание:

Функция Формат форматирует переданный параметр, руководствуясь ин­формацией, содержащейся в параметре <Форматная_строка>. Возвращает сформатированную строку.

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

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

Символы, определяющие тип форматируемых данных:

Ч — число (Англоязычный синоним: N)

С — строка (Англоязычный синоним: S)

Д — дата (Англоязычный синоним: D)

Между символом, определяющим тип форматируемого значения и дополни­тельными уточняющими параметрами может находиться любое число пробелов.

Для числовых значений форматная строка должна иметь вид: "Чm.nDT" или "Чm", где т и п— целые числа. Целое положительное число m определяет длину поля в котором будет размещаться строковое представление числа, а целое по­ложительное число n определяет число знаков после десятичной точки. D — представляет собой любой символ (кроме пробела и цифры), которым в сфор-матированной строке целая часть будет отделяться от дробной, а T — символ (также кроме пробела и цифры), которым будут разделяться триады целой час­ти числа. Символы "D" и "Т" являются необязательными.

Если в форматной строке проставить символ "0" (ноль) перед длиной поля, то нулевые значения при выводе будут подавлятся (выводится пустая строка). Пример: "Ч015.2".



Формат операторов


Операторы имеют вид стандартного обращения к процедуре, за исключени­ем оператора присваивания (А=В;) и управляющих конструкций (таких как Для, Пока, Если). Между собой операторы обязательно следует разделять сим­волом ";" ( точкой с запятой). Конец строки не является признаком конца опе­ратора, т. е. операторы могут свободно переходить через строки и продолжаться на другой строке. Можно располагать произвольное число операторов на од­ной строке, разделяя их символом ";".

Операторы языка в программном модуле можно подразделить на две кате­гории: операторы объявления переменных и исполняемые операторы.

Операторы объявления переменных создают имена переменных, которыми манипулируют исполняемые операторы.

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

В общем случае формат оператора языка следующий:

~метка:Оператор[(параметры)] [ДобКлючевоеСлово];

В качестве меток используются специальные идентификаторы, начинаю­щиеся с символа '~' (тильда) и состоящие из последовательности букв, цифр и символов '_'. Чтобы пометить оператор, надо поместить перед ним метку и сле­дующий за ней символ ":".

Пример:

~метка:А=В;



Формат описания элементов языка


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



Формат программного модуля


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



Формат текста описания запроса


Текст описания запроса на языке запросов состоит из последовательности операторов. Концом оператора является символ ";". Операторы могут записы­ваться в любом порядке, однако, следует помнить, что интерпретатор языка запросов однопроходный, следовательно, сначала следует описать переменную, и только потом ее использовать в операторах Группировка, Функция или Условие.

Пример:

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

"//({ЗАПРОС(РасчЛистки)

|  // Задаем интервал запроса

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

|  // Определяем внутренние переменные

|Рез = ЖурналРасчетов.Зарплата.Результат;

|Расч = ЖурналРасчетов.Зарплата.ВидРасч;

|Дни = ЖурналРасчетов.Зарплата.Дни;

|Сотр = ЖурналРасчетов.Зарплата.Объект;

|  // Назначаем группировки

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

|Группировка Расч;

|  // Назначаем функции

|Функция Сум = Сумма(Рез);

|Функция Дней = Сумма(Дни);

|  // Назначаем условие

|Условие(Рез <> 0);

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

;

// ...