Publicar um suplemento desenvolvido com o Código do Visual Studio

Este artigo descreve como publicar um Suplemento do Office criado com o gerador Yeoman e desenvolvido com o Código do Visual Studio (VS Code) ou qualquer outro editor.

Observação

• Para saber mais sobre como publicar um Suplemento do Office criado usando o Visual Studio, confira Publicar o suplemento usando o Visual Studio.
• Para obter informações sobre como publicar um Suplemento do Office que criou com o Teams Toolkit, consulte Implementar a aplicação Teams na nuvem e Implementar a sua primeira aplicação teams. Este artigo é sobre aplicações de separador do Teams, mas aplica-se aos Suplementos do Office criados com o Teams Toolkit.

Publicar um suplemento para que outros usuários acessem o

Um Suplemento do Office é formado por um aplicativo Web e um arquivo de manifesto. O aplicativo Web define a interface do usuário e a funcionalidade do suplemento, enquanto o manifesto especifica o local do aplicativo Web e define as configurações e os recursos do suplemento.

Enquanto estiver a desenvolver, pode executar o suplemento no seu servidor Web local (localhost). Quando estiver pronto para publicá-la para que outros utilizadores acedam, terá de implementar a aplicação Web e atualizar o manifesto para especificar o URL da aplicação implementada.

Quando o suplemento estiver a funcionar conforme pretendido, pode publicá-lo diretamente através do Visual Studio Code com a extensão de Armazenamento do Azure.

Usando o Visual Studio Code para publicar

Observação

Estes passos só funcionam para projetos criados com o gerador Yeoman e que utilizam o manifesto formatado em XML. Não se aplicam se tiver criado o suplemento com o Teams Toolkit ou o tiver criado com o gerador Yeoman e utilizar o manifesto unificado para o Microsoft 365.

1. Abra o projeto a partir da respetiva pasta raiz no Visual Studio Code (VS Code).

2. Selecione Ver>Extensões (Ctrl+Shift+X) para abrir a vista Extensões.

3. Procure a extensão do Armazenamento do Azure e instale-a.

4. Depois de instalado, é adicionado um ícone do Azure à Barra de Atividade. Selecione-a para aceder à extensão. Se a Barra de Atividade estiver oculta, abra-a ao selecionar Ver> Barrade Atividade deAspeto>.

5. Selecione Iniciar sessão no Azure para iniciar sessão na sua conta do Azure. Se ainda não tiver uma conta do Azure, crie uma ao selecionar Criar uma Conta do Azure. Siga os passos indicados para configurar a sua conta.

   

6. Depois de iniciar sessão, verá que as suas contas de armazenamento do Azure aparecem na extensão. Se ainda não tiver uma conta de armazenamento, crie uma com a opção Criar Conta de Armazenamento na paleta de comandos. Atribua um nome exclusivo global à sua conta de armazenamento, utilizando apenas "a-z" e "0-9". Tenha em atenção que, por predefinição, esta ação cria uma conta de armazenamento e um grupo de recursos com o mesmo nome. Coloca automaticamente a conta de armazenamento nos E.U.A. Oeste. Isto pode ser ajustado online através da sua conta do Azure.

   

7. Clique com o botão direito do rato (ou selecione sem soltar) na sua conta de armazenamento e selecione Configurar Site Estático. Ser-lhe-á pedido para introduzir o nome do documento de índice e o nome do documento 404. Altere o nome do documento de índice da predefinição index.html para taskpane.html. Também pode alterar o nome do documento 404, mas não é necessário.

8. Clique com o botão direito do rato (ou selecione sem soltar) novamente a sua conta de armazenamento e, desta vez, selecione Procurar Site Estático. Na janela do browser que é aberta, copie o URL do site.

9. Abra o ficheiro de manifesto do projeto (manifest.xml) e altere todas as referências para o URL do localhost (como https://localhost:3000) para o URL que copiou. Este ponto final é o URL do site estático da conta de armazenamento recentemente criada. Guarde as alterações ao ficheiro de manifesto.

10. Abra uma linha de comandos ou janela de terminal e aceda ao diretório de raiz do projeto de suplemento. Execute o seguinte comando para preparar todos os ficheiros para a implementação de produção.

    npm run build
    

    Quando a compilação for concluída, a pasta distno diretório raiz do projeto de suplemento incluirá os arquivos que você implantará nas etapas subsequentes.

11. No VS Code, aceda ao Explorador e clique com o botão direito do rato (ou selecione sem soltar) a pasta dist e selecione Implementar no Site Estático através do Armazenamento do Azure. Quando lhe for pedido, selecione a conta de armazenamento que criou anteriormente.

    

12. Quando a implementação estiver concluída, clique com o botão direito do rato (ou selecione sem soltar) a conta de armazenamento que criou anteriormente e selecione Procurar Site Estático. Esta ação abre o web site estático e apresenta o painel de tarefas.

13. Por fim, faça sideload do ficheiro de manifesto e o suplemento será carregado a partir do site estático que acabou de implementar.

Implementar funções personalizadas para o Excel

Se o suplemento tiver funções personalizadas, existem mais alguns passos para as ativar na conta de Armazenamento do Azure. Em primeiro lugar, ative o CORS para que o Office possa aceder ao ficheiro functions.json.

1. Clique com o botão direito do rato (ou selecione sem soltar) na conta de armazenamento do Azure e selecione Abrir no Portal.

2. No grupo Definições, selecione Partilha de recursos (CORS). Também pode utilizar a caixa de pesquisa para o encontrar.

3. Crie uma nova regra CORS com as seguintes definições.

   Propriedade	Valor
   Origens permitidas	*
   Métodos permitidos	OBTER
   Cabeçalhos permitidos	*
   Cabeçalhos expostos	Access-Control-Allow-Origin
   Idade máxima	200

4. Selecione Salvar.

Cuidado

Esta configuração CORS pressupõe que todos os ficheiros no servidor estão publicamente disponíveis para todos os domínios.

Em seguida, adicione um tipo de MIME para ficheiros JSON.

1. Crie um novo ficheiro na pasta /src com o nome web.config.

2. Insira o seguinte XML e guarde o ficheiro.

   <?xml version="1.0"?>
   <configuration>
     <system.webServer>
       <staticContent>
         <mimeMap fileExtension=".json" mimeType="application/json" />
       </staticContent>
     </system.webServer>
   </configuration> 
   

3. Abra o arquivo webpack.config.js.

4. Adicione o seguinte código na lista de plugins para copiar o web.config para o pacote quando a criação for executada.

   new CopyWebpackPlugin({
     patterns: [
     {
       from: "src/web.config",
       to: "src/web.config",
     },
    ],
   }),
   

5. Abra uma linha de comandos e aceda ao diretório de raiz do seu projeto de suplemento. Em seguida, execute o seguinte comando para preparar todos os ficheiros para implementação.

   npm run build
   

   Quando a compilação estiver concluída, a pasta dist no diretório de raiz do projeto de suplemento irá conter os ficheiros que irá implementar.

6. Para implementar, no Explorador de Código do VS, clique com o botão direito do rato (ou selecione sem soltar) a pasta dist e selecione Implementar no Site Estático através do Armazenamento do Azure. Quando lhe for pedido, selecione a conta de armazenamento que criou anteriormente. Se já tiver implementado a pasta dist , ser-lhe-á pedido que substitua os ficheiros no armazenamento do Azure pelas alterações mais recentes.

Implantar atualizações

Quando adiciona funcionalidades ou corrige erros no suplemento, terá de implementar as atualizações. Se o suplemento for implementado por um ou mais administradores nas respetivas organizações, algumas alterações de manifesto exigirão que o administrador consoante as atualizações. Os utilizadores serão bloqueados do suplemento até que o consentimento seja concedido. As seguintes alterações de manifesto exigirão que o administrador consinta novamente.

• Alterações às permissões pedidas. Veja Requesting permissions for API use in add-ins and Understanding Outlook add-in permissions (Pedir permissões para utilização de API em suplementos ) e Understanding Outlook add-in permissions (Compreender as permissões de suplementos do Outlook).
• Âmbitos adicionais ou alterados. (Não aplicável se o suplemento utilizar o manifesto unificado para o Microsoft 365.)
• Eventos adicionais ou alterados do Outlook.

Observação

Sempre que fizer uma alteração ao manifesto, tem de aumentar o número da versão do manifesto.

• Se o suplemento utilizar o manifesto XML, veja o elemento Versão.
• Se o suplemento utilizar o manifesto unificado, veja a propriedade da versão.

Confira também

• Desenvolver Suplementos do Office com o Código do Visual Studio
• Implantar e publicar seu suplemento do Office
• Suporte de Partilha de Recursos transversais à Origem (CORS) para o Armazenamento do Azure