Скрипты и плагины
Цель
Писать пользовательские скрипты для сайтов, типов аккаунтов, рабочих пространств или внутренних сайтов и расширять вход и обработку страниц через плагины сайтов.
Предварительные требования
- Создан целевой сайт или рабочее пространство.
- Текущий аккаунт имеет права настройки сайта, управления плагинами или настройки внутреннего сайта.
- Известны структура страниц и процесс входа целевого сайта.
Шаги
- В списке сайтов нажмите «Управлять плагинами».
- Создайте плагин, указав имя, версию, примечание и связанный сайт.
- Загрузите файл плагина или откройте страницу его настройки.
- На странице настройки добавьте скрипт: имя, URL совпадения, тип скрипта, селектор и содержимое.
- После сохранения откройте целевой сайт тестовым аккаунтом.
- Если нужны различия по типам аккаунта, рабочим пространствам или внутренним сайтам, добавьте скрипты на соответствующих страницах настройки.
Рекомендации по проектированию
| Пункт | Рекомендация |
|---|---|
| Именование | Использовать формат «site-purpose-version», например crm-login-v1 |
| URL совпадения | Максимально точно указывать страницу входа или целевой путь, не использовать глобальное совпадение без необходимости |
| Селектор | Предпочитать стабильные атрибуты, например name, data-*, явный ID |
| Обработка ошибок | Учитывать отсутствие элемента, медленную сеть и вторичные переходы |
| Примечание версии | Фиксировать версию целевого сайта, причину изменения и тестовый аккаунт |
Процесс публикации
- Написать скрипт в тестовом плагине или на тестовом сайте.
- Тестовым аккаунтом пройти полный процесс входа.
- Проверить пользовательский портал, ссылки совместного доступа и рабочие пространства.
- Экспортировать или записать версию плагина.
- Опубликовать на рабочем сайте и сохранить версию отката.
Проверка результата
- Новый плагин отображается в списке.
- При доступе к целевому сайту плагин или скрипт выполняется по правилам совпадения.
- Вход, переходы, заполнение данных или улучшение страницы соответствуют ожиданиям.
- При медленной загрузке или второй аутентификации скрипт не блокирует страницу.
Частые проблемы
- Скрипты страниц подходят для DOM, форм и поведения страниц.
- Изменения плагинов нужно сначала проверять в тестовой среде, чтобы не повлиять на вход рабочих пользователей.