Диагностика
Начните с воспроизведения одной операции на небольшом тестовом файле под учётной записью пользователя, у которого возникла проблема. Зафиксируйте время, запись, формат, выбранный редактор и хранилище. Не меняйте несколько настроек одновременно: после каждого исправления повторяйте тот же сценарий.
Нет кнопки или действие запрещено
- Проверьте наличие и назначение лицензии продукта пользователю.
- Проверьте права на запись и её вложения.
- Убедитесь, что выбрано файловое вложение, а не внешняя ссылка.
- Проверьте формат и текущую блокировку.
- Определите место хранения. Для внешней папки отсутствие кнопок редактирования, блокировки и расширенного предпросмотра соответствует ограничениям функции.
Сравните поведение администратора и целевого пользователя. Если действие работает только у администратора, не делайте вывод о готовности для всех пользователей; уточните лицензию и права.
Предпросмотр пустой
Проверьте, поддерживается ли формат выбранным способом просмотра, и скачайте ту же версию. Если скачанный файл открывается, а предпросмотр нет, проверяйте сервис просмотра и доступность требуемых сетевых соединений. Если файл не скачивается, сначала устраняйте проблему доступа или хранилища.
Не считайте наличие ответа HTTP доказательством чтения документа: нужно проверить, что возвращается содержимое нужного файла, а не пустой ответ или страница авторизации.
Онлайн-редактор не запускается
Сначала проверьте блокировку всплывающих окон браузером и OnlineEditService. Затем используйте проверку выбранного сервиса:
| Сервис | Что проверить |
|---|---|
| OneDrive | Client ID и значение секрета из одного приложения; срок секрета; точный URI; делегированные права и согласие |
| Яндекс.Диск | ClientID и секрет приложения; права Диска; получение и ввод нового кода в окно подключения |
| OnlyOffice / Р7 | Корневой адрес сервера документов, доступ браузера к интерфейсу и совпадение JWT-секрета |
| Nextcloud + OnlyOffice | Сначала работа редактора внутри Nextcloud, затем подключение хранилища и NextCloudOnlyOfficeEditing |
Если сервис открыл только авторизацию, после её завершения повторно запустите редактирование из карточки.
Изменения не вернулись в BPMSoft
Разделите проверку на два этапа. Сначала убедитесь, что редактор сохранил нужное содержимое. Затем проверьте появление новой версии в BPMSoft и её открытие.
Для Word проверьте работающий Informer, совпадение пользователя и адреса с браузером и активное соединение. Для OnlyOffice и Р7 проверьте получение исходного файла сервером документов и доставку callback в BPMSoft. Для облачного редактора проверьте завершение сессии и подтверждение сохранения после возврата в карточку.
Сопоставьте журнал BPMSoft и журнал редактора или Informer по одному времени попытки. Проверьте ошибки авторизации, получения файла и сохранения результата. Если документ важен, сохраните доступную копию изменений до повторной попытки.
Новые или старые файлы недоступны после смены хранилища
Проверьте новое тестовое вложение и отдельно старое. Новые используют выбранное активное хранилище, старые остаются в прежнем. Отсутствие автоматического переноса соответствует поведению продукта.
| Хранилище | Проверки |
|---|---|
| Внешняя папка | Активное хранилище БД, серверный путь, права учётной записи приложения, свободное место и порог размера |
| S3 | Endpoint, ключи, имена двух бакетов, доступ приложения и обработка удалений |
| SharePoint | Тип развёртывания, поддерживаемая схема авторизации, сайт и права; классический ACS-путь не подходит SharePoint Online |
| Nextcloud | OAuth2-клиент, секрет, URI, адрес и завершённая авторизация |
Блокировка не снимается
Проверьте владельца блокировки и незавершённую сессию пользователя. Сохраните его результат до принудительных действий. Затем проверьте SmrMaxTimeLockedFile в минутах и состояние процесса Разблокирование файлов с истекшим временем блокирования. Преднастроенная проверка выполняется раз в пять минут; ожидание до ближайшего запуска после срока является нормальным.
При независимых редакторах проверьте SmrLockFileWhenEditing, а при работе с одним облачным содержимым — SmrParallelFileEditMode и права участников в сервисе.
Informer не получает задачи или не запускает Word
Проверьте запуск приложения, адрес BPMSoft, учётную запись и состояние значка соединения. Проверьте, есть ли у пользователя активности, в которых он указан ответственным. Для Word проверьте установку приложения и формат .docx. Для сравнения нужны как минимум две версии.
Если действие выхода или перемещение окна недоступно, проверьте применённую запись Настроек Informer для пользователя и роли. Для воспроизведения включите журнал приложения и проверьте записи в sockets.log по времени операции.
Передать обращение
Включите версию BPMSoft и продукта, платформу, тип развёртывания, редактор, хранилище, формат и размер файла, учётную роль пользователя, выполненные шаги, время и текст ошибки. Приложите относящиеся к попытке фрагменты журналов без секретов и при необходимости обезличенный пример файла. Укажите, на каком этапе ошибка воспроизводится: запуск, авторизация, чтение, сохранение или создание версии.