Implante e instale suplementos do Outlook para teste
Como parte do processo de desenvolvimento de um suplemento do Outlook, você provavelmente se verá implantando e instalando iterativamente o suplemento para teste, o que envolve as etapas a seguir.
- Criação de um arquivo de manifesto que descreve o suplemento.
- Implementar os ficheiros de IU do suplemento num servidor Web.
- Instalação do suplemento em sua caixa de correio.
- Teste do suplemento, fazendo as alterações apropriadas na interface de usuário ou nos arquivos de manifesto e repetindo as etapas 2 e 3 para testar as alterações.
Observação
Os painéis personalizados foram preteridos; portanto, certifique-se de estar usando um ponto de extensão de suplemento com suporte.
Criar um arquivo de manifesto para o suplemento
Cada suplemento é descrito por um manifesto, um documento que fornece ao servidor informações sobre o suplemento, fornece informações descritivas sobre o suplemento para o utilizador e identifica a localização do ficheiro HTML da IU do suplemento. Você pode armazenar o manifesto em uma pasta ou servidor local, desde que o local possa ser acessado pelo servidor Exchange da caixa de correio que você está testando. Vamos pressupor que você armazena seu manifesto em uma pasta local. Para obter informações sobre como criar um ficheiro de manifesto, consulte Manifestos de suplementos do Office.
Implantar um suplemento em um servidor Web
Pode utilizar HTML e JavaScript para criar o suplemento. Os ficheiros de origem resultantes são armazenados num servidor Web que pode ser acedido pelo servidor Exchange que aloja o suplemento. Depois de implementar inicialmente os ficheiros de origem do suplemento, pode atualizar a IU e o comportamento do suplemento ao substituir os ficheiros HTML ou ficheiros JavaScript armazenados no servidor Web por uma nova versão do ficheiro HTML.
Instalar o suplemento
Depois de preparar o arquivo de manifesto do suplemento e implantar a interface de usuário do suplemento em um servidor Web que possa ser acessado, é possível realizar o sideload do suplemento para uma caixa de correio em um servidor Exchange usando um cliente do Outlook ou instalar o suplemento executando cmdlets remotos do Windows PowerShell.
Realizar o sideload do suplemento
Pode instalar um suplemento se a sua caixa de correio estiver no Exchange. Os suplementos de sideload requerem, no mínimo, a função As Minhas Aplicações Personalizadas para o seu Exchange Server. Para testar seu suplemento ou instalar suplementos em geral especificando uma URL ou um nome de arquivo de manifesto do suplemento, é preciso solicitar que seu administrador do Exchange forneça as permissões necessárias.
O administrador do Exchange pode executar o cmdlet do PowerShell a seguir para atribuir as permissões necessárias a um único usuário. Neste exemplo, wendyri está o alias de e-mail do utilizador.
New-ManagementRoleAssignment -Role "My Custom Apps" -User "wendyri"
Se necessário, o administrador poderá executar o seguinte cmdlet para atribuir a vários usuários as permissões semelhantes necessárias.
$users = Get-Mailbox *$users | ForEach-Object { New-ManagementRoleAssignment -Role "My Custom Apps" -User $_.Alias}
Para saber mais sobre a função Meus Suplementos Personalizados, confira Função Meus Suplementos Personalizados.
O uso do Microsoft 365 ou do Visual Studio para desenvolver suplementos atribui a você a função de administrador da organização, o que permite que você instale suplementos por arquivo ou URL no EAC, ou por cmdlets do Powershell.
Instalar um suplemento usando o PowerShell remoto
Depois de criar uma sessão remota do Windows PowerShell em seu servidor Exchange, você pode instalar um suplemento do Outlook usando o cmdlet New-App com o comando do PowerShell a seguir.
New-App -URL:"http://<fully-qualified URL">
A URL totalmente qualificada é o local do arquivo de manifesto do suplemento que você preparou para seu suplemento.
Você pode usar os seguintes cmdlets adicionais do Windows PowerShell para gerenciar os suplementos de uma caixa de correio.
-
Get-App– Lista os suplementos que estão habilitados para uma caixa de correio. -
Set-App– Habilita ou desabilita um suplemento em uma caixa de correio. -
Remove-App– Remove um suplemento instalado anteriormente de um servidor Exchange.
Versões de cliente
A decisão de quais versões de cliente do Outlook testar depende dos seus requisitos de desenvolvimento.
Se estiver a desenvolver um suplemento para utilização privada ou apenas para membros da sua organização, é importante testar as versões do Outlook que a sua empresa utiliza. Tenha em atenção que alguns utilizadores podem utilizar Outlook na Web, pelo que testar as versões padrão do browser da sua empresa também é importante.
Se você estiver desenvolvendo um suplemento para listar no AppSource, deverá testar as versões necessárias conforme especificado nas Políticas de certificação do Commercial Marketplace 1120.3. Isso inclui:
- A versão mais recente do Outlook no Windows e a versão anterior à mais recente.
- A versão mais recente do Outlook no Mac.
- A versão mais recente do Outlook no iOS e Android (se o suplemento for compatível com mobilidade).
- As versões do navegador especificadas na política de validação do mercado comercial 1120.3
Observação
Se seu suplemento não for compatível com um dos clientes acima devido a uma solicitação de um conjunto de exigências da API que o cliente não dá suporte, esse cliente será removido da lista de clientes exigidos.
Versões do Outlook na Web e do Exchange Server
Os usuários de contas do Microsoft 365 e de consumidor veem a versão moderna da interface do usuário ao acessar o Outlook na Web e não veem mais a versão clássica que foi substituída. No entanto, os servidores locais do Exchange continuam oferecendo suporte ao Outlook na Web clássico. Portanto, durante o processo de validação, seu envio poderá receber um aviso de que o suplemento não é compatível com o Outlook na Web clássico. Nesse caso, considere testar o suplemento em um ambiente do Exchange local. Esse aviso não bloqueará seu envio ao AppSource, mas seus clientes poderão ter uma experiência abaixo do ideal, caso usem o Outlook na Web em um ambiente do Exchange local.
Para atenuar isso, é recomendável que se faça o teste do suplemento no Outlook na Web conectado ao seu próprio ambiente Exchange local. Para saber mais, confira as orientações sobre como Estabelecer um ambiente de teste do Exchange 2016 ou do Exchange 2019 e como gerenciar o Outlook na Web no Exchange Server.
Como alternativa, você pode optar por pagar e usar um serviço que hospeda e gerencia servidores locais do Exchange. Algumas das opções são:
Além disso, se você não deseja que seus suplementos estejam disponíveis para usuários conectados ao Exchange local, é possível definir o conjunto de requisitos no manifesto de suplemento como 1.6 ou superior. Esses suplementos não serão testados nem validados na interface do usuário do Outlook na Web clássico.