Общие рекомендации по публикации приложений Teams, расширяемых в Microsoft 365

Завершено

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

В этой статье вы найдете дополнительные сведения о следующих рекомендациях:

• Общие рекомендации
• Рекомендации по совместимости
• Рекомендации по работе с мобильными устройствами

Общие рекомендации

• Приложения Teams, предназначенные для расширения клиентов Microsoft 365, должны использовать манифест приложения версии 1.13 или более поздней.

• URL-адрес поддержки приложения должен содержать содержимое, соответствующее приложению в клиентах Microsoft 365, и не должен ссылаться только на один клиент.

• Содержимое, предлагаемое на страницах "Начало работы", "Вход", "Регистрация", "Выход", "Справка " или "Пути пересылки", должно ссылаться на все поддерживаемые клиенты.

• Приложение должно обеспечить значительную ценность для каждого из клиентов, для которых оно может быть расширяемо. Например, если у вас есть приложение только для вкладки в Teams и вы хотите, чтобы приложение было расширяемым до Microsoft 365 и Outlook, необходимо убедиться, что приложение предоставляет подходящие рабочие процессы в клиентах Microsoft 365 и Outlook. Ваше приложение должно предоставлять жизнеспособное решение, совместимое со всеми клиентами Майкрософт, к которым приложение может быть расширяемо.

  Чтобы объяснить требование к приложению обеспечить значительную ценность для пользователей во всех расширяемых клиентах, ниже приведены некоторые сценарии, в которых приложение Contoso распространяется на Microsoft 365 и Outlook, предоставляя значительную ценность для пользователей в Teams, но не предлагая рабочих процессов в клиентах Microsoft 365 и Outlook.

  Сценарий 1

  Contoso — это корпоративное приложение для агрегатора новостей, которое объединяет все внутренние новости и важную информацию, которая распространяется в компании на личной вкладке в Teams в интересах конечных пользователей. Пользователи Contoso могут добавить приложение Contoso Teams в свою личную область и быть в курсе новостей компании в режиме реального времени. У contoso также есть вкладка Справка, содержащая полное пошаговое руководство по функциональным возможностям, если пользователям потребуются рекомендации по использованию полного потенциала приложения. Contoso поддерживает расширяемость Microsoft 365 и Outlook на личных вкладках на этих клиентах. Однако после добавления приложения Contoso из Магазина Microsoft 365 или Outlook пользователи увидят только вкладку Справка, но личная вкладка с агрегированным содержимым новостей не отображается в Microsoft 365 и Outlook. Таким образом, приложение Contoso в Microsoft 365 и Outlook не предлагает подходящего программного решения и не отвечает значительной ценности в этих клиентах.

  Приложение Contoso в Outlook:
  

  
  

  Приложение Contoso в Microsoft 365:
  

  
  

  Рекомендация:

  Чтобы обеспечить значительную ценность, разработчик приложения Contoso должен убедиться, что личная вкладка в Teams с агрегированным содержимым новостей также будет отображаться в клиентах Microsoft 365 и Outlook.

  Сценарий 2

  Contoso — это приложение CRM (управление отношениями с клиентами) с личной вкладкой, которая позволяет агентам просматривать билеты и действовать с ними в Teams. В обновлении приложения разработчик Contoso обновил версию манифеста приложения до версии 1.16, что свидетельствует о намерении поддерживать расширяемость приложения Contoso CRM для клиентов Microsoft 365 и Outlook. Однако разработчик приложения Contoso CRM не тестировал рабочие процессы приложения в клиентах Microsoft 365 и Outlook перед отправкой на проверку приложения или неосознанно обновил манифест приложения без каких-либо реальных намерений для поддержки расширяемости Contoso CRM в Microsoft 365 и Outlook, и, следовательно, приложение Contoso CRM в этих клиентах отображает сообщение с просьбой пользователя использовать приложение в Teams.

  Приложение Contoso CRM в Outlook:
  

  

  Приложение Contoso CRM в Microsoft 365:
  

  

  Такие сценарии также часто встречаются при проверке приложений и завершаются сбоем, так как приложение не предоставляет существенной ценности в Microsoft 365 и Outlook.

  Рекомендации:

  Разработчикам рекомендуется создавать рабочие процессы, предоставляющие достаточное значение для пользователя в клиенте Microsoft 365 и Outlook, или понизить версию приложения до более низкой версии манифеста приложения.

Рекомендации по совместимости

• Приложения Teams, распространяющиеся на клиенты Microsoft 365, должны полностью реагировать и работать в последней версии клиентов Microsoft Edge и Google Chrome.
• Пользователь должен иметь возможность вызывать и использовать личные вкладки или расширения сообщений в последней версии следующего:
  • Outlook на компьютере, в Интернете и iOS.
  • Microsoft 365 на компьютере, в Интернете, Android и iOS.

Рекомендации по работе с мобильными устройствами

• Пользователи должны иметь возможность запускать приложение из всплывающего меню действий в клиентах Microsoft 365 и Outlook на мобильных устройствах, а имя приложения должно отображаться на панели действий.
• Пользователи должны иметь возможность запускать и переключаться между несколькими статическими вкладками в клиенте Microsoft 365 на мобильных устройствах, и вкладки должны загружаться. Если статических вкладок больше трех, остальные вкладки должны быть видны в разделе Дополнительно .
• Если приложение использует единый вход (SSO), оно должно успешно пройти проверку подлинности пользователя в клиенте, в котором приложение запускается впервые, без необходимости повторной проверки подлинности на каждом клиенте.
• Когда пользователь переключается или выходит из клиентов Microsoft 365 и Outlook на мобильных устройствах, приложение должно закрыть экземпляр пользователя.
• Пользователи должны иметь возможность вернуться к предыдущему рабочему состоянию. Если пользователь находится на корневой странице, обратная навигация должна завершить экземпляр приложения в клиенте на мобильном устройстве.
• Приложения, поддерживающие прямую связь с рабочим процессом, должны иметь возможность перенаправлять пользователя на соответствующую целевую страницу.
• Индикаторы хода выполнения должны отображаться при загрузке приложения и автоматически закрывать его после полной загрузки приложения.
• Экран ошибки должен отображаться, когда приложение не загружается из-за несогласованности или сбоя сети, времени ожидания и сбоя проверки подлинности.