Partilhar via

Orientações gerais para combinar um suplemento do Office e uma aplicação do Teams

  • Artigo

Quando tiver uma aplicação do Teams existente e um suplemento do Office que tenham funcionalidades e cargas de trabalho intimamente relacionadas ou sobrepostas, recomendamos que as combine numa única aplicação. Isto permite que os utilizadores e administradores inquilinos do Microsoft 365 adquiram e aprovem o suplemento e a aplicação Teams como uma unidade. Para obter um exemplo de uma aplicação que combina um suplemento e uma aplicação do Teams, veja Exemplo de Ofertas de Desconto.

Observação

Os suplementos do Outlook são o único tipo de suplemento do Office que pode ser combinado com uma aplicação do Teams. Estamos a trabalhar arduamente para suportar esta funcionalidade para o Excel, o PowerPoint e também Word suplementos.

Não pode haver nenhum procedimento algorítmico para intercalar um suplemento e uma aplicação do Teams pelos seguintes motivos:

  • Um algoritmo terá de fazer suposições sobre a pasta e a estrutura de ficheiros da aplicação Teams existente. No entanto, estas estruturas variam consoante a ferramenta utilizada para criar o projeto de aplicação e a versão dessa ferramenta. E, claro, o programador da aplicação pode ter alterado a estrutura após a criação do projeto.
  • A marca de lista anterior também se aplica ao projeto de suplemento.
  • Um algoritmo terá de fazer suposições sobre as definições em vários ficheiros de configuração. No entanto, estas definições também variam consoante a forma como o projeto foi criado e as alterações efetuadas à configuração desde que foi criado.
  • Um algoritmo terá de assumir que linguagem, TypeScript ou JavaScript foi utilizada para o código fonte do lado do cliente da aplicação Web.

Observação

Além destas marcas de lista, tenha em atenção que existem duas famílias básicas de arquiteturas de aplicações Web nas quais o suplemento ou a aplicação Teams podem ter sido criados.

  • IIS/.NET:

    • Os projetos de suplemento podem ser criados no Visual Studio com as Ferramentas de Programação do Office, caso em que a parte da aplicação Web é criada com base no ASP.NET e no Servidor de Informação Internet (IIS).
    • Os projetos de aplicações do Teams podem ser criados no Visual Studio com o Teams Toolkit for Visual Studio, caso em que a parte da aplicação Web é uma aplicação Blazor/C#.

  • Node.js servidor/JavaScript ou TypeScript:

Atualmente, o Visual Studio não suporta o manifesto unificado em projetos de suplementos, pelo que este artigo pressupõe que tanto o suplemento como os projetos de aplicações do Teams são baseados em Node.js e não são criados com o Visual Studio.

No entanto, podemos fazer algumas recomendações gerais sobre como combinar um suplemento com uma aplicação do Teams.

Saiba mais sobre o manifesto e a estrutura de uma aplicação combinada do Teams e do suplemento do Office

Antes de começar a trabalhar para intercalar as suas duas extensões existentes, obtenha uma noção de como intercalar os dois tipos de extensões ao criar uma nova aplicação teams e um novo suplemento no Toolkit do Teams e, em seguida, siga as instruções em Adicionar um Suplemento do Outlook a uma aplicação do Teams para combiná-las . Preste muita atenção ao seguinte:

  • Como é criado o manifesto unificado único.
  • As diferenças na forma como o suplemento e a aplicação Teams são sideloaded e depurados.

Siga os princípios adequados para combinar aplicações e suplementos do Teams

Quando estiver pronto para intercalar o seu suplemento existente e a aplicação Teams, siga estes princípios:

  • Se o suplemento utilizar um manifesto XML, converta-o para utilizar o manifesto unificado do Microsoft 365, conforme descrito em Converter um suplemento para utilizar o manifesto unificado do Microsoft 365 antes de o combinar com uma aplicação do Teams.
  • Utilize o projeto da aplicação Teams como o projeto base da aplicação unida.
  • Mantenha os ficheiros de configuração aplicáveis ao suplemento e à aplicação Teams na raiz do projeto.
  • Mova ficheiros de origem e ficheiros de configuração que só são aplicáveis à aplicação Teams para uma subpasta da raiz do projeto. Da mesma forma, copie os ficheiros de origem e configuração que só são utilizados pelo suplemento do suplemento existente para uma subpasta diferente da raiz do projeto combinado.
  • Utilize o mesmo domínio base para os ficheiros incorporados do suplemento e da aplicação Teams; por exemplo, contoso.com.
  • Intercale os dois manifestos num único manifesto. Utilize o processo que passou no passo 1 como guia.
  • A propriedade ID no novo manifesto deve ser o mesmo valor que a propriedade "id" no manifesto original da aplicação Teams.
  • Aumentar o valor da propriedade de versão ; por exemplo, aumente "1.0.0" para "1.1.0".
  • Adicione uma propriedade extensions.alternates ao manifesto e configure-a para ocultar as versões originais do suplemento do Office do Office que suportam a combinação de um suplemento e uma aplicação do Teams. Para obter mais informações, consulte Gerir versões novas e antigas de um suplemento.

Publicar a aplicação combinada do Teams e o suplemento do Office

Para publicar a aplicação combinada, trate-a como uma atualização para a aplicação Teams. Para obter mais informações, veja Publicar atualizações na sua aplicação.

Quando a atualização tiver sido publicada, a forma como a atualização fica disponível para os utilizadores finais varia. Seguem-se os princípios gerais.

Observação

Para ser claro sobre o que significa "disponível", tenha em atenção que o Outlook e a aplicação Microsoft 365 têm uma Barra de aplicações tal como o Teams. Em princípio, uma "aplicação teams" pode ser instalada a partir do botão Aplicações ou Mais aplicações em qualquer uma destas três barras de aplicações. A "aplicação Teams" instalada pode ser iniciada a partir de (ou afixada separadamente a) qualquer uma das barras de aplicações de qualquer uma das três aplicações. Um suplemento autónomo do Outlook, por outro lado, é instalado através do botão Todas as Aplicações no friso do Outlook. Além disso, independentemente de ser autónomo ou combinado numa aplicação do Teams, é iniciado um suplemento a partir do friso do Outlook ou é iniciado automaticamente em resposta a um evento na mensagem aberta do Outlook ou no item de reunião. Estes factos são assumidos no resto desta secção.

  • Se o administrador do Microsoft 365 consentir a atualização, então:

    • A versão atualizada da aplicação Teams está imediatamente disponível a partir de Aplicações ou Mais Aplicações no Outlook e da aplicação Microsoft 365, mas não das Aplicações do Teams, aos utilizadores que tinham adquirido anteriormente a aplicação Teams.
    • O suplemento do Outlook também está disponível imediatamente para os utilizadores que tinham adquirido anteriormente a aplicação Teams, independentemente de também terem adquirido anteriormente o suplemento.
    • Se um administrador do Teams permitir a atualização, os utilizadores podem instalá-la individualmente no Teams a partir das Aplicações do Teams.

  • Se o administrador não consentir, cada utilizador que tenha adquirido anteriormente a aplicação Teams tem de consentir a atualização e só pode ser disponibilizado no Teams se o administrador do Teams o tiver permitido.

  • Os utilizadores que tinham adquirido anteriormente apenas o suplemento do Office têm de adquirir a nova aplicação combinada a partir da Loja Teams. Não pode ser adquirido através do botão Todas as Aplicações no friso do Outlook.

Importante

Os utilizadores com determinadas versões mais antigas do Office poderão continuar a ver a versão antiga do suplemento, mesmo depois de a nova aplicação combinada ser adquirida. Geralmente, os suplementos que utilizam o manifesto de aplicação unificada para o Microsoft 365 (antigo manifesto da aplicação Teams) só podem ser instalados na Versão 2307 do Microsoft 365 (Compilação 16626.20132) e posterior. No entanto, existem duas exceções que permitem que estes suplementos sejam instalados em versões mais antigas do Microsoft 365 e em versões de licença perpétua do Office.

  • O administrador do Microsoft 365 do utilizador implementa o suplemento para todos os utilizadores.
  • O utilizador instala o suplemento no Outlook na Web, no novo Outlook para Windows ou noutra aplicação cliente de ambiente de trabalho do Microsoft 365 que seja a Versão 2307 (Compilação 16626.20132) ou posterior. Isto disponibiliza o suplemento noutros clientes do Office do mesmo utilizador, incluindo clientes de licenças mais antigos ou perpétuos.

No futuro, só precisa de atualizar a nova versão da aplicação.

Confira também