Убедитесь, что надстройка Office совместима с существующей надстройкой COM

Если у вас есть существующая надстройка COM, вы можете создать эквивалентную функциональность в Office надстройки, что позволит вашему решению работать на других платформах, таких как Office в Интернете или Mac. В некоторых случаях Office надстройка может быть не в состоянии предоставить все функциональные возможности, доступные в соответствующей надстройки COM. В таких ситуациях надстройка COM может предоставлять пользователям более Windows, чем соответствующие Office надстройки.

Можно настроить надстройку Office так, чтобы при установке эквивалентной надстройки COM на компьютере пользователя Office на Windows надстройка COM вместо надстройки Office. Надстройка COM называется "эквивалентной", так как Office плавно переходит между надстройки COM и надстройки Office, в соответствии с которой устанавливается компьютер пользователя.

Важно!

Эквивалентная функция надстройки поддерживается следующей платформой и приложениями. Надстройки COM не могут быть установлены на любой другой платформе, поэтому на этих платформах игнорируется элемент манифеста, который обсуждается позже в этой EquivalentAddins статье.

  • Excel, Word и PowerPoint на Windows (версия 1904 или более поздней версии)
  • Outlook версии Windows версии 2102 или более поздней версии Exchange сервера
    • Exchange Online
    • Exchange 2019 Накопительное обновление 10 или более поздней версии(KB5003612)
    • Exchange 2016 накопительного обновления 21 или более поздней версии(KB5003611)

Укажите эквивалентную надстройка COM

Манифест

Важно!

Применяется к Excel, Outlook, PowerPoint и Word.

Чтобы обеспечить совместимость Office надстройки и надстройки COM, определите эквивалентную надстройка COM в манифесте Office надстройки. Затем Office на Windows надстройка COM вместо надстройки Office, если они установлены.

В следующем примере показана часть манифеста, которая указывает надстройки COM в качестве эквивалентной надстройки. Значение элемента определяет надстройку COM, а элемент EquivalentAddins должен быть позиционен непосредственно ProgId перед закрывающими VersionOverrides тегами.

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

Совет

Сведения о совместимости надстройки COM и совместимости XLL UDF см. в ссылке Make your custom functions compatible with XLL user-defined functions. Не применимо для Outlook.

Групповая политика

Важно!

Применяется только Outlook.

Чтобы объявить совместимость между Outlook веб-надстройки и надстройки COM/VSTO, определите эквивалентную надстройку COM в групповой политике Deactivate Outlook веб-надстроек, эквивалентные com или VSTO надстройки, установленные путем настройки на компьютере пользователя. Затем Outlook на Windows будет использовать надстройки COM вместо веб-надстройки, если они установлены.

  1. Скачайте последний инструмент административных шаблонов,обращая внимание на инструкции по установке средства.
  2. Откройте редактор локальной групповой политики (gpedit.msc).
  3. Перейдите к административным шаблонам конфигурации > > пользователей Microsoft Outlook 2016 > разных типов.
  4. Выберите параметр Deactivate Outlook веб-надстроек, у которых установлен эквивалент com или VSTO надстройка.
  5. Откройте ссылку для редактирования параметра политики.
  6. В диалоговом Outlook веб-надстроек для отключения:
    1. Установите имя value для найденного в манифесте Id веб-надстройки. Важно. Не добавляйте фигурные скобки {} вокруг входа.
    2. Задайте значение ProgId эквивалентной надстройки COM/VSTO.
    3. Выберите ОК, чтобы вложить обновление в действие. Снимок экрана, показывающий диалоговое окно "Outlook веб-надстроек для деактивации".

Эквивалентное поведение для пользователей

При указанииэквивалентной надстройки COM Office на Windows не будет отображаться пользовательский интерфейс Office надстройки (UI), если установлена эквивалентная надстройка COM. Office только скрывает кнопки ленты надстройки Office надстройки и не препятствует установке. Поэтому Office надстройка по-прежнему будет отображаться в следующих расположениях в пользовательском интерфейсе.

  • В статье Мои надстройки
  • В качестве записи в диспетчере ленты (только Excel, Word и PowerPoint)

Примечание

Указание эквивалентной надстройки COM в манифесте не влияет на другие платформы, такие как Office в Интернете или Mac.

В следующих сценариях описывается, что происходит в зависимости от того, как пользователь Office надстройку.

Приобретение appSource Office надстройки

Если пользователь приобретает надстройки Office AppSource и эквивалентная надстройка COM уже установлена, Office будет:

  1. Установите Office надстройки.
  2. Скрыть интерфейс Office надстройки в ленте.
  3. Отображение вызова для пользователя, который указывает кнопку ленты надстройки COM.

Централизованное развертывание Office надстройки

Если администратор развертывает надстройку Office клиента с помощью централизованного развертывания, а эквивалентная надстройка COM уже установлена, пользователь должен перезапустить Office, прежде чем они увидят какие-либо изменения. После Office перезапуска будет:

  1. Установите Office надстройки.
  2. Скрыть интерфейс Office надстройки в ленте.
  3. Отображение вызова для пользователя, который указывает кнопку ленты надстройки COM.

Документ, общий со встроенными Office надстройки

Если у пользователя установлена надстройка COM, а затем он получает общий документ со встроенной надстройки Office, то при открываемом документе Office:

  1. Запрос пользователя на доверие Office надстройки.
  2. При доверии Office надстройка будет устанавливаться.
  3. Скрыть интерфейс Office надстройки в ленте.

Другое поведение надстройки COM

Excel, PowerPoint, Word

Если пользователь отреставрирует эквивалентную надстройку COM, Office на Windows восстанавливает пользовательский интерфейс Office надстройки.

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

Outlook

Надстройка com/VSTO должна быть подключена при Outlook, чтобы соответствующая веб-надстройка была отключена.

Если надстройка com/VSTO отключена во время последующего сеанса Outlook, веб-надстройка, скорее всего, будет отключена до Outlook перезапуска.

См. также