Запуск у вэб-версіі
Вэб-доступ, вызначэнне асяроддзя, знешні сэрвіс і сумяшчальнасць мабільнага моста.
Пераклад пакуль недаступны. Паказаны арыгінал.
Запуск в веб-версии
В настройках сервиса включите Разрешить в веб-версии и сохраните изменения. Для виджета переключатель находится в плашке Настройки виджета, для обычного сервиса — Доступность сервиса. Для нового встроенного сервиса этот же переключатель доступен при создании. По умолчанию он выключен: существующие сервисы не появляются в вебе автоматически. Рядом находится независимый переключатель Разрешить в мобильной версии, по умолчанию включённый. Можно оставить сервис доступным только на одной платформе.
Сервис появится в боковом меню Сервисы с заданными названием и иконкой. Он участвует в поиске меню и в персональной настройке видимости разделов. После сохранения или публикации меню обновляется. При переходе по пункту сервис открывается внутри обычной рабочей области с сохранением бокового меню. Область сервиса заполняет оставшуюся высоту экрана под шапкой; снизу сохраняется отступ 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.