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

         

<Поле>


Предоставляет доступ к полю записи с именем «Поле». Имя поля должно совпадать с именем поля базы данных, с которой связан объ­ект.

Синтаксис:

<Поле>

Описание:

Атрибут <Поле> предоставляет доступ к полю записи с именем «Поле». В тексте программного модуля под термином <Поле> понимается имя конкрет­ного столбца файла базы данных, с которым связан объект.

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

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

Пример:

ФИО = ДБФ.FIO;



Поля и записи


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

Поле

Поле

Поле

"Фамилия"

"№ комнаты"

"Телефон"

Иванов

25

513

Запись № 2 —>

Петров

31

274

Сидоров

25

513



ПолноеИмяПользователя


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

Синтаксис:

ПолноеИмяПользователя()

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

UserFullName

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

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

Описание:

Функция ПолноеИмяПользователя возвращает полное имя пользователя, указанное в конфигураторе при авторизации доступа.

Пример:

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

Спр.НайтиПоНаименованию(ПолноеИмяПользователя());

Менеджер = Спр.ТекущийЭлемент();

Если Менеджер.Выбран() = 0 Тогда

   Предупреждение("Не выбран менеджер!");

КонецЕсли;



ПолноеНаименование


Определить полное наименование элемента справочника.

Синтаксис:

ПолноеНаименование()

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

FullDescr

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

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

Описание:

Метод ПолноеНаименование возвращает строку, содержащую полное на­именование выбранного элемента справочника (с наименованиями групп всех вышестоящих уровней, разделенными символом "/").

Пример:

ПолнИмя = Спр.Подразделения.ПолноеНаименование();

См. также: НайтиПоНаименованию



ПолныйИдентификатор


Возвращает полный идентификатор объекта.

Синтаксис:

ПолныйИдентификатор()

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

FullIdentifier

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

Идентификатор объекта с идентификаторами его родителей через точку.

Описание:

Метод ПолныйИдентификатор возвращает идентификатор объекта с иден­тификаторами его родителей через точку, например: "Документ.Счет.Цена".

Пример:

Сообщить("Реквизит " + РеквМД.ПолныйИдентификатор());



ПолныйКод


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

Синтаксис:

ПолныйКод()

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

FullCode

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

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

Описание:

Метод ПолныйКод возвращает строку, содержащую полный код выбранно­го элемента справочника (с кодами групп всех вышестоящих уровней, разде­ленными символом "/").

Пример:

ПолнКод = Спр.Подразделения.ПолныйКод();

См. также: НайтиПоКоду



Получить


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

Синтаксис:

Получить(<Дата>)

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

GetValue

Параметры:

<Дата>

Необязательный параметр. Выражение со зна­чением требуемой даты или значение типа «документ» (в этом случае возвращается зна­чение на дату и время документа). Значение по умолчанию — ТА.

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

Значение периодического реквизита справочника на заданную дату (или на документ).

Описание:

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

Замечание: Если к объекту типа «справочник» однажды применен метод ИспользоватьДату, то в дальнейшем, чтобы выбирать значения перио­дических реквизитов справочника, нельзя применять к этому же объекту метод Получить, т. е. в такой последовательности эти два метода несо­вместимы.

Пример:

// при работе в контексте документа, его реквизит "Сотрудник"

// является переменной типа "справочник",

// чтобы получить значение периодического реквизита "Оклад" этого

// справочника, применим функцию Получить

ОкладСотр = Сотрудники.Оклад.Получить(ДатаДок);

См. также: ИспользоватьДату, Установить



Получить


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

Синтаксис:

Получить()

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

Get

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

Строковое представление Границы Последовательности.

Описание:

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

Пример:

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



Получить


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

Синтаксис:

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

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

Get

Параметры:

<Строка>

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

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

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

Описание:

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

Пример:

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



Получить


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

Синтаксис:

Получить(<ЗначениеГруппировки_1>, ..., <ЗначениеГруппировки_n>)

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

Get

Параметры:

<ЗначениеГруппировки_n>

Выражение, содержащее значение n-ой группировки запроса.

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

Число: 1 — если запись найдена, 0 — если нет.

Описание:

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

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

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

Пример:

// Текст запроса

Текст3апроса = "

| ...

|Группировка Должность;

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

| ...

|";

// Текст процедуры обработки запроса

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

   Возврат;

КонецЕсли;

Если Запрос.Получить(ВыбДолжн, ВыбКатег) = 0 Тогда

   Если Запрос.Получить(ВыбДолжн, ) = 0 Тогда

      // ...

   КонецЕсли;

КонецЕсли;



Получить


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

Синтаксис:

Получить(<Дата>)

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

GetValue

Параметры:

<Дата>

Выражение со значением требуемой даты.

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

Значение константы на заданную дату.

Описание:

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

Пример:

// Константа.РазмерКомпенсации - периодическая

// поэтому получим значение этой константы на дату документа

РазмерДК = Константа.РазмерКомпенсации.Получить(ДатаДок);

Если РазмерДК <> 0 Тогда

   Результат = РазмерДК;

Иначе

   // операторы

КонецЕсли;



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


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

Синтаксис:

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

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

GetLineByNum

Параметры:

<Номер>

Выражение, содержащее номер искомой строки.

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

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

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

Описание:

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

Пример:

Процедура УдалЗаданнойСтроки(Док, Стр)

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

      // если переданный параметр содержит значение документа, то

      // найдем в нем строку

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

      // удалим найденную строку спецификации документа

      Док.УдалитьСтроку();

   Иначе

      Предупреждение("Документ не выбран!");

   КонецЕсли;

КонецЕсли;



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по име­ни идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаТов = Тов.ПолучитьАтрибут("ЦенаРозн");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяПеречисления>)

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

GetAttrib

Параметры:

<ИмяПеречисления>

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

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

Объект перечисления конкретного вида.

Описание:

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

Этот метод применяется только к объекту глобального контекста Перечисление.

Пример:

Булево = Перечисление.ПолучитьАтрибут("Булево");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по име­ни идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаДок = Док.ПолучитьАтрибут("Цена");



ПолучитьАтрибут


Получить значение атрибута по идентификатору.

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>)

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

GetAttrib

Параметры:

<ИмяAтpибyтa>

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

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

Значение атрибута <ИмяАтрибута>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение атрибута по иден­тификатору, как оно задано в метаданных.

Пример:

СуммаТов = Рег.ПолучитьАтрибут("Сумма");



ПолучитьАтрибут


Получить значение атрибута по идентификатору.

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>)

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

GetAttrib

Параметры:

<ИмяАтрибута>

Строковое выражение, содержащее идентифика­тор регистра конфигурации.

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

Значение атрибута <ИмяАтрибута>.

Описание:

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

Пример:

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

Рег = СпецРег.ПолучитьАтрибут("ОстаткиТоваров");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по име­ни идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаТов = Счт.ПолучитьАтрибут("ЦенаРозн");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по име­ни идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаТов = Опер.ПолучитьАтрибут("ЦенаРозн");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяВидаРасчета>)

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

GetAttrib

Параметры:

<ИмяВидаРасчета>

Строковое выражение, содержащее идентифика­тор вида расчета, как он задан в конфигураторе.

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

Объект вид расчета.

Описание:

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

Этот метод применяется только к объекту глобально контекста ВидРасчета.

Пример:

Начисл = ВидРасчета.ПолучитьАтрибут("Начисления");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>)

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

GetAttrib

Параметры:

<ИмяАтрибута>

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

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

Значение атрибута <ИмяАтрибута >.

Описание:

Метод ПолучитьАтрибут позволяет получить значение объекта конкретно­го вида календаря по идентификатору, как оно задано в метаданных.

Пример:

Календари.ПолучитьАтрибут("Служащие").Дней(ТекДата, ТекДата - 5);



ПолучитьАтрибут


Получить значение атрибута по идентификатору.

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>}

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

GetAttrib

Параметры:

<ИмяАтрибута>

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

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

Значение атрибута <ИмяАтрибута >.

Описание:

Метод ПолучитьАтрибут позволяет получить значение атрибута по иден­тификатору, как оно задано в метаданных. Доступные имена атрибутов — "Дата" и "Значение".

Пример:

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

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

Календ.ВыбратьДаты(ДатаНачала, ДатаОкончания);

Пока Календ.СледующаяДата() = 1 Цикл

   Сообщить("" + Календ.ПолучитьАтрибут("Дата") + "; ");

   // ...

КонецЦикла;



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

Метод ПолучитьАтрибут позволяет получить значение реквизита по име­ни идентификатора, как оно задано в конфигураторе.

Пример:

ЦенаТов = Форма.ПолучитьАтрибут("ЦенаРозн");



ПолучитьАтрибут


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

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>)

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

SetAttrib

Параметры:

<ИмяАтрибута>

Строковое выражение, содержащее значение лю­бого атрибута запроса.

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

Значение атрибута запроса.

Описание:

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

Пример:

// Текст запроса

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

|ВидРаб = Документ.Наряд.ВидРаботы;

|Сотр = Документ.Наряд.Сотрудник;

|Группировка ВидРаб

|Упорядочить По ВидРаб.Код, ВидРаб.Стоимость;

|Группировка Сотр;

|";

// ...

// Фрагмент заполнения таблицы

// Выбираем значение ВидРаб

Запрос.ПолучитьАтрибут("ВидРаб");

// Выбираем сотрудника

Запрос.ПолучитьАтрибут("Сотр");




ПолучитьАтрибут


Получить значение константы по идентификатору.

Синтаксис:

ПолучитьАтрибут(<ИмяАтрибута>)

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

GetAttrib

Параметры:

<ИмяАтрибута>

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

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

Значение константы <ИмяАтрибута>.

Описание:

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

Пример:

ФлЗапрРед = Константа.ПолучитьАтрибут("ФлагЗапретаРедактирования");



ПолучитьДату


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

Синтаксис:

ПолучитьДату(<ДатаНачала>, <Количество>)

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

GetDate

Параметры:

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

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

<Количество>

Количество дней, отсчитываемых от <ДатаНачала>.

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

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

Описание:

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

Пример:

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

   Если Число(Окончание) = 0 Тогда

      // календарь

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

      // при расчете отпуска, запишем дату его окончания

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

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

   КонецЕсли;

   Если Расчет <> ВидРасчета.ОтпускПоУходуЗаРебенком Тогда

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

         РасчетВперед(ГруппаРасчетов.ПересчДляОтпуска, Сотрудник,

                      ТекущийДокумент());

      КонецЕсли;

      ЖрнЗарплата.ВвестиРасчет(Сотрудник, Расчет, Начало, Окончание, 0);

   Иначе

      ЖрнЗарплата. ВвестиРасчет (Сотрудник, Расчет,

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

                  Минимум(Окончание, ЖрнЗарплата.КонецТекущегоПериода()), 0);

      Зарегистрировать(Контекст, ТекущийДокумент());

   КонецЕсли;

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



ПолучитьДату


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

Синтаксис:

ПолучитьДату()

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

GetDate

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

Дата Границы Последовательности.

Описание:

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

Пример:

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



ПолучитьДатуТА


Получить дату Точки Актуальности

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

Синтаксис:

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

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

GetDateOfAP

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

Значение типа «дата», содержащее дату ТА.

Описание:

Функция ПолучитьДатуТА возвращает значение (типа «дата») даты Точки Актуальности

итогов.

Пример:

Дата_ТА = ПолучитьДатуТА();



ПолучитьДокумент


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

Синтаксис:

ПолучитьДокумент()

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

GetDocument

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

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

Описание:

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

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

Пример:

Если Режим = "Подробный" Тогда

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

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

   Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);

   // Цикл выбора документов

   Пока Док.ПолучитьДокумент() > 0 Цикл

   // присвоим переменной ТекДок значение найденного документа

      ТекДок = Док.ТекущийДокумент();

      // ...

   КонецЦикла;

КонецЕсли;

См. также: ВыбратьДокументы



ПолучитьДокумент


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

Синтаксис:

ПолучитьДокумент()

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

GetDocument

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

Значение типа «Документ».

Описание:

Метод ПолучитьДокумент возвращает значение типа «Документ» содер-жащий документ, которому принадлежит операция. Его следует использовать, если нужно передать какому либо методу или запомнить в переменную значе­ние типа документ операции. Для доступа к данным документа непосредствен­но из объекта типа «Операция» следует использовать атрибут объекта «Доку­мент».

Пример:

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

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

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

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

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

   Док.НайтиДокумент(Опер.ПолучитьДокумент());

КонецЦикла;



ПолучитьДокумент


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

Синтаксис:

ПолучитьДокумент()

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

GetDocument

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

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

Описание:

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

Пример:

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



ПолучитьДокументТА


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

Синтаксис:

ПолучитьДокументТА()

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

GetDocOfAP

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

Значение типа «документ», который стоит на ТА.

Описание:

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

Пример:

ПоследнийДок = ПолучитьДокументТА();



ПолучитьДвижение


Выбрать очередное движение регистра.

Синтаксис:

ПолучитьДвижение()

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

GetDocAct

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

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

Описание:

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

После выполнения даннго метода все атрибуты регистра: измерения, ресур­сы, Приход и Расход содержат значения текущей записи движения регистра.

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

Пример:

Рег1 = СоздатьОбъект("Регистр.Взаиморасчеты");

Если Режим = "Подробно" Тогда

   Рег1.УстановитьФильтр(Клиент);

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

   Рег1.ВыбратьДвижения(ДатаНачало, );

   // Цикл выбора движений по регистру

   Пока Рег1.ПолучитьДвижение() > 0 Цикл

      Если Строка(Рег1.Клиент.Код) <> Строка(Запрос.Клиент.Код) Тогда

         Продолжить;

      КонецЕсли;

      Док = Рег1.ТекущийДокумент();

      Дв_Баз_Сум = Рег1.СуммаБазовая;

      Дв_Вал_Сум = Рег1.СуммаВалютная;

      Если Рег1.Расход = 1 Тогда

         Таб.ВывестиСекцию("Расход2");

      Иначе

         Таб.ВывестиСекцию("Приход2");

      КонецЕсли;

   КонецЦикла;

КонецЕсли;

См. также: ВыбратьДвиженияДокумента, ВыбратьДвижения, ВыбратьДвиженияСОстатками



ПолучитьИтог


Выбрать очередной остаток по регистру.

Синтаксис:

ПолучитьИтог()

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

GetTotal

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

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

Описание:

Метод ПолучитьИтог выбирает очередной остаток по регистру в последо­вательности выборки, открытой перед этим при помощи метода ВыбратьИто­ги. Данный метод используется для организации цикла по регистру — позволя­ет перебрать текущие или временные (см. ВременныйРасчет) остатки по ре­гистру. При этом используется фильтр, если он установлен (см. УстановитьФильтр). Открывается выборка остатков по всем записанным зна­чениям измерений.

Итоги с нулевыми остатками не выдаются. Порядок выдачи для измерений типа «справочник» и «документ» не определен.

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

Пример:

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

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

   Рег = СоздатьОбъект("Регистр.ТоварныйКредит");

   Рег.УстановитьФильтр(Клиент, );

   Ном = 0;

   Рег.ВыбратьИтоги();

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

      Док = Рег.Документ;

      Список.ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);

      Если Ном = 0 Тогда

         ВыбДок = Док;

      КонецЕсли;

      Ном = Ном + 1;

   КонецЦикла;

   Если Ном > 0 Тогда

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

         ДокКредита = ВыбДок;

      КонецЕсли;

   КонецЕсли;

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

См. также: ВыбратьИтоги



ПолучитьЭлемент


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

Синтаксис:

ПолучитьЭлемент(<Режим>)

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

Getltem

Параметры:

<Режим>

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

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

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

Описание:

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

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

Пример:

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

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

Спр.ПорядокКодов();

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

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

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

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

   Сообщить("===" + Спр.Наименование);

КонецЦикла;

См. также: ВыбратьЭлементы, ПолучитьЭлемент, ПорядокНаименований, ОбратныйПорядок, ПорядокКодов, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату



ПолучитьКорректнуюПроводку


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

Синтаксис:

ПолучитьКорректнуюПроводку()

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

GetCorrectEntry

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

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

Описание:

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

Пример:

КП = СоздатьОбъект("КорректныеПроводки");

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

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

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

      Сообщить(КП.Комментарий + " счет кредита — " + КП.СчетКт);

   КонецЕсли;

КонецЦикла;



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


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

ВыбратьКорСчета.

Синтаксис:

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

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

GetCorAccount

Параметры:

<Номер>

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

<Счет>

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

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

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

Описание:

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

   КонецЦикла;

КонецЦикла;



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


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

Синтаксис:

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

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

GetCorSubconto

Параметры:

<Индекс>

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

<Номер>

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

<КорСубконто>

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

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

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

Описание:

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

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

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

   КонецЦикла;

КонецЦикла;



ПолучитьОперацию


Извлекает операции из выборки, открытой при помощи метода

ВыбратьОперции.

Синтаксис:

ПолучитьОперацию()

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

GetOper

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

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

Описание:

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

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

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

Пример:

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

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

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

   Сообщить("Операция " + Опер.Содержание);

КонецЦикла;



ПолучитьОтбор


Возвратить текущее значение отбора списка справочника.

Синтаксис:

ПолучитьОтбор(<ИмяОтбора>, <3начение0т6ора>)

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

GetSelection

Параметры:

<ИмяОтбора>

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

<ЗначениеОтбора>

Имя переменной, куда вернется значение отбора.

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

Числовое значение: 1 — есть отбор; 0 — если нет отбора.

Описание:

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

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

Пример:

См. пример для предыдущей функции.



ПолучитьОтбор


Возвратить текущее значение отбора журнала.

Синтаксис:

ПолучитьОтбор(<ИмяОтбора>, <3начение0тбора>)

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

GetSelection

Параметры:

<ИмяОтбора>

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

<3начениеОтбора>

Имя переменной, куда вернется значение отбора.

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

Числовое значение: 1 — есть отбор; 0 — если нет отбора.

Описание:

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

Пример:

Изм = ПолучитьОтбор();



ПолучитьОтбор


Возвратить текущее значение отбора журнала операций.

Синтаксис:

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

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

GetSelection

Параметры:

<ИмяОтбора>

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

<ЗначениеОтбора>

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

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

Число: 1 — отбор включен; 0 — отбор не включен.

Описание:

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

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

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

Пример:

Изм = ПолучитьОтбор();



ПолучитьОтбор


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

Синтаксис:

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

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

GetSelection

Параметры:

<ИмяОтбора>

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

<ЗначениеОтбора>

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

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

Числовое значение: 1 — отбор включен; 0 — отбор не включен.

Описание:

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

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

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

Пример:

Изм = ПолучитьОтбор();



ПолучитьОтбор


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

Синтаксис:

ПолучитьОтбор(<ИмяГрафыОтбора>, <ЗначениеОтбора>)

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

GetSelection

Параметры:

<ИмяГрафыОтбора>

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

<ЗначениеОтбора>

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

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

Число: 1 — если отбор был установлен и <ИмяГрафыОтбора> и <ЗначениеОтбора> заполнены установками сделанными ранее методом УстановитьОтбор; 0 — если отбор прежде не был установлен.

Описание:

Метод предназначен для получение текущих значений отбора, установлен­ных в форме журнала расчетов программным образом или интерактивно. Ме­тод заполняет параметры <ИмяГрафыОтбора> и <ЗначениеОтбора>, пере­данные по ссылке. Если отбор ранее не был установлен, метод возвращает 0, а значения переменных, переданных в качестве параметров, не изменяются.

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

Пример:

// модуль формы журнала расчетов

Перем ИмяОтбора;

Перем ЗначОтб;

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

   // ниже ИмяОтбора и ЗначениеОтбора будут заполнены

   // текущими значениями

   БылОтбор = ПолучитьОтбор(ИмяОтбора, ЗначОтб);

   Если БылОтбор = 1 Тогда

      Если ИмяОтбора = "Родитель" Тогда

         // снимем отбор

         УстановитьОтбор("");

      ИначеЕсли ИмяОтбора = "Подразделение" Тогда

         Сообщить("Было отобрано " + ЗначОтб.Наименование);

         УстановитьОтбор(ИмяОтбора, Подразд);

      КонецЕсли;

   КонецЕсли;

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

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



ПолучитьПараметрыКолонки


Возвращает значения параметров колонки.

Синтаксис:

ПолучитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>,

                         <Ширина>, <Формат>, <Положение>)

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

GetColumnParameters

Параметры:

<Колонка>

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

<Тип>

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

<Длина>

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

<Точность>

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

<3аголовок>

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

<Ширина>

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

<Формат>

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

<Положение>

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

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

Номер или идентификатор колонки. Если в параметре <Колонка> задан номер колонки, то возвращается идентификатор колонки, и наоборот.

Описание:

Метод ПолучитьПараметрыКолонки возвращает значения параметров ко­лонки по номеру колонки или по ее идентификатору.

Пример:

Перем ВыбТип;

Перем ВыбДлина;

Перем ВыбТочность;

Перем ВыбЗаголовок;

Перем ВыбШирина;

Табл.ПолучитьПараметрыКолонки("Код", ВыбТип, ВыбДлина, ВыбТочность, ВыбЗаголовок,

                                ВыбШирина);



ПолучитьПериод


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

Синтаксис:

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

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

GetPeriod

Параметры:

<Номер>

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

<ДатаНачалаПериода>

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

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

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

Описание:

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

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

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

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

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

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");

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

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

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

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

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

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

   КонецЦикла;

КонецЦикла;



ПолучитьПодчиненный


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

Синтаксис:

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

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

GetDependent

Параметры:

<НомерВР>

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

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

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

Описание:

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

Пример:

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



ПолучитьПозицию


Получить позицию документа.

Синтаксис:

ПолучитьПозицию()

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

GetPosition

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

32-х символьное строковое значение позиции документа.

Описание:

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

Замечание. Позиция может существовать только у записанного документа.

Пример:

ПозицияДокумента = ВыбДокумент.ПолучитьПозицию();



ПолучитьПозицию


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

Синтаксис:

ПолучитьПозицию()

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

GetPosition

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

32-х символьное строковое значение позиции Границы Последовательности.

Описание:

Метод ПолучитьПозицию возвращает позицию Границы Последовательно­сти.

Пример:

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



ПолучитьПозициюТА


Получить позицию Точки Актуальности

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

Синтаксис:

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

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

GetAPPosition

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

32-х символьное строковое значение позиции ТА.

Описание:

Функция ПолучитьПозициюТА возвращает 32-х символьное строковое зна­чение позиции ТА.

Пример:

ПозицияТА = ПолучитьПозициюТА();