Criar projetos de Suplemento do Office com o Toolkit de Agentes do Microsoft 365

Uma ferramenta principal para desenvolver aplicações e agentes do Microsoft 365, incluindo Suplementos do Office, é o Toolkit de Agentes do Microsoft 365.

Os suplementos criados com o Toolkit de Agentes utilizam o manifesto unificado para o Microsoft 365.

Instale a versão mais recente do Agents Toolkit no Visual Studio Code conforme descrito em Instalar o Toolkit de Agentes do Microsoft 365.

Criar um projeto de Suplemento do Office

1. Abra Visual Studio Code e selecione o ícone Do Toolkit agentes na Barra de Atividade.

   

2. Selecione Criar uma Nova Aplicação.

3. O menu pendente Novo Projeto é aberto. As opções listadas variam consoante a sua versão do Toolkit de Agentes. Selecione Suplemento do Office.

   

4. É aberto o menu pendente Funcionalidades da Aplicação Utilizando um Suplemento do Office . As opções listadas variam consoante a sua versão do Toolkit de Agentes. Selecione Painel de tarefas.

   

5. Na caixa de diálogo Pasta de Área de Trabalho que é aberta, selecione a pasta onde pretende criar o projeto.

6. Atribua um nome ao projeto (sem espaços) quando lhe for pedido. O Toolkit de Agentes irá criar o projeto com ficheiros básicos e andaimes. Em seguida, abrirá o projeto numa segunda janela Visual Studio Code. Feche a janela de Visual Studio Code original.

   Observação

   O projeto gerado está configurado para ser instalável no Excel, Outlook, PowerPoint e Word. Pode editar o manifesto e os ficheiros de origem conforme necessário para alterar as aplicações do Office suportadas.

7. Na Visual Studio Code TERMINAL, navegue para a raiz do projeto e execute npm install.

8. Após a conclusão da instalação, verifique se pode fazer sideload do suplemento a partir de Visual Studio Code. Os passos para sideload variam consoante a aplicação do Office na qual pretende testar o suplemento.

Sideload no Excel, PowerPoint ou Word

1. Selecione Ver | Executar no Visual Studio Code. No menu pendente EXECUTAR E DEPURAR , selecione uma destas opções:

   • Ambiente de Trabalho do Excel (Chromium Edge)
   • PowerPoint Desktop (edge Chromium)
   • ambiente de trabalho do Word (Chromium do Edge)

2. Pressione F5. O projeto é compilação e é aberta uma janela Dev-Server do Nó. Este processo pode demorar alguns minutos. Eventualmente, é aberta a versão de ambiente de trabalho da aplicação do Office que selecionou.

   Observação

   Se esta for a primeira vez que tem sideload de um Suplemento do Office no seu computador (ou a primeira vez em mais de um mês), poderá ser-lhe pedido para eliminar um certificado antigo e/ou para instalar um novo. Concorde com ambos os pedidos.

3. Será apresentado um separador Suplemento da Contoso com dois botões no friso Base. Utilize um botão para efetuar uma ação no documento aberto do Office. Utilize o outro para abrir o painel de tarefas do suplemento.

   Observação

   Independentemente do botão que selecionar, é apresentado um pedido Parar Ao Carregar na WebView . Selecione OK.

   Dica

   O sideload no Office no Windows também disponibiliza o suplemento no Office na Web, para que também possa testá-lo nessa plataforma. Após a conclusão deste passo, minimize a janela da aplicação do Office no Windows e num browser, navegue para https://excel.cloud.microsoft/, https://word.cloud.microsoft/ou https://powerpoint.cloud.microsoft/, o que for adequado para o suplemento que está a testar. Abra um documento novo ou existente na aplicação do Office na Web. Os botões devem aparecer no friso Base tal como no Office no Windows.

4. Para parar a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração no Visual Studio Code.

   Observação

   Se o passo anterior parecer não ter qualquer efeito, desinstale o suplemento ao abrir um TERMINAL no Visual Studio Code e, em seguida, execute o comando npm run stop. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento.

Outras formas de sideload

Consulte Sideload Office Add-ins that use the unified manifest for Microsoft 365 (Sideload Office Add-ins that use the unified manifest for Microsoft 365 for alternative ways to sideload an Excel, PowerPoint, or Word add-in, including through the app store in Teams (Sideload de Suplementos do Office que utilizam o manifesto unificado do Microsoft 365) para obter formas alternativas de fazer sideload de um suplemento do Excel, PowerPoint ou Word, incluindo através da loja de aplicações no Teams.

Sideload no Outlook

1. Certifique-se de que a sua conta no seu inquilino de programador do Microsoft 365 também é uma conta de e-mail no Outlook para ambiente de trabalho. Se não estiver, siga a documentação de orientação em Adicionar uma conta de e-mail ao Outlook.

2. Feche o Outlook para ambiente de trabalho.

3. No Visual Studio Code, abra o Toolkit de Agentes.

4. Na secção CONTAS , verifique se tem sessão iniciada no Microsoft 365.

5. Selecione Ver | Executar no Visual Studio Code. No menu pendente EXECUTAR E DEPURAR, selecione a opção Ambiente de Trabalho do Outlook (Edge Chromium) e, em seguida, prima F5. O projeto é compilação e é aberta uma janela Dev-Server do Nó. Este processo pode demorar alguns minutos e, em seguida, o Outlook para ambiente de trabalho será aberto.

   Observação

   Se esta for a primeira vez que tem sideload de um Suplemento do Office no seu computador (ou a primeira vez em mais de um mês), poderá ser-lhe pedido para eliminar um certificado antigo e/ou para instalar um novo. Concorde com ambos os pedidos.

6. Abra a Caixa de Entradada sua identidade de conta do Microsoft 365 e abra qualquer mensagem. Será apresentado um separador Suplemento da Contoso com dois botões no friso Base (ou no friso Mensagem , se tiver aberto a mensagem na sua própria janela).

7. Clique no botão Mostrar Painel de Tarefas e é aberto um painel de tarefas. Clique no botão Executar uma ação e é apresentada uma pequena notificação junto à parte superior da mensagem.

   Observação

   Independentemente do botão que selecionar, é apresentado um pedido Parar Ao Carregar na WebView . Selecione OK.

8. Para parar a depuração e desinstalar o suplemento, selecione Executar | Parar Depuração no Visual Studio Code.

   Observação

   Se o passo anterior parecer não ter qualquer efeito, desinstale o suplemento ao abrir um TERMINAL no Visual Studio Code e, em seguida, execute o comando npm run stop. Fechar a janela do servidor não para de forma fiável o servidor e fechar a aplicação do Office não faz com que o Office não se preocupe com o suplemento.

Desenvolver o seu projeto

Agora pode alterar e desenvolver o projeto. Em locais onde a documentação de orientação nos Suplementos do Office se ramifica consoante o tipo de manifesto que está a ser utilizado, certifique-se de que segue as orientações para o manifesto unificado.