Skip to content

Help script_triggers ru

Alex Miarsky edited this page Nov 10, 2026 · 1 revision

Триггеры скриптов

Триггеры запускают сохранённые скрипты непосредственно до или после выбранных действий Handler и DCC.

Поддержка легаси TACTIC сохранена: триггеры читаются и сохраняются через его стандартный API, с проверкой ревизии и откатом транзакции при ошибке. Stream использует собственную команду автоматизации. В обоих режимах работают запуски до и после действия; посторонние серверные триггеры сохраняются. Если другой клиент изменил правила, перезагрузите их перед сохранением.

Основные элементы

Откройте «Триггеры скриптов» из редактора скриптов. Выберите действие, запуск до или после него и сохранённый скрипт.

Необязательные фильтры по Search Type, search key, процессу и контексту ограничивают условия запуска. Несколько подходящих скриптов выполняются сверху вниз.

Как пользоваться

  • Каждый триггер получает TACTIC_SCRIPT_KWARGS.
  • Общие ключи: event, phase, operation_id, project_code, source, client_id, targets, search_key, process и context.
  • Данные конкретного действия — например values, file, snapshot или result_search_key — добавляются, когда доступны.
  • Во время тестирования выведите словарь через print, чтобы увидеть точный payload.
  • Перехваченные stdout и stderr скриптов Handler и DCC записываются в панель «Вывод» редактора скриптов и в Debug Log, если включены события LOG; если скрипт триггера уже открыт во вкладке, вывод остаётся в этой вкладке.
  • Server-скрипты показывают там возвращённый RESULT; stdout их процесса остаётся в журнале сервера TACTIC.
  • Исключение в скрипте «До действия» блокирует действие.
  • Исключение в скрипте «После действия» записывается в журнал, но не может отменить уже завершённое действие и не останавливает следующие скрипты после действия.

Примеры

Получить настоящие SObject из payload

targets, target и snapshot внутри TACTIC_SCRIPT_KWARGS — обычные словари с данными действия. Для чтения полей, связей, задач и снапшотов получите публичные объекты API по их search_key. Пример подходит для Local Python; DCC Python использует тот же API через подключённый Handler.

from tactic_handler_api import get_api

data = TACTIC_SCRIPT_KWARGS
th = get_api()

search_keys = [
    target['search_key']
    for target in data.get('targets', [])
    if target.get('search_key')
]
for name in ('search_key', 'result_search_key'):
    if data.get(name):
        search_keys.append(data[name])
search_keys.extend(data.get('result_search_keys') or [])

sobjects = [
    th.sobject(search_key)
    for search_key in dict.fromkeys(search_keys)
]

for sobject in sobjects:
    print('Object:', sobject.get_search_key())
    print('Values:', dict(sobject.get_info()))

RESULT = [dict(sobject.get_info()) for sobject in sobjects]

До создания объекта search_key может отсутствовать — настоящего объекта на сервере ещё нет. После пакетного создания новые ключи приходят в result_search_keys.

Получить Snapshot и его File-объекты

При открытии опубликованного файла ключ снапшота находится в snapshot.search_key. По нему можно получить Snapshot, а затем родные File-объекты с репозиторными путями и метаданными.

from tactic_handler_api import get_api

data = TACTIC_SCRIPT_KWARGS
th = get_api()
snapshot_key = (data.get('snapshot') or {}).get('search_key')

if snapshot_key:
    snapshot = th.snapshot(snapshot_key)
    print('Snapshot:', dict(snapshot.get_info()))

    for file_object in snapshot.get_files_objects():
        print('File:', file_object.get_full_abs_path())
        print('Metadata:', file_object.get_metadata())

До действия: проверить контекст и при необходимости заблокировать действие

data = TACTIC_SCRIPT_KWARGS

if data['phase'] != 'before':
    raise RuntimeError('This script must run before the action')

targets = data.get('targets', [])
if not targets:
    raise RuntimeError('Select an object first')

print('Starting:', data['event'])
print('Target:', targets[0]['search_key'])
RESULT = {'allowed': True}

После действия: обработать завершённое действие

data = TACTIC_SCRIPT_KWARGS

print('Completed:', data['event'])
print('Project:', data['project_code'])
for target in data.get('targets', []):
    print('Target:', target['search_key'])

RESULT = data.get('result_search_key')

Нативное редактирование триггеров

Форма использует контролы Frame, а запуск остаётся у существующих обработчиков Handler «до» и «после» операции. Перестановка сохраняет идентификатор правила. Выбор скрипта не применяется после смены правила, действия или версии документа. Перезагрузка требует подтверждения сброса изменений. Обработчики Handler/DCC остаются нативной возможностью; браузер их не устанавливает.

Настройка внешним агентом

Внешний агент администратора может сохранить неактивный черновик, проверить синтаксис Python и отдельно опубликовать обычный скрипт Local Python с хуком до или после чекина. Публикация требует явного разрешения хоста на конкретный код и привязку, а также серверного права исполнения. Черновики не выполняются. Изолированного запуска произвольного кода пока нет.

ТХ 0.6.0.151 сохраняет весь набор хуков одной штатной командой с проверкой ревизии; нужны TS 0.112.207 и обновление схемы. Пути входных файлов и идентификатор операции очереди захватываются до чекина. Хуки After также получают готовый снапшот и его ключ. Пока другой хук выполняется, новая операция Before отклоняется, а After ждёт своей очереди. Отмена во время проверки предотвращает последующий чекин после завершения текущей программы.

В Local Python доступен tactic_handler_api.automation.run_checkin_program(argv, TACTIC_SCRIPT_KWARGS, timeout=60, per_file=True). Укажите существующий абсолютный путь программы и отдельные аргументы; {file} подставляет захваченные входные пути. Ненулевой код возврата, отсутствие программы и тайм-аут вызывают ошибку. После публикации доступен {result_search_key}. Вывод сохраняется в консоли или сообщении об ошибке скрипта. Это обычный запуск на компьютере пользователя: внешние эффекты и очистку дочерних процессов обеспечивает сама программа. Клиентские хуки не контролируют загрузки из других клиентов и headless API.

Clone this wiki locally