Методы
Синтаксис:
Выбрать(<Родитель>, <Владелец>, <Отбор>, <Порядок>)
Параметры:
<Родитель> Необязательный
Тип: СправочникСсылка. <Имя справочникам Отбор по родителю. Имеет смысл только для многоуровневых справочников. Если параметр не задан или установлен в Неопределено, то отбор по родителю не производится. Чтобы отобрать элементы верхнего уровня, нужно в качестве данного параметра указать пустую ссылку на элемент справочника.
Значение по умолчанию: Неопределено.
<Владелец> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Отбор по владельцу. Имеет смысл только для подчиненных справочников. Если параметр не задан или установлен в Неопределено, то отбор по владельцу не производится.
Значение по умолчанию: Неопределено.
<Отбор> Необязательный
Тип: Структура. Задает поле и значение отбора открываемой выборки. Ключ структуры описывает имя поля, а значение структуры - значение отбора по этому полю. В качестве полей для отбора могут задаваться только поле Код, Наименование и реквизиты справочника для которых в конфигураторе признак индексирования установлен в значение "Индексировать" или в значение "Индексировать с доп. упорядоч.".
Важно! Структура может содержать только один элемент.
Значение по умолчанию: Неопределено.
<Порядок> Необязательный
Тип: Строка. Строка с именем реквизита справочника, определяющая упорядочивание элементов в выборке. Может быть указано "Код", "Наименование" или имя одного из реквизитов примитивного типа (число, строка, дата, булево), для которого установлен признак "Индексирование" в значение "Индексировать" или в "Индексировать с доп. упорядоч." в конфигураторе. После имени реквизита через пробел может быть указано направление сортировки. Направление определяется: "Убыв" (" Desc") - упорядочивать по убыванию; "Возр" (" Asc") - упорядочивать по возрастанию. По умолчанию сортировка производится по возрастанию. Если параметр не указан, то порядок определяется основным представлением справочника.
Значение по умолчанию:
Пустая строка.
Возвращаемое значение:
Тип: СправочникВыборка. <Имя справочника>. Полученная выборка.
Описание:
Позволяет получить выборку элементов справочника по заданным условиям.
Пример:
МПЗ = Справочники.Номенклатура;
ОтборМПЗ = Новый Структура("ТипНоменклатуры");
Пусто = Перечисления.ТипыНоменклатуры.ПустаяСсылка();
ОтборМПЗ.ТипНоменклатуры = Пусто;
ВыборкаМПЗ = МПЗ.Выбрать(,,ОтборМПЗ, "Наименование Убыв");
Пока ВыборкаМПЗ.Следующий() Цикл
Объект = ВыборкаМПЗ.ПолучитьОбъект();
Объект.ТипНоменклатуры = Перечисления.ТипыНоненклатуры.Товар;
Попытка
Объект.Записать();
Исключение
Предупреждение("Не удалось записать объект " + Объект + "|" + ОписаниеОиибки(),60);
КонецПопытки ;
КонецЦикла ;
ВыбратьИерархически ( SelectHierarchicaly )
Синтаксис;
ВыбратьИерархически (< Родитель> , <Владелец>, <Отбор>, <Порядок>)
Параметры:
<Родитель> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Отбор по родителю. Имеет смысл только для многоуровневых справочников. Если параметр не задан или установлен в Неопределено, то отбор по родителю не производится.
Значение по умолчанию: Неопределено.
<Владелец> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Отбор по владельцу. Имеет смысл только для подчиненных справочников. Если параметр не задан или установлен в Неопределено, то отбор по владельцу не производится.
Значение по умолчанию: Неопределено.
<Отбор> Необязательный
Тип: Структура. Структура, в которой указывается поле отбора и значение отбора. Могут задаваться только Код, Наименование и реквизиты справочника, для которых в конфигураторе признак индексирования установлен в значение "Индексировать" или в значение "Индексировать с доп. упорядоч.".
Важно! Структура может содержать только один элемент
Значение по умолчанию: Неопределено.
<Порядок> Необязательный
Тип: Строка. Строка с именем реквизита справочника, определяющая упорядочивание элементов в выборке.
Может быть указан "Код", "Наименование" или имя одного из реквизитов примитивного типа (число, строка, дата, булево), для которого установлен признак Индексирование в значение Индексировать или Индексировать с доп. упорядоч. в метаданных. После имени реквизита через пробел может быть указано направление сортировки. Направление определяется:
По умолчанию сортировка производится по возрастанию. Если параметр не указан, то порядок определяется основным представлением справочника.
Значение по умолчанию:
Пустая строка.
Возвращаемое значение:
Тип: СправочникВыборка. <Имя справочника>. Полученная выборка.
Описание:
Позволяет получить иерархическую выборку элементов справочника по заданным условиям. При иерархической выборке для каждого элемента сначала выбираются элементы, для которых он является родителем, а затем уже выбирается следующий элемент.
Пример:
Товары = Справочники.Номенклатура;
ВыборкаСправочника = Товары.ВыбратьИерархически();
НайтиПоКоду ( FindByCode )
Синтаксис:
НайтиПоКоду(<Код>, <Поиск по полному коду> , <Родитель>, <Владелец>}
Параметры:
<Код> Обязательный
Тип: Число, Строка. Искомый код.
Строка или число в зависимости от настроек справочника в конфигураторе.
<Поиск по полному коду> Необязательный
Тип: Булево. Режим поиска по полному коду.
Если параметр устанавливается в Истина, то искомый код следует задавать в виде строки, состоящей из последовательности кодов по уровням справочника, разделенных символом "/".
Значение по умолчанию. Ложь.
<Родитель> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Родитель, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию: Неопределено.
<Владелец> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Владелец, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию:
Неопределенно.
Возвращаемое значение:
Тип: СправочникСсылка.<Имя справочника>. Ссылка на найденный элемент справочника. Если не существует ни одного элемента с требуемым кодом, то будет возвращена пустая ссылка.
Описание:
Позволяет получить ссылку на элемент по его коду.
Пример:
СтрокаКода = "840";
Волюты = Справочники.Валюты;
НайденнаяСсылка = Валюты.НайтиПоКоду(СтрокаКода);
Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда
Сообщить( "Валюты " + СтрокаКода + " еще нет");
КонеиЕсли;
НайтиПоНаименованию ( FindByDescr )
Синтаксис:
НайтиПоНаименованию (< Наименование> , <Точное соответствие> , <Родитель>, <Владелец>)
Параметры:
<Наименование>_Обязательный
Тип: Строка. Строка, содержащая искомое наименование.
<Точное соответствие> Необязательный
Тип: Булево. Режим поиска по полному соответствию.
Поиск будет успешным, если строка поиска: в случае значения параметра Ложь - будет соответствовать левой части наименования; в случае значения параметра Истина - будет полностью совпадать с наименованием (за исключением "хвостовых" пробелов в наименовании).
Значение по умолчанию: Ложь.
<Родитель> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Родитель, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию: Неопределено.
<Владелец> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Владелец, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию: Неопределено.
Возвращаемое значение:
Тип: СправочникСсылка. <Имя справочника>. Ссылка на найденный элемент справочника. Если не существует ни одного элемента с требуемым наименованием, то будет возвращена пустая ссылка.
Описание:
Позволяет получить ссылку на элемент по его наименованию.
Примечание:
Если существует несколько элементов с указанным наименованием, то будет найден только один из них.
Пример:
СтрокаНаименоваиия = "USD";
Валюты = Справочники.Валюты;
НайденнаяСсылка = Валюты.НаЙтиПоНаименованию(СтрокаНаименования);
Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда
Сообщить("Валюты " + СтрокаНаименования + " еще нет");
КонецЕсли;
НайтиПоРеквизиту ( FindByAttribute )
Синтаксис:
НайтиПоРеквизиту (<Имя реквизита> , <3начение реквизита>, <Родитель>, <Владелец>)
Параметры:
<Имя реквизита> Обязательный
Тип: Строка. Имя реквизита, как он задан в конфигураторе.
<3начение реквизита> Обязательный
Значение, по которому должен выполняться поиск.
<Родитель> Необязательный
Тип: СправочникСсылка. <Имя справочника>. Родитель, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию: Неопределено.
<Владелец>Необязательный
Тип: СправочникСсылка. <Имя справочника>. Владелец, в пределах которого нужно выполнять поиск. Если не угазан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.
Значение по умолчанию: Неопределено.
Возвращаемое значение:
Тип: СправочникСсылка.<Имя справочника>. Ссылка на найденный элемент справочника. Если не существует ни одного элемента с требуемым значением реквизита, то будет возвращена пустая ссылка.
Описание:
Позволяет получить ссылку на элемент по значению реквизита.
Примечание:
Если существует несколько элементов с указанным значением реквизита, то будет найдет только один из них.
Для реквизитов типа Строка поиск осуществляется по точному соответствию.
Пример:
СтрокаНаименования = "Доллары США" ;
Валеты = Справочники.Валюты;
НайденнаяСсылка = Валюты.НайтиПоРеквизиту ("ПолноеНаименоваяяе", СтрокаНаименования);
Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда
Сообщить("Валюты " + СтрокаНаименования + "еде нет.");
Иначе
Сообщить('Нашли такую.") ;
КонецЕсли;
ПолучитьМакет ( GetTemplate )
Синтаксис:
ПолучитьМакет(< Макет>)
Параметры:
<Макет> Обязательный
Тип- Строка, Объект описания метаданного. Имя макета, как оно задано в конфигураторе или объект описания метаданного требуемого макета.
Возвращаемое значение:
Тип- ТабличныйДокумент. Созданный макет.
Описание:
Позволяет получить макет справочника.
ПолучитьФорму ( GetForm )
Синтаксис:
ПолучитьФорму (< Форма>, <Владелец> , <Ключ уникальности>)
Параметры:
<Форма> Обязательный
Тип: Строка. Имя формы, как оно задано в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму справочника. Если получаемая форма - форма для редактирования элемента или группы справочника, то будет получена форма нового элемента или группы.
Пример:
Товары = Справочники.Номенклатура;
ФормаСписка= Товары.ПолучитьФорму("ФормаСписка") ;
Если Не ФормаСписка. Открыта () Тогда ФормаСписка.Открыть();
КонецЕсли;
ПолучитьФормуВыбора( GetFormChose )
Синтаксис:
ПолучитьФормуВыбора(< Форма >, <Владелец>, <Ключ уникальносnи>)
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение;
Тип: Форма.
Описание:
Позволяет получить форму списка для выбора элементов справочника.
Пример:
Товары = Справочники.Номенклатура;
ФормаСлиска= Товары.ПолучитьФормуВыбора();
Если Не ФормаСписка.Открыта() Тогда ФормаСписка.Открыть();
КонецЕсли;
ПолучитьФормуВыбораГруппы
Синтаксис:
ПолучитьФормуВыбораГруппы(< Форма>, <Владелец> , <Ключ уникальности> }
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму списка для выбора группы справочника.
ПолучитьФормуНовогоЭлемента ( GetFormNewltem)
Синтаксис:
ПолучитьФормуНовогоЭлемента(< Форма>, <Владелец>,<Ключ уникальности> )
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму нового элемента.
Пример:
Товары = Справочники.Номенклатура;
ФормаНового= Товары.ПолучитьФормуНовогоЭлемента();
ФормаНового.Открыть();
ПолучитьФормуНовойГруппы
Синтаксис:
ПолучитьФормуНовойГруппы (< Форма> , <Владелец> , <Ключ уникальности>)
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип: Форма.
Описание:
Позволяет получить форму новой группы.
Пример:
Товары = Справочники. Номенклатура;
ФормаНового= Товары.ПолучитьФормуНовойГруппы();
ФормаНового.Открыть();
ПолучитьФормуСписка ( GetFormList )
Синтаксис:
ПолучитьФормуСписка (< Форма>, <Владелец> , <Ключ уникальности>)
Параметры:
<Форма> Необязательный
Тип: Строка, Объект описания метаданного. Имя формы, как оно задано в конфигураторе или объект описания метаданного требуемой формы.
Значение по умолчанию: Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> Необязательный
Тип: Форма. Форма, которая будет являться владельцем открываемой формы.
<Ключ уникальности> Необязательный
Тип: Произвольный. В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм. Если будет найдена форма с таким же ключом уникальности, вместо открытия новой формы будет активизирована она.
Значение по умолчанию: Если параметр не указан, сначала всегда будет искаться уже открытая форма.
Возвращаемое значение:
Тип:Форма.
Описание:
Позволяет получить форму списка элементов справочника.
Пример:
Товары = Справочники.Номенклатура;
ФормаСписка= Товары.ПолучитьФормуСписка();
Если не ФормаСписка.Открыта() Тогда ФормаСписка.Открыть() ;
КонецЕсли;
ПустаяСсылка ( EmptyRef )
Синтаксис:
ПустаяСсылка()
Возвращаемое значение:
Тип: СправочникСсылка.<Имя справочника>.
Описание:
Позволяет получить пустое значение ссылки на данный справочник.
Примечание:
Может использоваться, например, когда нужно передать пустую ссылку в параметр метода.
Пример:
Если найденнаяСсылка = Справочники.Валюты.ПустаяСсылка() Тогда Сообщить("Такой валюты еде нет");
КонецЕсли;
СоздатьГруппу ( CreateFolder )
Синтаксис:
СоздатьГруппу()
Возвращаемое значение:
Тип: СправочникОбъект. < Имя справочникам Созданный объект для записи группы справочника.
Описание:
Позволяет создать новую группу справочника.
Пример:
НовыйОбьект = Справочники ["Контрагенты"] .СоздатьГруппу() ;
НовыйОбъект.Наименование = "Покупатели";
НовыйОбъект.Записать() ;
СоздатьЭлемент ( Createltem )
Синтаксис:
СоздатьЭлемент()
Возвращаемое значение:
Тип: СправочникОбъект.<Имя справочника>. Созданный объект для записи элемента справочника.
Описание:
Позволяет создать новый элемент справочника.
Пример:
НовыйОбъект = Справочники.Валеты.СоздатьЭлемент();
НовыйОбъект.Код = "840";
НовыйОбъект.Наименование = "USD";
НовыйОбъект.ПолноеНаименование = "Доллары США";
НовыйОбъект.Записать() ;
