Compartilhar via

Criar projetos de Suplementos do Office com o Teams Toolkit

  • Artigo

Uma das principais ferramentas para desenvolver Aplicações do Teams é o Teams Toolkit. Pode criar Suplementos do Office com o Teams Toolkit.

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

Observação

O manifesto unificado do Microsoft 365 pode ser utilizado nos suplementos de produção do Outlook. Está disponível apenas como uma pré-visualização para suplementos do Excel, PowerPoint e Word.

Dica

Existe outra extensão de Visual Studio Code que cria Suplementos do Office que utilizam o manifesto apenas de suplemento. Consulte Criar projetos de Suplementos do Office com o Development Kit de Suplementos do Office para Visual Studio Code.

Observação

Os Suplementos do Office que utilizam o manifesto unificado do Microsoft 365 são diretamente suportados no Office na Web, no novo Outlook no Windows e no Office no Windows ligado a uma subscrição do Microsoft 365, Versão 2304 (Compilação 16320.00000) ou posterior.

Quando o pacote de aplicação que contém o manifesto unificado é implementado no AppSource ou no Centro de Administração Microsoft 365, é gerado um manifesto apenas de suplemento a partir do manifesto unificado e armazenado. Este manifesto apenas de suplemento permite que o suplemento seja instalado em plataformas que não suportam diretamente o manifesto unificado, incluindo o Office no Mac, o Office em dispositivos móveis, versões de subscrição do Office no Windows anteriores à 2304 (Compilação 16320.00000) e versões perpétuas do Office no Windows.

Instale a versão mais recente do Teams Toolkit no Visual Studio Code conforme descrito em Instalar o Teams Toolkit.

Importante

Pode criar um suplemento do Outlook com a versão mais recente do Teams Toolkit. Para criar um suplemento para o Excel, PowerPoint ou Word, instale a versão de pré-lançamento conforme descrito em Instalar uma versão de pré-lançamento. O toolkit cria projetos que utilizam o manifesto unificado para o Microsoft 365. O suporte para este manifesto no Excel, PowerPoint e Word é apenas pré-visualização.

Criar um projeto de Suplemento do Office

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

    Ícone do Toolkit do Teams.

  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 Teams Toolkit. Selecione Suplemento do Office.

    As opções no menu pendente Novo Projeto. A última opção é denominada

  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 Teams Toolkit. Selecione Painel de tarefas.

    As opções no menu pendente Funcionalidades da Aplicação Utilizar um Suplemento do Office. A opção

  5. Se estiver a criar um suplemento do Outlook, o toolkit mostra um menu pendente Linguagem de Programação . Selecione TypeScript ou JavaScript. (Para suplementos do Excel, PowerPoint e Word, é sempre criado um projeto TypeScript.)

  6. Se estiver a criar um suplemento do Outlook, o toolkit mostra um menu pendente Framework . Selecione Predefinição ou React. (Para suplementos do Excel, PowerPoint e Word, é sempre criado um projeto predefinido.)

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

  8. Atribua um nome ao projeto (sem espaços) quando lhe for pedido. O Teams Toolkit 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.

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

  10. 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

Observação

Esta secção só se aplica se estiver a desenvolver o suplemento num computador Windows . Se trabalhar num Mac, pode testar o suplemento ao fazer com que o seu administrador do Microsoft 365 implemente o suplemento como uma aplicação integrada no Centro de Administração Microsoft 365.

  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.

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

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 Teams Toolkit.

  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.

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.