1С Предприятие 8.0. Описание встроенного языка

         

Методы


Выбрать ( Select )

Синтаксис:

Выбрать(<Родитель>, <Владелец>, <Отбор>, <Порядок>)

Параметры:

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

Тип: СправочникСсылка. <Имя справочникам Отбор по родителю. Имеет смысл только для многоуровневых справочни­ков. Если параметр не задан или установлен в Неопределено, то отбор по родителю не производится. Чтобы отобрать элементы верхнего уровня, нужно в качестве данного параметра указать пустую ссылку на элемент справочника.

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

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

Тип: СправочникСсылка. <Имя справочника>. Отбор по владельцу. Имеет смысл только для подчиненных справочников. Если параметр не задан или установлен в Неопределено, то отбор по владельцу не производится.

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

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

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

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



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

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

Тип: Строка. Строка с именем реквизита справочника, опреде­ляющая упорядочивание элементов в выборке. Может быть ука­зано "Код", "Наименование" или имя одного из реквизитов при­митивного типа (число, строка, дата, булево), для которого уста­новлен признак "Индексирование" в значение "Индексировать" или в "Индексировать с доп. упорядоч." в конфигураторе. После имени реквизита через пробел может быть указано направление сортировки. Направление определяется: "Убыв" (" Desc") - упо­рядочивать по убыванию; "Возр" (" Asc") - упорядочивать по воз­растанию. По умолчанию сортировка производится по возраста­нию. Если параметр не указан, то порядок определяется основ­ным представлением справочника.




Значение по умолчанию: 

Пустая строка.

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

Тип: СправочникВыборка. <Имя справочника>. Получен­ная выборка.

Описание:

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

Пример:

МПЗ = Справочники.Номенклатура;

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

Пусто = Перечисления.ТипыНоменклатуры.ПустаяСсылка();

ОтборМПЗ.ТипНоменклатуры = Пусто;

ВыборкаМПЗ = МПЗ.Выбрать(,,ОтборМПЗ, "Наименование Убыв");

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

    Объект = ВыборкаМПЗ.ПолучитьОбъект();

    Объект.ТипНоменклатуры = Перечисления.ТипыНоненклатуры.Товар;

    Попытка

        Объект.Записать();

     Исключение

        Предупреждение("Не удалось записать объект " + Объект + "|" + ОписаниеОиибки(),60);

    КонецПопытки ;

КонецЦикла ;

ВыбратьИерархически ( SelectHierarchicaly )

Синтаксис;

ВыбратьИерархически (< Родитель> , <Владелец>, <Отбор>, <Порядок>)

Параметры:

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

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

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

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

Тип: СправочникСсылка. <Имя справочника>. Отбор по владельцу. Имеет смысл только для подчиненных справочников. Если параметр не задан или установлен в Неопределено, то отбор по владельцу не производится.

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

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

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



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

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

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

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

Может быть указан "Код", "Наименование" или имя одного из реквизитов примитивного типа (число, строка, дата, булево), для которого установлен признак Индексирование в значение Индексировать или Индексировать с доп. упорядоч. в метаданных. После имени реквизита через пробел может быть указано направление сортировки. Направление определяется:

  • "Убыв" ("Desc") - упорядочивать по убыванию; 


  • "Возр" (" Asc") -упорядочивать по возрастанию. 


  • По умолчанию сортировка произ­водится по возрастанию. Если параметр не указан, то порядок определяется основным представлением справочника.

    Значение по умолчанию: 

    Пустая строка.

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

    Тип: СправочникВыборка. <Имя справочника>. Получен­ная выборка.

    Описание:

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

    Пример:

    Товары = Справочники.Номенклатура;

    ВыборкаСправочника = Товары.ВыбратьИерархически();

    НайтиПоКоду ( FindByCode )

    Синтаксис:

    НайтиПоКоду(<Код>, <Поиск по полному коду> , <Родитель>, <Владелец>}

    Параметры:

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

    Тип: Число, Строка. Искомый код.

    Строка или число в зависимости от настроек справочника в кон­фигураторе.

    <Поиск по полному коду> Необязательный

    Тип: Булево. Режим поиска по полному коду.

    Если параметр устанавливается в Истина, то искомый код сле­дует задавать в виде строки, состоящей из последовательности кодов по уровням справочника, разделенных символом "/".

    Значение по умолчанию. Ложь. 

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



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

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

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

    Тип: СправочникСсылка. <Имя справочника>. Владелец, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.

    Значение по умолчанию: 

    Неопределенно.

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

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

    Описание:

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

    Пример:

    СтрокаКода = "840";

    Волюты = Справочники.Валюты;

    НайденнаяСсылка = Валюты.НайтиПоКоду(СтрокаКода);

    Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда

        Сообщить( "Валюты " + СтрокаКода + " еще нет");

    КонеиЕсли;

    НайтиПоНаименованию ( FindByDescr )

    Синтаксис:

    НайтиПоНаименованию (< Наименование> , <Точное соответствие> , <Родитель>, <Владелец>)

    Параметры:

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

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

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

    Тип: Булево. Режим поиска по полному соответствию.

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

    Значение по умолчанию: Ложь.

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

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

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

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



    Тип: СправочникСсылка. <Имя справочника>.  Владелец, в пределах которого нужно выполнять поиск. Если не указан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.

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

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

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

    Описание:

    Позволяет получить ссылку на элемент по его наименованию.

    Примечание:

    Если существует несколько элементов с указанным наименовани­ем, то будет найден только один из них.

    Пример:

    СтрокаНаименоваиия = "USD";

    Валюты = Справочники.Валюты;

    НайденнаяСсылка = Валюты.НаЙтиПоНаименованию(СтрокаНаименования);

    Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда

        Сообщить("Валюты " + СтрокаНаименования + " еще нет");

    КонецЕсли;

    НайтиПоРеквизиту ( FindByAttribute )

    Синтаксис:

    НайтиПоРеквизиту (<Имя реквизита> , <3начение реквизита>, <Родитель>, <Владелец>)

    Параметры:

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

    Тип: Строка. Имя реквизита, как он задан в конфигураторе.

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

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

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

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

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

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

    Тип: СправочникСсылка. <Имя справочника>.  Владелец, в пределах которого нужно выполнять поиск. Если не угазан или установлен в Неопределено, то поиск будет проводиться во всем справочнике.

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

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

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



    Описание:

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

    Примечание:

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

    Для реквизитов типа Строка поиск осуществляется по точному соответствию.

    Пример:

    СтрокаНаименования = "Доллары США" ;

    Валеты = Справочники.Валюты;

    НайденнаяСсылка = Валюты.НайтиПоРеквизиту ("ПолноеНаименоваяяе", СтрокаНаименования);

    Если НайденнаяСсылка = Валюты.ПустаяСсылка() Тогда

        Сообщить("Валюты " + СтрокаНаименования + "еде нет.");

    Иначе

        Сообщить('Нашли такую.") ;

    КонецЕсли;

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

    Синтаксис:

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

    Параметры:

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

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

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

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

    Описание:

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

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

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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

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

    Тип: Форма.

    Описание:

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



    Пример:

    Товары = Справочники.Номенклатура;

    ФормаСписка= Товары.ПолучитьФорму("ФормаСписка") ;

    Если Не ФормаСписка. Открыта () Тогда ФормаСписка.Открыть();

    КонецЕсли;

    ПолучитьФормуВыбора( GetFormChose )

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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

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

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

    Тип: Форма.

    Описание:

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

    Пример:

    Товары = Справочники.Номенклатура;

    ФормаСлиска= Товары.ПолучитьФормуВыбора();

    Если Не ФормаСписка.Открыта() Тогда ФормаСписка.Открыть();

    КонецЕсли;

    ПолучитьФормуВыбораГруппы

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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



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

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

    Тип: Форма.

    Описание:

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

    ПолучитьФормуНовогоЭлемента ( GetFormNewltem)

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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

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

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

    Тип: Форма.

    Описание:

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

    Пример:

    Товары = Справочники.Номенклатура;

    ФормаНового= Товары.ПолучитьФормуНовогоЭлемента();

    ФормаНового.Открыть();

    ПолучитьФормуНовойГруппы

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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



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

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

    Тип: Форма.

    Описание:

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

    Пример:

    Товары = Справочники. Номенклатура;

    ФормаНового= Товары.ПолучитьФормуНовойГруппы();

    ФормаНового.Открыть();

    ПолучитьФормуСписка ( GetFormList )

    Синтаксис:

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

    Параметры:

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

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

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

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

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

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

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

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

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

    Тип:Форма.

    Описание:

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

    Пример:

    Товары = Справочники.Номенклатура;

    ФормаСписка= Товары.ПолучитьФормуСписка();

    Если не ФормаСписка.Открыта() Тогда ФормаСписка.Открыть() ;

    КонецЕсли;

    ПустаяСсылка ( EmptyRef )

    Синтаксис:

    ПустаяСсылка()

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

    Тип: СправочникСсылка.<Имя справочника>.

    Описание:

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

    Примечание:

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

    Пример:

    Если найденнаяСсылка = Справочники.Валюты.ПустаяСсылка() Тогда Сообщить("Такой валюты еде нет");

    КонецЕсли;

    СоздатьГруппу ( CreateFolder )



    Синтаксис:

    СоздатьГруппу()



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

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

    Описание:

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

    Пример:

    НовыйОбьект = Справочники ["Контрагенты"] .СоздатьГруппу() ;

    НовыйОбъект.Наименование = "Покупатели";

    НовыйОбъект.Записать() ;

    СоздатьЭлемент ( Createltem )

    Синтаксис:

    СоздатьЭлемент()

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

    Тип: СправочникОбъект.<Имя справочника>.  Созданный объект для записи элемента справочника.

    Описание:

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

    Пример:

    НовыйОбъект = Справочники.Валеты.СоздатьЭлемент();

    НовыйОбъект.Код = "840";

    НовыйОбъект.Наименование = "USD";

    НовыйОбъект.ПолноеНаименование = "Доллары США";

    НовыйОбъект.Записать() ;


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