Кіріспе
Synchra ішіндегі жеке қызметті іске қосудың негізгі сценарийі.24.
Аударма әзірге қолжетімсіз. Түпнұсқа көрсетілді.
Микроприложение в Synchra.24 помогает добавить внутренний сценарий компании без отдельного большого продукта. Это может быть рабочая форма, экран согласования, сервис для подрядчиков, специальный дашборд отдела или внутренний инструмент для конкретной роли.
Когда имеет смысл делать микроприложение
Подход подходит, если вам нужно:
- закрыть узкий процесс, который не покрывается стандартными модулями;
- встроить внутреннюю форму или журнал в единый рабочий контур;
- дать сотрудникам отдельный экран под конкретную задачу;
- добавить сценарий, связанный с задачами, документами, заявками или MotionCode.
Как устроен запуск
Обычно процесс состоит из четырех шагов:
- Определите сценарий: что именно должен делать пользователь в микроприложении.
- Опишите роли и доступы: кто видит экран, кто может редактировать данные, кто только просматривает.
- Подготовьте интерфейс и данные: какие поля, статусы, таблицы и действия нужны.
- Встройте приложение в рабочий контур Synchra.24: меню, роли, связи с другими сервисами и навигация.
Что важно продумать заранее
1. Пользовательский сценарий
Перед разработкой полезно коротко зафиксировать:
- кто открывает экран;
- что он должен сделать за один заход;
- какие данные нужно показать сразу;
- какой результат считается успешным.
Если сценарий можно объяснить одним абзацем, значит его проще реализовать и поддерживать.
2. Доступы и роли
Микроприложение лучше сразу привязывать к ролям. Тогда:
- сотрудники видят только нужные разделы;
- руководители получают нужный уровень контроля;
- интерфейс не перегружается лишними функциями.
3. Связь с основными сервисами
Микроприложение особенно полезно, когда оно не живет отдельно, а встраивается в существующие процессы:
- создает или дополняет задачи;
- работает с документами и вложениями;
- использует заявки и согласования;
- дополняет учет рабочего времени и сценарии MotionCode;
- отдает данные для аналитики и отчетности.
Базовая структура микроприложения
На практике удобно начинать с простого состава:
- экран списка;
- экран карточки;
- форма создания или редактирования;
- статусы;
- фильтры;
- права доступа.
Этого достаточно, чтобы быстро запустить первый рабочий сценарий и не перегружать проект на старте.
Запуск автоматизации из сервиса
Во встроенном веб-сервисе можно использовать зарегистрированное событие вместо
собственного HTTP-вебхука. Сначала сохраните сервис и создайте событие во вкладке
События, затем выберите его как триггер автоматизации. Код сервиса вызывает
synchra.emitEvent('report_ready', { report_id: '125' }, { requestKey }) после
нужного действия пользователя; метод не создаёт события в реестре.
Имена разделяются префиксом постоянного ID сервиса, а данные — компанией.
Подтверждение event_id означает приём в очередь. Предпросмотр не запускает
настоящие сценарии; мобильный мост пока не поддерживает этот метод.
Полный пример, доступы и ограничения — в
руководстве по встроенным сервисам.
Как не усложнить первый релиз
Для первого запуска лучше:
- оставить только один ключевой сценарий;
- сократить число ролей до минимально необходимого;
- не добавлять сложные интеграции, если они не обязательны;
- сначала проверить процесс на небольшой группе пользователей.
Так команда быстрее получает рабочий результат, а доработки можно делать уже по живой обратной связи.
Что можно подготовить для старта
Если вы хотите быстрее перейти к запуску, заранее соберите:
- название сценария и его краткое описание;
- список пользователей или ролей;
- перечень обязательных полей;
- статусы процесса;
- примеры карточек, таблиц или форм, если они уже есть.
Что дальше
Если у вас уже есть идея микроприложения, следующим шагом обычно становится описание сценария и ролей. После этого можно переходить к проектированию интерфейса и встраиванию в Synchra.24.
Доступ из бокового меню веб-версии
В настройках включите Разрешить в веб-версии. Для встроенного сервиса сохраните и опубликуйте код. Пункт в меню увидят только сотрудники с доступом; ограничения по лицензии и полномочию сохраняются. По умолчанию доступ в вебе выключен.
Во встроенном редакторе разделяйте реализации через synchra.getRuntime():
mobile — нативные действия телефона, web — ваша браузерная реализация.
Подробности, включая адаптер для сервиса по внешней ссылке:
Запуск в веб-версии.
Виджет дашборда
В настройках сервиса доступно назначение Виджет дашборда с отдельной плашкой настройки высоты. В мобильном приложении используется стандартный WebView с мостом; в веб-версии — Shadow DOM для доверенного кода встроенного сервиса. Для показа в вебе обязательно включите Разрешить в веб-версии. Права доступа и публикация продолжают проверяться. Подробности и ограничения: Назначение сервиса и виджеты.
Виджеты карточек
Сервис можно назначить виджетом задачи, инцидента, документа, выезда, визита, мероприятия журнала, отчёта, сотрудника управления или экрана управления. Используются те же WebView/Shadow DOM, SDK и отдельные высоты для платформ. Метод synchra.getWidgetContext() возвращает тип, ID и данные текущей записи; подписка synchra.onWidgetContextChange() обновляет их без перезапуска. Виджеты размещаются в конце карточки перед комментариями. Доступные места показа и использование контекста: Виджеты карточек и управления.
Общие данные с автоматизациями
Сервис может не только читать getArtifact, но и обновлять уже созданное имя через встроенный setArtifact(name, value) или событие app.automation.artifact.set. Значение заменяется целиком, права пользователя сохраняются. Автоматизация подключает его через artifacts и читает на любом этапе, включая context.artifacts в transform. Полное руководство.
Установка из локального шаблона
Готовый HTML/CSS/JavaScript-сервис можно упаковать вместе с service.json в ZIP и загрузить через Сервисы → Новый сервис → Из ZIP-шаблона в веб-администраторе. Создаётся новый неопубликованный сервис; токен и доступ сотрудников не переносятся. Экспорт из редактора уже содержит нужную конфигурацию. Формат пакета, примеры, права и ограничения — в руководстве встроенных сервисов. Для публикации используйте форму магазина расширений; локальный ZIP создаёт самостоятельную копию без связи с обновлениями магазина.