Skip to content

Help script_shelf ru

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

Шелф скриптов

Шелф даёт быстрый доступ к сохранённым скриптам из рабочей области поиска.

Личный и общий шелф

Личный шелф виден только текущему пользователю. Общий шелф настраивает супервайзер для проекта. Оба режима могут использовать один шелф во всех вкладках либо отдельный шелф для конкретной вкладки сайдбара. Общий для всего проекта шелф всегда называется Общий шелф — его нельзя переименовать или удалить. У шелфов отдельных вкладок имена редактируются.

Настройка

  1. Откройте редактор шелфа.
  2. Выберите личный или общий режим и область действия.
  3. Для общего шелфа вкладки выберите существующий шелф или создайте новый.
  4. Добавьте сохранённые скрипты из дерева, задайте подпись, подсказку и иконку.
  5. Расставьте кнопки в нужном порядке и сохраните шелф.
  6. Нажмите Применить к этой вкладке, чтобы активировать сохранённый общий шелф в текущей вкладке сайдбара.

Заголовок редактора всегда показывает имя изменяемого шелфа. Кнопка удаления и подтверждение повторяют это точное имя, поэтому нельзя перепутать его с другим общим шелфом.

Кнопка шелфа находится рядом со строкой поиска. Если кнопок больше доступной ширины, используйте горизонтальную прокрутку.

При подключённой Maya редактор также может создать или обновить нативный Maya shelf. Первая кнопка запускает TACTIC Handler, остальные повторяют настроенные действия текущего шелфа.

Как выбирается шелф

Компактный переключатель выбирает Личный или Общий. Внутри владельца Handler сначала ищет шелф текущей вкладки боковой панели, а иначе показывает общий. Привязка к вкладке не создаёт пресет боковой панели и не влияет на другие вкладки.

Общие шелфы и их привязки являются конфигурацией проекта. Личные принадлежат вошедшему пользователю. Сохранение одного владельца не переписывает документ другого.

Оформление кнопки

Каждое действие имеет фиксированную область 36 × 36, одну иконку, короткую обрезаемую подпись и полный хинт. Оставляйте видимую подпись короткой, а в хинте описывайте входные данные, побочные действия и ожидаемый результат. Перетаскивание меняет только порядок.

Если кнопки не помещаются, шелф Поиска прокручивается горизонтально и не ужимает их до нечитаемого вида.

Создание и обновление Maya Shelf

Действие показывается только для подключённой Maya с возможностью create_script_shelf. Укажите видимое имя вкладки. Если оно уже существует, подтвердите Обновить: Handler заменит сгенерированные кнопки, а не создаст дубликат с хешем.

Первая кнопка Maya запускает или показывает Handler. Остальные сохраняют подпись, хинт, проектный путь, порядок и отрисованную иконку. Maya хранит вкладку нативным механизмом Shelf.

Если шелф или кнопки пропали

  • Проверьте Личный/Общий и текущую вкладку до редактирования.
  • Пустой шелф конкретной вкладки намеренно перекрывает общий.
  • Несохранённые изменения редактора не заменяют активный шелф.
  • Если серверный скрипт удалён, обновите данные и удалите либо исправьте устаревшее действие.

Серверный JavaScript

С 0.112.39 редактор поддерживает server_js, а Script Shelf запускает его через исходный JsCmd. Выберите Серверный JavaScript в Script Editor. Это синхронный код администратора с server и глобальными kwargs; браузерный javascript сохраняет отдельное окружение. Примеры, транзакции и ограничения — в Исходном HTML API и серверном JavaScript.

Полка TACTIC Stream

Изменения черновика не влияют на активную полку. Удаление личной полки вкладки открывает общую. Удаление общей полки вкладки снимает её назначения в навигации. Если другой пользователь изменил конфигурацию, обновите её.

Веб-полка запускает сохранённый браузерный JavaScript, серверный Python или серверный JavaScript. Браузерный скрипт получает context, project, searchType, searchKeys, rpc(method, args, kwargs) и refresh(). RPC использует вашу учётную запись и захваченный проект. Верните значение для показа в результате скрипта:

const rows = await rpc('query', [searchType], {limit: 10});
return {project, selected: searchKeys, count: rows.length};

Локальный Python, выполнение и экспорт в DCC исключены из веб-полки. Серверный JavaScript требует прав администратора и откатывает изменения при необработанной ошибке; у него нет доступа к DOM браузера или DCC. Справка полки открывает эту статью в общем каталоге.

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

Область действия, черновики и общие контролы

Полоса и редактор шелфа используют общую с Handler компоновку Frame. При переполнении остаются видимые полосы прокрутки. Выбор иконки и скрипта привязан к идентификатору кнопки и текущей области редактирования: отложенный ответ не изменит удалённую кнопку или другой шелф. Нативный черновик вкладки нельзя сохранить в другую вкладку после смены контекста. Отмените черновик или заново откройте редактор. После подтверждённого назначения браузер сразу показывает, что шелф используется на этой вкладке. Справка открывает эту статью в общем окне.

Где выполняется скрипт

Кнопки показывают иконку по центру и название без пометки TH. В ТС видны только кнопки, которые текущий пользователь может выполнить там; локальный Python и действия DCC скрыты. Сохранённая полка сохраняет весь набор скриптов, доступный в редакторе. Для серверного Python, серверного JavaScript и JavaScript браузера среда указана в подсказке; окно результата ТС повторяет её, в том числе при ошибке.

Среду определяет язык сохранённого скрипта, а не его папка или название. Серверный Python не является скриптом ТХ. Серверный триггер, ожидающий данные события в input, нужно запускать своим событием: кнопка шелфа эти данные не передаёт.

Доступ к кастомным скриптам по группам

Откройте Администрирование → Права доступа → Кастомные скрипты, выберите проект и снимите галочки у скриптов, запрещённых выбранным группам. Таблица содержит все активные кастомные скрипты: клиентские, серверные, вспомогательные модули и другие сохранённые языки. Поиск фильтрует пути скриптов и названия групп. Строка Все запрещает группе все кастомные скрипты. Сохранение применяет изменения; сброс отменяет черновик. Установка галочки обратно снимает собственный запрет. Унаследованный запрет или запрет строки «Все» снимается в его источнике. Запрет хотя бы одной группы имеет приоритет; администратор сохраняет доступ.

Кнопки, включая личные полки, наследуют доступ от своего скрипта. Без настроенного запрета всё работает как раньше. Правила ограничивают явный запуск по имени; доступные способы выполнения языков и импорты внутри разрешённых скриптов сохраняются. После смены прав или членства обновите скрипты/полку. Чтобы убрать старые видимые кнопки Maya, повторите экспорт полки; обновлённый коннектор также проверяет актуальное разрешение при нажатии уже сохранённой кнопки.

Правила хранятся в существующих правах групп; код скриптов, схема базы и остальные права не меняются. Легаси-клиенты не учитывают это новое правило. Локальный Python и скопированный код не являются защищённой средой: доступ к данным ограничивают серверные права. После обновления ТХ переподключите старые сеансы Maya, чтобы их коннектор использовал новую проверку.

Clone this wiki locally