<< Click to Display Table of Contents >> Navigation:  Раздел 7 Расширения языка L9 > Объекты учета > Работа со справочниками > Справочник > Методы > ПолучитьМассив (GetArray)

Описание:

Возвращает массив реквизита для всех элементов справочника, при этом учитываются установленные фильтры и выбранная группа. Значениями в массиве являются объекты реквизита значения. Ключи описываются реквизитом ключа. Если тип реквизита ключа простой (Число (Number), Булево (Boolean), Строка (String), ДатаВремя (DateTime)), то ключом являются объекты соответствующего типа. Если тип реквизита ключа – справочник, то ключом будет являться идентификатор соответствующего элемента справочника. Аналогично для типов: картинка, документ, перечисление, объект "ГУИД" ("GUID"). Другие типы реквизита ключа не допускаются. В случае ошибки или неверных параметров функция возвращает значение "Неопределено" ("Undefined").

Чтобы вернуть все значения реквизита значения, значения реквизита ключа должны быть уникальными. Если значения реквизита ключа повторяются (например, в справочнике), то массив будет содержать только одно (из всех возможных вариантов пар)  значение реквизита значения для этого ключа.

Синтаксис:

ПолучитьМассив(<РеквизитКлюча>,<РеквизитЗначения>)

GetArray(<Key>,<Value>)

Параметры:

РеквизитКлюча (Key) – реквизит справочника, значения этого реквизита элемента справочника будут ключом.

РеквизитЗначения (Value) – реквизит справочника, значения этого реквизита элемента справочника будут значением.

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

Возвращает массив реквизита для всех элементов справочника, при этом учитываются установленные фильтры и выбранная группа. В случае ошибки или неверных параметров функция возвращает значение "Неопределено" ("Undefined").

Пример:

//В примере в качестве реквизита ключа и реквизита значения

//указаны реквизиты справочника "ИсторияПродаж":
//ИдентификаторТовара и ОборотКоличества
МассивИсторииПродаж = СпрИсторияПРодаж.ПолучитьМассив("ИдентификаторТовара", "ОборотКоличество");