Compartir a través de

Hacer que el complemento de Office sea compatible con un complemento COM o VSTO existente

Si tiene un complemento COM existente o un complemento VSTO, puede crear una funcionalidad casi equivalente en el complemento web de Office, lo que permite que la solución se ejecute en otras plataformas, como en Office en la Web o en Mac. En este escenario, los dos complementos se denominan "equivalentes" y puede usar el manifiesto del complemento web de Office para controlar qué complemento está disponible para los usuarios en equipos Windows (o dar a los usuarios la opción que elijan).

Nota:

Dado que los complementos COM y VSTO solo se pueden instalar en Windows, en este artículo se hace referencia a los complementos COM y VSTO colectivamente como complementos "solo para Windows".

Como regla general, los complementos deben tratarse como equivalentes solo cuando se cumplen las condiciones siguientes, pero puede haber escenarios excepcionales en los que los complementos que no cumplan estas condiciones se puedan tratar como equivalentes.

  • Ambos los crea el mismo desarrollador, normalmente la entidad especificada en la "developer" propiedad del manifiesto unificado o el elemento ProviderName en el manifiesto de solo complemento.
  • Ambos están diseñados para instalarse en la misma aplicación o aplicaciones de Office, y abordan la misma carga de trabajo con funcionalidad principalmente superpuesta.
  • Tienen nombres públicos e interfaces de usuario idénticos o muy similares, incluidos los nombres de control y los iconos.

Importante

La siguiente plataforma y aplicaciones admiten la característica de complemento equivalente. Los complementos COM, VSTO y XLL no se pueden instalar en ninguna otra plataforma, por lo que en esas plataformas se omite el marcado de manifiesto que se describe más adelante en este artículo.

  • 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
    • Exchange en línea
    • Exchange Server Subscription Edition (SE)
    • Actualización acumulativa 10 o posterior de Exchange 2019 (KB5003612)
    • Actualización acumulativa 21 de Exchange 2016 o posterior (KB5003611)

Importante

Los complementos COM y VSTO no se admiten en el nuevo Outlook en Windows. 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.

Dado que es posible que el complemento solo de Windows y el complemento de Office no tengan exactamente las mismas características, hay tres escenarios que debe tener en cuenta.

Obtener el nombre del complemento solo para Windows

Para poder configurar el manifiesto del complemento de Office, primero debe identificar el nombre del complemento solo de Windows en el Registro de Windows con estos pasos:

  1. Abra el Editor del Registro de Windows en cualquier equipo donde esté instalado el complemento de solo Windows.
  2. 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.
  3. Copie el nombre de la clave del Registro asociada al complemento de solo Windows que necesita. Tenga en cuenta que los nombres distinguen mayúsculas de minúsculas.

Ocultar el complemento de Office

Puede configurar el complemento de Office para que cuando el complemento de solo Windows equivalente ya esté instalado en el equipo de un usuario, Office en Windows ejecute el complemento de solo Windows en lugar del complemento de Office. Si el complemento de solo Windows se desinstala alguna vez, Office activará automáticamente el complemento de Office la próxima vez que se inicie la aplicación host de Office. Si el complemento de solo Windows se instala después del complemento de Office, cuando se reinicie la aplicación de Office, se ocultará el complemento de Office. Para obtener más información, vea Comportamiento de los usuarios cuando el complemento de Office está oculto.

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 solo de Windows, identifique el complemento equivalente solo para Windows en el manifiesto del complemento de Office con el nombre que obtuvo en la sección Obtener el nombre del complemento solo para Windows. A continuación, Office en Windows usará el complemento solo de Windows en lugar del complemento de Office, si ambos están instalados. La configuración depende del tipo de manifiesto que se esté usando.

En el ejemplo siguiente se muestra la parte del manifiesto que especifica un complemento solo de Windows como complemento equivalente. El valor de la "alternates.prefer.comAddin.progId" propiedad identifica el complemento de solo Windows.

Nota:

Aunque la propiedad se denomina "comAddin", en realidad hace referencia a cualquier complemento solo de Windows, independientemente de si el complemento es COM o VSTO. De forma similar, el término "progId" suele estar asociado a solo complementos COM, pero en el manifiesto hace referencia al nombre del complemento solo de Windows.

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoAddin"
        }
      }
    }
  ]
]

Sugerencia

Si no puede especificar la alternates.prefer propiedad en el manifiesto del complemento web de Outlook, debe configurar directiva de grupo en su lugar. Esto solo se aplica a Outlook. Para obtener instrucciones, vea Configurar la configuración de directiva de grupo para complementos de Outlook.

Sugerencia

Configuración de la configuración de directiva de grupo para complementos de Outlook

Un usuario con poderes de administrador en su equipo puede configurar un complemento de solo Windows para que sea el equivalente de un complemento de Outlook mediante la desactivación de complementos web de Outlook cuyo complemento COM o VSTO equivalente está instalado directiva de grupo configuración en el equipo. Esto se puede lograr incluso cuando el manifiesto del complemento de Outlook no tiene el marcado de complemento equivalente. A continuación, outlook clásico en Windows usa el complemento de solo Windows en lugar del complemento de Outlook si ambos están instalados. Estos son los pasos para configurar la directiva.

  1. Descargue la herramienta de plantillas administrativas más reciente, prestando atención a las instrucciones de instalación de la herramienta.

  2. Abra el Editor de directiva de grupo local (gpedit.msc).

  3. Vaya aPlantillas> administrativas de configuración> de usuarioMicrosoft Outlook 2016>Miscellaneous.

  4. Seleccione la opción Desactivar complementos web de Outlook cuyo complemento COM o VSTO equivalente esté instalado.

  5. Abra el vínculo para editar la configuración de directiva.

  6. En el cuadro de diálogo Complementos web de Outlook para desactivar:

    1. Establezca Nombre del valor en el identificador del manifiesto del complemento de Outlook. En el manifiesto de solo complemento, use el valor del <ID> elemento . En el manifiesto unificado, use el valor de la id propiedad en la raíz del manifiesto. No agregue llaves {} alrededor de la entrada.
    2. Establezca Value en el nombre del complemento de solo Windows equivalente. Consulte la sección Obtención del nombre del complemento solo para Windows.
    3. Seleccione Aceptar para aplicar la actualización.

    Cuadro de diálogo

Comportamiento de los usuarios cuando el complemento de Office está oculto

Cuando se especifica un complemento equivalente solo de Windows, Office en Windows no mostrará la interfaz de usuario (UI) del complemento de Office si está instalado el complemento equivalente solo de Windows. Pero 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 equivalente solo de Windows 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 Microsoft Marketplace del complemento de Office

Si un usuario adquiere el complemento de Office de Microsoft Marketplace y el complemento equivalente solo para Windows ya está instalado, Office hará lo siguiente:

  1. Instale el complemento de Office.
  2. Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.
  3. Muestra una llamada para el usuario que señala el botón de la cinta de opciones de complemento solo para Windows.

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 equivalente solo para Windows ya está instalado, el usuario debe reiniciar Office antes de ver los cambios. Después de reiniciar Office, hará lo siguiente:

  1. Instale el complemento de Office.
  2. Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.
  3. Muestra una llamada para el usuario que señala el botón de la cinta de opciones de complemento solo para Windows.

Documento compartido con el complemento de Office incrustado

Si un usuario tiene instalado el complemento solo de Windows y, a continuación, obtiene un documento compartido con el complemento de Office incrustado, cuando abra el documento, Office:

  1. Pida al usuario que confíe en el complemento de Office.
  2. Si es de confianza, se instalará el complemento de Office.
  3. Oculte la interfaz de usuario del complemento de Office en la cinta de opciones.

Otro comportamiento de complemento solo de Windows

Excel, PowerPoint y Word

Si un usuario desinstala el complemento equivalente solo de Windows, Office en Windows restaura la interfaz de usuario del complemento de Office.

Después de especificar un complemento equivalente solo de Windows 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 solo para Windows.

Outlook

El complemento de solo Windows debe estar conectado cuando se inicia Outlook para que se deshabilite el complemento de Outlook correspondiente.

Si el complemento de solo Windows se desconecta durante una sesión posterior de Outlook, es probable que el complemento de Outlook permanezca deshabilitado hasta que se reinicie Outlook.

Ocultar el complemento solo de Windows

Nota:

La opción descrita en esta sección tiene las siguientes limitaciones.

  • Solo se admite para Excel, PowerPoint y Word.
  • La versión mínima de Office que admite la característica es la suscripción a Office en la versión 2506 de Windows (compilación 19029.20004).

Configuración del manifiesto

Los detalles para configurar esta característica dependen del tipo de manifiesto que use el complemento de Office.

Para deshabilitar el complemento de solo Windows, siga estos pasos.

  1. Si aún no existe, cree una "extensions.alternates.hide.windowsExtensions" propiedad.
  2. Agregue una propiedad secundaria effect a la windowsExtensions propiedad y establezca su valor en disableWithNotification.
  3. Agregue una propiedad secundaria "comAddin" a la windowsExtensions propiedad .
  4. Agregue una propiedad de matriz secundaria progIds a la comAddin propiedad .
  5. Agregue los nombres de todos los complementos solo de Windows que quiera ocultar a la progIds matriz. Para obtener información sobre cómo obtener estos nombres, vea Obtener el nombre del complemento de solo Windows.

Nota:

La cadena "com" está en el nombre comAddin por motivos históricos. En el manifiesto, la propiedad hace referencia a complementos COM o VSTO. De forma similar, el término "progIds" suele estar asociado a solo complementos COM, pero los nombres de los complementos VSTO también se pueden incluir en la progIds matriz.

En el ejemplo siguiente se muestra el aspecto que debe tener el JSON.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "disableWithNotification",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportamiento de los usuarios cuando el complemento de solo Windows está oculto

Cuando un complemento de solo Windows está oculto, Office en Windows no mostrará su interfaz de usuario (UI) si está instalado el complemento de Office equivalente. Un cuadro de diálogo emergente notifica al usuario que esto está ocurriendo. Pero Office solo oculta el complemento solo de Windows y no impide la instalación.

Asigne al usuario la opción de qué complemento usar.

Nota:

La opción descrita en esta sección tiene las siguientes limitaciones.

  • Solo se admite para Excel, PowerPoint y Word.
  • La versión mínima de Office que admite la característica es la suscripción a Office en la versión 2506 de Windows (compilación 19029.20004).

Configuración del manifiesto

Los detalles para configurar esta característica dependen del tipo de manifiesto que use el complemento de Office.

Para dar al usuario la opción de qué complemento ocultar, siga estos pasos.

  1. Si aún no existe, cree una "extensions.alternates.hide.windowsExtensions" propiedad.
  2. Agregue una propiedad secundaria effect a la windowsExtensions propiedad y establezca su valor en userOptionToDisable.
  3. Agregue una propiedad secundaria "comAddin" a la windowsExtensions propiedad .
  4. Agregue una propiedad de matriz secundaria progIds a la comAddin propiedad .
  5. Agregue los nombres de todos los complementos equivalentes solo de Windows a la progIds matriz. Para obtener información sobre cómo obtener estos nombres, vea Obtener el nombre del complemento de solo Windows.

Nota:

La cadena "com" está en el nombre comAddin por motivos históricos. En el manifiesto, la propiedad hace referencia a complementos COM o VSTO. De forma similar, el término "progIds" suele estar asociado a solo complementos COM, pero los nombres de los complementos VSTO también se pueden incluir en la progIds matriz.

En el ejemplo siguiente se muestra el aspecto que debe tener el JSON.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "userOptionToDisable",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportamiento de los usuarios cuando tienen la opción de qué complemento está oculto

Si configura el manifiesto para que el usuario elija, verá un cuadro de diálogo similar al siguiente cuando instale el complemento de Office. El vínculo Más información del cuadro de diálogo apunta a la siguiente página de ayuda que proporciona información para ayudar al usuario a tomar la decisión: Resolver conflictos de versión para complementos de Office.

Cuadro de diálogo titulado

Si el usuario elige Sí y Office deshabilita y oculta correctamente el complemento solo de Windows, se abre un cuadro de diálogo similar al siguiente que aconseja al usuario que reinicie la aplicación de Office.

Cuadro de diálogo titulado

Si el usuario elige Sí , pero Office no puede deshabilitar el complemento solo de Windows por cualquier motivo, se abrirá un cuadro de diálogo similar al siguiente que aconseja al usuario que deshabilite manualmente el complemento solo para Windows.

Cuadro de diálogo titulado

Vea también

  • Last updated on