Устранение неполадок приложения Microsoft Teams

  • Статья

Устранение неполадок с вкладками

Доступ к средствам разработки

Вы можете открыть средства разработки в клиенте Teams , чтобы нажать клавишу F12 (в Windows) или Command-Option-I (в MacOS) в браузере.

Пустой экран вкладки

Если содержимое не отображается в представлении вкладки, это может быть следующее:

  • содержимое не может отображаться в <iframe>.
  • домен содержимого отсутствует в списке допустимых доменов в манифесте.

Примечание.

Когда заданный URL-адрес вкладки перенаправляется на экран входа, отображается пустая вкладка. Страницы входа не отображаются в iFrames в качестве защиты от щелчка. Логика проверки подлинности должна использовать метод, отличный от перенаправления.

Изменения в веб-приложении не отражаются на вкладке Teams

Если у вас возникают проблемы с последовательным или периодическим кэшированием, из-за которых обновления веб-приложения не отображаются при его размещении на вкладке Teams, проверка параметры кэша сервера и используйте Cache-Control заголовки, чтобы обеспечить требуемое поведение кэширования клиента.

Кнопка Сохранить не включена в диалоговом окне параметров

Убедитесь, что вызов вызовет microsoftTeams.settings.setValidityState(true) после ввода или выбора пользователем всех необходимых данных на странице параметров, чтобы включить кнопку сохранения.

Не удается сохранить параметры вкладки при выборе кнопки Сохранить

Если при добавлении вкладки выбрать Сохранить , но появится сообщение об ошибке, указывающее, что параметры не удается сохранить, проблема может быть одним из двух классов проблем:

  • Сообщение об успешном сохранении не было получено: если обработчик сохранения был зарегистрирован с помощью microsoftTeams.settings.registerOnSaveHandler(handler), обратный вызов должен вызвать saveEvent.notifySuccess().

    • Если обратный вызов не вызывается saveEvent.notifySuccess() в течение 30 секунд или вместо этого вызывает saveEvent.notifyFailure(reason) , отображается эта ошибка.
    • Если обработчик сохранения не зарегистрирован, saveEvent.notifySuccess() вызов выполняется автоматически, когда пользователь нажимает кнопку Сохранить.

  • Предоставленные параметры были недопустимыми. Другая причина, по которой параметры не могут быть сохранены, заключается в том, что вызов microsoftTeams.setSettings(settings) предоставил недопустимый объект settings или вызов не был выполнен вообще. См. раздел Общие проблемы с объектом settings.

Распространенные проблемы с объектом settings

  • settings.entityId отсутствует. Это поле является обязательным.
  • settings.contentUrl отсутствует. Это поле является обязательным.
  • settings.contentUrl или необязательные settings.removeUrl, или settings.websiteUrl предоставляются, но недопустимы. URL-адреса должны использовать ПРОТОКОЛ HTTPS, а также должны быть тем же доменом, что и страница параметров, или указываться в списке манифеста validDomains .

Не удается проверить подлинность пользователя или отобразить поставщик проверки подлинности на вкладке

Если вы не выполняете автоматическую проверку подлинности, необходимо следовать процедуре проверки подлинности, предоставляемой клиентской библиотекой JavaScript в Microsoft Teams.

Примечание.

Мы требуем, чтобы весь поток проверки подлинности запускался и заканчивался в вашем домене, который должен быть указан в объекте validDomains манифеста.

Дополнительные сведения о проверке подлинности см. в статье Проверка подлинности пользователя.

Статические вкладки не отображаются

Существует известная проблема, из-за которой при обновлении существующего приложения бота с помощью новой или обновленной статической вкладки не отображается изменение вкладки при доступе к приложению из личной беседы в чате. Чтобы увидеть изменение, необходимо выполнить тестирование на новом пользователе или тестовом экземпляре или получить доступ к боту из всплывающего меню Приложения.

Устранение неполадок с ботами

Не удается добавить бота

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

Не удается добавить бота в качестве члена команды

Боты должны быть сначала отправлены в команду, прежде чем они станут доступны в любом канале этой команды. Дополнительные сведения об этом процессе см. в статье о том, как отправить приложение в команду.

Мой бот не получает мое сообщение в канале

Боты в каналах получают сообщения только в явном виде @mentioned, даже если вы отвечаете на предыдущее сообщение бота. Единственное исключение, в котором имя бота может не отображаться в сообщении imBack , заключается в том, что бот получает действие в результате отправки CardAction.

Мой бот не понимает мои команды, когда в канале

Так как боты в каналах получают сообщения только в том случае, если они являются @mentioned, все сообщения, получаемые ботом в канале, включают их @mention в текстовое поле. Рекомендуется удалить имя бота из всех входящих текстовых сообщений перед передачей в логику анализа. Советы по обработке этого случая см. в упоминаниях .

Проблемы с упаковкой и отправкой

Ошибка при чтении manifest.json

Большинство ошибок манифеста дают указание на то, какое конкретное поле отсутствует или недопустимо. Однако если JSON-файл вообще не может быть прочитан как JSON, используется это универсальное сообщение об ошибке.

Распространенные причины ошибок чтения манифеста:

  • Недопустимый КОД JSON. Используйте интегрированную среду разработки, например Visual Studio Code или Visual Studio, которая автоматически проверяет синтаксис JSON.
  • Проблемы с кодировкой. Используйте UTF-8 для файла manifest.json . Другие кодировки, особенно с спецификацией, могут быть недоступны для чтения.
  • Неправильно сформированный пакет .zip. Файл manifest.json должен находиться на верхнем уровне файла .zip. Обратите внимание, что сжатие файлов Mac по умолчанию может поместить файл manifest.json в подкаталог, который не загружается должным образом в Microsoft Teams.

Существует другое расширение с тем же идентификатором

Если вы снова пытаетесь отправить обновленный пакет с тем же идентификатором, нажмите значок Заменить в конце строки таблицы вкладки, а не кнопку Отправить .

Если вы не отправляете обновленный пакет повторно, убедитесь, что идентификатор уникален.

См. также