Synchra.24
menu_bookDocumentación
Практические материалы по запуску и развитию

Здесь собраны инструкции по запуску, разработке внутренних сценариев и встраиванию собственных инструментов в рабочий контур компании.

folderServicios integrados

Ejecutar en la versión web

Acceso web, definición de entorno, Servicio externo y compatibilidad de puente móvil.

La traducción no está disponible. Se muestra el original.

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

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

Сервис появится в боковом меню Сервисы с заданными названием и иконкой. Он участвует в поиске меню и в персональной настройке видимости разделов. После сохранения или публикации меню обновляется. При переходе по пункту сервис открывается внутри обычной рабочей области с сохранением бокового меню. Область сервиса заполняет оставшуюся высоту экрана под шапкой; снизу сохраняется отступ 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.