| name | choose-value |
| description | Выбирает ссылочное значение в поле формы, открывая форму выбора, осматривая ее, находя нужную запись и подтверждая выбор. |
Выбор значения
Используй этот навык, когда поле ожидает ссылку на другой объект 1C и должно быть заполнено через форму выбора или выпадающий список.
Когда использовать
- Когда нужно выбрать справочник, документ, счет, договор или другое ссылочное значение в поле формы
Когда не использовать
- Когда поле принимает примитивное значение, которое нужно ввести напрямую, например текст, число или дату
- Когда значение нужно установить через
ВнестиЗначение() или очистить через Очистить(), а не открывать форму выбора
Рабочий процесс
- Вызови
Выбрать("<ИдентификаторЭлемента>") для исходного поля.
- Метод
Выбрать как правило, открывает новую форму. Поэтому, заверши шаг строкой возврат ПолучитьЭлементыАктивногоОкна();.
- В следующем скрипте установи контекст на открытое окно через
Здесь("<ЗаголовокФормы>").
- Осмотри открытое окно перед следующим действием. Если
Выбрать открывает промежуточный диалог вместо итоговой формы выбора, обработайте этот диалог по тому же принципу - "сначала осмотр".
- В форме выбора используй навык
search-in-list, чтобы найти и сфокусировать нужную запись.
- Когда форма выбора предоставляет несколько механизмов поиска, следуй стандартной политике
search-in-list, а не импровизируй на основе первой видимой кнопки поиска.
- Подтверждай выбор нажатием на соответствующий элемент, предварительно убедившись, что он существует.
- После закрытия формы выбора, рассматривай родительскую форму как активную и заверши шаг строкой
возврат ПолучитьЭлементыАктивногоОкна();.
Типичные ошибки
- Не предполагай заранее каким будет заголовок формы выбора, списка значений, или кнопки подтверждения. Всегда осматривай форму перед действием.
- Некоторые поля открывают диалог выбора типа данных перед фактической формой выбора. Рассматривай его как отдельную форму и осматривай перед продолжением.
Ссылки
- Примеры выбора значений:
@references/examples.md
