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, com as seguintes restrições.

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

  • Neste momento, só podem ser criados suplementos do Outlook. Estamos a trabalhar arduamente para ativar o suporte no Teams Toolkit para suplementos para outras aplicações e plataformas do Office.

    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 do Microsoft 365 , se o manifesto tiver uma propriedade "alternateIcons" válida, é 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.

Criar um projeto de Suplemento do Outlook

  1. Abra o 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. No menu pendente Novo Projeto , selecione Suplemento do Outlook.

    As quatro opções no menu pendente Novo Projeto. A quarta opção chama-se

  4. No menu pendente Funcionalidades da Aplicação Utilizar um Suplemento do Outlook , selecione Painel de tarefas.

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

  5. Na caixa de diálogo da pasta Á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 Teams Toolkit irá criar o projeto com ficheiros básicos e andaimes. Em seguida, abrirá o projeto numa segunda janela do Visual Studio Code. Feche a janela original do Visual Studio Code.

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

  8. Antes de efetuar alterações ao projeto, verifique se pode fazer sideload do seu suplemento do Outlook a partir do Visual Studio Code. Use as seguintes etapas:

    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 Execução | 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. Eventualmente, o Outlook para ambiente de trabalho será aberto.
    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.
    8. Para parar a depuração e desinstalação do suplemento, selecione Executar | Parar Depuração no Visual Studio Code.

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.