Методы


Пустая ( IsEmpty )

Синтаксис:

Пустая()

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

Тип: Булево. Истина, если ссылка не указывает ни на какое значение, Ложь, если ссылка указывает на какое-либо значение перечисления.

Описание:

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

Пример:

ВидКонтаргента = Контрагент.Вид;

Если ВидКонтаргента.Пустая() Тогда

Сообщить(" +Контрагент + ". Неизвестный вид контрагента!");

КонецЕсли;


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

Синтаксис:

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



Параметры:

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

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

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

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

Описание:

Позволяет получить макет отчета.

Пример:

МакетОтчета = Отчеты.ОстаткиНоменклатуры.ПолучитьМакет("Основной");

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип:Форма.

Описание:

Позволяет получить форму отчета.

Пример:

ФормаОтчета = Отчеты.Продажи.ПолучитьФорму();

Создать ( Create )

Синтаксис:

Создать()

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

Тип: ОтчетОбъект.<Имя отчета>. Объект отчета.

Описание:

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

Пример:

ОтчетОстаткиНоменклатуры = Отчеты.ОстаткиНоменклатуры.Создать();




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

Синтаксис:

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

Параметры:

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

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

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

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

Описание:

Позволяет получить макет отчета.

Пример:

ОтчетОПродажах = Отчеты.Продажи.Создать();

МакетОтчета = ОтчетОПродажах.ПолучитьМакет ("Продажи") ;

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

Позволяет получить форму отчета.

Пример:

ОтчетОПродажах = Отчеты.Продажи.Создать();

ФормаОтчета = ОтчетОПродажах.ПолучитьФорму();




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

Синтаксис:

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

Параметры:

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

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

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

Тип: ТабличныйДокумент. Макет обработки.

Описание:

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

Пример:

ИдМакета = "ОбработкаДокументов";

МакетОбр = Обработки.ОбработкаДокументов.ПолучитьМакет(ИдМакета);

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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

Пример:

ИдФормы = "ОсновнаяФорма";

ФормаОбр = Обработки. ОбработкаДокументов. ПолучитьФорму( ИдФормы);

Создать ( Create )

Синтаксис:

Создать()

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

Тип: ОбработкаОбъект. <Имя обработки>. Объект обра­ботки.

Описание:

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

Пример:

ОбработкаДокументов = Обработки.ОбработкаДокументов.Создать();




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

Синтаксис:

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

Параметры:

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

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

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

Тип: ТабличныйДокумент. Макет обработки.

Описание:

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

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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




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

Синтаксис:

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

Параметры:

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

Тип: Строка. Путь к файлу внешней обработки.

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

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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

Создать ( Create )

Синтаксис:

Создать(<Полное имя файла>)

Параметры:

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

Полное имя файла внешней обработки.

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

Тип: ВнешняяОбработка. Объект внешней обработки.

Описание:

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




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

Синтаксис:

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

Параметры:

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

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

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

Тип: ТабличныйДокумент. Макет внешней обработки.

Описание:

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

Пример:

МакетОбработки = ВнешОбработка. ПолучитьМакет("Шаблон");

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

будет искаться уже открытая форма.

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

Тип: Форма.

Описание:

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

Пример:

ФормаОбработки = ВнешОбработка.ПолучитьФорму("ТлавнаяФорма");

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




Выбрать ( Select )

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

Синтаксис;

Выбрать{<Начало интервала> , <Конец интервала> , <Отбор>)

Параметры:

<Начало интервала» Необязательный

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

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

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

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

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

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

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

Важно! Структура может содержать только один элемент.

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

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

Выбрать(< Отбор>)

Параметры:

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

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

Важно! Структура может содержать только один элемент. Значение по умолчанию: Неопределено.

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

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

Описание:




ПолучитьМенеджерЗаписи(GetRecorderManager)

Синтаксис:

ПолучитьМенеджерЗаписи()

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

Тип: РегистрСведенийМенеджерЗаписи.<Имя регистра сведений>. Менеджер записи регистра сведений.

Описание:

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

Следующий ( Next )

Синтаксис:

Следующий()

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

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

достигнут конец выборки.

Описание:

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

Пример:

// найдем максимальную цену у конкурентов на товар ВыбТовар

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

ОтборПоТовару = Новый Структура("Номенклатура");

ОтборПоТовару.Номенклатура = ВыбТовар;

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

МаксЦена = 3;

Конкурент = "Не найден";

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

    Если ЦеныТовара.Цена > МаксЦена Тогда МаксЦена = ЦеныТовара.Цена;

        Конкурент = ЦеныТовара.Конкурент;

     КонецЕсли;

КонецЦикла;

Предупреждение("Максимальня цена " + СокрЛП(ВыбТовар) + " = " + МаксЦена + " руб. у  " + СокрЛП (Конкурент) + ".");




МоментВремени ( PointOfTime )

Синтаксис:

МоментВремени()

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

Тип: МоментВремени.

Описание:

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




ЗаписатьВФорме ( WritelnForm )

Синтаксис:

ЗаплсатьВФорме()

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

Тип: Булево. Истина - объект записан.

Ложь - нет.

Описание:

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

Пример:

Если ЗаписатьВФорме() Тогда

Сообщить("Запись занесена в ИБ.");

КонецЕсли;




ЗаписатьВФорме ( WritelnForm )

Синтаксис:

ЗаписатьВФорме()

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

Истина - объект записан. Ложь - нет.

Описание:

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

Пример:

Если ЗаписатьВФорме() Тогда

Сообщить("Объект записан.') ;

КонецЕсли;




Выбрать ( Select )

Синтаксис:

Выбрать(<Начало интервала> , <Конец интервала> , <Отбор>)

Параметры:

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

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

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

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

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

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

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

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

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

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

Важно! Структура может содержать только один элемент.

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

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

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

Описание:

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

Пример:

// Посчитаем, сколько отгружено с начала года

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

ОтборПоТовару = Новый Структура("Номенклатура");

ОтборПоТовару.Номенклатура = ВыбТовар;

НачДата = НачалоГода(ТекущаяДата()) ;

КонДата = ТекущаяДата() ;

ВыборкаМПЗ = МПЗ.Выбрать(НачДата,КонДата,ОтборПоТовару);

Расход =0;

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

    Если ВыборкаМПЗ.Расход Тогда

        Расход = Расход + ВыборкаМПЗ.Количество;

    КонецЕсли;

КонецЦикла ;

Предупреждение("Отгружено с начала года " + СокрЛП(ВыбТовар) + " = "+ Расход + " шт.");




Следующий ( Next )

Синтаксис:

Следующий()

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

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

Ложь- запись не выбрана - достигнут конец выборки.

Описание:

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




Обновить ( Refresh )

Синтаксис:

Обновить()

Описание:

Вызывает перечитывание данных списка.




Вставить ( Insert )

Синтаксис:

Вставить(<Индекс>)

Параметры:

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

Тип: Число. Индекс позиции, на которую надо вставить новую запись.

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

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

Описание:

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

Выбран ( Selected )

Синтаксис:

Выбран()

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

Тип: Булево. Истина, если считан.

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

Описание:

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

Примечание:

При изменении отбора считается, что набор перестает быть счи­танным.

Выгрузить ( Unload )

Синтаксис:

Выгрузить()

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

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

Описание:

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

ВыгрузитьКолонку ( UnloadColumn )

Синтаксис:

ВыгрузитьКолонку(< Имя поля>)

Параметры:

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

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

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

Тип: Массив. Сформированный массив значений.

Описание:

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

Добавить( Add )

Синтаксис:

Добавить()

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

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

Описание:

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

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

Синтаксис:

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

Параметры:

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

Тип: ТаблицаЗначений. Таблица значений, содержащая данные для заполнения набора записей.

Описание:

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




МоментВремени ( PointOfTime )

Синтаксис:

МоментВремени()

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

Тип: МоментВремени.

Описание:

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




ЗаписатьВФорме ( WritelnForm )

Синтаксис:

ЗаписатьВФорме()

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

Тип: Булево. Истина - объект записан.

Ложь - нет.

Описание:

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

Пример:

Если ЗаписатьВФорме() Тогда

Сообщить("Объект записан.");

КонецЕсли;




Найти ( Find )

Синтаксис:

Найти(<Значение поиска> )

Параметры:

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

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

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

Тип: Массив. Массив ссылок на объекты, в которых использует­ся указанное значение отбора.

Описание:

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

Примечание:

Состав объектов метаданных, входящих в состав отбора, задается при конфигурировании.

Пример:

МассивСсылок = КритерииОтбора.Контрагенты.Найти(ВыбКонтрагент);

Для Каждого Ссылка Из МассивСсылок Цикл Сообщить(Ссылка);

КонецЦикла;

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

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

Тип: Форма.

Описание:

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




Вставить ( Insert )

Синтаксис:

Вставить{<Индекс>)

Параметры:

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

Тип: Число. Индекс позиции, на которую надо вставить новую запись.

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

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

Описание:

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

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

Пример:

НоваяЦена = НаборЦенКонкурентов.Вставить(0);

Выбран ( Selected )

Синтаксис:

Выбран()

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

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

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

Описание:

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

Примечание:

При изменении отбора считается, что набор перестает быть счи­танным.

Пример:

Если Не НаборКурсов.Выбран() Тогда НаборКурсов.Прочитать() ;

КонеиЕсли;

Выгрузить ( Unload )

Синтаксис:

Выгрузить()

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

Тип: ТаблицаЗначений. Созданная таблица значений.

Описание:

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

Пример:

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

ВыгрузитьКолонку( UnloadColumn )

Синтаксис:

ВыгрузитьКолонку(<Имя поля>)

Параметры:

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

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

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

Тип: Массив. Сформированный массив значений.

Описание:

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

Пример:

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

Добавить ( Add )

Синтаксис:

Добавить()

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

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




ПолучитьОбъекг ( GetObject )

Синтаксис:

ПолучитьОбъект()

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

Тип: ДокументОбъект.<Имя документа>.

Описание:

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

Следующий ( Next )

Синтаксис:

Следующий()

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

Тип: Булево. Возвращает значение Истина, если получен сле­дующий документ из выборки, и Ложь - если не получен (вы­борка документов завершена).

Описание:

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




Обновить ( Refresh )

Синтаксис:

Обновить()

Описание:

Вызывает перечитывание данных списка из базы данных.




ЗаписатьВФорме ( WritelnForm )

Синтаксис:

ЗаписатьВФорме()

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

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

противном случае.

Описание:

Записывает документ, открытый в данный момент в форме.

См. также:

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




Выбрать ( Select )

Синтаксис:

Выбрать(<Дата начала>, <Дата окончания>}

Параметры:

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

Тип: Дата. Дата и время начала периода выборки документов.

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

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

Тип: Дата. Дата окончания периода выбираемых документов.

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

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

Тип: Документ Выборка. <Имя документа>.

Описание:

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

Пример:

ВыборкаИзЖурнала = ЖурналыДокументов.Торговля.Выбрать(, РабочаяДата);

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

Синтаксис:

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

Параметры:

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

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

Описание:

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

Пример:

МакетРеестра = ЖурналыДокументов.Общий.ПолучитьМакет("Реестр");

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

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

будет искаться уже открытая форма.

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

Тип: Форма.

Описание;

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

Пример:

ФормаЖурнала = ЖурналыДокументов .Общий.ПолучитьФорму();




ПолучитьОбъект ( GetObject )

Синтаксис:

ПолучитьОбъект()

Описание:

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

Следующий ( Next )

Синтаксис:

Следующий()

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

Возвращает значение Истина, если получен следующий доку­мент из выборки, и Ложь - если не получен (выборка докумен­тов завершена).

Описание:

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




Обновить ( Refresh )

Синтаксис:

Обновить()

Описание:

Вызывает перечитывание данных списка.




Обновить ( Refresh )

Синтаксис:

Обновить()

Описание:

Вызывает перечитывание данных списка.




Выбран ( Selected )

Синтаксис:

Выбран()

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

Истина - если запись считана, Ложь - запись не считана.

Описание:

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

Пример:

Если Не Курс.Выбран() Тогда

    Предупреждение("Курс не считан");

КонецЕсли;

Записать ( Write )

Синтаксис:

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

Параметры:

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

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

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

Описание:

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

Пример:

Курс. Записать(1) ;

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

Синтаксис:

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

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

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

Описание:

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

Примечание:

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

Пример:

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

    Курс.Записать();

КонецЕсли;

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

Синтаксис:

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

Параметры:




Восстановить ( Restore )

Синтаксис:

Восстановить (< Момент времени>, <Последовательности>)

Параметры:

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

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

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

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

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

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

Описание:

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

Пример:

ТабПоследовательностей = Новый ТаблицаЗначений;

ТабПоследовательностей.Колонки.Добавить("ИмяПоследовательности");

ТабПоследовательностей.Колонки.Добавить("НаборКомбинаций") ;

ПустаяТаблица = Новый ТаблицаЗначений;

Стр = ТабПоследовательностей.Добавить();

Стр.ИмяПоследовательности = "УчетТоваров" ;

Стр.НаборКомбинаций = ПустаяТаблица;

Последовательности.Восстановить(РабочаяДата, ТабПоследовательностей);




Восстановить ( Restore )

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

Пример:

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

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

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

Отбор.Добавить().Товар = Товар;

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

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

Синтаксис:

ПолучитьГраницу (< Отбор> )

Параметры:

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

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

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

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

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

Тип: МоментВремени. Момент времени, соответствующий ми­нимальной границе последовательности.

Описание:

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




Добавить ( Add )

Синтаксис:

Добавить()

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

Тип: ПоследовательностьЗапись.<Имя последовательности>. Запись регистрации документа в по­следовательности.

Описание:

Добавляет новую запись регистрации документа в набор.

Записать ( Write )

Синтаксис:

Записать()

Описание:

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

Индекс ( IndexOf )

Синтаксис:

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

Параметры:

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

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

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

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

Описание:

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

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

Синтаксис:

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

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

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

Описание:

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

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

Синтаксис:

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

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

Тип: Булево.

Описание:

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

Очистить ( Clear )

Синтаксис:

Очистить()

Описание:

Удаляет все записи регистрации из набора.

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

Синтаксис:

Прочитать()

Описание:

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

Удалить ( Remove )

Синтаксис:

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

Параметры:

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

Тип: Число или ПоследовательностьЗапись. Удаляемая из набора запись. Может быть указан индекс записи в наборе или сама запись.

Описание:

Удаляет указанную запись регистрации документа из набора.

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




Сравнить (Compare)

Синтаксис:

Сравнить(<Момент времени>)

Параметры:

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

Тип: МоментВремени. Момент времени, с которым производит­ся сравнение.

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

Тип: Число. -1 - если момент времени меньше момента времени, с которым выполняется сравнение, 0 - если момент времени ра­вен моменту времени, с которым выполняется сравнение, 1 - если момент времени больше момента времени, с которым выполняет­ся сравнение.

Описание:

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

Пример:

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

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

Если Момент1.Сравнить(Момент2) = -1 Тогда Момент1 = Момент2;

КонецЕсли;



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