Hacer que el complemento de Office sea compatible con un complemento COM existente
Si tiene un complemento COM existente, puede crear una funcionalidad equivalente en el complemento de Office, lo que permite que la solución se ejecute en otras plataformas, como Office en la web o Mac. En algunos casos, es posible que el complemento de Office no pueda proporcionar toda la funcionalidad disponible en el complemento COM correspondiente. En estas situaciones, el complemento COM puede proporcionar una mejor experiencia de usuario en Windows de la que puede proporcionar el complemento de Office correspondiente.
Importante
Los complementos COM y VSTO no se admiten en el nuevo Outlook en Windows que se encuentra actualmente en versión preliminar. Estos complementos siguen siendo compatibles con el cliente de escritorio clásico de Outlook en Windows. Para obtener más información, consulte Desarrollo de complementos de Outlook para nuevas Outlook en Windows.
Puede configurar el complemento de Office para que cuando el complemento COM equivalente ya esté instalado en el equipo de un usuario, Office en Windows ejecute el complemento COM en lugar del complemento de Office. El complemento COM se denomina "equivalente" porque Office realizará una transición sin problemas entre el complemento COM y el complemento de Office según el cual se instala uno en el equipo de un usuario.
Importante
La siguiente plataforma y aplicaciones admiten la característica de complemento equivalente. Los complementos COM no se pueden instalar en ninguna otra plataforma, por lo que en esas plataformas se omite el elemento de manifiesto que se describe más adelante en este artículo, EquivalentAddins, .
- Excel, Word y PowerPoint en Windows (versión 1904 o posterior)
- Outlook clásico en Windows (versión 2102 o posterior) en una versión admitida del servidor Exchange
Especificar un complemento COM equivalente
Obtener el ProgId de un complemento COM
Para poder especificar un complemento COM equivalente, primero debe identificar su ProgId. Para obtener el ProgId de un complemento COM:
- Abra el Editor del Registro de Windows en el equipo donde está instalado el complemento COM.
- Vaya a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<aplicación> de Office\Addins o HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<aplicación> de Office\Addins, donde <la aplicación> de Office es Excel, Outlook, PowerPoint o Word. Por ejemplo, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins.
- Copie el nombre de la clave del Registro asociada al complemento COM que necesita. Tenga en cuenta que los nombres distinguen mayúsculas de minúsculas.
Configuración del manifiesto
Importante
Se aplica a Excel, Outlook, PowerPoint y Word.
Para habilitar la compatibilidad entre el complemento de Office y el complemento COM, identifique el complemento COM equivalente en el manifiesto del complemento de Office. A continuación, Office en Windows usará el complemento COM en lugar del complemento de Office, si ambos están instalados.
En el ejemplo siguiente se muestra la parte del manifiesto que especifica un complemento COM como complemento equivalente. El valor del ProgId elemento identifica el complemento COM y el elemento EquivalentAddins debe colocarse inmediatamente antes de la etiqueta de cierre VersionOverrides .
<VersionOverrides>
...
<EquivalentAddins>
<EquivalentAddin>
<ProgId>ContosoCOMAddin</ProgId>
<Type>COM</Type>
</EquivalentAddin>
</EquivalentAddins>
</VersionOverrides>
Sugerencia
Para obtener información sobre el complemento COM y la compatibilidad con UDF de XLL, consulte Hacer que las funciones personalizadas sean compatibles con funciones definidas por el usuario de XLL. No aplicable para Outlook.
Configuración de la directiva de grupo
Importante
Solo se aplica a Outlook.
Para declarar la compatibilidad entre el complemento web de Outlook y el complemento COM, identifique el complemento COM equivalente en la opción Desactivar complementos web de Outlook cuyo complemento COM o VSTO equivalente esté instalado . Debe configurarse en el equipo del usuario. A continuación, outlook clásico en Windows usará el complemento COM en lugar del complemento web, si ambos están instalados.
Descargue la herramienta de plantillas administrativas más reciente, prestando atención a las instrucciones de instalación de la herramienta.
Abra el Editor de directivas de grupo local (gpedit.msc).
Vaya aPlantillas> administrativas de configuración> de usuarioMicrosoft Outlook 2016>Varios.
Seleccione la opción Desactivar complementos web de Outlook cuyo complemento COM o VSTO equivalente esté instalado.
Abra el vínculo para editar la configuración de directiva.
En el cuadro de diálogo Complementos web de Outlook para desactivar:
- Establezca Nombre del valor en el
Idque se encuentra en el manifiesto del complemento web. Importante: No agregue llaves{}alrededor de la entrada. - Establezca Value en el
ProgIddel complemento COM equivalente. - Seleccione Aceptar para aplicar la actualización.
- Establezca Nombre del valor en el
Comportamiento equivalente para los usuarios
Cuando se especifica un complemento COM equivalente, Office en Windows no mostrará la interfaz de usuario (UI) del complemento de Office si está instalado el complemento COM equivalente. Office solo oculta los botones de la cinta de opciones del complemento de Office y no impide la instalación. Por lo tanto, el complemento de Office seguirá apareciendo en las siguientes ubicaciones dentro de la interfaz de usuario.
- En Mis complementos.
- Como entrada en el administrador de la cinta de opciones (solo Excel, Word y PowerPoint).
Nota:
La especificación de un complemento COM equivalente en el manifiesto no tiene ningún efecto en otras plataformas, como Office en la web o en Mac.
En los escenarios siguientes se describe lo que ocurre en función de cómo el usuario adquiere el complemento de Office.
Adquisición de AppSource de un complemento de Office
Si un usuario adquiere el complemento de Office de AppSource y el complemento COM equivalente ya está instalado, Office hará lo siguiente:
- Instale el complemento de Office.
- Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.
- Muestra una llamada para el usuario que señala el botón de la cinta de opciones del complemento COM.
Implementación centralizada del complemento de Office
Si un administrador implementa el complemento de Office en su inquilino mediante la implementación centralizada y el complemento COM equivalente ya está instalado, el usuario debe reiniciar Office antes de ver los cambios. Después de reiniciar Office, hará lo siguiente:
- Instale el complemento de Office.
- Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.
- Muestra una llamada para el usuario que señala el botón de la cinta de opciones del complemento COM.
Documento compartido con un complemento de Office incrustado
Si un usuario tiene instalado el complemento COM y, a continuación, obtiene un documento compartido con el complemento de Office incrustado, cuando abra el documento, Office:
- Pida al usuario que confíe en el complemento de Office.
- Si es de confianza, se instalará el complemento de Office.
- Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.
Otro comportamiento de complemento COM
Excel, PowerPoint y Word
Si un usuario desinstala el complemento COM equivalente, Office en Windows restaura la interfaz de usuario del complemento de Office.
Después de especificar un complemento COM equivalente para el complemento de Office, Office deja de procesar las actualizaciones del complemento de Office. Para adquirir las actualizaciones más recientes para el complemento de Office, el usuario debe desinstalar primero el complemento COM.
Outlook
El complemento COM debe estar conectado cuando se inicia Outlook para que se deshabilite el complemento web correspondiente.
Si el complemento COM se desconecta durante una sesión posterior de Outlook, es probable que el complemento web permanezca deshabilitado hasta que se reinicie Outlook.