Методы

Выбрать ( Select )

Вариант синтаксиса: Для периодического регистра

Синтаксис;

Выбрать{<Начало интервала> , <Конец интервала> , <Отбор>)

Параметры:

<Начало интервала» Необязательный

Тип: Дата, МоментВремени или Граница. Начало интер­вала, за который будут выдаваться записи периодического реги­стра сведений. Если не указан, то будут выдаваться записи с са­мого ранней включительно.

Значение по умолчанию: Неопределено.

<Конец интервала> Необязательный

Тип: Дата, МоментВремени или Граница. Конец интер­вала, за который будут выдаваться записи периодического реги­стра сведений. Если не указан, то будут выдаваться записи до са­мой поздней включительно.

Значение по умолчанию: Неопределено. Описание

<Отбор> Необязательный

Тип: Структура. Задает поле и значение отбора открываемой выборки. Ключ структуры описывает имя поля, а значение струк­туры - значение отбора по этому полю. В качестве полей для от­бора могут задаваться измерения, для которых в конфигураторе признак индексирования установлен в значение "Индексировать" или установлен признак "Ведущее".

Важно! Структура может содержать только один элемент.

Значение по умолчанию: Неопределено.

Вариант синтаксиса: Для непериодического регистра Синтаксис:

Выбрать(< Отбор>)

Параметры:

<0тбор> Необязательный

Тип: Структура. Задает поле и значение отбора открываемой выборки. Ключ структуры описывает имя поля, а значение струк­туры - значение отбора по этому полю. В качестве полей для от­бора могут задаваться измерения, для которых в конфигураторе признак индексирования установлен в значение "Индексировать" или установлен признак "Ведущее".

Важно! Структура может содержать только один элемент. Значение по умолчанию: Неопределено.

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

Тип: РегистрCведенийВыборка.<Имя    регистра сведений>. Сформированная выборка записей регистра сведе­ний.

Описание:

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

Пример:

Курсы = РегистрыСведений.КурсыВалют;

ОтборВалют = Новый Структура("Валюта");

ОтборВалют.Валюта = ВыбВалюта;

ВыборкаКурсовВалют = Курсы.Выбрать(,,ОтборВалот);

Пока ВыборкаКурсовВалот.Следующий() Цикл

    Сообщить("Дата " + ВыборкаКурсовВалот.Период *

    " Валюта "+СокрЛП(ВыборкаКурсовВалст.Валюта) +

    ", Курс "+ ВыборкаКурсовВалют.Курс );

КонецЦикла;

ВыбратьПоРегистратору ( SelectByRecorder )

Синтаксис:

ВыбратьПоРегистратору (< Регистратор>)

Параметры:

<Регистратор> Обязательный

Тип: ДокументСсылка. <Имя документа>. Ссылка на до­кумент, являющийся регистратором для записей регистра.

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

Тип:     РегистрСведенийВыборка.<Имя регистра сведений>. Сформированная выборка записей регистра сведе­ний.

Описание:

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

Пример:

ВыборкаЦен = РегистрыСведений.МаркетингЦен.ВыбратьПоРегистратору(ВыбРегистратор);

Пока ВыборкаПев.Следующий() Цикл

    Сообщить("Дата " + ВыборкаЦен. Регистратор. ДатаДокумента *

    " Номенклатура "+СокрЛП(ВыборкаЦен.Номенклатура) +

    ", Конкурент "+ ВыборкаЦен.Конкурент );

КонецЦикла ;

Получить ( Get )



Вариант синтаксиса: Для периодического регистра

Синтаксис:

Получить(<Период>, <Измерение 1>, ..., <ИзмерениеN >)

Параметры:

<Период> Обязательный

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



<Измерение 1>, ..., <Измерение N > Необязательный

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

Вариант синтаксиса: Для непериодического регистра Синтаксис:

Получить(< Измерение 1>, ..., <Измерение N >)

Параметры:

<Измерение 1>, . . ., <Измерение N > Необязательный

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

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

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

Описание:

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

ПолучитьМакет ( GetTemplate )



Синтаксис;

ПолучитьМакет(< Макет>)

Параметры:

<Макет> Обязательный

Тип:Строка, Объект описания метаданного. Имя ма­кета, как оно задано в конфигураторе или объект описания мета­данного требуемого макета.

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

Тип: ТабличныйДокумент. Созданный макет.

Описание:

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

Пример:

Таб = СоздатьОбъект("ТабличныйДокумент");

Макет = РегистрыСведений.КурсыВалют.ПолучитьМакет("ТаблицаКурсов");

Таб.Вывести(Макет.ПолучитьОбласть("Шапка"));

Таб.Показать();

ПолучитьПервое ( GetFirst )



Синтаксис:

ПолучитьПервое (< Начало периодам, <Измерение 1> , ..., <Измерение N > )

Параметры:

<Начало периода > Необязательный



Тип: Дата, МоментВремени или Граница. Определяет момент времени, начиная с которого необходимо получить значе­ния ресурсов. Если параметр не указан, то будут возвращены зна­чения ресурсов самой первой записи регистра.

Значение по умолчанию: Неопредепено.

<Измерение 1>, . . - , <Измерение N > Необязательный

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

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

Тип: Структура. Возвращает структуру, содержащую значения ресурсов.

Описание:

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

Пример:

МаркетингЦен = РегистрыСведений.МаркетингЦен;

Цена = МаркетингЦен.ПолучитьПервое(ВыбДата, ВыбКлиент, ВыбТовар).Цена;

ПолучитьПоследнее ( GetLast )

Синтаксис:

ПолучитьПоследнее (< Конец периода> , <Измерение 1>, ..., <Измерение N > )

Параметры;

<Конец периода > Необязательный

Тип: Дата, МоментВремени или Граница. Определяет момент времени, по который необходимо получить значения ре­сурсов. Если параметр не указан, то будут возвращены значения ресурсов самой последней записи регистра.

Значение по умолчанию: Неопределено.

<Измерение 1>, . . . , <Измере ние N >     Необязательный

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



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

Тип: Структура. Возвращает структуру, содержащую значения ресурсов.

Описание:

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

Пример:

Доллары = Справочники.Валюты.НайтиПоНаименованио("USD");

Курсы     = РегистрыСведений.КурсыВалют;

ТекКурс = Курсы.ПолучитьПоследнее(ТекущаяДата(), Доллары);

Сообщить("Текущий курс доллара: " + ТекКурс.Курс + " руб.");

ПолучитьФорму ( GetForm )



Синтаксис:

ПолучитьФорму (< Форма>, <Владелец>, <Ключ уникальности> )

Параметры:

<Форма> Обязательный

Тип: Строка. Имя формы, как оно задано в конфигураторе.

<Владелец> Необязательный

Тип: Форма. Форма, которая будет являться владельцем откры­ваемой формы.

<Ключ уникальности> Необязательный

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

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

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

Тип: Форма.

Описание:

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

Пример:

КурсыВалют = РегистрыСведений.КурсыВалют;

ФормаВалют = КурсыВалют.ПоялчитьФорму("ФормаСписка");

ФормаВалют.Открыть();

ПолучитьФормуРедактированияЗаписи ( GetRecordEditingForm )



Синтаксис:

ПолучитьФормуРедактированияЗаписи(< Форма>, <Владелец>, <Ключ уникальности>)

Параметры:

<Форма> Необязательный

Тип. Строка, Объект описания метаданного Имя формы, как оно задано в конфигураторе или объект описания ме-тадаиного требуемой формы.

Значение по умолчанию: Если параметр не указан, то использует­ся основная форма, заданная в конфигураторе.



<Владелец> Необязательный

Тип Форма Форма, которая будет являться владельцем откры­ваемой формы.

<Ключ уникальности> Необязательный

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

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

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

Тип Форма.

Описание:

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

Пример:

РегистрыСведений.КурсыВалют.ПолучитьФормуСписка().Открыть();

ПолучитьФормуСписка ( GetFormList )



Синтаксис:

ПолучитьФормуСписка (< Форма> , <Владелец> , <Ключ уникальности>)

Параметры:

<Форма> Необязательный

Тип Строка, Объект описания метаданного Имя форты, как оно задано в конфигураторе или объект описания ме­таданного требуемой формы.

Значение по умолчанию- Если параметр не указан, то использует­ся основная форма, заданная в конфигураторе

<Владелец> Необязательный

Тип Форма. Форма, которая будет являться владельцем откры­ваемой формы

<Ключ уникальности> Необязательный

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

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

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

Тип Форма.

Описание:

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

Пример:

РегмстрыСвеяений.КурсыВалют.ПолучитьФормуСписка().Открыть();

СоздатьКлючЗаписи ( CreateRecordKey )



Синтаксис:

СоздатьКлючЗаписи (< Значения ключа> )

Параметры:

<3начения клоча> Обязательный

Тип: Структура. Структура, содержащая значения для заполне­ния свойств ключа записи.



Имена элементов структуры должны соответствовать именам ключевых полей.

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

Тип:   РегистрСведенийКлючЗаписи.<Имя   регистра сведений>. Созданный ключ записи.

Описание:

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

СоздатьМенеджерЗаписи ( CreateRecordManager )

Синтаксис:

СоздатьМенеджерЗаписи()

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

Тип: РегистрСведенийМенеджерЗаписи.<Имя регистра сведений>. Созданный менеджер записи регистра сведений.

Описание:

Создает объект для управления записью регистра сведений.

Пример:

РегистрыСведений.КурсыВалют.СоздатьМенеджерЗаписи();

СоздатьНаборЗаписей ( CreateRecordSet )



Синтаксис:

СоздатьНаборЗаписей()

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

Тип: РегистрСведенийНаборЗаписей.<Имя регистра сведений>. Созданный набор записей.

Описание:

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

Пример:

КурсыВалют = РегистрыСведений.КурсыВалют;

НаборКурсов = КурсыВалют.СоздатьНаборЗаписей();

СрезПервых ( SliceFirst )



Синтаксис:

СрезПервых(<Начало периода>, <Отбор>)

Параметры:

<Начало периода> Необязательный

Тип: Дата, МоментВремени или Граница. Определяет момент времени, начиная с которого необходимо выбрать записи.

Значение по умолчанию: Неопределено.

<Отбор>Необязательный

Тип: Структура. Структура, содержащая отбор по измерениям регистра.

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

Значение по умолчанию: Неопределено.

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

Тип: ТаблицаЗначений. Таблица значений, заполненная дан­ными найденных записей регистра сведений.

Описание:

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



Пример:

МаркетингЦен = РегистрыСведений.МаркетингЦен;

ОбновленныеСегодняЦены = МаркетингЦен.СрезПервых(ТекущаяДата());

СрезПоследних ( SliceLast )



Синтаксис:

СрезПоследних{<Конец периода> , <Отбор>)

Параметры:

< Конец периода > Необязательный

Тип. Дата, МоментВремени или Граница. Определяет момент времени, заканчивая которым необходимо выбрать запи­си.

Значение по умолчанию: Неопределено.

<Отбор> Необязательный

Тип: Структура. Структура, содержащая отбор по измерениям регистра.

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

Значение по умолчанию: Неопределено. Описание

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

Тип: ТаблицаЗначений. Таблица значений, заполненная дан­ными найденных записей регистра сведений.

Описание:

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

Пример:

МаркетингЦен = РегистрыСведений МаркетингЦен ;

ТекущиеЦеныКонкурентов = МаркетингЦен.СрезПоследних(ТекущаяДата());


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

---