Интеграции и внешние кабинеты

Диагностика ошибок и обращение в поддержку

Порядок проверки прав, организации, сети, кэша, интеграции, файлов и идентификатора запроса перед обращением.

Для чего нужен

  • Порядок проверки прав, организации, сети, кэша, интеграции, файлов и идентификатора запроса перед обращением.
  • Дать сотруднику точный порядок действий и ожидаемый результат: Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.
  • Закрепить единый рабочий сценарий для команды, руководителя и администратора.
Когда использовать: При ошибке интерфейса, запрете действия, пропавших данных, сбое интеграции или загрузки файла.

Кто работает

  • Сотрудник фиксирует сценарий.
  • Администратор проверяет права и настройки.
  • Поддержка исследует request_id и логи.

Порядок работы

  1. 1

    Зафиксируйте сценарий

    Раздел, карточка, действие, ожидаемый и фактический результат.

  2. 2

    Повторите безопасно

    Обновите данные и повторите одно действие без массовых операций.

  3. 3

    Проверьте контекст

    Активная компания, организация, роль, исполнитель и архивный статус.

  4. 4

    Определите класс

    403 - права, 404 - ресурс или область, 409 - конфликт версии, 422 - данные, 500 - сервер.

  5. 5

    Соберите доказательства

    Время, адрес страницы, снимок экрана, устройство и название записи. Если в ошибке показан ID запроса, приложите его.

  6. 6

    Передайте обращение

    Опишите один воспроизводимый дефект без паролей, токенов и персональных секретов.

Возможности

  • Расшифровка кодов ошибок.
  • ID запроса.
  • Порядок восстановления.
  • Безопасный сброс кэша.
  • Проверка подключений.
  • Чек-лист обращения.

Связи с другими модулями

  • «Настройки → Платформа → Аудит» показывает, кто и что менял.
  • Вкладка «Подключённые» в Маркетплейсе показывает состояние интеграций.
  • «Настройки → Платформа → Диагностика системы» (для администраторов) показывает состояние системы.
  • Поддержка находит ошибку по времени и ID запроса.

Что происходит дальше

  • Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.
  • Изменение фиксируется в истории и становится доступно только участникам с подходящими правами.
  • Связанные модули получают событие и обновляют свои списки, уведомления или показатели.

Пример: Диагностика ошибок и обращение в поддержку

При ошибке интерфейса, запрете действия, пропавших данных, сбое интеграции или загрузки файла.

  1. Зафиксируйте сценарий: Раздел, карточка, действие, ожидаемый и фактический результат.
  2. Повторите безопасно: Обновите данные и повторите одно действие без массовых операций.
  3. Проверьте контекст: Активная компания, организация, роль, исполнитель и архивный статус.
  4. Определите класс: 403 - права, 404 - ресурс или область, 409 - конфликт версии, 422 - данные, 500 - сервер.
  5. Соберите доказательства: Время, адрес страницы, снимок экрана, устройство и название записи. Если в ошибке показан ID запроса, приложите его.
  6. Передайте обращение: Опишите один воспроизводимый дефект без паролей, токенов и персональных секретов.
Результат: Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.

Проверка перед запуском

  • Сценарий воспроизводится.
  • Активная компания указана.
  • Время и URL есть.
  • Request ID сохранён.
  • Секреты скрыты.
  • Ожидаемое поведение описано.

Частые вопросы

Когда сбрасывать локальный кэш?

После обычной перезагрузки и проверки статуса. На экране ошибки есть кнопка «Сбросить кэш и в начало». Сброс удаляет локальные настройки устройства, поэтому используйте его как отдельный диагностический шаг.

Появилось «Доступно обновление приложения». Что делать?

Taska обновилась. Сохраните текущую работу и обновите страницу: после этого откроется новая версия.