O objetivo deste documento é fazer com que um ícone apareça fixado na barra de navegação do aplicativo do Microsoft Teams para um site do SharePoint que queremos que esteja disponível para todos os usuários do Teams ou pessoas específicas. Não importa se eles são membros de qualquer Equipe ou Canal. A solução fornecerá aos novos usuários acesso ao próprio portal do cliente para treinamento de equipes antes mesmo de ingressarem ou criarem sua primeira equipe.
1 Controles de aplicativos do Teams no Admin Console
2 Controlando quem pode fazer upload de aplicativos personalizados
3 Verificando quais políticas são aplicadas a um usuário
4 Controlando permissões para aplicativos do Teams
5 Criando o aplicativo
6 Testando o aplicativo
7 Empacotando o aplicativo
8 Carregando o aplicativo
9 Disponibilizando o aplicativo
10 Solução Final
Controles de aplicativos do Teams no Admin Console
Os aplicativos que aparecem na barra de aplicativos do Teams são controlados no console de administração do Teams no locatário. Aplicativos do Teams > Políticas de configuração.
Aviso ! Não preparar seu locatário adequadamente com antecedência para carregar um aplicativo personalizado resultará na seguinte mensagem posteriormente neste documento.
Aviso ! Não preparar seu locatário para permitir que apenas algumas pessoas façam upload de aplicativos personalizados permitirá que todos façam upload de aplicativos em sua loja de aplicativos.
Controlando quem pode fazer upload de aplicativos personalizados
- Na página Políticas de configuração do aplicativo, crie uma nova política personalizada.
Escolhemos o nome “ Política de Upload de Aplicativos ”, mas todos vocês podem usar o que fizer sentido. Na nova política, mude para “ ON ” a capacidade de fazer upload de aplicativos personalizados se o ID do usuário for atribuído a esta política.
- Ignore todas as outras configurações e clique em “ Salvar ”
- Na tela da política, selecione a nova política e clique em “ Gerenciar usuários ”
- Na página Usuários Gerenciados, digite os nomes dos usuários aos quais você deseja atribuir esta política.
- Qualquer usuário que não faça parte desta política receberá o seguinte erro ao tentar fazer upload de um aplicativo.
Aviso ! Depois de salvar essas configurações de política, pode levar horas para que elas entrem em vigor.
Verificando quais políticas são aplicadas a um usuário
- Navegue até a guia “ Usuários ” no Centro de administração do Teams
- Procure um usuário ao qual você acabou de aplicar a política na etapa anterior e marque a caixa ao lado do usuário. Isso permitirá que você veja quantas políticas se aplicam a esse usuário.
- Você pode então selecionar a opção “ Editar configurações ” para editar as configurações de política do usuário.
- Localize a opção " Política de configuração do aplicativo " e clique no menu suspenso.
- Você verá todas as políticas atuais de configuração do aplicativo controlando o acesso deste usuário aos aplicativos do Teams.
Controlando permissões para aplicativos do Teams
- No Console de administração do Teams, procure a guia “ Políticas de permissões ” em “ Aplicativos do Teams ”
- Clique no botão “ Configurações do aplicativo em toda a organização ” para verificar as permissões atuais para usar os aplicativos do Teams em seu locatário.
Aviso ! Se o administrador do seu locatário tiver definido as opções abaixo em verde como " Desativado ", você não poderá concluir com êxito esta missão de documentos de adicionar e usar um aplicativo personalizado no Teams.
- Em seguida, devemos verificar a permissão do aplicativo no nível da política se as configurações anteriores pareciam estar ativadas.
- Nas “ Políticas de permissão do aplicativo ”, selecione a política “ Global (padrão para toda a organização) para suas configurações verificando a política e clicando em “ Editar ”
- O melhor cenário é que a caixa em verde está definida para todos os aplicativos e os usuários estão abaixo desta política. É o padrão e nenhuma outra política os restringe dessas configurações.
Aviso! Se o administrador alterou a permissão de aplicativos padrão para algo diferente de " Permitir todos os aplicativos ", precisaremos colocar nosso aplicativo personalizado na lista de permissões no final deste documento e o aplicativo " Teams Apps Studio " desde o início para permitir que eles sejam vistos por os usuários no Teams.
- Neste ponto, nosso aplicativo de portal não foi criado, portanto, não podemos colocar na lista de permissões até concluirmos as etapas neste documento e carregarmos o aplicativo personalizado no Catálogo de aplicativos do locatário.
- Certifique-se de salvar todas as alterações feitas e dar tempo para que as alterações de políticas entrem em vigor.
Criando o aplicativo
Agora que temos nossas políticas de aplicativos e permissões preparadas, estamos prontos para criar o aplicativo personalizado para exibir o ícone vinculado ao nosso Portal do SharePoint na barra de navegação do aplicativo do Teams.
- Faça login na versão da Web do Teams ou na versão da área de trabalho como um usuário que adicionamos à “ Política de upload de aplicativos ”
- No Teams, clique no ícone da App Store na barra de navegação do aplicativo à esquerda do Teams.
- Quando a loja abrir digite “ App Studio ” para localizar o aplicativo que precisamos instalar para que esse usuário crie nosso aplicativo personalizado.
- Clique no botão “ Adicionar ” para instalar o aplicativo
- Depois que o aplicativo App Studio for aberto, clique em " Editor de manifesto "
- Na guia do editor de manifesto, procure por “ Criar um novo aplicativo ”
- Em seguida, você verá a tela a seguir com muitos campos que devemos preencher. Vamos levá-los uma seção de cada vez.
- Detalhes do aplicativo Aviso ! Não coloque “ Microsoft ” na nomenclatura. Se você tornar o “ Nome abreviado ” muito longo, ele será truncado e mostrará uma elipse ao lado do nome.
Na seção de identificação, você deve clicar no botão “ Gerar ” para gerar uma chave única para este aplicativo. Você deve preencher o “ Nome do pacote ”. Você pode usar qualquer nome basta seguir o formato mostrado acima. A “ Versão ” também precisa ser definida.
- Descrição Aviso ! Não coloque “ Microsoft ” na nomenclatura
- Informações do desenvolvedor
As informações do desenvolvedor apenas identificam quem criou o aplicativo e um site para descobrir mais sobre o desenvolvedor. Sugiro vincular a uma página que as pessoas possam descobrir mais sobre o desenvolvimento e a finalidade do aplicativo. Neste exemplo, apenas apontamos de volta para o site do SharePoint que inicia o site Learning Pathways em um locatário.
A URL para a “ Declaração de privacidade ” aponta para a declaração de privacidade da Microsoft desde este exemplo com o uso do Portal de Caminhos de Aprendizagem da Microsoft. Os “ Termos de Uso ” apenas apontam para a documentação do Portal Learning Pathways. Recomenda-se que esses URLs não apontem para sites hospedados externamente. Durante nossos testes deste aplicativo, veremos os seguintes avisos.
Você precisará de pelo menos dois logotipos da página de branding. Eles devem ser do tamanho exato listado em sua descrição. Agora você concluiu todas as opções na guia " Detalhes do aplicativo ". Agora vá para a guia “ Guias ” em “ Capabilities ”.
- Clique em “ Adicionar uma guia pessoal ”
- Na guia Nome, escolha um nome que aparecerá na página da Web do portal, conforme mostrado abaixo.
- Defina qualquer número no ID da entidade.
- O “ URL de conteúdo ” que apontamos para o nosso portal Learning Pathways.
- O “ URL do site ” que apontamos para o nosso portal de Caminhos de Aprendizagem Clique em Salvar.
- Logon único do aplicativo Web
- A ID do aplicativo AAD neste exemplo é para um site do SharePoint. O número oficial é 00000003-0000-0ff1-ce00-000000000000 não use nenhum outro número para este exemplo.
- A “ URL do recurso ” precisa ter o nome exclusivo do seu locatário no lugar do meu “ m365x360288 ”. Pressione Salvar após preencher os campos.
- Concluímos agora a configuração de nosso aplicativo personalizado.
Testando o aplicativo
- Sob o título “ Finish ” no App Studio App selecione “ Test and Distribute ”
- Em seguida, você verá a tela a seguir com uma série de avisos. Não se preocupe com os avisos neste caso de uso de exemplo. Em um ambiente de produção, você deve seguir a orientação de torná-los porta para URLs internos.
- Se você não inseriu as coisas corretamente, verá o seguinte aviso.
- Se você fez tudo certo, o instalador do aplicativo aparecerá pronto para você testar Adicione-o às suas equipes. Antes de clicar em adicionar, revise as informações sobre o sobre . Você verá como as informações foram usadas acima.
- Após a instalação do aplicativo, ele carregará o portal Learning Pathways, se funcionar.
Empacotando o aplicativo
- Retorne ao aplicativo App Studio clicando na elipse na barra de navegação do aplicativo.
- A janela a seguir será aberta exibindo o aplicativo “ App Studio ” e o aplicativo “ Contoso Learning ” que acabamos de testar adicionar à nossa equipe de usuários. Clique no ícone " App Studio " para reiniciar o aplicativo. Selecione o “ Editor de manifesto ”
- Procure em “ Aplicativos criados recentemente ” pelo aplicativo “ Contoso Learning ” e clique nele.
- Clique na aba “ Testar e distribuir ”
- Clique no botão “ Download ” para empacotar o aplicativo para importação.
- Você verá um pop-up indicando que o pacote foi exportado e o nome do arquivo.
- O local será a pasta de downloads no PC. Lembre-se desse local para o upload no Portal de aplicativos do locatário.
Carregando o aplicativo
- Volte para o Teams e procure o ícone “ Aplicativos ” na barra de navegação do aplicativo
- Se o seu ID de usuário tiver a permissão correta concedida para fazer upload de um aplicativo personalizado, você pode clicar em “ Fazer upload de um aplicativo personalizado ” na parte inferior da lista. Clique nisso. Em seguida, clique para fazer o upload para o seu inquilino. Não tenho certeza porque é um clique duplo Navegue até a pasta de downloads para localizar nosso pacote e clique em “ Abrir ”
- Se você não conseguiu usar uma conta que está na “ Política de Upload de Aplicativos ” que criamos, você verá o seguinte erro.
- Se for bem-sucedido, o aplicativo agora aparecerá no Catálogo de aplicativos do locatário
- Pesquisar este aplicativo no catálogo de aplicativos e clicar em adicionar instalará o aplicativo na elipse, como na instalação de teste. PARE! Não vamos instalar o aplicativo dessa maneira. Em vez disso, vamos fixar o aplicativo na barra de navegação do aplicativo usando nossa “ Política de configuração do aplicativo ”.
Disponibilizando o aplicativo
- Localize a Política de configuração do aplicativo que criamos anteriormente e marque a caixa. Em seguida, clique em “ Editar ”
- Em “ Aplicativos fixados ”, clique em “ Adicionar aplicativos ”
- Procure o aplicativo “ Aprendizagem ”, selecione-o e clique em “ Adicionar ”. Clique no botão “ Adicionar ” na parte inferior para fechar a tela.
- Agora você verá o aplicativo sobre como vou aparecer na barra de navegação do aplicativo. O padrão está na parte inferior, você pode destacar o aplicativo e movê-lo para cima. Se estiver satisfeito com a posição clique em “ Salvar ”
Solução final
- Agora, esperamos que as configurações de política sejam sincronizadas nos sistemas de back-end do Microsoft 365 antes de vermos os resultados do nosso trabalho. Não veremos nosso novo aplicativo aparecer na barra de navegação do aplicativo por cerca de 2 horas.
- Clique no ícone New App e veja o projeto finalizado.
