Synchra.24
menu_bookDocumentation
Practical guides for setup and development

Find guides for getting started, building workflows and adding your own tools to your company workspace.

folderEmbedded services

Launching in the web version

Web access, environment definition, external service, and mobile bridge compatibility.

Translation is currently unavailable. The original is shown.

Запуск в веб-версии

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

Сервис появится в боковом меню Сервисы с заданными названием и иконкой. Он участвует в поиске меню и в персональной настройке видимости разделов. После сохранения или публикации меню обновляется. При переходе по пункту сервис открывается внутри обычной рабочей области с сохранением бокового меню. Область сервиса заполняет оставшуюся высоту экрана под шапкой; снизу сохраняется отступ 20 пикселей, в том числе в светлой теме и на узком экране. Длинное содержимое прокручивается внутри области сервиса.

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

Сервис по внешней ссылке открывается во встроенном окне. Его сайт должен разрешать встраивание через собственные заголовки CSP / X-Frame-Options. Если это запрещено, используйте Открыть отдельно. При открытии отдельно авторизованный мост Synchra24 недоступен. Сайты по внешним ссылкам не получают пользовательский или корпоративный API-токен.

Проверка среды выполнения

Во встроенном сервисе доступен синхронный метод:

const runtime = synchra.getRuntime(); // 'web' или 'mobile'
if (runtime === 'mobile') {
  const photo = await synchra.takePhoto({ upload: true });
  // Обработайте результат нативной камеры.
} else {
  // Собственная веб-реализация: например, обычный input type="file".
  document.querySelector('#web-file-input')?.click();
}

isSynchraIntegrated() проверяет доступность моста, а getRuntime() определяет среду: это разные проверки. Не определяйте мобильную среду по наличию ReactNativeWebView: в вебе движок использует совместимый транспорт. Нативные действия в вебе не открывают камеру, геолокацию или диалоги телефона: они возвращают {runtime: 'web', supported: false, ignored: true}. Это не успешное получение фотографии или координат. Неизвестные методы и произвольные api.request не разрешаются автоматически.

Для внешнего сервиса, использующего свою версию SDK, доступна проверка window.getSynchraRuntime?.() ?? 'web'. Мобильное приложение устанавливает эту функцию до загрузки страницы. Метод synchra.getRuntime() предоставляется встроенным движком, а не любой старой версией npm-пакета. Веб-альтернатива подчиняется ограничениям браузера и sandbox; мобильный вызов не преобразуется автоматически в браузерный.

Внешний сервис в браузере

Приложение по ссылке должно разрешать встраивание в страницу Synchra24. Поддержка её функций в браузере зависит от используемой версии библиотеки интеграции. Проверяйте подключение через isSynchraIntegrated() и обрабатывайте недоступность нужного метода.

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

Если сайт не разрешает встраивание, откройте его отдельно. В отдельной вкладке функции интеграции Synchra24 недоступны. Не передавайте токены входа пользователя в адресе страницы.

Доступ с телефона и ограничения

В мобильном приложении опубликованный сервис открывается без отдельного входа в веб-версию. Доступ зависит от подписки компании, роли сотрудника и настроек сервиса, включая Разрешить в мобильной версии. Выключение мобильного показа не меняет веб-показ и не удаляет данные.

Встроенным сервисам нужно интернет-соединение: офлайн-работа пока не поддерживается. При открытии ссылки в обычном браузере потребуется войти в Synchra24.