choose-value

name	choose-value
description	Выбирает ссылочное значение в поле формы, открывая форму выбора, осматривая ее, находя нужную запись и подтверждая выбор.

Выбор значения

Используй этот навык, когда поле ожидает ссылку на другой объект 1C и должно быть заполнено через форму выбора или выпадающий список.

Когда использовать

• Когда нужно выбрать справочник, документ, счет, договор или другое ссылочное значение в поле формы

Когда не использовать

• Когда поле принимает примитивное значение, которое нужно ввести напрямую, например текст, число или дату
• Когда значение нужно установить через ВнестиЗначение() или очистить через Очистить(), а не открывать форму выбора

Рабочий процесс

1. Вызови Выбрать("<ИдентификаторЭлемента>") для исходного поля.
2. Метод Выбрать как правило, открывает новую форму. Поэтому, заверши шаг строкой возврат ПолучитьЭлементыАктивногоОкна();.
3. В следующем скрипте установи контекст на открытое окно через Здесь("<ЗаголовокФормы>").
4. Осмотри открытое окно перед следующим действием. Если Выбрать открывает промежуточный диалог вместо итоговой формы выбора, обработайте этот диалог по тому же принципу - "сначала осмотр".
5. В форме выбора используй навык search-in-list, чтобы найти и сфокусировать нужную запись.
6. Когда форма выбора предоставляет несколько механизмов поиска, следуй стандартной политике search-in-list, а не импровизируй на основе первой видимой кнопки поиска.
7. Подтверждай выбор нажатием на соответствующий элемент, предварительно убедившись, что он существует.
8. После закрытия формы выбора, рассматривай родительскую форму как активную и заверши шаг строкой возврат ПолучитьЭлементыАктивногоОкна();.

Типичные ошибки

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

Ссылки

• Примеры выбора значений: @references/examples.md