{ИмяРегистраСведений}.НаборЗаписей
{ИмяРазработчика}::{ИмяПроекта}::{ИмяПодсистемы}::{ИмяРегистраСведений}.НаборЗаписей Доступность: Сервер
Набор записей предназначен для записи и чтения из БД набора записей со значениями измерений соответствующими установленному фильтру (см. свойство Фильтр).
Порядок следования записей в наборе не сохраняется между записью и последующим чтением из БД.
Пример
метод ОчиститьРегистр(ЗагруженныеЗаписи: Обходимое<ЦеныТоваров.Запись>)
знч НаборЗаписей = новый ЦеныТоваров.НаборЗаписей()
НаборЗаписей.Фильтр.Установить(Период = Дата.Сейчас())
НаборЗаписей.ДобавитьВсе(ЗагруженныеЗаписи)
НаборЗаписей.Записать()
;
Сравнение ссылочное
Иерархия типа
Базовые типы: ИзменяемаяКоллекция<ItemType>, ИзменяемыйМассив<ItemType>, Коллекция<ItemType>, Массив<ИмяРазработчика::ИмяПроекта::ИмяПодсистемы::ИмяРегистраСведений.Запись>, Обходимое<ItemType>, Объект, Стд::РегистрыСведений::РегистрСведений.НаборЗаписей, Стд::Сущности::Сущность.НаборЗаписей, ЧитаемаяКоллекция<ItemType>, ЧитаемыйМассив<ItemType>, ЧитаемыйМассив<Стд::Сущности::Сущность.Запись>
Конструкторы
{ИмяРегистраСведений}.НаборЗаписей
Доступность: Сервер
ИмяРегистраСведений.НаборЗаписей()Свойства
Фильтр
Доступность: Сервер
ТолькоЧтение
Свойство унаследовано от базового типа, только уточнён тип.
Переопределение: Фильтр
Методы
ДобавитьЗапись
Версия 8.0 и выше
Доступность: Сервер
@ИменованныеПараметры
ДобавитьЗапись(
<Измерение1>: <ТипИзмерения1> = <ЗначениеПоУмолчаниюИзмерения1>,
....<ИзмерениеN>: <ТипИзмеренияN> = <ЗначениеПоУмолчаниюИзмеренияN>,
<Ресурс1>: <ТипРесурса1> = <ЗначениеПоУмолчаниюРесурса1>,
...<РесурсN>: <ТипРесурсаN> = <ЗначениеПоУмолчаниюРесурсаN>,
<Реквизит1>: <ТипРеквизита1> = <ЗначениеПоУмолчаниюРеквизита1>,
....<РеквизитN>: <ТипРеквизитаN> = <ЗначениеПоУм олчаниюРеквизитаN>)Вызов возможен только с именованными параметрами
Добавляет в набор новую запись и заполняет значения её измерений (и стандартного поля Период, если оно есть) в соответствии с установленным в наборе записей фильтром и переданными значениями.
Если фильтр не инициализирован (см. описание свойство Инициализирован в фильтре набора записей регистра сведений) - будет выдана ошибки о неиницализированности фильтра.
Добавленная запись возвращается в качестве результата вызова.
ДобавитьЗапись
Версия 7.0 и ниже
Доступность: Сервер
@ИменованныеПараметры
ДобавитьЗапись(
Период: Дата,
ИмяИзмерения: ИнформационныеСистемы.Ссылка?,
ИмяРесурса: Число,
ИмяРеквизита: Строка
): {ИмяРегистраСведений}.ЗаписьЗаписать
Доступность: Сервер
Записать(Замещать: Булево = Истина)Записать(Замещать: Булево = Истина, ПараметрыЗаписи: ИмяРегистраСведений.ПараметрыЗаписи)
Записывает набор записей в базу данных.
Если фильтр не инициализирован (см. описание свойство Инициализирован в фильтре набора записей регистра сведений) - будет выдана ошибки о неиницализированности фильтра.
При наличии в наборе записей не соответствующих фильтру - будет выдана ошибка о несоответствии записи фильтру.
При наличии в наборе записей с одинаковыми ключами записей - будет выдана ошибка о нарушении уникальности записей.
Если значение параметра Замещать = Истина, перед записью из таблицы базы данных будут удалены все записи соответствующие фильтру (если фильтр пустой, но инициализированный - из таблицы будут удалены вообще все записи).
Если значение параметра Замещать = Ложь, новые записи будут дописываться к существующим. Если при этом будет обнаружено нарушение уникальности записей в таблице базы данных - будет выдана ошибка о нарушении уникальности записей. При этом если вызов выполнялся в объемлющей транзакции - транзакция становится непригодной для продолжения работы.
После записи в режиме Замещать = Ложь набор записей очищается.
Записать
Доступность: Сервер
Записать(
Замещать: Булево = Истина,
ПараметрыЗаписи: {ИмяРегистраСведений}.ПараметрыЗаписи)Записать(Замещать: Булево = Истина)
{ИмяРегистраСведений}.НаборЗаписей
Версия 8.0 и выше
Доступность: Сервер
ИмяРегистраСведений.НаборЗаписей()ПередЗаписью
Версия 8.0 и выше
Доступность: Сервер
ПередЗаписью(Замещать: Булево)Замещать соответствуют значению переданному при вызове метода Записать.
Примеры
Подписка на событие, объявленная в общем модуле
@Подписка(Событие{ЦеныТоваров.НаборЗаписей.ПередЗаписью})
метод ПодпискаПередЗаписью(Источник: ЦеныТоваров.НаборЗаписей.Данные,
Заменить: Булево,
Параметры: ЦеныТоваров.ПараметрыЗаписи)
// Обработка события
;
ПослеЗаписи
Версия 8.0 и выше
Доступность: Сервер
ПослеЗаписи(Замещать: Булево)Замещать соответствуют значению переданному при вызове метода Записать.
Примеры
Подписка на событие, объявленная в общем модуле
@Подписка(Событие{ЦеныТоваров.НаборЗаписей.ПослеЗаписи})
метод ПодпискаПослеЗаписи(Источник: ЦеныТоваров.НаборЗаписей.Данные,
Заменить: Булево,
Параметры: ЦеныТоваров.ПараметрыЗаписи)
// Обработка события
;
Список унаследованных методов
ИзменяемаяКоллекция
Очистить, Удалить, УдалитьВсе, УдалитьКроме
ИзменяемыйМассив
ВставитьНовый, ДобавитьНовый, Перевернуть, Удалить, УдалитьДиапазон, УдалитьПоИндексу
Коллекция
Массив
Вставить, ВставитьВсе, Установить
Обходимое
ВМассив, ВСоответствие, ВСоответствиеСКлючами, ВСоответствиеСоЗначениями, ВоМножество, ВсеСоответствуют, ГруппироватьПо, ГруппироватьПо, ГруппироватьПо, ДляКаждого, ЕдинственныйИлиНеопределено, ЕдинственныйИлиУмолчание, ЕдинственныйИлиУмолчание, ЕстьСоответствия, КакПоследовательность, Максимум, МаксимумПо, Минимум, МинимумПо, НетСоответствий, Объединить, Первый, ПервыйИлиНеопределено, ПервыйИлиУмолчание, ПервыйИлиУмолчание, ПотомСортироватьПо, Преобразовать, ПреобразоватьЛинейно, Пусто, Свернуть, Свернуть, Соединить, Сортировать, Сортировать, СортироватьПо, Среднее, СреднееИлиУмолчание, Сумма, Уникальные, УникальныеПо, Фильтровать, ФильтроватьПоТипу
Объект
ВСтроку, ПолучитьТип, Представление
РегистрСведений.НаборЗаписей
ЧитаемаяКоллекция
Единственный, Размер, Содержит, СодержитВсе
ЧитаемыйМассив
Граница, Найти, НайтиСКонца, ПодМассив, Получить, Последний, СодержитВсе