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.

  1. Criação de um arquivo de manifesto que descreve o suplemento.
  2. Implantando os arquivos de interface do usuário do suplemento em um servidor Web.
  3. Instalação do suplemento em sua caixa de correio.
  4. 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 usuário e identifica o local do arquivo HTML da interface do usuário 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 arquivo de manifesto, consulte Manifestos de suplemento do Office.

Implantar um suplemento em um servidor Web

Você pode usar HTML e JavaScript para criar o suplemento. Os arquivos de origem resultantes são armazenados em um servidor Web que pode ser acessado pelo servidor Exchange que hospeda o suplemento. Depois de implantar inicialmente os arquivos de origem do suplemento, você pode atualizar a interface do usuário e o comportamento do suplemento substituindo os arquivos HTML ou os arquivos JavaScript armazenados no servidor Web por uma nova versão do arquivo HTML.

Instalar o suplemento

Depois de preparar o arquivo de manifesto do suplemento e implantar a interface do usuário do suplemento em um servidor Web que possa ser acessado, você pode instalar o suplemento usando uma das opções a seguir.

Observação

Para instalar e gerenciar suplementos em uma caixa de correio, a conta de caixa de correio deve receber a função de usuário Meus Aplicativos Personalizados no Exchange. Para obter mais informações, consulte Especificar os administradores e usuários que podem instalar e gerenciar suplementos do Outlook no Exchange Online.

Realizar o sideload do suplemento

Para obter instruções sobre como fazer sideload de seu suplemento no Outlook, consulte Fazer sideload de suplementos do Outlook para teste.

Implantar o suplemento por meio do Centro de administração do Microsoft 365

Outra opção para testar seu suplemento do Outlook é implantá-lo nas contas relevantes por meio do Centro de administração do Microsoft 365. No centro de administração, vá para Configurações>Aplicativos integrados. Em seguida, selecione Carregar aplicativos personalizados. Para obter mais informações, consulte Implantar e gerenciar suplementos do Office por meio do portal de aplicativos integrados.

Instalar o 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 você estiver desenvolvendo um suplemento para uso privado ou apenas para membros da sua organização, é importante testar as versões do Outlook usadas pela sua empresa. Lembre-se de que alguns usuários podem usar o Outlook na Web, portanto, testar as versões padrão do navegador da sua empresa também é importante.

  • Se você estiver desenvolvendo um suplemento para listar no Microsoft Marketplace, deverá testar as versões necessárias, conforme especificado nas políticas de certificação 1120.3 do marketplace comercial. 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 para o Microsoft Marketplace, mas seus clientes poderão ter uma experiência abaixo do ideal se usarem o Outlook na Web em um ambiente 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 obter mais informações, consulte Estabelecer um ambiente de teste do Exchange Server e 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.

Confira também