Criando guias do Microsoft Teams usando a Estrutura do SharePoint

Artigo
06/29/2022
4 minutos para o fim da leitura

A partir do Estrutura do SharePoint v1.8, você pode criar guias para o Microsoft Teams com as ferramentas do Estrutura do SharePoint e usar o SharePoint como um host para suas soluções. Como parte do Estrutura do SharePoint v1.10, você também pode publicar sua solução como aplicativo pessoal do Microsoft Teams.

Os benefícios de usar o Estrutura do SharePoint como a plataforma para suas guias do Microsoft Teams incluem o seguinte:

O modelo de desenvolvimento é semelhante Estrutura do SharePoint web parts
Qualquer Web Part pode ser exposta como uma guia ou aplicativo pessoal no Microsoft Teams
As diferentes opções de escopo para expor uma guia personalizada como uma web part e uma guia em seu locatário
A guia será executada no contexto do site do SharePoint subjacente por trás da equipe específica. Isso significa que você pode aproveitar quaisquer funcionalidades ou APIs específicas do SharePoint na sua web part.

Processo de desenvolvimento

Você pode começar a desenvolver guias do Microsoft Teams simplesmente usando o Estrutura do SharePoint 1.8 ou pacotes posteriores. As etapas de alto nível para começar são as seguintes:

Observação

Consulte as etapas detalhadas para começar a usar a guia Compilar o Microsoft Teams usando o Estrutura do SharePoint – Tutorial que contém detalhes importantes adicionais que você deve seguir.

Criar uma Estrutura do SharePoint com uma Web Part do lado do cliente
Adicione "TeamsTab" à propriedade supportedHosts do manifesto da Web Part para usá-lo como uma guia em um canal:
```
"supportedHosts": ["SharePointWebPart", "TeamsTab"],
```
Adicione "TeamsPersonalApp" à propriedade supportedHosts do manifesto da Web Part para usá-lo como um aplicativo pessoal:
```
"supportedHosts": ["SharePointWebPart", "TeamsPersonalApp"],
```
Implantar a Web Part usando a opção de implantação no escopo do locatário no catálogo de aplicativos do SharePoint
Ative a Estrutura do SharePoint, que você implantou, e selecione o botão Sincronizar com o Teams no Catálogo de Aplicativos

Opções de implantação

Há várias opções para implantar a guia Microsoft Teams ou como um aplicativo pessoal. Como o SharePoint e o Microsoft Teams têm seu próprio catálogo de aplicativos, a implantação requer operações nos dois serviços. A visibilidade da nova funcionalidade pode ser controlada pelas etapas de implantação executadas.

Implantação de locatário

Você pode usar o botão Sincronizar com o Teams na faixa de opções do Catálogo de Aplicativos que criará automaticamente o manifesto do aplicativo Microsoft Teams, o pacote de aplicativos e o instalará na loja do Microsoft Teams. Isso disponibilizará sua solução para todos os usuários em seu locatário e equipes do Microsoft Teams.

Os desenvolvedores também podem definir o conteúdo do manifesto do aplicativo e do pacote de aplicativos do Microsoft Teams. Consulte as opções de implantação para Estrutura do SharePoint soluções do Microsoft Teams para opções de implantação.

Opções de implantação alternativas

Há uma maneira alternativa de implantar sua solução, que, por exemplo, permitirá disponibilizar uma solução apenas para uma equipe específica em seu locatário.

Crie sua Estrutura do SharePoint solução da maneira normal:
```
gulp bundle --ship
gulp package-solution --ship
```
Localize a pasta ./teams na pasta do projeto:
Adicione o pacote de aplicativos do Microsoft Teams conforme descrito nas opções de implantação Estrutura do SharePoint soluções do Microsoft Teams à pasta ./teams.
Adicione sua solução ao catálogo de aplicativos e selecione a opção Disponibilizar essa solução para todos os sites da organização antes de selecionar Implantar.

Sideload de aplicativos externos no Teams

Vá para sua instância do Microsoft Teams selecionando o Teams no inicializador de aplicativos:
Escolha uma equipe que você deseja usar para testar a funcionalidade e selecione Gerenciar equipe no ... menu:
Mover para a guia Aplicativos .
Escolha Carregar um aplicativo personalizado no canto inferior direito.

Observação

Se essa configuração não estiver disponível, o sideload não estará habilitado no locatário sendo usado. Verifique novamente as configurações da interface do usuário do administrador de locatários.
Carregue o arquivo de manifesto do aplicativo Microsoft Teams criado anteriormente na pasta ./teams em sua solução recém-criada e verifique se ele está corretamente visível na lista de aplicativos. Observe como a imagem personalizada é visível com a descrição da solução:
Vá para um canal na Equipe em que você carregou a solução. Na imagem a seguir, observe que ativamos o canal Geral na Equipe
Selecione + para adicionar uma nova guia ao canal
Selecione sua guia personalizada chamada MyFirstTeamTab na lista:
Observe como você pode personalizar a instância da guia usando as propriedades expostas na Web Part. Selecione Salvar:

Detectando se a web part está no contexto do Teams

O contexto de página em uma Web Part contém uma referência ao SDK javaScript do Teams para que você possa facilmente obter acesso no contexto do Teams quando sua Web Part for renderizada como uma guia.

this.context.sdks.microsoftTeams

Observação

Para obter mais informações sobre o contexto da guia do Microsoft Teams, consulte a documentação de desenvolvimento do Microsoft Teams.

Importante

A propriedade this.context.microsoftTeams foi preterida na versão Estrutura do SharePoint v1.10.

Você deve usar this.context.sdks.microsoftTeams para todas as soluções criadas com o Estrutura do SharePoint v1.10 e posterior.