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


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

Пример:

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

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

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

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

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

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

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

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

КонецЦикла;

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

Синтаксис:

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

Параметры:

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

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



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

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

Описание:

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

Пример:

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

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

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

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

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

КонецЦикла ;

Получить ( Get )



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

Синтаксис:

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

Параметры:

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

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



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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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

Пример:

Курс.ПолучитьФорму().Открыть() ;

Прочитать ( Read ) 



Синтаксис:

Прочитать()

Описание:

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

Пример:

Курс.Прочитать()

Удалить ( Delete )



Синтаксис:

Удалить()

Описание:

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

Пример:

Курс.Удалить();

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»


Описание:

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

Пример:

НовыйКурс = НаборКурсов.Добавить();

Загрузить( Load )



Синтаксис:

Загрузить(<Таблица значений>)

Параметры:

<Таблица значений> Обязательный

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

Описание:

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

Пример:

НаборКурсов.Загрузить(ТаблКурсов) ;

ЗагрузитьКолонку ( LoadColumn )



Синтаксис:

ЗагрузитьКолонку (<Массив>, <Имя поля>)

Параметры:

<Массив> Обязательный

Тип: Массив. Массив, содержащий значения для заполнения ко­лонки набора.

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

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

Описание:

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

Пример:

НаборКурсов.ЗагрузитьКолонку(МассивКурсов, "Курс");

Записать ( Write )



Синтаксис:

Записать (< 3амещать> )

Параметры:

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

Тип: Булево. Замещать записи по установленному отбору. Если значение параметра Истина, то перед записью существующие записи будут удалены.

Значение по умолчанию: Истина.

Описание:

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



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

Синтаксис:

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

Параметры:

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

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

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

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

Описание:

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

Обороты ( Turnovers )

Синтаксис:

Обороты(<Начало периода> , <Конец периода> , <Отбор>, <Измерения>, <Ресурсы>)

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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



ЗагрузитьКолонку ( LoadColumn )



Синтаксис:

ЗагрузитьКолонку( <Массив> , <Имя поля>)

Параметры:

<Массив> Обязательный

Тип: Массив. Массив, содержащий значения для заполнения ко­лонки набора.

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

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

Описание:

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

Записать ( Write )



Синтаксис:

Записать(< Замещать> )

Параметры:

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

Тип: Булево. Замещать записи по установленному отбору.

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

Значение по умолчанию: Истина.

Описание:

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

Индекс ( IndexOf )



Синтаксис:

Индекс(< Запись>)

Параметры:

<3апись> Обязательный

Тип:    РегистрНакопленияЗапись.<Имя     регистра накопления>. Запись набора, для которой необходимо полу­чить индекс.

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

Тип: Число. Индекс записи в наборе.

Описание:

Позволяет определить индекс записи в наборе.

Итог ( Total )



Синтаксис:

Итог(<Имя поля>)

Параметры:

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

Тип: Строка. Имя поля записей набора, по которому необходи­мо подсчитать итог.

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

Тип: Число. Числовое значения результата вычисления.

Описание:

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

Количество ( Count )

Синтаксис:

Количество()

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

Тип: Число. Количество записей в наборе.

Описание:

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



Пример:

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

Отбор.Вставить("Товар", ТекТовар) ;

ГП = Последовательности.УчетТоваров.ПолучитьГраницу(Отбор);

ПолучитьГраницы ( GetBoundaries )



Синтаксис:

ПолучитьГраницы (< Разрез> , <Отбор> )

Параметры:

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

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

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

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

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

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

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

Описание:

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

Пример:

Отбор = Новый ТаблицаЗначений;

Отбор.Колонки.Добавить("Товар");

Разрез = "Товар";

Последов = Последовательности.УчетТоваров;

ТабГраницы = Последов.ПолучитьГраницы(Разрез, Отбор);

Принадлежит (Belong)



Синтаксис:

Принадлежит(< Документ>, <Отбор>)

Описание

<Документ> Обязательный

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

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

Тип: Структура. Структура, задающая отбор по измерениям последовательности. Ключ структуры определяет измерение по­следовательности, по которому будет осуществляться отбор, а значение структуры - значение измерения. Если измерение от­сутствует в структуре, то по нему отбор осуществляться не будет.



Пример:

Состав.Загрузить(ТаблицаСостава);

ЗагрузитьКолонку ( LoadColumn )

Синтаксис:

ЗагрузитьКолонку (< Массив>, <Колонка>)

Параметры:

<Массив> Обузательный

Тип: Массив. Массив значений для загрузки в колонку.

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

Тип: Число, Строка. Колонка, в которую будут загружены значения из массива.

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

Описание:

Загружает значения из массива в заданную колонку табличной части.

Примечание:

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

Пример:

Состав.ЗагрузитьКолонку(Товары, "Номенклатура") ;

Индекс ( IndexOf )

Синтаксис:

Индекс(< Строка>)

Параметры:

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

Тип: Строка табличной части- Строка табличной части, для которой необходимо получить индекс.

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

Тип: Число. Индекс строки.

Описание:

Получает индекс стоки в табличной части.

Пример:

ИндексТекСтроки = Состав.Индекс(ЭлементыФормы.Состав.ТекущаяСтрока);

Итог (Total)

Синтаксис:

Итог (<Колонка> )

Параметры:

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

Тип; Число, Строка. Индекс либо имя колонки, по которой подсчитывается итог.

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

Тип: Число.

Описание:

Суммирует значения всех строк в указанной колонке.

Примечание:

Имеет смысл для числовых значений.

Пример:

ВсегоПоДокументу = Сумма.Итог("Всего");

Количество ( Count )

Синтаксис:

Количество()

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

Тип: Число. Количество строк табличной части.

Описание:

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

Пример:

ВсегоСтрок = Состав.Количество();

Найти ( Find )



Синтаксис:

Найти(< Значение>, <Колонки>)

Параметры:

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

Тип: Произвольный. Искомое значение.

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

Тип: Строка. Список имен колонок, в которых будет осуществ­ляться поиск, разделенных запятыми.

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



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

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

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

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

Параметры:

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

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

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

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

Описание:

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

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



Синтаксис;

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

Параметры:

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

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

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

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

Описание:

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

Пример:

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

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

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

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

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



Синтаксис:

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

Параметры:

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



Пример:

НаборКурсов.Записать();

Индекс ( IndexOf )



Синтаксис:

Индекс(< Запись>)

Параметры:

<3апись> Обязательный

Тип: РегистрСведенийЗапись.<Имя регистра сведений>. Запись набора, для которой необходимо получить индекс.

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

Тип: Число. Индекс записи в наборе.

Описание:

Позволяет определить индекс записи в наборе.

Пример:

Если НовыйКурс. Индекс() =0 Тогда

    Сообщить("Это первая запись о курсе в наборе.");

КонецЕсли ;

Итог ( Total )



Синтаксис:

Итог(<Имя поля>)

Параметры:

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

Тип: Строка. Имя поля записей набора, по которому необходи­мо подсчитать итог.

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

Тип: Число. Числовое значения результата вычисления.

Описание:

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

Пример:

СреднийКурс = НаборКурсов.Итог("Курс") / НаборКурсов.Количество();

Сообщить("Средний курс " + СреднийКурс);

Количество ( Count )



Синтаксис:

Количество()

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

Тип- Число. Количество записей в наборе.

Описание:

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

Пример:

Для Сч = 0 По НаборКурсов. Количество () -1 Цикл

    ДатаКурса = НаборКурсов(Сч].Период;

    ТекКурс    = НаборКурсов[Сч]-Курс;

    Сообщить ("Курс на " + ДатаКурса + " - "+ ТекКурс + " руб.");

КонецЦикла;

Модифицированность ( Modified )

Синтаксис:

Модифицированность()

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

Тип: Булево. Истина - записи изменены.

Ложь - записи не изменены.

Описание:

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

Примечание:

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

Пример:

Если НаборКурсов.Модифицированность () Тогда НаборКурсов.Записать();

КонецЕсли;

Очистить ( Clear )



Значение по умолчанию: Пустая строка.

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

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

Если параметр не указан или указана пустая строка, то обороты будут сформированы по всем ресурсам.

Значение по умолчанию: Пустая строка.

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

Тип: ТаблицаЗначений. Сформированная таблица значений.

Описание:

Позволяет получить обороты регистра накопления за заданный момент времени. Есть возможность фильтрации по значениям измерений. Возвращает таблицу значений, содержащую колонки с измерениями, указанными в параметре Измерения, и по две ко­лонки на каждый ресурс, указанный в параметре Ресурсы. На звания колонок для ресурсов формируются следующим образом "<Имя ресурса>Приход" и "<Имя ресурса>Расход".

Пример:

ОстаткиМПЗ = РегистрыНакопления.ОстаткиМПЗ;

ФильтрМПЗ   =  Новый Структура("Номенклатура","Склад");

ФильтрМПЗ.Номенклатура = ВыбМПЗ;

ФильтрМПЗ.Склад        = ВыбСклад;

ТабОборотов = ОстаткиМПЗ.Обороты(ДатаНач, ДатаКон, ФильтрМПЗ, "Номенклатура,Склад", "Количество") ;

Остатки ( Balance )

Синтаксис:

Остатки(< Момент времени> , <Отбор>, <Измерения>, <Ресурсы>)

Параметры:

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

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

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

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

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



Пример:

Сообщить(" Записей в наборе - " + НаборЗаписейМПЗ. Количество());

Модифицированность ( Modified )



Синтаксис:

Модифицированность()

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

Тип: Булево. Истина - если записи изменены.

Ложь - если записи не изменены.

Описание:

Позволяет определить, были ли изменены записи в наборе.

Пример:

Если НаборЗаписейМПЗ.Модифицированность() Тогда НаборЗаписейМПЗ.Записать();

КонецЕсли;

Очистить ( Clear )



Синтаксис:

Очистить()

Описание:

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

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



Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип Форма.

Описание:

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

Прочитать ( Read )

Синтаксис:

Прочитать()

Описание:

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

Пример:

ОстаткиМПЗ = РегистрыНакопления.УчетНоменклатуры;

НаборЗаписейМПЗ ОстаткиМПЗ.СоздатьНаборЗаписей();

Док = НаборЗаписейМПЗ.Отбор.Регистратор;

Док.Установить(ВыбДок);

НаборЗаписейМПЗ.Прочитать();

Сдвинуть ( Move )



Синтаксис:

Сдвинуть(< Запись>, <Смещение>)



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

Тип: Булево.

Описание:

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

Пример:

Отбор = Новый Структура;

Отбор.Вставить("Товар", ТекТовар);

Принадлежит = Последовательности.УчетТоваров.Принадлежит(Док, Отбор);

Проверить ( Validate )



Синтаксис:

Проверить(<Момент времени>, <Отбор>)

Параметры:

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

Тип: Дата, Момент Времени. Момент времени, по который проверяется последовательность.

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

Тип: Структура. Структура, задающая отбор по измерениям последовательности. Ключ структуры определяет измерение последовательности, по которому будет осуществляться отбор, а значение структуры - значение измерения.

Если измерение отсутствует в структуре, то по нему отбор осуще­ствляться не будет.

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

Тип: Булево. Истина - последовательность не нарушена, Ложь - последовательность нарушена.

Описание:

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

Пример:

Момент = Новый МоментВремени(Док.Дата, Док.Ссылка);

Отбор = Новый Структура;

Отбор.Вставить("Товар", Товар) ;

Непрерывна = Последовательности.УчетТоваров.Проверить(Момент, Отбор) ;

УстановитьГраницу ( SetBoundary )



Синтаксис:

УстановитьГраницу (< Момент времени> , <Отбор>)

Параметры:

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

Тип: МоментВремени, Дата. Момент времени, на который устанавливается граница последовательности.

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

Тип: Структура. Структура, задающая отбор по измерениям последовательности. Ключ структуры определяет измерение по­следовательности, по которому будет осуществляться отбор, а значение структуры - значение измерения.

Описание:

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

Пример:

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

Отбор.Вставить("Товар", ТекТовар) ;

Последовательности.УчетТоваров.УстановитьГраницу(ТекМомент, Отбор) ;



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

Тип: Строка табличной части. Строка, которая содержит искомое значение. Если значение не найдено возвращает значение Неопределено

Описание:

Позволяет найти значение в указанных колонках табличной час­ти. Если список колонок пуст, поиск осуществляется по всей таб­личной части.

Примечание:

Метод эффективно использовать для поиска уникальных значе­ний.

Пример:

НайдСтрока = Состав.Найти(ТекТовар, "Номенклатура');

Если НайдСтрока = Неопределено Тогда

Предупреждение("Товар не найден !");

Иначе

    Количество = НайдСтрока.Количество;

КонецЕсли;

НайтиСтроки ( FindRows )



Синтаксис:

НайтиСтроки (< Параметры отбора>)

Параметры:

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

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

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

Тип: Массив. Массив из строк табличной части, соответствую­щих заданному условию поиска.

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

Описание:

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

Примечание:

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

Пример:

ПараметрыОтбора = Новый Структура;

ПараметрыОтбора.Вставить("Номенклатура", ТекТовар);

НайдСтроки = Состав.НайтиСтроки(ПараметрыОтбора);

Очистить ( Clear )



Синтаксис:

Очистить ()

Описание:

Удаляет все строки табличной части.

Пример:

Состав.Очистить();

Свернуть ( GroupBy )



Синтаксис:

Свернуть(<Колонки группировок, <Колонки суммирования>)

Параметры:

<Колонки группировок>  Обязательный

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

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

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



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

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

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

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

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

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

Описание:

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

Пример:

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

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

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

Синтаксис:

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

Параметры;

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

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

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

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

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



Синтаксис:

Очистить()

Описание;

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

Пример:

НаборКурсов.Очистить();

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



Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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

Пример:

НаборКурсов.ПолучитьФорму("ФормаНабораЗаписей").Открыть();

Прочитать ( Read )

Синтаксис:

Прочитать()

Описание:

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

Пример:

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

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

НаборКурсов.Прочитать();

Сдвинуть ( Move )



Синтаксис:

Сдвинуть(< Запись>, <Смещение>)

Параметры:

<3апись> Обязательный

Тип: Число, РегистрСведенийЗапись.<Имя регистра сведений>. Индекс сдвигаемой записи либо сама запись.

<Смещение> Обязательный

Тип: Число. Количество позиций, на которое следует сдвинуть запись. Положительное значение соответствует смещению записи в сторону конца списка записей набора (увеличение индекса), отрицательное - к началу.

Описание:

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



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

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

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

Если параметр не указан или указана пустая строка, то остатки будут сформированы по всем измерениям.

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

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

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

Если параметр не указан или указана пустая строка, то остатки будут сформированы по всем ресурсам.

Значение по умолчанию: Пустая строка.

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

Тип: ТаблицаЗначений. Сформированная таблица значений.

Описание:

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

Замечание! Использование данного метода имеет смысл толь­ко для регистров, у которых в конфигураторе указан вид регистра "Остатки".

Пример:

ОстаткиМПЗ = РегистрыНакопления.ОстаткиМПЗ;

ФигьтрМПЗ    = Новый Структура() ;

ФильтрМПЗ.Вставить("Номенклатура",ВыбМПЗ);

ФильтрМПЗ.Вставить("Склад", ВыбСклад) ;

ТабОстатков = ОстаткиМПЗ. Остатки (ВыбДата, ФильтрМПЗ, "Номенклатура,Склад", "Количество") ;

ПересчитатьИтоги ( RecalcTotals )

Синтаксис:

ПересчитатьИтоги()

Описание:

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

Пример:

Регистры.ОстаткиМПЗ.ПересчитатьИтоги();

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

Синтаксис:

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

Параметры:

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

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



Параметры:

<3апись> Обязательный

Тип:     Число,     РегистрНакопленияЗапись.<Имя регистра накопления>. Индекс сдвигаемой записи либо сама запись.

<Смещение> Обязательный

Тип" Число. Количество позиций, на которое следует сдвинуть запись. Положительное значение соответствует смещению записи в сторону конца списка записей набора (увеличение индекса), отрицательное - к началу.

Описание:

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

Удалить ( Remove )

Синтаксис:

Удалить (< Запись> )

Параметры:

<3апись> Обязательный

Тип.     Число,     РегистрНакопленияЗапись.<Имя регистра накопления>. Индекс удаляемой записи либо сама запись.

Описание:

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

УстановитьАктивность ( SetActive )

Синтаксис:

УстановитьАктивность(< Активность> )

Параметры:

<Активность> Обязательный

Тип: Булево. Истина - записи учитываются в итогах регист­ра.

Ложь - записи не учитываются в итогах регистра.

Описание:

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

Пример:

НаборЗаписейМПЗ.УстановитьАктивность(Истина);



Описание:

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

Важно! Оба списка колонок должны покрывать всю табличную часть. Списки колонок не должны пересекаться.

Пример:

Состав.Свернуть("Номенклатура", "Количество, Сумма, Всего"');

Сдвинуть ( Move )



Синтаксис:

Сдвинуть(< Строка>, <Смещение>)

Параметры:

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

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

<Смещение> Обязательный

Тип: Число. Количество строк, на которое необходимо перемес­тить строку. Положительное значение означает, что строка будет передвинута ближе к концу табличной части (вниз), отрицатель­ное - ближе к началу (вверх).

Описание:

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

Пример:

// сдвиг 2-й строки на предыдущую позицию

Состав.Сдвинуть(1, -1);

// сдвиг 2-й строки на следующую позицию

Состав.Сдвинуть(1, 1);

Удалить ( Remove )



Синтаксис:

Удалить(< Индекс>)

Параметры:

<Индекс> Обязательный

Тип: Число, Строка табличной части. Индекс удаляемой строки в табличной части, либо сама удаляемая строка.

Описание:

Удаляет строку с указанным индексом из табличной части.

Пример:

Состав.Удалить(3);


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