Оформление
Безопасный запуск Groovy
Консоль позволяет выполнить Groovy-скрипт от вашего имени. Это инструмент суперпользователя, а не способ обойти проверки платформы.
Где находится
Настройки платформы → Настройка системы → Консоль. В справочнике доступны методы API, поля системы, примеры, ограничения и помощь LLM.
Первый запуск
- Откройте безопасный пример из встроенной справки.
- Перенесите его в редактор. Перенос кода ещё не выполняет его.
- Проверьте входной JSON и оставьте запись выключенной.
- Выполните проверку синтаксиса.
- Запустите скрипт и изучите результат и журнал.
Простой пример без изменения записей:
groovy
log.info('Проверка Groovy')
def values = (1..5).collect { it * it }
return [squares: values, sum: values.sum()]Найти настоящее поле, а не угадывать код
- В справочнике откройте «Поля системы».
- Выберите категорию «Типы записей» или «Пользовательские справочники», затем нужный тип. Справочник не исчез из API — он выделен в отдельный список.
- Найдите поле по названию или коду. В код скрипта переносите именно код, а значение задавайте в формате из таблицы. Русская подпись и код могут различаться.
- При необходимости нажмите «Скопировать ID типа». Это ID типа, не ID рабочей заявки.
- После изменения конфигурации нажмите «Обновить типы и поля». Для существующей записи с прежней версией схемы используйте
api.metadata.fieldsFor(subject), а не считайте актуальную схему единственной возможной.
Примеры чтения в таблице используют subject: в консоли для них нужен input.objectId существующей доступной записи. Пример значения одного поля не является готовым скриптом. Если список пуст, проверьте категорию, поисковый запрос и доступ, прежде чем создавать дублирующее поле.
Если нужно менять данные
Используйте только методы из текущего справочника. Сначала проверьте выбор объектов в режиме чтения. Затем явно разрешите запись и подтвердите запуск, убедившись в объёме изменений.
Сервер сохраняет проверки прав и бизнес-правил. Произвольный доступ к файлам сервера, SQL или HTTP не является возможностью этой консоли.
DANGER
Код, входные данные и результат сохраняются в истории. Не вставляйте пароли, токены и ключи. Не выполняйте массовую правку на рабочей базе ради проверки примера.
Ограничения и ошибки
Код и входной JSON ограничены 64 КиБ каждый; вход должен быть JSON-объектом. Время выполнения — от 1 до 300 секунд, по умолчанию 30. Одновременно выполняется один консольный скрипт в организации. В списке доступны последние 50 запусков.
Проверка синтаксиса не проверяет существование всех объектов и достаточность прав. После прерывания или ошибки сначала проверьте результат, затем решайте, нужен ли повтор.
Файл, журнал и повтор запроса
- «Загрузить файл» принимает
.groovyили.txtв UTF-8 до 64 КиБ. Загрузка заменяет код после подтверждения, но не запускает его. «Развернуть редактор» меняет только размер рабочей области. - В «Параметрах запуска» задаются JSON-объект
input, время и разрешение записи.Ctrl + Enterвыполняет код так же, как кнопка запуска; это не проверка синтаксиса. - Выберите запуск в «Истории», чтобы увидеть результат, фактический код и режим этого запуска. Фильтр уровня лога показывает сообщения выбранной важности и выше; текстовый поиск применяется к сообщениям.
- «Обновить» перечитывает историю и выбранный результат. «Автообновление» делает это каждые пять секунд, когда вкладка видима. «Очистить экран» скрывает выбранный результат, но не удаляет историю. «Сохранить лог» скачивает результат и полный лог, включая скрытые фильтром строки: проверьте его перед передачей.
- Если ответ сервера потерялся, код блокируется, а кнопка меняется на «Повторить запрос». Она запрашивает тот же запуск без повторного выполнения. «Начать новый запуск» — уже отдельное выполнение кода; сначала проверьте историю и изменённые записи.
У консоли нет кнопки принудительной остановки уже отправленного запуска. Лимит времени задаётся заранее. При ошибке или таймауте откатываются изменения базы этого запуска; незавершённый после перезапуска сервера результат требует проверки, а не слепого повтора.