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

Убедитесь, что надстройка 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

Получение ProgId надстройки COM

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

  1. Откройте редактор реестра Windows на компьютере, где установлена надстройка COM.
  2. Перейдите <поHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Приложение> Office\Addins или HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<Приложение> Office\Addins, где <приложение> Office — Excel, Outlook, PowerPoint или Word. Например, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins.
  3. Скопируйте имя раздела реестра, связанного с необходимой надстройкой 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, определите эквивалентную надстройку COM в параметре Групповой политики Деактивировать веб-надстройки Outlook, для которых установлена эквивалентная надстройка COM или VSTO . Это необходимо настроить на компьютере пользователя. Затем классический Outlook в Windows будет использовать надстройку COM вместо веб-надстройки, если они установлены.

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

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

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

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

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

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

    1. Задайте для параметра Value name ( Id Имя значения), которое находится в манифесте веб-надстройки. Важно!Не добавляйте фигурные скобки {} вокруг записи.
    2. Задайте для параметра ValueProgId значение эквивалентной надстройки COM.
    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 должна быть подключена при запуске Outlook, чтобы отключить соответствующую веб-надстройку.

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

См. также