AGENT SKILL

choose-value

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

License 许可
BSD-2-Clause
最近更新
2026-09-21
Stars
★ 208
Forks
32

01 前言 Front Matter

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

02 资源文件 1

03 SKILL.md 正文

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

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

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

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

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

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

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

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

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

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

Ссылки

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

04 同仓库更多 Skills

grumagargler
grumagargler/tester

sort-in-list

Сортирует динамические списки, формы выбора и табличные части 1C через стандартное дополнительное меню списка или таблицы: Еще или Настроить список. Используется, когда нужно упорядочить строки по одной или нескольким колонкам, проверить порядок строк или подготовить список к чтению.

★ 208
grumagargler
grumagargler/tester

search-in-list

Ищет записи в формах списков и выбора 1C (справочники, документы, планы счетов, планы видов характеристик, табличные части и т. д.), чтобы находить элементы перед созданием или ссылкой на записи. Используется для поиска, дедупликации и выборе сущности из списка.

★ 208
grumagargler
grumagargler/tester

runner-core

Базовый рабочий процесс для написания и запуска BSL-скриптов Runner для взаимодействия с 1С:Предприятие 8.3. Используй для осмотра UI, управления контекстом формы, принятия решений с учетом навыков, построения минимальных шагов и выбора методов Runner, таких как Подключить, Здесь, ПолучитьЭлементыАктивногоОкна, ПолучитьИзмененияОкна, Коммандос, Нажать, ВнестиЗначение, Выбрать, ОткрытьЗначениеВПолеВвода, Фокус и средства чтения таблиц.

★ 208
grumagargler
grumagargler/tester

choose-value

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

★ 208
grumagargler
grumagargler/tester

sort-in-list

Сортирует динамические списки, формы выбора и табличные части 1C через стандартное дополнительное меню списка или таблицы: Еще или Настроить список. Используется, когда нужно упорядочить строки по одной или нескольким колонкам, проверить порядок строк или подготовить список к чтению.

★ 208
grumagargler
grumagargler/tester

search-in-list

Ищет записи в формах списков и выбора 1C (справочники, документы, планы счетов, планы видов характеристик, табличные части и т. д.), чтобы находить элементы перед созданием или ссылкой на записи. Используется для поиска, дедупликации и выборе сущности из списка.

★ 208