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