Repository navigation
Help script_triggers ru
Триггеры запускают сохранённые скрипты непосредственно до или после выбранных действий 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.
- Исключение в скрипте «До действия» блокирует действие.
- Исключение в скрипте «После действия» записывается в журнал, но не может отменить уже завершённое действие и не останавливает следующие скрипты после действия.
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.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.
TACTIC-Handler · Releases · Issues · English · Русский
English
- Home
- Installation
- Feature tour
- User guide
- Assistant
- Dashboards
- Knowledge Base
- Maya / Shelf
- Plugins / Плагины
Русский
- Главная
- Установка
- Обзор возможностей
- Руководство пользователя
- Помощник
- Дашборды
- База знаний
- Maya / Shelf
- Plugins / Плагины
Development / Разработка