Методы
Вариант синтаксиса: Для периодического регистра
Синтаксис;
Выбрать{<Начало интервала> , <Конец интервала> , <Отбор>)
Параметры:
<Начало интервала» Необязательный
Тип: Дата, МоментВремени или Граница. Начало интервала, за который будут выдаваться записи периодического регистра сведений. Если не указан, то будут выдаваться записи с самого ранней включительно.
Значение по умолчанию: Неопределено.
<Конец интервала> Необязательный
Тип: Дата, МоментВремени или Граница. Конец интервала, за который будут выдаваться записи периодического регистра сведений. Если не указан, то будут выдаваться записи до самой поздней включительно.
Значение по умолчанию: Неопределено. Описание
<Отбор> Необязательный
Тип: Структура. Задает поле и значение отбора открываемой выборки. Ключ структуры описывает имя поля, а значение структуры - значение отбора по этому полю. В качестве полей для отбора могут задаваться измерения, для которых в конфигураторе признак индексирования установлен в значение "Индексировать" или установлен признак "Ведущее".
Важно! Структура может содержать только один элемент.
Значение по умолчанию: Неопределено.
Вариант синтаксиса: Для непериодического регистра Синтаксис:
Выбрать(< Отбор>)
Параметры:
<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 )
Синтаксис:
СрезПоследних{<Конец периода> , <Отбор>)
Параметры:
< Конец периода > Необязательный
Тип. Дата, МоментВремени или Граница. Определяет момент времени, заканчивая которым необходимо выбрать записи.
Значение по умолчанию: Неопределено.
<Отбор> Необязательный
Тип: Структура. Структура, содержащая отбор по измерениям регистра.
В переданной структуре должны содержаться те измерения, по которым должны быть отфильтрованы записи. В элементе структуры задается имя и значение отбора.
Значение по умолчанию: Неопределено. Описание
Возвращаемое значение:
Тип: ТаблицаЗначений. Таблица значений, заполненная данными найденных записей регистра сведений.
Описание:
Позволяет получить наиболее поздние записи регистра, соответствующие установленным в параметрах метода значениям ключевых полей. Записи подбираются для каждого сочетания из всех имеющихся значений измерений регистра. Метод применим только для периодических регистров сведений.
Пример:
МаркетингЦен = РегистрыСведений МаркетингЦен ;
ТекущиеЦеныКонкурентов = МаркетингЦен.СрезПоследних(ТекущаяДата());