Поделиться через

Общие рекомендации по объединению надстройки Office и приложения Teams

  • Статья

Если у вас есть приложение Teams и надстройка Office с тесно связанными или перекрывающимися функциями и рабочими нагрузками, рекомендуется объединить их в одно приложение. Это позволяет пользователям и администраторам клиентов Microsoft 365 получать и утверждать надстройку и приложение Teams как единое целое. Пример приложения, сочетающего надстройку и приложение Teams, см. в разделе Пример предложения скидок.

Примечание.

Надстройки Outlook — это единственный тип надстроек Office, который можно комбинировать с приложением Teams. Мы прилагаем все усилия для поддержки этой функции для Excel, PowerPoint и Word надстройки.

Не может быть алгоритмической процедуры слияния надстройки и приложения Teams по следующим причинам:

  • Алгоритму придется делать предположения о структуре папок и файлов существующего приложения Teams. Но эти структуры зависят от того, какое средство использовалось для создания проекта приложения и какой версии этого средства. И, конечно, разработчик приложения мог изменить структуру после создания проекта.
  • Предыдущий маркер также относится к проекту надстройки.
  • Алгоритму придется делать предположения о параметрах в различных файлах конфигурации. Но эти параметры также будут отличаться в зависимости от того, как был создан проект и изменения, внесенные в конфигурацию с момента его создания.
  • Алгоритм должен сделать предположение о том, какой язык, TypeScript или JavaScript, использовался для клиентского исходного кода веб-приложения.

Примечание.

В дополнение к этим маркерам следует также отметить, что существует два основных семейства платформ веб-приложений, на которых можно было создать надстройку или приложение Teams.

В настоящее время Visual Studio не поддерживает унифицированный манифест в проектах надстроек, поэтому в этой статье предполагается, что проекты надстроек и приложений Teams основаны на Node.js и не создаются с помощью Visual Studio.

Однако мы можем сделать некоторые общие рекомендации по объединению надстройки с приложением Teams.

Сведения о манифесте и структуре объединенного приложения Teams и надстройки Office

Прежде чем приступить к объединению двух существующих расширений, получите представление о том, как объединить два типа расширений, создав новое приложение Teams и новую надстройку в наборе средств Teams, а затем следуйте инструкциям в разделе Добавление надстройки Outlook в приложение Teams для их объединения. Обратите особое внимание на следующее:

  • Как создается единый унифицированный манифест.
  • Различия в способах загрузки и отладки надстройки и приложения Teams.

Соблюдайте правильные принципы объединения приложений и надстроек Teams

Когда вы будете готовы объединить существующую надстройку и приложение Teams, следуйте следующим принципам:

  • Если надстройка использует XML-манифест, преобразуйте его для использования единого манифеста для Microsoft 365, как описано в разделе Преобразование надстройки в использование унифицированного манифеста для Microsoft 365, прежде чем объединять его с приложением Teams.
  • Используйте проект приложения Teams в качестве базового проекта для объединенного приложения.
  • Сохраните файлы конфигурации, применимые как к надстройке, так и к приложению Teams в корневой части проекта.
  • Переместите исходные файлы и файлы конфигурации, которые применимы только к приложению Teams, во вложенную папку из корневого каталога проекта. Аналогичным образом скопируйте исходные файлы и файлы конфигурации, используемые только надстройкой, из существующей надстройки в другую вложенную папку из корня объединенного проекта.
  • Используйте один и тот же базовый домен для встроенных файлов надстройки и приложения Teams; например, contoso.com.
  • Объедините два манифеста в один манифест. Используйте процесс, который вы прошли на шаге 1, в качестве руководства.
  • Свойство id в новом манифесте должно иметь то же значение, что и свойство id в исходном манифесте приложения Teams.
  • Повышение значения свойства version ; например, вызовите "1.0.0" до "1.1.0".
  • Добавьте свойство extensions.alternates в манифест и настройте его для скрытия исходной надстройки Office в версиях Office, поддерживающих объединение надстройки и приложения Teams. Дополнительные сведения см. в статье Управление новыми и старыми версиями надстройки.

Публикация объединенного приложения Teams и надстройки Office

Чтобы опубликовать объединенное приложение, обработайте его как обновление приложения Teams. Дополнительные сведения см. в статье Публикация обновлений в приложении.

Когда обновление будет опубликовано, то, как обновление станет доступным для конечных пользователей, зависит. Ниже приведены общие принципы.

Примечание.

Чтобы понять, что означает "доступно", обратите внимание, что Outlook и приложение Microsoft 365 имеют панель приложения так же, как и Teams. В принципе, "Приложение Teams" можно установить с помощью кнопки "Приложения " или "Другие приложения " на любой из этих трех панели приложения. Установленное приложение Teams можно запустить из любой панели любого из трех приложений (или отдельно закрепить на ней). С другой стороны, автономная надстройка Outlook устанавливается с помощью кнопки Все приложения на ленте Outlook. И, независимо от того, является ли надстройка автономной или объединенной в приложение Teams, надстройка запускается с ленты Outlook или автоматически запускается в ответ на событие в открытом сообщении Outlook или элементе собрания. Эти факты предполагаются в оставшейся части этого раздела.

  • Если администратор Microsoft 365 дает согласие на обновление, выполните следующие действия:

    • Обновленная версия приложения Teams доступна сразу в разделе "Приложения" или "Другие приложения " в Outlook и приложении Microsoft 365, но не в приложениях Teams, для пользователей, которые ранее приобрели приложение Teams.
    • Надстройка Outlook также доступна сразу для пользователей, которые ранее приобрели приложение Teams, независимо от того, приобрели ли они надстройку ранее.
    • Если администратор Teams разрешает обновление, пользователи могут по отдельности установить его в Teams из приложений Teams.

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

  • Пользователи, которые ранее приобрели только надстройку Office, должны приобрести новое объединенное приложение из магазина Teams. Его невозможно получить с помощью кнопки "Все приложения " на ленте Outlook.

Важно!

Пользователи с некоторыми более старыми версиями Office могут по-прежнему видеть старую версию надстройки даже после приобретения нового объединенного приложения. Как правило, надстройки, использующие манифест единого приложения для Microsoft 365 (ранее — Манифест приложения Teams), можно установить только в Microsoft 365 версии 2307 (сборка 16626.20132) и более поздних версиях. Однако существуют два исключения, которые позволяют устанавливать эти надстройки в более ранних версиях Microsoft 365 и в версиях Office с бессрочной лицензией.

  • Администратор Microsoft 365 развертывает надстройку для всех пользователей.
  • Пользователь устанавливает надстройку в Outlook в Интернете, новый Outlook для Windows или в другом классическом клиентском приложении Microsoft 365 версии 2307 (сборка 16626.20132) или более поздней версии. Это делает надстройку доступной на других клиентах Office того же пользователя, в том числе на клиентах с более старыми или бессрочными лицензиями.

В будущем потребуется только обновить новую версию приложения.

См. также