Управление унифицированным манифестом и версией манифеста только надстройки Office
Корпорация Майкрософт вносит ряд улучшений в платформу разработчиков Microsoft 365. Эти улучшения обеспечивают большую согласованность при разработке, развертывании, установке и администрировании всех типов расширений Microsoft 365, включая надстройки Office.
Одним из важных улучшений, над которым мы работаем, является возможность создания единой единицы распространения для всех расширений Microsoft 365 с использованием одного формата манифеста: унифицированного манифеста в формате JSON для Microsoft 365.
Совет
Сведения о преобразовании существующей надстройки для использования единого манифеста см. в статье Преобразование надстройки в использование единого манифеста для Microsoft 365.
После создания версии надстройки, которая использует унифицированный манифест, необходимо связать существующую надстройку и приложение, созданное с помощью единого манифеста, чтобы пользователи не видели две копии пользовательского интерфейса надстройки в Outlook.
Примечание.
Описанная ниже конфигурация не вступают в силу в течение 24 часов после установки новой версии на компьютере пользователя. В течение этого периода пользовательский интерфейс обеих версий отображается. Например, если в обеих версиях есть настраиваемая кнопка ленты, на ленте отображаются обе кнопки.
Выполните следующие действия.
Откройте объект расширения в массиве extensions.
Создайте свойство массива alternatives, если его еще нет.
В массиве alternatives создайте альтернативный объект со свойством hide.
Если существующая надстройка продается через AppSource, присвойте объекту hide свойство storeOfficeAddin. В противном случае перейдите к шагу 6.
Присвойте объекту storeOfficeAddin два свойства:
- Объект "officeAddinId" с ИДЕНТИФИКАТОРом GUID старой надстройки в качестве значения.
- Значение assetId с идентификатором ресурса AppSource.
Ниже приведен пример.
"extensions": [ ... { ... "alternates": [ ... { ... "hide": { "storeOfficeAddin": { "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4", "assetId": "WA999999999" } } } ] } ]Примечание.
- Идентификатор ресурса надстройки в унифицированном манифесте должен совпадать с существующей надстройкой, опубликованной вашей учетной записью продавца в Центре партнеров. Если идентификатор ресурса надстройки, которую вы связали в едином манифесте, не соответствует существующему предложению, опубликованному вашей учетной записью продавца, отправка унифицированного манифеста завершится ошибкой. Вам потребуется обновить манифест, чтобы использовать правильный идентификатор ресурса надстройки и повторно отправить унифицированный манифест.
- Существующая надстройка может быть скрыта только одним унифицированным манифестом. В настоящее время для скрытия одной надстройки нельзя использовать несколько унифицированных манифестов. Если вы попытаетесь скрыть уже связанную надстройку с помощью другого унифицированного манифеста, отправка завершится ошибкой. Вам потребуется удалить ссылку и повторно отправить унифицированный манифест.
Если старая надстройка не распространяется через AppSource, присвойте объекту hide свойство customOfficeAddin.
Присвойте объекту customOfficeAddin свойство "officeAddinId" со значением GUID старой надстройки. Ниже приведен пример.
"extensions": [ ... { ... "alternates": [ ... { ... "hide": { "customOfficeAddin": { "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4" } } } ] } ]
Не удаляйте существующую надстройку из AppSource или Центра администрирования Microsoft 365. Более ранние версии Office больше не смогут использовать надстройку.
Обслуживание обеих версий в ближайшем будущем
Как правило, надстройки, использующие унифицированный манифест, можно установить только в Microsoft 365 версии 2307 (сборка 16626.20132) и более поздних версиях. Однако существуют два исключения, которые позволяют устанавливать эти надстройки в более ранних версиях Microsoft 365 и в версиях Office с бессрочной лицензией.
- Администратор Microsoft 365 развертывает надстройку для всех пользователей.
- Пользователь устанавливает надстройку в другое клиентское приложение Microsoft 365 версии 2307 (сборка 16626.20132) и более поздних версий. Это делает надстройку доступной на других клиентах Office того же пользователя, включая старую или бессрочную лицензию.
Если у вас есть пользователи с более старыми или бессрочными версиями лицензий, для которых эти исключения не применяются, вам потребуется сохранить обе версии надстройки. Когда все пользователи работают с версиями Office, поддерживающими унифицированный манифест, можно удалить версию XML из развертывания.
Существуют также некоторые сценарии, в которых может потребоваться поддерживать обе версии надстройки в течение длительного периода времени. Например, существуют две функции надстроек, которые не поддерживаются в унифицированном манифесте, так как они мало используются или не рекомендуется использовать. Вы можете сохранить версию надстройки, которая использует эти функции. Ниже приведены функции, которые не поддерживаются в унифицированном манифесте.
- Модули Outlook не поддерживаются. Но вы можете обеспечить практически идентичный интерфейс с помощью единого манифеста, включив вкладку Teams с надстройкой в одном приложении.
- Контекстные надстройки Outlook (также известные как "правила активации") не поддерживаются. Но вы можете обеспечить аналогичные возможности с помощью унифицированного манифеста и активации на основе событий.
Критически важное требование для обеспечения доступности двух версий — убедиться, что в пользовательском интерфейсе Outlook они отличаются друг от друга.
- Присвойте новой версии имя, отличное от имени существующей надстройки.
- Создайте и используйте различные значки для новой версии.
- Убедитесь, что свойство "id" унифицированного манифеста в новой версии отличается от <GUID элемента Id> в манифесте только надстройки существующей надстройки.
Примечание.
Если вы используете одно и то же имя и значок, старые и новые решения отображаются в пользовательском интерфейсе Outlook для установки надстройки.
Office Add-ins