Позволяет сформировать выборку записей регистра
Позволяет сформировать выборку записей регистра сведений.
Пример:
Курсы = РегистрыСведений.КурсыВалют;
ОтборВалют = Новый Структура("Валюта");
ОтборВалют.Валюта = ВыбВалюта;
ВыборкаКурсовВалют = Курсы.Выбрать(,,ОтборВалот);
Пока ВыборкаКурсовВалот.Следующий() Цикл
Сообщить("Дата " + ВыборкаКурсовВалот.Период *
" Валюта "+СокрЛП(ВыборкаКурсовВалст.Валюта) +
", Курс "+ ВыборкаКурсовВалют.Курс );
КонецЦикла;
ВыбратьПоРегистратору ( 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);
