Методы
Синтаксис:
Выбрать(<Начало интервала> , <Конец интервала> , <Отбор>)
Параметры:
<Начало интервала> Необязательный.
Тип: Дата, МоментВремени или Граница.. Начало интервала, за который будут выбираться записи регистра накопления.
Если не указан, то будут выбираться записи с самого ранней включительно.
Значение по умолчанию: Неопределено.
<Конец интервала> Необязательный
Тип: Дата, МоментВремени или Граница.. Конец интервала, за который будут выбираться записи регистра накопления.
Если не указан, то будут выбираться записи до самой поздней включительно.
Значение по умолчанию: Неопределено.
<Отбор> Необязательный
Тип: Структура. Задает поле и значение отбора открываемой выборки. Ключ структуры описывает имя поля, а значение структуры - значение отбора по этому полю. В качестве полей для отбора могут задаваться измерения, для которых в конфигураторе признак индексирования установлен в значение "Индексировать".
Важно! Структура может содержать только один элемент.
Значение по умолчанию: Неопределено.
Возвращаемое значение:
Тип: РегистрНакопленияВыборка.<Имя регистра накопления>. Сформированная выборка записей регистра накопления.
Описание:
Позволяет получить выборку записей регистра накопления.
Пример:
// Посчитаем, сколько отгружено с начала года
МПЗ = РегистрыНакопления.УчетНоменклатуры;
ОтборПоТовару = Новый Структура("Номенклатура");
ОтборПоТовару.Номенклатура = ВыбТовар;
НачДата = НачалоГода(ТекущаяДата()) ;
КонДата = ТекущаяДата() ;
ВыборкаМПЗ = МПЗ.Выбрать(НачДата,КонДата,ОтборПоТовару);
Расход =0;
Пока ВыборкаМПЗ.Следующий() Цикл
Если ВыборкаМПЗ.Расход Тогда
Расход = Расход + ВыборкаМПЗ.Количество;
КонецЕсли;
КонецЦикла ;
Предупреждение("Отгружено с начала года " + СокрЛП(ВыбТовар) + " = "+ Расход + " шт.");
ВыбратьПоРегистратору
Синтаксис:
ВыбратьПоРегистратору (< Регистратор>)
Параметры:
<Регистратор> Обязательный
Тип: Документ-Ссылка. <Имя документа>. Ссылка на документ, являющийся регистратором для записей регистра.
Возвращаемое значение:
Тип: РегистрНакопленияВыборка.<Имя регистра накопления>. Сформированная выборка записей регистра накопления.
Описание:
Позволяет получить выборку по регистратору записей регистра накопления.
Обороты ( Turnovers )
Синтаксис:
Обороты(<Начало периода> , <Конец периода> , <Отбор>, <Измерения>, <Ресурсы>)
Параметры:
<Начало периода> Необязательный
Тип: Дата, Момент Времени, Граница. Момент времени, начиная с которого необходимо получить обороты. Если параметр не указан или установлен в Неопределено, то обороты будут получены начиная с момента ведения информационной базы. Если в качестве параметра передана Дата или МоментВремени, то обороты за указанную дату (момент времени) будут включены в результирующую таблицу значений.
Значение по умолчанию: Неопределено.
<Конец периода > Необязательный
Тип: Дата, МоментВремени, Граница. Момент времени, определяющий конец периода за который необходимо получить обороты. Если параметр не указан или установлен в Неопределено, то обороты будут получены до самого позднего движения регистра. Если в качестве параметра передана Дата
или Момент Времени, то обороты за указанную дату (момент времени) будут включены в результирующую таблицу значений.
Значение по умолчанию: Неопределено.
<От6ор> Необязательный
Тип: Структура. Структура, содержащая набор значений измерений регистра, по которым надо отбирать обороты. Имя ключа структуры должно совпадать с именем измерения регистра, заданного в конфигураторе.
Значение по умолчанию: Неопределено.
<Измерения> Необязательный
Тип: Строка. Список измерений, для которых надо разворачивать обороты. Строка, содержащая имена измерений, разделенные запятыми. Если параметр не указан или указана пустая строка, то обороты будут сформированы по всем измерениям.
Значение по умолчанию: Пустая строка.
<Ресурсы> Необязательный
Тип: Строка. Список ресурсов, для которых надо получить обороты. Строка, содержащая имена ресурсов, разделенные запятыми.
Если параметр не указан или указана пустая строка, то обороты будут сформированы по всем ресурсам.
Значение по умолчанию: Пустая строка.
Возвращаемое значение:
Тип: ТаблицаЗначений. Сформированная таблица значений.
Описание:
Позволяет получить обороты регистра накопления за заданный момент времени. Есть возможность фильтрации по значениям измерений. Возвращает таблицу значений, содержащую колонки с измерениями, указанными в параметре Измерения, и по две колонки на каждый ресурс, указанный в параметре Ресурсы. На звания колонок для ресурсов формируются следующим образом "<Имя ресурса>Приход" и "<Имя ресурса>Расход".
Пример:
ОстаткиМПЗ = РегистрыНакопления.ОстаткиМПЗ;
ФильтрМПЗ = Новый Структура("Номенклатура","Склад");
ФильтрМПЗ.Номенклатура = ВыбМПЗ;
ФильтрМПЗ.Склад = ВыбСклад;
ТабОборотов = ОстаткиМПЗ.Обороты(ДатаНач, ДатаКон, ФильтрМПЗ, "Номенклатура,Склад", "Количество") ;
Остатки ( Balance )
Синтаксис:
Остатки(< Момент времени> , <Отбор>, <Измерения>, <Ресурсы>)
Параметры:
<Момент времени> Необязательный
Тип: Дата, МоментВремени, Граница. Момент времени, на который необходимо получить остатки. Если параметр не указан или установлен в Неопределено, то будут получены текущие остатки (на максимальную дату движений регистра). Если в качестве параметра передана Дата, то остатки будут получены на начало дня, если МоментВремени - то в остатках не будут учтены движения регистра, произошедшие в тот же момент времени.
Значение по умолчанию: Неопределено.
<Отбор> Необязательный
Тип: Структура. Структура, содержащая набор значений измерений регистра, по которым надо отбирать итоги. Имя Ключа структуры должен совпадать с именем измерения регистра, заданного в конфигураторе.
Значение по умолчанию: Неопределено. Описание
<Измерения> Необязательный
Тип: Строка. Список измерений, для которых надо получить остатки. Строка, содержащая имена измерений, разделенные запятыми.
Если параметр не указан или указана пустая строка, то остатки будут сформированы по всем измерениям.
Значение по умолчанию: Неопределено.
<Ресурсы> Необязательный
Тип: Строка. Список ресурсов, для которых надо получить остатки. Строка, содержащая имена ресурсов, разделенные запятыми.
Если параметр не указан или указана пустая строка, то остатки будут сформированы по всем ресурсам.
Значение по умолчанию: Пустая строка.
Возвращаемое значение:
Тип: ТаблицаЗначений. Сформированная таблица значений.
Описание:
Позволяет получить остатки регистра накопления на заданный момент времени. Есть возможность фильтрации по значениям измерений, а также получения остатков в разрезе других измерений. Возвращает таблицу значений, содержащую колонки с измерениями, указанными в параметре Измерения, и колонки с ресурсами, указанными в параметре Ресурсы.
Замечание! Использование данного метода имеет смысл только для регистров, у которых в конфигураторе указан вид регистра "Остатки".
Пример:
ОстаткиМПЗ = РегистрыНакопления.ОстаткиМПЗ;
ФигьтрМПЗ = Новый Структура() ;
ФильтрМПЗ.Вставить("Номенклатура",ВыбМПЗ);
ФильтрМПЗ.Вставить("Склад", ВыбСклад) ;
ТабОстатков = ОстаткиМПЗ. Остатки (ВыбДата, ФильтрМПЗ, "Номенклатура,Склад", "Количество") ;
ПересчитатьИтоги ( RecalcTotals )
Синтаксис:
ПересчитатьИтоги()
Описание:
Позволяет осуществить полный пересчет итогов регистра накопления.
Пример:
Регистры.ОстаткиМПЗ.ПересчитатьИтоги();
ПолучитьМакет ( GetTemplate )
Синтаксис:
ПолучитьМакет(< Макет>)
Параметры:
<Макет> Обязательный
Тип: Строка, Объект описания метаданного. Имя макета, как оно задано в конфигураторе или объект описания метаданного требуемого макета.
Возвращаемое значение:
Тип: ТабличныйДокумент. Созданный макет.
Описание:
Позволяет получить макет регистра накопления.
ПолучитьПериодРасчитанныхИтогов
Синтаксис:
ПолучитьПериодРасчитанныхИтогов()
Возвращаемое значение:
Тип: Дата. Период рассчитанных итогов.
Описание:
Позволяет получить период рассчитанных итогов. Имеет смысл только для регистров остатков.
Пример:
ВыбДата = Регистры.ОстаткиМПЗ.ПолучитьПериодРасчитанныхИтогов();
См. также:
РегистрНакопленияМенеджер.<Имя регистра накопления>. Метод УстановитьПериодРассчитанныхИтогов.
ПолучитьФорму ( GetForm )
Синтаксис:
ПолучитьФорму(<Форма>, <Владелец>, <Ключ уникальности>)
Параметры:
<Форма> Обязательный
Тип: Строка. Имя формы, как оно задано в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму регистра накопления.
ПолучитьФормуСписка ( GetFormList )
Синтаксис:
ПолучитьФормуСписка (< Форма>, <Владелец> , <Ключ уникальности>}
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму списка регистра накопления.
Пример:
РегистрыНакопления.УчетНоменклатуры.ПолучитьФормуСписка().Открыть();
СоздатьКлючЗаписи ( CreateRecordKey )
Синтаксис:
СоздатьКлючЗаписи(< Значения ключа>)
Параметры:
< Значения ключа> Обязательный
Тип: Структура.
Возвращаемое значение:
Тип: РегистрНакопленияКлючЗаписи.<Имя регистра накопления>. Созданный ключ записи.
Описание:
Создает ключ записи по переданной структуре.
СоздатьНаборЗаписей ( CreateRecordSet )
Синтаксис:
СоздатьНаборЗаписей()
Возвращаемое значение:
Тип: РегистрНакопленияНаборЗаписей.<Имя регистра накопления>. Созданный набор записей.
Описание:
Позволяет создать набор записей регистра накопления. Набор записей создается пустым.
Пример:
ОстаткиТоваров = РегистрыНакопления.УчетНоменклатуры;
НаборЗаписейМПЗ = ОстаткиТоваров.СоздатьНаборЗаписей();
УстановитьПериодРассчитанныхИтогов ( SetTotalsMaxPeriod )
Синтаксис:
УстановитьПериодРассчитанныхИтогов(< Период>)
Параметры:
<Период> Обязательный
Тип: Дата. Период, на который необходимо рассчитать итоги.
Описание:
Позволяет установить период, на который рассчитаны итоги. Периодичность расчета - месяц. Период устанавливается на начало месяца. Имеет смысл только для регистров остатков.
Примечание:
Период, на который рассчитаны итоги, влияет только на производительность получения остатков по данному регистру. Для получения итогов регистра после установленного периода расчета будут использоваться полученные в результате использования метода результаты.
Пример:
Регистры.ОстаткиМПЗ.УстановитьПериодРасчитанныхИтогов(ВыбДата) ;
