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

  • Статья

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

Важно!

Надстройки COM и VSTO не поддерживаются в новой предварительной версии Outlook для Windows . Эти надстройки по-прежнему поддерживаются в классическом классическом клиенте Outlook для Windows. Дополнительные сведения см. в статье Разработка надстроек Outlook для новых приложений Outlook в Windows (предварительная версия).

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

Важно!

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

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

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

Манифест

Важно!

Применимо к Excel, Outlook, PowerPoint и Word.

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

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

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

Совет

Сведения о совместимости надстройки COM и UDF XLL см. в статье Совместимость пользовательских функций с определяемыми пользователем функциями XLL. Неприменимо для Outlook.

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

Важно!

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

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

  1. Скачайте последнюю версию средства административных шаблонов, обращая внимание на инструкции по установке средства.

  2. Откройте редактор локальных групповых политик (gpedit.msc).

  3. Перейдите в раздел Конфигурация>пользователей Административные шаблоны>Microsoft Outlook 2016>Miscellaneous.

  4. Выберите параметр Деактивировать веб-надстройки Outlook, для которых установлена эквивалентная надстройка COM или VSTO.

  5. Откройте ссылку, чтобы изменить параметр политики.

  6. В диалоговом окне веб-надстройки Outlook для деактивации:

    1. Задайте для параметра Value name ( Id Имя значения), которое находится в манифесте веб-надстройки. Важно!Не добавляйте фигурные скобки {} вокруг записи.
    2. Задайте для параметра ЗначениеProgId эквивалентной надстройки COM/VSTO.
    3. Нажмите кнопку ОК , чтобы ввести обновление в действие.

    Диалоговое окно

Аналогичное поведение для пользователей

Если указана эквивалентная надстройка COM, Office в Windows не будет отображать пользовательский интерфейс надстройки Office, если установлена эквивалентная надстройка 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. Чтобы получить последние обновления для надстройки Office, пользователь должен сначала удалить надстройку COM.

Outlook

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

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

См. также