Implementar e instalar complementos de Outlook para pruebas
Como parte del proceso de desarrollo del complemento de Outlook, se encontrará implementando e instalando el complemento repetidamente para probarlo, lo cual consiste en los siguientes pasos.
- Creación de un archivo de manifiesto que describa el complemento.
- Implementar los archivos de interfaz de usuario del complemento en un servidor web.
- Instalación del complemento en su buzón de correo.
- Prueba del complemento, haciendo los cambios apropiados a la IU o los archivos de manifiesto, y repitiendo los pasos 2 y 3 para probar los cambios.
Nota:
Los paneles personalizados se han dejado de usar, así que asegúrese de que está usando un punto de extensión de complemento admitido.
Crear un archivo de manifiesto para el complemento
Cada complemento se describe mediante un manifiesto, un documento que proporciona al servidor información sobre el complemento, proporciona información descriptiva sobre el complemento para el usuario e identifica la ubicación del archivo HTML de la interfaz de usuario del complemento. Puede almacenar el manifiesto en una carpeta local o un servidor, siempre que la ubicación sea accesible para el servidor Exchange del buzón de correo con el que esté haciendo las pruebas. Se asume que el manifiesto se guardará en una carpeta local. Para obtener información sobre cómo crear un archivo de manifiesto, vea Manifiestos de complementos de Office.
Implementar un complemento en un servidor web
Puede usar HTML y JavaScript para crear el complemento. Los archivos de origen resultantes se almacenan en un servidor web al que puede acceder el servidor exchange que hospeda el complemento. Después de implementar inicialmente los archivos de origen para el complemento, puede actualizar la interfaz de usuario y el comportamiento del complemento reemplazando los archivos HTML o los archivos JavaScript almacenados en el servidor web por una nueva versión del archivo HTML.
Instalar el complemento
Una vez que se haya preparado el archivo del manifiesto del complemento y se haya implementado la interfaz de usuario del complemento en un servidor web al que se pueda obtener acceso, se puede transferir localmente el complemento para un buzón en un servidor Exchange mediante un cliente de Outlook; o bien, instale el complemento al ejecutar cmdlets remotos de Windows PowerShell.
Transferir el complemento localmente
Puede instalar un complemento si el buzón está en Exchange. La instalación local de complementos requiere como mínimo el rol Mis aplicaciones personalizadas para el Exchange Server. Para probar el complemento o instalar complementos en general especificando un nombre de archivo o dirección URL del manifiesto del complemento, debe solicitar al administrador de Exchange que le proporcione los permisos necesarios.
El administrador de Exchange puede ejecutar el siguiente cmdlet de PowerShell para asignar a un solo usuario los permisos necesarios. En este ejemplo, wendyri es el alias de correo electrónico del usuario.
New-ManagementRoleAssignment -Role "My Custom Apps" -User "wendyri"
Si es necesario, el administrador puede ejecutar el cmdlet siguiente para asignar a varios usuarios permisos necesarios parecidos.
$users = Get-Mailbox *$users | ForEach-Object { New-ManagementRoleAssignment -Role "My Custom Apps" -User $_.Alias}
Para obtener más información sobre el rol Mis aplicaciones personalizadas, vea Rol Mis aplicaciones personalizadas.
Al usar Microsoft 365 o Visual Studio para desarrollar complementos, se le asignará el rol de administrador de la organización, que le permite instalar complementos con un archivo o una dirección URL en el EAC, o bien con los cmdlets de PowerShell.
Instalar un complemento con PowerShell remoto
Una vez que haya creado una sesión remota de Windows PowerShell en su servidor Exchange, puede instalar un complemento de Outlook con el cmdlet New-App con el siguiente comando de PowerShell.
New-App -URL:"http://<fully-qualified URL">
La dirección URL completa es la ubicación del archivo de manifiesto del complemento que preparó para su complemento.
Puede usar los siguientes cmdlets de PowerShell adicionales para administrar los complementos para un buzón de correo.
-
Get-App: enumera los complementos que están activados para un buzón de correo. -
Set-App: activa o desactiva un complemento para un buzón de correo. -
Remove-App: elimina del servidor Exchange un complemento previamente instalado.
Versiones de cliente
Decidir qué versiones del cliente de Outlook probar depende de sus requisitos de desarrollo.
Si va a desarrollar un complemento para uso privado o solo para miembros de su organización, es importante probar las versiones de Outlook que usa su empresa. Tenga en cuenta que algunos usuarios pueden usar Outlook en la Web, por lo que también es importante probar las versiones estándar del explorador de su empresa.
Si está desarrollando un complemento para enumerarlo en AppSource, debe probar las versiones necesarias según se especifica en las directivas 1120.3 de certificación de marketplace comercial. Esto incluye lo siguiente:
- La última versión de Outlook en Windows y la versión anterior a la última.
- La última versión de Outlook en Mac.
- La última versión de Outlook en iOS y Android (si el complemento es compatible con el factor de forma móvil).
- Las versiones de exploradores especificadas en la directiva de validación del Mercado comercial 1120.3.
Nota:
Si el complemento no admite uno de los anteriores clientes debido a que solicita un conjunto de requisitos de API que no es compatible con el cliente, ese cliente se quitará de la lista de clientes obligatorios.
Outlook en la Web para versiones de Exchange Server
Los usuarios de cuentas de clientes y Microsoft 365 verán la versión moderna de la interfaz de usuario cuando obtengan acceso a Outlook en la Web y no verán la versión básica, que está en desuso. Sin embargo, los servidores de Exchange locales siguen admitiendo Outlook en la Web clásico. Por ello, durante el proceso de validación puede recibir una advertencia de que el complemento no es compatible con la versión clásica de Outlook en la Web. En este caso, debería plantearse probar el complemento en un entorno local de Exchange. Esta advertencia no impide el envío en AppSource, pero es posible que los clientes sufran una experiencia deficiente si usan Outlook en la Web en un entorno local de Exchange.
Para mitigar esto, le recomendamos que pruebe el complemento de Outlook en la Web conectado a su propio entorno de Exchange local privado. Para obtener más información, vea instrucciones sobre Cómo establecer un entorno de pruebas de Exchange 2016 o Exchange 2019 y cómo administrar Outlook en la Web en Exchange Server.
También puede optar por pagar y usar un servicio que hospede y administre servidores de Exchange locales. Estas son dos opciones interesantes:
Además, si no quiere que los complementos estén disponibles para usuarios conectados a Exchange local, puede establecer el conjunto de requisitos en el manifiesto de complemento para que sea 1.6 o posterior. Estos complementos no se evaluarán ni validarán en la interfaz de usuario clásica de Outlook en la Web.