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

         

Таблица получения среза первых (наиболее ранних) записей


Синтаксис:

РегистрСведений.<Имя регистра>.СрезПервых(<Дата>, <Условно>)

Описание:

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

Предоставляемые поля:

Период (Period)

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

Примечание: Имеет смысл только для периодических регистров.

Регистратор (Recorder)

Тип: ДокументСсылка.<Имя документа>. Содержит ссыл­ку на документ-регистратор движения.

Примечание: Имеет смысл только для регистров, записываемых регистратором.

НомерСтроки (LineNumber)

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



Примечание: Имеет смысл только для регистров, записываемых регистратором.

Активность (Active)

Тип: Булево. Содержит признак активности записи и влияния на получение первых и последних записей

Примечание: Имеет смысл только для регистров, записываемых регистратором.

<Имя измерения>

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

<Имя ресурса>

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

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

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

Параметры:

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

Тип параметра: Значение. Тип: Дата, МоментВремени. Ука­зывается дата или момент времени, на которые будут получены сведения.

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

<Условие>    Необязательный

Тип параметра: Конструкция. Указывается условие на языке за­просов. Условие может оперировать полями регистра сведений. Оно будет использовано для ограничения состава записей, среди которых будут выбираться наиболее ранние. То есть условие бу­дет применяться к исходным записям, а не к уже отобранным.

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

Пример:

// Получение всех наиболее ранних записей регистра сведений

ВЫБРАТЬ * ИЗ РегистрСведений.КурсВал.СрезПервых()

// Получение всех наиболее ранних записей регистра сведений на

// указанную дату и по указанной валете.

ВЫБРАТЬ * ИЗ РегистрСведений.КурсВал.СрезПервых(&ПарДата, Вал = &ПарВал)



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