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

         

ПолучитьПредставление


Получить установки представления журнала расчетов — режим пред­ставления и отображаемый объект.

Синтаксис:

ПолучитьПредставление(<Режим>, <Объект>}

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

GetPresentation

Параметры:

<Режим>

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

<Объект>

Переменная, в которую записывается объект, за­писи которого отображаются. Если текущий ре­жим — «по одному документу» (см. ниже), этот параметр примет значение типа «документ», если режим устанавливаемого представления — «по одному объекту», этот параметр примет значение типа «элемент справочника».

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

Число: 1, если представление успешно установлено; 0 — если представление по каким-либо причинам не установлено.

Описание:

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

1. Записи по всем объектам расчета.

2.        Записи по одному объекту расчета.

3.        Записи по одному документу-основанию.

Параметр <Объект> получит значение того или иного типа, в зависимости от устанавливаемого режима. Если текущий режим — «по одному документу», этот параметр примет значение типа «документ», если режим устанавливаемого представления — «по одному объекту», этот параметр примет значение типа «элемент справочника».

Если текущий режим представления — просмотр записей по всем объектам расчета, параметр <Объект> не заполняется и его значение остается прежним.

Данный метод доступен только в контексте Модуля формы журнала расче­тов (см. «Виды программных модулей»).

Пример:

Перем СтРежим;

Перем СтОбъект;

Перем СменилиРежим;

Процедура ПоОдному(Сотрудник)

   // запомним предыдущие установки

   ПолучитьПредставление(СтРежим, СтОбъект);

   // Сменим режим

   СменилиРежим = УстановитьПредставление(2.Сотрудник);

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

Процедура Восстановить()

   Если СменилиРежим = 1 Тогда

      УстановитьПредставление(СтРежим, СтОбъект);

   КонецЕсли;

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

См. также: УстановитьПредставление, ГраницаПросмотра



ПолучитьПроводку


Получить проводку из выборки, открытой методом

ВыбратьПроводки.

Синтаксис:

ПолучитьПроводку()

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

GetEntry

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

Число: 1 — следующая проводка выбрана успешно; 0 — следующая проводка не выбрана (отсутствует).

Описание:

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

Метод ПолучитьПроводку используется для организации цикла по про­водкам текущей операции. Условием цикла может служить равенство 1 воз­вращаемого значения метода: цикл выполняется, пока метод ПолучитьПроводку возвращает 1.

Метод возвращает 0, когда очередная проводка не выбрана. Это происходит, если при предыдущем применении метода была выбрана последняя проводка выборки.

Пример:

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

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

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

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

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

КонецЦикла;



ПолучитьПроводкуПоНомеру


Выбрать в качестве текущей проводку по ее номеру и номеру коррес­понденции.

Синтаксис 1:

ПолучитьПроводкуПоНомеру(<АбсолютныиНомерПроводки>)

Синтаксис 2:

ПолучитьПроводкуПоНомеру(<НомерПроводки>, <НомерКорреспонденции>)

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

GetEntryByNumber

Параметры:

<АбсолютныйНомерПроводки>

Необязатальный параметр. Число — абсо­лютный номер проводки в операции (вклю­чая проводки и корреспонденции). Если не задан –1.

<НомерПроводки>

Необязатальный параметр. Число — номер проводки в операции.

<НомерКорреспонденции>

Необязатальный параметр. Число — номер корреспонденции в проводке. Параметр име­ет смысл, если указан параметр <НомерПроводки>.

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

Число: 0 — проводка не найдена; 1 — проводка найдена.

Описание:

Метод ПолучитьПроводкуПоНомеру выбирает в качестве текущей про­водку или корреспонденцию проводки.

Если передан один параметр, то он воспринимается, как абсолютный номер проводки (корреспонденции) в операции среди всех проводок и корреспонден­ции. Если передано два параметра, то первый из них — это номер проводки, а второй — номер корреспонденции в проводке.

Пример:

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

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

Опер.ПолучитьПроводкуПоНомеру(3, 2);

Для Инд = 1 До Опер.КоличествоПроводок() Цикл

   Опер.ПолучитьПроводкуПоНомеру(Инд);

КонецЦикла;



ПолучитьПустоеЗначение


Получить пустое значение заданного типа данных.

Синтаксис:

ПолучитьПустоеЗначение(<Тип>)

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

GetEmptyValue

Параметры:

<Тип>

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

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

Функция ПолучитьПустоеЗначение возвращает пустое значение заданно­го типа данных.

Описание:

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

Пример:

Если ВыбФирма = ПолучитьПустоеЗначение("Справочник.Фирмы") = 1 Тогда

   Предупреждение("Задайте непустое значение Фирмы");

КонецЕсли;



ПолучитьРасчет


Получает ссылку на вид расчета.

Синтаксис:

ПолучитьРасчет(<Номер>)

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

GetCalculation

Параметры:

<Номер>

Номер вида расчета в списке видов расчета данной группы.

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

Агрегатный объект типа «Вид Расчета».

Описание:

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

Пример:

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

См. также: Количество




ПолучитьСчет


Получить из выборки следующий счет. Выборка должна быть пред­варительно открыта при помощи метода ВыбратьСчета.

Синтаксис:

ПолучитьСчет([<Режим>])

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

GetAccount

Параметры:

<Режим>

Необязательный параметр. Числовое выраже­ние — признак выборки подчиненных счетов. Может принимать значения: 0 — не включать подчиненные счета; 1 — включать подчиненные счета. По умолчанию — 1.

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

Число: 1 — следующий счет выбран успешно; 0 — следующий счет не вы­бран (отсутствует).

Описание:

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

Метод ПолучитьСчет используется для организации цикла по счетам. Ус­ловием цикла может служить равенство 1 возвращаемого значения метода: цикл выполняется, пока метод ПолучитьСчет возвращает 1.

Метод возвращает 0, когда очередной счет не выбран. Это происходит, если при предыдущем применении метода был выбран последний счет выборки.

Пример:

Процедура Сформировать()

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

   Сч.ВыбратьСчета();

   Пока Сч.ПолучитьСчет() = 1 Цикл

      Сообщить(Сч.Код);

   КонецЦикла;

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



ПолучитьСчет


Получить из выборки следующий счет. Выборка должна быть пред­варительно открыта при помощи метода ВыбратьСчета.

Синтаксис:

ПолучитьСчет(<Номер>, <Счет>)

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

GetAccount

Параметры:

<Номер>

Необязательный параметр. Положительное целое число — номер выборки.

<Счет>

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

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

Число: 1 — следующий счет выбран успешно; 0 — следующий счет не вы­бран (отсутствует).

Описание:

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

Метод ПолучитьСчет позволяет также обращаться к результатам выборки по номеру выборки, если предварительно было открыто несколько выборок. Номер выборки передается методу в качестве параметра <Номер>.

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

Метод ПолучитьСчет позволяет также обращаться к конкретному значе­нию результа выборки. Значение счета выборки передается методу в качестве параметра <Счет>.

Если параметр <Счет> не задан, то метод ПолучитьСчет может использо­ваться для организации цикла по счетам. Условием цикла может служить ра­венство 1 возвращаемого значения метода: цикл выполняется, пока метод ПолучитьСчет возвращает 1.

Метод возвращает 0, когда очередной счет не выбран. Это происходит, если при предыдущем применении метода был выбран последний счет выборки.

Пример:

БухИтоги.Запрос(Дата1, Дата2);

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

   Деб = БухИтоги.ДО();

   Кред = БухИтоги.КО();

КонецЦикла;



ПолучитьСекцию


Получить значение секции исходной таблицы.

Синтаксис:

ПолучитьСекцию(<ИмяСекции>)

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

GetSection

Параметры:

<ИмяСекции>

Выражение типа строка, задающее имя секции.

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

Объект типа секция.

Описание:

Метод ПолучитьСекцию возвращает именованную секцию исходной таб­лицы-шаблона. При получении секции, ячейки секции, имеющие тип «Шаб­лон» и «Выражение» будут заполнены соответствующими данными. Имя секции задается строковым выражением следующего формата:

ИдентификаторСекции1[<|>|-][|ИдентификаторСекции2[<|>|-]]

Символы "<" , ">" , "-" после идентификатора секции указывают на то, что выбирается только часть секции:

<

заголовочная часть (с начала секции до начала вложенной сек­ции).

>

подвальная часть (с конца вложенной секции до конца секции).

средняя часть (собственно вложенная секция).

В выражении <ИмяСекции> можно задавать имена двух секций, разделенных знаком "|". При этом будет получена область исходной таблицы, являющаяся пересечением первой и второй указанных секций. При этом одна секция может быть горизонтальной (состоять из строк), а другая — вертикальной (состоять из колонок). В результате получится прямоугольная область таблицы.

Пример:

//Выводим секцию таблицы

Секция = Таб.ПолучитьСекцию("Документ<|ДокументВерт<");

Таб.ВывестиСекцию(Секция);



ПолучитьСтроку


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

Синтаксис:

ПолучитьСтроку()

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

GetLine

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

Число: 1 — если следующая строка табличной части документа выбрана ус­пешно; 0 — если следующая строка документа не найдена (отсутствует).

Описание:

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

Пример:

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

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

   // открываем выборку строк спецификации документа

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

   // цикл выбора строк спецификации документа

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

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

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

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

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

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

   КонецЦикла;

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



ПолучитьСтроку


Получить из выборки следующую строку таблицы значений.

Синтаксис:

ПолучитьСтроку()

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

GetLine

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

Число: 1 — если строка выбрана успешно, 0 — если строка не выбрана (вы­борка закончилась).

Описание:

Метод ПолучитьСтроку выбирает следующую строку таблицы значений в последовательности выборки, открытой перед этим при помощи метода ВыбратьСтроки.

Пример:

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

Пока Табл.ПолучитьСтроку() = 1 Цикл

   ...

КонецЦикла;



ПолучитьСтроку


Полнить строку текста по номеру.

Синтаксис:

ПолучитьСтроку(<НомерСтроки>)

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

GetLine

Параметры:

<НомерСтроки>

Числовое выражение — номер строки.

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

Строковое значение — требуемая строка текста.

Описание:

Метод ПолучитьСтроку возвращает значение строки с номером <НомерСтроки>.

Пример:

Процедура Тест()

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

   Текст.Открыть(ИмяФайла);

   Если Текст.КоличествоСтрок() = 0 Тогда

      Предупреждение("Текст пустой!");

      Возврат;

   КонецЕсли;

   Для Ном = 1 по Текст.КоличествоСтрок() Цикл

      Стр = Текст.ПолучитьСтроку(Ном);

      Сообщить(Строка(Ном) + Стр);

   КонецЦикла;

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



ПолучитьСтрокуПоНомеру


Получить строку таблицы значений по номеру.

Синтаксис:

ПолучитьСтрокуПоНомеру(<НомерСтроки>)

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

GetLineByNumber

Параметры:

<НомерСтроки>

Номер строки, на которую следует переместиться.

Описание:

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

Пример:

Табл.ПолучитьСтрокуПоНомеру(3);



ПолучитьСубконто


Получить из выборки следующее субконто. Выборка должна быть предварительно открыта при помощи метода ВыбратьСубконто.

Синтаксис:

ПолучитьСубконто(<Индекс>, <Номер>, <Субконто>)

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

GetSubconto

Параметры:

<Индекс>

Необязательный параметр. Число —порядковый номер вызова метода ИспользоватьСубконто.

<Номер>

Необязательный параметр. Положительное целое число — номер выборки.

<Субконто>

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

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

Число: 1 — следующее субконто выбрано успешно; 0 — следующе субконто не выбрано (отсутствует).

Описание:

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

Метод ПолучитьСубконто позволяет также обращаться к результатам вы­борки по номеру выборки. Номер выборки передается методу в качестве пара­метра <Номер>.

Метод ПолучитьСубконто позволяет также обращаться к конкретному значению результа выборки. Значение субконто выборки передается методу в качестве параметра <Субконто>.

Если параметр <Субконто> не задан, то метод ПолучитьСубконто ис­пользуется для организации цикла по субконто. Условием цикла может слу­жить равенство 1 возвращаемого значения метода: цикл выполняется, пока ме­тод ПолучитьСубконто возвращает 1.

Метод возвращает 0, когда очередное субконто не выбрано. Это происходит, если при предыдущем применении метода было выбрано последнее субконто выборки.

Пример:

БухИтоги.ИспользоватьСубконто(ВидыСубконто.Материалы, , 1);

БухИтоги.ИспользоватьСубконто(ВидыСубконто.Склады, , 1);

БухИтоги.ВыполнитьЗапрос(ДатаНач, ДатаКон, "10");

БухИтоги.ВыбратьСубконто(1);

Пока БухИтоги.ПолучитьСубконто(1) = 1 цикл

   БухИтоги.ВыбратьСубконто(2);

   Пока БухИтоги.ПолучитьСубконто(2) = 1 цикл

      Деб = БухИтоги.ДО();

      Кред = БухИтоги.КО();

   КонецЦикла;

КонецЦикла;



ПолучитьТА


Получить дату и время Точки Актуальности

итогов в текстовом виде. Данная функция используется только при наличии компоненты. «Опе­ративный учет».

Синтаксис:

ПолучитьТА()

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

GetAP

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

Строковое значение, содержащее дату и время ТА.

Описание:

Функция ПолучитьТА возвращает дату и время Точки Актуальности ито­гов в текстовом виде.

Пример:

Дата_И_Время_ТА = ПолучитьТА();



ПолучитьВалюту


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

Синтаксис:

ПолучитьВалюту(<Номер>, <Валюта>}

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

GetCurrency

Параметры:

<Номер>

Необязательный параметр. Положительное целое число — номер выборки.

<Валюта>

Необязательный параметр. Конкретное значение валюты, которое нужно получить из выборки.

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

Число: 1 — следующая валюта выбрана успешно; 0 — следующий валюта не выбрана (отсутствует).

Описание:

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

Метод ПолучитьВалюту позволяет также обращаться к результатам кон­кретной выборки по ее номеру. Номер выборки передается методу в качестве параметра <Номер>.

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

Если параметр <Валюта> не задан, то метод ПолучитьВалюту использует­ся для организации цикла по валютам. Условием цикла может служить равен­ство 1 возвращаемого значения метода: цикл выполняется, пока метод ПолучитьВалюту возвращает 1.

Метод возвращает 0, когда очередная валюта не выбрана. Это происходит, если при предыдущем применении метода была выбрана последняя валюта выборки.

Пример:

БухИтоги.Запрос(Дата1, Дата2);

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

   БухИтоги.ВыбратьВалюты();

   Пока БухИтоги.ПолучитьВалюту() = 1 цикл

      ДебВ = БухИтоги.ДО(2);

      КредВ = БухИтоги.КО(2);

   КонецЦикла;

КонецЦикла;



ПолучитьВедущий


Возвращает вид расчета из списка «ведущих» расчетов.

Синтаксис:

ПолучитьВедущий(<НомерВР>)

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

GetLeading

Параметры:

<НомерВР>

Числовое выражение — номер вида расчета в списке «ведущих» расчетов.

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

Вид расчета с номером <НомерВР> из списка «ведущих» расчетов.

Описание:

Метод ПолучитьВедущий возвращает вид расчета с номером <НомерВР> из списка «ведущих» расчетов.

Пример:

ВидВедРасч = ПравилоПерерасчета.Доплаты.ПолучитьВедущий(Инд);



ПолучитьВремя


Прочитать время документа.

Синтаксис:

ПолучитьВремя(<Часы>, <Минуты>, <Секунды>)

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

GetTime

Параметры:

<Часы>

Идентификатор переменной, в которую метод воз­вращает строковое значение минут записи документа.

<Секунды>

Идентификатор переменной, в которую метод воз­вращает строковое значение секунд записи докумен­та.

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

Строковое значение времени записи документа в виде "ЧЧ.ММ.СС".

Описание:

Метод ПолучитьВремя возвращает время документа в переданные для это­го переменные <Часы>, <Минуты>, <Секунды>.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Функция ВремяДокумента(Док)

   Перем Ч;

   Перем М;

   Перем С;

   Если Док.Выбран() > 0 Тогда

      Док.ПолучитьВремя(Ч, М, С);

      Возврат "Документ записан в " + Ч + " час " + М + " мин. " + С + " с";

   Иначе

      Возврат "Документ не выбран!";

   КонецЕсли;

Конецфункции



ПолучитьВремя


Возвращает время текущей операции.

Синтаксис:

ПолучитьВремя(<Часы>, <Минуты>, <Секунды>)

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

GetTime

Параметры:

<Часы>

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

<Минуты>

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

<Секунды>

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

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

Строковое значение времени в виде "ЧЧ.ММ.СС".

Описание:

Метод ПолучитьВремя возвращает время операции. Время записывается в переменные, передаваемые как параметры при вызове метода.

Пример:

Перем Час;

Перем Минута;

Перем Секунда;

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

Опер.ВыбратьОперации(ДатаНач, ДатаКон);

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

   Опер.ПолучитьВремя(Час, Минута, Секунда);

КонецЦикла;



ПолучитьВремя


Получить время Границы Последовательности.

Синтаксис:

ПолучитьВремя(<Часы>, <Минуты>, <Секунды>)

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

GetTime

Параметры:

<Часы>

Идентификатор переменной, в которую метод возвращает строковое значение часа ГП.

<Минуты>

Идентификатор переменной, в которую метод возвращает строковое значение минут ГП.

<Ceкyнды>

Идентификатор переменной, в которую метод возвращает строковое значение секунд ГП.

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

Строковое значение времени Границы Последовательности в виде "ЧЧ.ММ.СС".

Описание:

Метод ПолучитьВремя возвращает время Границы Последовательности.

Пример:

Функция ВремяГП()

   Перем Ч;

   Перем М;

   Перем С;

   ВремяГП = Последовательность.УправленческийУчет.ПолучитьВремя();

   Возврат "Время ГП в " + Ч + " час " + М + " мин. " + С + " с";

КонецФункции



ПолучитьВремяТА


Получить значение времени Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

ПолучитьВремяТА(<Часы>, <Минуты>, <Секунды>)

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

GetTimeOfAP

Параметры:

<Часы>

Идентификатор переменной, в которую ме­тод возвращает строковое значение часа ТА.

<Минуты>

Идентификатор переменной, в которую ме­тод возвращает строковое значение минут ТА.

<Секунды>

Идентификатор переменной, в которую ме­тод возвращает строковое значение секунд ТА.

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

Строковое значение времени ТА в виде " ЧЧ. MM. СС".

Описание:

Функция ПолучитьВремяТА записывает значение времени Точки Актуаль­ности итогов в передаваемые при вызове параметры.

Пример:

ПолучитьВремяТА(Час, Минута, Секунда);



ПолучитьЗапись


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

Синтаксис:

ПолучитьЗапись()

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

GetRecord

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

Числовое значение — 1, если очередная запись журнала расчетов найдена, и 0, если очередная запись журнала не найдена или отсутствует (выборка пуста).

Описание:

Метод предназначен для позиционирования очередной записи журнала рас­четов в выборке, установленной одним из следующих методов:

ВыбратьЗаписи

ВыбратьЗаписиПоОбъекту

ВыбратьПериод

ВыбратьПериодПоОбъекту

ВыбратьЗаписиПоДокументу

Как правило, применяется в цикле после использования одного из вышепе­речисленных методов.

Пример:

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

//по текущему основному средству и просуммируем результат

ЖР = СоздатьОбъект("ЖурналРасчетов.Амортизация");

ЖР.ВыбратьПериодПоОбъекту(Объект, ЖР.НачалоТекущегоПериода());

// Инициализируем переменную

Сумма = 0;

Пока ЖР.ПолучитьЗапись() > 0 Цикл

   Сумма = Сумма + ЖР.Результат;

КонецЦикла;



ПолучитьЗначение


Получить из выборки следующее периодическое значение.

Синтаксис:

ПолучитьЗначение()

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

GetValue

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

Число: 1 — если элемент выбран успешно, 0 — если элемент не выбран (от­сутствует).

Описание:

Метод ПолучитьЗначение выбирает периодическое значение в последова­тельности выборки, открытой перед этим при помощи метода ВыбратьЗначения или ВыбратьПоДокументу. Само полученное значение следует считывать из атрибута Значение. Дату этого значения можно считать из атрибута ДатаЗнач. Если значение периодического реквизита установлено документом, то этот документ можно получить при помощи метода ТекущийДокумент. Метод ТекущийОбъект позволит определить значение текущего элемента справочника, а метод ТекущийРеквизит — определить наименование текущего реквизита справочника.

Пример:

Процедура КурсыВалюты(КодВалюты)

   Вал = СоздатьОбъект("Справочник.Валюты");

   // Позиционируем созданный объект Вал по известному коду

   Вал.НайтиПоКоду(КодВалюты);

   Если Вал.Выбран() = 1 Тогда

      Доллар = Вал.ТекущийЭлемент();

   Иначе

      Предупреждение("Не найдена валюта!");

      Возврат;

   КонецЕсли;

   ПерВал = СоздатьОбъект("Периодический");

   ПерВал.ИспользоватьОбъект("Текущ_курс", Доллар);

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

   ПерВал.ВыбратьЗначения();

   Пока ПерВал.ПолучитьЗначение() = 1 Цикл

      Сообщить("Курс на " + Строка(ПерВал.ДатаЗнач) + " = " + ПерВал.Значение);

   КонецЦикла;

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

См. также: ВыбратьЗначения, ВыбратьПоДокументу, ТекущийОбъект, ТекущийРеквизит, ТекущийДокумент



ПолучитьЗначение


Получить значение элемента по номеру в списке.

Синтаксис:

ПолучитьЗначение(<Позиция>, <Перем>)

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

GetValue

Параметры:

<Позиция>

Числовое выражение — номер элемента в списке, значение которого будет возвращено. Номер позиции может быть от 1 до количества элементов в списке.

<Перем>

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

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

Полученное значение из списка.

Описание:

С помощью метода ПолучитьЗначение можно получить значение элемен­та, находящегося в указанной позиции списка.

Пример:

ОпредПредст = "";

ОпредВид=Спис.ПолучитьЗначение(1, ОпредПредст);



ПолучитьЗначение


Получить значение конкретной колонки в данной строке таблицы значений.

Синтаксис:

ПолучитьЗначение(<Строка>, <Колонка>)

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

GetValue

Параметры:

<Строка>

Номер строки.

<Колонка>

Номер или идентификатор колонки.

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

Значение конкретной колонки в данной строке.

Описание:

Метод ПолучитьЗначение получает значение конкретной колонки в дан­ной строке таблицы значений.

Пример:

ВыбЗнач = Табл.ПолучитьЗначение(3, 5);



ПолучитьЗначениеИзПодбора


Вычислить выражение в контексте открытой формы подбора.

Синтаксис:

ПолучитьЗначениеИзПодбора(<Выражение>)

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

GetValueFromPermanentChoice

Параметры:

<Выражение>

Строковое выражение, которое должно содержать запись выражения на встроенном языке. Значение этого выра­жения вычисляется в контексте открытой формы подбо­ра.

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

Значение вычисленного в контексте формы подбора выражения.

Описание:

Метод ПолучитьЗначениеИзПодбора, который доступен только в контек­сте Модуля формы, позволяет получить результат выражения, выполненного в контексте формы подбора (т. е. получить любые данные из той формы, напри­мер выбранный элемент списка справочника подбора значения).

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

Пример:

Процедура ОбработкаПодбора(Выб, Конформы)

   Кол = 0;

   Если ВвестиЧисло(Кол, "Введите количество", 10, 0) = 1 Тогда

      НоваяСтрока();

      ТипPaб = Выб;

      Количество = Кол;

      АктивизироватьСтроку();

      Активизировать("Стоимость", 0);

   КонецЕсли;

   // тип выполненной работы

   ТР = ПолучитьЗначениеИзПодбора("Наименование");

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

См. также: ОткрытьПодбор, ОбработкаПодбора



ПолучитьЗначениеПоля


Получить значение поля записи.

Синтаксис:

ПолучитьЗначениеПоля(<НазваниеПоля>)

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

GetFieldValue

Параметры:

<НазваниеПоля>

Строковое выражение с названием поля или число­вое выражение с номером поля.

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

Значение поля записи, тип зависит от типа поля.

Описание:

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

Пример:

Процедура ПерНаЗап(НЗап)

   ДБФ.Перейти(НЗап);

   Стр3ап = "" + ДБФ.НомерЗаписи() + "; " + ДБФ.ЗаписьУдалена() + "; ";

   Для КП = 1 По ДБФ.КоличествоПолей() Цикл

      СтрЗап = СтрЗап + Строка(ДБФ.ПолучитьЗначениеПоля(КП)) + "; ";

   КонецЦикла;

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



ПолучитьЗначенияОтбора


Выбирать все существующие значения отбора.

Синтаксис:

ПолучитьЗначенияОтбора(<ИмяОтбора>, <СписокЗначений> , [<ДатаНач>], [<ДатаКон>])

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

GetSelect ionValues

Параметры:

<ИмяОтбора>

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

<СписокЗначений>

Идентификатор переменной. Если при вызове метода данная переменная содержит объект ти­па «СписокЗначений», то система заполнит его всеми возможными существующими значения­ми отбора. Если при вызове метода данная пе­ременная содержит любое другое значение кро­ме объекта типа «СписокЗначений», то система сама создаст объект типа «СписокЗначений», заполнит его существующими значениями отбо­ра и присвоит переменной ссылку на этот объ­ект.

<ДатаНач>

Необязательный параметр. Дата начала интер­вала в котором проводить отбор. Если параметр не задан, то отбор будет производиться по всем данным.

<ДатаКон>

Необязательный параметр. Дата конца интерва­ла в котором проводить отбор. Если параметр не задан или равен 0, то отбор будет производиться до ТА.

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

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

Описание:

Функция ПолучитьЗначенияОтбора выбирает все возможные сущест­вующие значения отбора <ИмяОтбора>, заполняет выбранными значениями объект типа «СписокЗначений», и передает ссылку на этот объект в перемен­ной <СписокЗначений>.

Замечание. Функция ПолучитьЗначенияОтбора может работать и с вы­бранными в конфигурации отборами операций и проводок ("СуммаОперации", "Содержание", "Сумма", "Валюта", "Количество", "ВалСумма", "Счет", "СчетДт", "СчетКт", "ПланСчетов", реквизитам операции, реквизитам проводки, видам субконто) для которых установлен режим отбора.

Пример:

// Выбрать существующие значения Авторов документов

ПолучитьЗначенияОтбора("Автор", Спис, , );

См. также: «Работа со Списком Значений»



Полужирный


Получить/установить признак жирного шрифта области.

Синтаксис:

Полужирный(<Жирный>)

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

Bold

Параметры:

<Жирный>

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

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

Признак жирного шрифта до исполнения метода.

Описание:

Метод Полужирный устанавливает признак жирного шрифта области.

Пример:

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

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

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

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

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

ВыбОбласть.Полужирный(1);



Пометка


Пометить значение списка.

Синтаксис:

Пометка(<Позиция>, <Отметка>}

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

Check

Параметры:

<Позиция> Номер позиции выбранного значения в списке.

<Отметка> Необязательный параметр. Число: 1 — установить отметку; 0 — снять отметку. Если данный пара­метр опущен, то отметка значения списка не из­меняется.

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

Значение метки до выполнения метода. Число: 1 — отметка установлена; 0 _- отметка не установлена.

Описание:

Метод Пометка позволяет пометить указанную позицию списка значений.

Пример:

Функция ОтметитьДокумент(Список, ВыбДок)

   Для Н = 1 по Список.РазмерСписка() Цикл

      Док = Список.ПолучитьЗначение(Н);

      Если Док = ВыбДок Тогда

         Список.Пометка(Н, 1);

      КонецЕсли;

   КонецЦикла;

КонецФункции



ПометкаУдаления


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

Синтаксис:

ПометкаУдаления()

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

DeleteMark

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

Числовое значение: 1 — если на элементе справочника стоит пометка удале­ния; 0 — если нет пометки удаления.

Описание:

Метод ПометкаУдаления позволяет прочитать значение пометки удаления текущего элемента справочника.

Пример:

Процедура УсловноеУдалениеСотрудника(Сотр)

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

   Если Сотр.Выбран() > 0 Тогда

      // позиционируем справочник на заданном элементе

      Спр.НайтиЭлемент(Сотр);

      Если Спр.Выбран() > 0 Тогда

         Если Вопрос("Удалять??? ", 1) = 1 Тогда

            Если Спр.ПометкаУдаления() = 1 Тогда

               Предупреждение("Уже помечен на удаление!");

            Иначе

               // удаляем элемент справочника

               Спр.Удалить(0);

            КонецЕсли;

         КонецЕсли;

      Иначе

         Предупреждение("Некого удалять!");

      КонецЕсли;

   КонецЕсли;

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

См. также: Удалить, СнятьПометкуУдаления



ПометкаУдаления


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

Синтаксис:

ПометкаУдаления()

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

DeleteMark

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

Число: 1 — если на документе стоит пометка удаления; 0 — если нет пометки удаления.

Описание:

Метод ПометкаУдаления позволяет прочитать значение пометки удаления документа.

Пример:

Процедура УсловноеУдаление(Докум)

   Док = СоздатьОбъект("Документ");

   Если Докум.Выбран() > 0 Тогда

      // позиционируем документ на переданном значении

      Док.НайтиДокумент(Докум);

      Если Док.Выбран() > 0 Тогда

         Если Вопрос("Удалять??? ", 1) = 1 Тогда

            Если Док.ПометкаУдаления() = 1 Тогда

               Предупреждение("Уже помечен на удаление!");

            Иначе

               // удаляем документ

               Док.Удалить(0);

            КонецЕсли;

         КонецЕсли;

      Иначе

         Предупреждение("Нечего удалять! ");

      КонецЕсли;

   КонецЕсли;

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

См. также: Удалить, СнятьПометкуУдаления



ПометкаУдаления


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

Синтаксис:

ПометкаУдаления()

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

DeleteMark

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

1 — счет помечен на удаление;

0 — счет не помечен на удаление.

Описание;

Метод используется для проверки, помечен ли на удаление текущий счет.

Пример:

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

Сч.НайтиПоКоду("76.02");

Если Сч.ПометкаУдаления() = 1 Тогда

   Сообщить("Счет помечен на удаление");

КонецЕсли;



ПометкаУдаления


Проверяет наличие пометки на удаление текущей операции.

Синтаксис:

ПометкаУдаления()

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

DeleteMark

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

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

Описание:

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

Пример:

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

Опер.ВыбратьОперации(ДатаНач, ДатаКон);

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

   Если Опер.ПометкаУдаления() = 1 Тогда

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

   КонецЕсли;

КонецЦикла;



Попытка


Обработка исключительных ситуаций.

Синтаксис:

Попытка

   // Некоторые действия;

Исключение

   // Обработка исключительной ситуации;

КонецПопытки;

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

Try

   // Некоторые действия;

Except

   // Обработка исключительной ситуации;

EndTry;

Параметры:

// Некоторые действия

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

// Обработка исключительной ситуации

Исполняемый оператор или последовательность операторов, которые обраба­тывают исключительную ситуацию.

Исключение

Операторы, следующие за ключевым словом Исключение выполняются, если при выполнении последовательно­сти операторов <// Некоторые действия> произошла ошибка времени вы­полнения.

КонецПопытки

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

Описание:

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

В качестве ошибочных (исключительных) ситуаций воспринимаются ошиб­ки времени выполнения модуля. Не предусмотрено определяемых пользовате­лем исключений.

Если при выполнении последовательности операторов <// Некоторые действия> произошла ошибка времени выполнения, то выполнение оператора, вызвавшего ошибку прерывается и управление передается на первый оператор последовательности операторов <// Обработка исключительной ситуации>. При этом управление будет передано даже в том случае, если ошибку вызвал оператор, находящийся в процедуре или функции, вызванной из <// Некото­рые действия>. Если ошибка произошла в вызванной процедуре или функции, то ее выполнение будет прервано, а локальные переменные уничтожены. Это справедливо для любой вложенности вызовов. После выполнения последова­тельности операторов <// Обработка исключительной ситуации> управление передается на следующий за ключевым словом КонецПопытки оператор. Если же последовательность <// Некоторые действия> выполнилась без ошибок, то последовательность операторов <// Обработка исключительной ситуации> будет пропущена и управление также будет продолжено с оператора, следующе­го за ключевым словом КонецПопытки.




Конструкции Попытка-Исключение-КонецПопытки могут быть вложен­ными. При этом, при возникновении исключительной ситуации управление будет передано на самый «внутренний» обработчик, начинающийся с ключево­го слова Исключение. Последовательность операторов <// Обработка ис­ключительной ситуации> может содержать оператор ВызватьИсключение (англоязычный синоним Raise). Выполнение данного оператора прекращает выполнение последовательности <// Обработка исключительной ситуации> и производится поиск более «внешнего» обработчика. Если таковой есть, то управление передается на его первый оператор. Если нет, то выполнение моду­ля прекращается с выдачей сообщения о первоначально возникшей ошибке. Оператор ВызватьИсключение может встречаться только внутри операторных скобок Исключение ... КонецПопытки.

В выдаче диагностики помощь может оказать встроенная функция ОписаниеОшибки() (англоязычный синоним GetErrorDescription). Эта функция не имеет параметров, а в качестве значения возвращает описание ошибки, такое же, как было бы выдано в окне сообщений, в случае отсутствия обработчика исключительной ситуации, за исключением описания модуля и строки, в которой ошибка возникла. Применять данную функцию имеет смысл только при выполнении последовательности операторов <// Обработка исклю­чительной ситуации>, так как в ином случае она вернет пустую строку.

Пример:

Процедура СформироватьВЕхсеl()

   Попытка

      // пытаемся обратиться к программе MS Excel

      Табл = СоздатьОбъект("Excel.Application");

   Исключение

      Предупреждение(ОписаниеОшибки() +

           "; Excel не установлен на данном компьютере!");

      Возврат;

   КонецПопытки;

   // Формирование отчета

   ...

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


ПорядковыйНомер


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

Синтаксис:

ПорядковыйНомер()

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

Number

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

Строковое значение, содержащее название вида перечисления.

Описание:

Метод ПорядковыйНомер определяет порядковый номер значения в пере­чеслении, как он задан в конфигураторе. Значения перечисления нумеруются с 1.

Пример:

// отобразим порядковый номер значения перечисления

Сообщить(Перечисление.Единицы.Штука.ПорядковыйНомер());



ПорядковыйНомер


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

Синтаксис:

ПорядковыйНомер()

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

Number

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

Числовое значение: порядковый номер плана счетов среди планов счетов конфигурации.

Описание:

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

Пример:

Если ИспПланСчетов.Выбран() = 1 Тогда

   Сообщить("План счетов" + ИспПланСчетов.ПорядковыйНоиер());

КонецЕсли;



ПорядковыйНомер


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

Синтаксис:

ПорядковыйНомер()

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

Number

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

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

Описание:

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

Пример:

Если ВыбВидСубк1.Выбран() = 1 Тогда

   Сообщить("Вид номер" + ВыбВидСубк1.ПорядковыйНомер());

КонецЕсли;



ПорядокКодов


Установить порядок выборки по возрастанию кода.

Синтаксис:

ПорядокКодов()

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

OrderByCode

Описание:

Метод ПорядокКодов устанавливает режим выборки элементов справоч­ника в порядке возрастания кодов элементов.

Данный метод обычно используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего спра­вочника в порядке возрастания кодов элементов.

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

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

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

// Задаем выборку в порядке кодов Спр.ПорядокКодов();

// Открываем выборку Спр.ВыбратьЭлементы();

// Цикл получения элементов справочника

Пока (Спр.ПолучитьЭлемент() > 0) Цикл

   Состояние(Спр.Наименование);

КонецЦикла;



ПорядокНаименований


Установить порядок выборки по возрастанию наименования.

Синтаксис:

ПорядокНаименований()

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

OrderByDescr

Описание:

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

Данный метод обычно используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего спра­вочника в порядке возрастания наименования элементов.

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

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

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

// Задаем выборку в порядке наименований

Спр.ПорядокНаименований();

// Открываем выборку

Спр.ВыбратьЭлементы();

// Цикл получения элементов справочника

Пока (Спр.ПолучитьЭлемент() > 0) Цикл

   Состояние(Спр.Наименование);

КонецЦикла;



ПорядокРеквизита


Установить порядок выборки по возрастанию значения реквизита.

Синтаксис:

ПорядокРеквизита(<ИмяРеквизита>)

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

OrderByAttribute

Параметры:

<ИмяРеквизита>

Строковое выражение с именем реквизита справочника, который задает порядок обхода эле­ментов справочника.

Описание:

Метод ПорядокРеквизита устанавливает режим выборки элементов спра­вочника в порядке возрастания значения указанного реквизита <ИмяРеквизита>.

Данный метод обычно используется до вызова метода ВыбратьЭлементы, который фактически открывает выборку. Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего спра­вочника в порядке возрастания значения реквизита.

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

Данный метод может использоваться только для объектов, созданных Функцией СоздатьОбъект.

Пример:

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

// Задаем выборку в порядке возрастания окладов

Спр.ПорядокРеквизита("Оклад");

// Открываем выборку

Спр.ВыбратьЭлементы();

// Цикл получения элементов справочника

Пока Спр.ПолучитьЭлемент() = 1 Цикл

   Состояние(Спр.Наименование + " - " + Спр.Оклад);

КонецЦикла;



Последняя


Перейти на последнюю запись.

Синтаксис:

Последняя()

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

Last

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

Число: 1 — если действие выполнено; 0 — если действие не выполнено.

Описание:

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

Пример:

// Вычисляет сумму полей AMOUNT всех существующих записей,

// начиная с последней записи и двигаясь к первой

Функция ВычислитьСумму()

   ДБФ.Последняя();

   Сумма = 0;

   Пока ДБФ.Вначале() = 0 Цикл

      Сумма = Сумма + ДБФ.AMOUNT;

      ДБФ.Предыдущая();

   КонецЦикла;

   Возврат Сумма;

КонецФункции



Построение книги


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



ПоТиповойОперации


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

Синтаксис:

ПоТиповойОперации (<Переменная>)

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

ByTemplateOper

Параметры:

<Переменная>

Необязательный параметр. Имя переменной, в которую будет записано наименование типовой операции.

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

Число: 1 — если при вводе операции вручную использована типовая опера-ци; 0 — если при вводе операции вручную не использовалась типовая операция.

Описание:

Определяет, вводится ли новая операция с использованием типовой. Если указан параметр <Переменная>, в переменную будет записано имя типовой операции;

Пример:

Процедура ПриОткрытии()

   Если ПоТиповойОперации() = 0 Тогда

      ИспользоватьВалюту(Константа.ОснВалюта);

   КонецЕсли;

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



ПовторятьПриПечатиСтолбцы


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

Синтаксис:

ПовторятьПриПечатиСтолбцы(<НачСтолбец>, <КонСтолбец>)

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

RepeatColsWhilePrinting

Параметры:

<НачСтолбец>

Числовое выражение — номер первого столбца повторения.

<КонСтолбец>

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

Описание:

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

Пример:

Таб.ПовторятьПриПечатиСтолбцы(1, Таб.ШиринаСекции("БоковикОтчета"));



ПовторятьПриПечатиСтроки


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

Синтаксис:

ПовторятьПриПечатиСтроки(<НачСтрока>, <КонСтрока>)

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

RepeatRowsWhilePrinting

Параметры:

<НачСтрока>

Числовое выражение — номер первой строки по­вторения.

<КонСтрока>

Числовое выражение — номер последней строки повторения.

Описание:

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

Пример:

Таб.ПовторятьПриПечатиСтроки(1, Таб.ВысотаСекции("ШапкаОтчета"));



Позиция документа


Все документы в системе 1С:Предприятие располагаются на временной оси. Основными характеристиками расположения документа на временной оси яв­ляются дата и время документа. Дата документа доступна через атрибут ДатаДок, а работа со временем документа осуществляется при помощи методов УстановитьВремя, ПолучитьВремя и предопределенной процедуры ПриИзмененииВремениДокумента. Кроме даты и времени в системе 1С:Предприятие существует понятие позиции документа.

Позиции документа — это строковое значение специального формата длиной 32 символа. Позиция документа однозначно характеризует расположение до­кумента на оси времени относительно других документов, т. е. позиция доку­мента заключает в себе и дату и время (с точностью до секунды), плюс некото­рые дополнительные данные, определяющие взаимное расположение докумен­тов в пределах одной секунды. Позиции документов можно сравнивать (>; <), определяя какой документ раньше, какой позже. Позиции документов можно сортировать по возрастанию или по убыванию. Кроме того, можно получить позицию точки актуальности (ПолучитьПозициюТА) и позицию границы последовательности (ПолучитьПозицию). Позицию документа можно получить при помощи метода Позиция.

Многие методы могут в качестве парамера воспринимать кроме документа или даты позицию документа.

См. также:

СформироватьПозициюДокумента, РазобратьПозициюДОкумента, ПолучитьПозициюТА, ПолучитьПозицию, ВыбратьДокументы, ВыбратьПодчиненныеДокументы, ВыбратьПоЗначению, РассчитатьРегистрыНа, РассчитатьРегистрыПо, УстановитьТАна, УстановитьТАпо, ВыбратьДвижения, ВыбратьДвиженияСОстатками, ВыполнитьЗапрос, Рассчитать, ВыбратьОперации, ВыбратьОперацииСПроводками, ВыбратьПоЗначению



Прав


Выбрать в строке символы справа.

Синтаксис:

Прав(<Строка>, <Число>)

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

Right

Параметры:

<Строка>

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

<Число>

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

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

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

Описание:

Функция Прав получает в качестве параметра строку, выбирает крайние справа символы строки, числом равные <Число>, и возвращает в качестве зна­чения результирующую строку.

Пример:

Отчество = Прав(ФИО, 15);



Правила преобразования типов данных


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

Число -> Строка

Если число не имеет форматных установок, то его строковым представлени­ем является полное представление числа в формате с фиксированной точкой.

Дата -> Строка

Дата преобразованная к строковому типу имеет вид ДД.ММ.ГГ, где ГГ — две цифры года, ММ — числовое обозначение месяца (01, ..., 12), ДД — день месяца.

Строка -> Число

Строка преобразуется в число пока это возможно. Получившееся число счи­тается результатом преобразования. (Например, строка "1.22 Glass" будет преобразована к числу 1.22). Если в начале строки не имеется ничего, что мог­ло бы быть проинтерпретировано как число, то результат равен 0.

Дата -> Число

Результатом данного преобразования является численное представление да­ты.

Строка -> Дата

Если в начале строки содержится что-то, что может быть проинтерпретиро­вано как строковое представление даты в виде ДД.ММ.ГГ, где ГГ — две цифры года, ММ — числовое обозначение месяца (01, ..., 12), ДД — день месяца, то бу­дет произведено соответствующее преобразование. В противном случае значе­ние даты будет нулевым.

Число -> Дата

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



ПравоДоступа


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

Синтаксис:

ПравоДоступа(<НазваниеПрава>, <Объект>)

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

AccessRight

Параметры:

<НазваниеПрава>

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

<Объект>

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

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

Число: 1 — если право доступа есть, иначе 0.

Описание:

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

Пример:

Доступ = ПравоДоступа("Чтение", "Документ.Счет");

Доступ1 = ПравоДоступа("МонопольныйРежим");



Предопределенные процедуры Глобального модуля


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