Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе. Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.
Синтаксис
ПолучитьДанныеВыбора(<Параметры>)Полное описание, параметры и ограничения
ВнешнийИсточникДанныхКубТаблицаИзмеренияМенеджер.<Имя внешнего источника>.<Имя куба>.<Имя таблицы измерения>.ПолучитьДанныеВыбора (ExternalDataSourceCubeDimensionTableManager.<External source name>.<Cube name>.<Dimension table name>.GetChoiceData)
ВнешнийИсточникДанныхКубТаблицаИзмеренияМенеджер.<Имя внешнего источника>.<Имя куба>.<Имя таблицы измерения> (ExternalDataSourceCubeDimensionTableManager.<External source name>.<Cube name>.<Dimension table name>)
ПолучитьДанныеВыбора (GetChoiceData)
Доступен, начиная с версии 8.3.3.
Синтаксис:
ПолучитьДанныеВыбора(<Параметры>)
Параметры:
<Параметры> (обязательный)
Тип: Структура.
Содержит параметры для формирования списка значений.
Структура, в которой обязательно должны содержаться следующие ключи:
Отбор (Filter) - отбор, используемый для поиска данных, тип Структура; значения элементов отбора могут иметь тип Массив, СписокЗначений, ФиксированныйМассив или иной тип, не являющийся коллекцией; для типов Массив, СписокЗначений, ФиксированныйМассив сравнение выполняется с видом сравнения ВСписке, иначе вид сравнения Равно;
СтрокаПоиска (SearchString) - содержит строку, используемую при поиске данных; для быстрого выбора содержит значение Неопределено;
СпособПоискаСтроки (StringSearchMode) - указывается способ поиска при вводе по строке; тип СпособПоискаСтрокиПриВводеПоСтроке; параметр может отсутствовать.
Возвращаемое значение:
Тип: СписокЗначений.
Описание:
Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе.
Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Примечание:
Если в модуле менеджера в методе указано два параметра, то будет вызван метод ПолучитьДанныеВыбора глобального контекста.
Выполнение метода приводит к вызову события ОбработкаПолученияДанныхВыбора.
В режиме совместимости конфигурации Версия8_3_17 и ниже рекомендуется устанавливать свойство ОграничиватьСтрокуПоиска в значение Истина, чтобы при выполнении сложных запросов генерировалась ошибка.
Использование в версии:
Доступен, начиная с версии 8.3.3.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
Навигация к кубу и выбор товара измерения
Коллекции Кубы и ТаблицыИзмерений дают менеджер конкретного измерения. Поиск, ссылка из ключа и пустая ссылка — разные операции.
Где и как запускать
Толстый клиент: тело обработчика своей учебной формы. Внешние подключения заранее настроены; здесь код не запускался.
Подготовка
В собственной учебной конфигурации настройте внешний источник Аналитика, куб Продажи с ключом Товар и числовыми полями Количество, Сумма. Его измерение Товары имеет строковый ключ BOOK и поле Код.
В этом же источнике подготовьте необъектную таблицу Остатки с ключевым строковым полем Код и числовым Количество; объектная таблица Товары имеет строковый ключ BOOK. Нужны свои доступные внешние учебные данные, не рабочее подключение.
Кубы = ВнешниеИсточникиДанных.Аналитика.Кубы;
Куб = Кубы.Продажи;
Измерения = Куб.ТаблицыИзмерений;
Товары = Измерения.Товары;
Найденная = Товары.НайтиПоПолю("Код", "BOOK");
ИзКлюча = Товары.ПолучитьСсылку("BOOK");
Пустая = Товары.ПустаяСсылка();
Параметры = Новый Структура("Отбор,СтрокаПоиска", Новый Структура("Код", "BOOK"), Неопределено);
Варианты = Товары.ПолучитьДанныеВыбора(Параметры);
Сообщить("Поиск: " + Строка(Найденная));
Сообщить("Ссылка из ключа: " + Строка(ИзКлюча));
Сообщить("Пустая: " + Строка(Пустая.Пустая()));
Сообщить("Вариантов: " + Строка(Варианты.Количество()));
Макет = Товары.ПолучитьМакет("Памятка");
Макет.Показать();Разбор по шагам
Получите менеджер измерения через коллекции источника и куба.
Используйте поле Код для поиска и фильтра списка выбора.
Откройте свой табличный макет измерения.
Как проверить результат
Пустая.Пустая() возвращает Истина.
Число вариантов определяется собственными данными, а не гарантированным числом 1.
Ожидаемый результат
Код показывает вызовы на собственных учебных объектах; фактические данные и результат проверьте в подготовленной среде. Здесь пример не выполнялся.
На что обратить внимание
ПолучитьСсылку формирует значение, но не проверяет существование записи. Макет Памятка должен быть настроен как ТабличныйДокумент именно в измерении Товары.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.