AGENT SKILL

runner-core

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

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

01 前言 Front Matter

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

02 资源文件 1

03 SKILL.md 正文

Ядро Runner

Используйте этот навык для любой задачи, которая пишет или запускает Runner-скрипты для приложения 1C в этом репозитории.

Протокол принятия решений

  1. Сначала осмотри текущее состояние формы.
  2. После осмотра определи, какие навыки применимы к текущей задаче, текущей форме или текущему бизнес-объекту, и используй наиболее подходящий.
  3. Если подходящего навыка нет, переходи к общим рассуждениям об UI.
  4. Используй элементы управления для проверки предварительных условий и получения точных ID, заголовков и ссылок.

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

  • Когда нужно осмотреть UI приложения через Runner
  • Когда нужно переходить между формами или навигационными ссылками
  • Когда нужно читать значения, таблицы или табличные документы
  • Когда нужно безопасно и пошагово заполнять или очищать поля, выбирать значения или нажимать элементы управления

Базовый рабочий процесс

  1. Начинай каждый скрипт с вызова метода Подключить.
  2. Используй ПолучитьГлавноеМеню для навигации верхнего уровня или ПолучитьЭлементыАктивногоОкна для текущей формы.
  3. Используй только элементы управления, заголовки и навигационные ссылки, которые уже известны из состояния приложения.
  4. Перед взаимодействием с формой, установи контекст выполнения через Здесь.
  5. Когда несколько известных элементов управления могут достичь одной цели, предпочитай стандартный механизм, определенный наиболее подходящим навыком, а не случайно более заметной кнопке.
  6. Рассматривай каждое действие, изменяющее состояние, как потенциально меняющее другие поля, значения по умолчанию и доступность элементов управления, а не только целевой элемент.
  7. После каждого такого действия останови шаг и осмотри результат через ПолучитьИзмененияОкна.
  8. Скрипты должны быть минимально достаточными. В большинстве случаев, записывай в tester/ одно надежное действие, изменяющее состояние, затем осматривайте результат и продолжай.

Выбор методов Runner

Обнаружение и чтение

Используй эти методы, чтобы понять текущее состояние перед действием:

  • ПолучитьГлавноеМеню
  • ПолучитьЭлементыАктивногоОкна
  • ПолучитьИзмененияОкна
  • Взять
  • ПолучитьСодержимоеТаблицы
  • ПолучитьСодержимоеТабличногоДокумента
  • ПолучитьСнимок

Контекст формы и навигация

Используй эти методы, чтобы безопасно перемещаться по UI:

  • Здесь
  • Коммандос
  • Фокус
  • Закрыть
  • ЗакрытьВсё
  • Далее
  • Дождаться

Ввод данных и выбор

Используй эти методы после подтверждения, что целевой элемент управления существует:

  • Нажать
  • ВнестиЗначение
  • Очистить
  • Выбрать
  • ОткрытьЗначениеВПолеВвода

Навигация по таблицам и ожидание

Используй эти методы для перехода к строкам таблиц, иерархическим уровням и веткам дерева:

  • КСтроке
  • ПерейтиКПервойСтроке
  • ПерейтиКПоследнейСтроке
  • ПерейтиКСледующейСтроке
  • ПерейтиКПредыдущейСтроке
  • ПерейтиНаУровеньНиже
  • ПерейтиНаУровеньВыше
  • РаскрытьСтрокуДерева
  • СвернутьСтрокуДерева

После перехода по строкам, используй ПолучитьИзмененияОкна, если нужно понять текущее состояние и другие изменения на форме.

Важные ограничения

  • Не угадывай ID элементов, заголовки кнопок, заголовки форм или навигационные ссылки.
  • Не объединяй несколько вызовов ВнестиЗначение в один скрипт только потому, что поля выглядят независимыми. Изменение значения поля формы, может запустить обработчик, логика которого может изменить форму и её поля и элементы.
  • Коммандос допустим только тогда, как чётко известно, что навигационная ссылка существует в приложении.
  • КСтроке предназначен для точной навигации к строке по известному значению колонки (или колонок). Не используй КСтроке для произвольного поиска. Используй стандартное поле поиска или фильтр у списка.
  • ПолучитьСодержимоеТаблицы читает до 100 строк. Сужай набор результатов перед чтением больших списков. Если всё-таки нужно получить более 100 строк, попробуй экспортировать таблицу в табличный документ, а затем использовать ПолучитьСодержимоеТабличногоДокумента для получения данных в файле Microsoft Excel.
  • Выбрать может открыть промежуточный диалог выбора типа данных. Рассматривай это как смену формы и осмотрите ее перед продолжением.
  • Используй ПолучитьЭлементыАктивногоОкна только в случае, когда тебе нужно полностью изучить форму. Предпочитай ПолучитьИзмененияОкна, если ты с формой уже работаешь и тебе нужно видеть только изменения. Таким способом ты существенно сэкономишь объём информации для анализа.
  • Используй ПолучитьСнимок только когда дерево элементов управления недостаточно объясняет текущее состояние UI.

Ссылки

  • Точное описание сигнатуры методов, нюансы и примеры: @references/api-methods.md

04 同仓库更多 Skills

grumagargler
grumagargler/tester

sort-in-list

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

★ 208
grumagargler
grumagargler/tester

search-in-list

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

★ 208
grumagargler
grumagargler/tester

choose-value

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

★ 208
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