Migração de Arquivos do Teams Cria Pasta de Canal Errada: Checklist para Administradores

Ao migrar arquivos para o Microsoft Teams, a pasta do canal de destino às vezes não corresponde à estrutura esperada. Os arquivos vão parar na pasta do canal errado ou na raiz da biblioteca de documentos do SharePoint. Esse problema ocorre porque o Teams armazena arquivos de canal em uma estrutura de pastas oculta do SharePoint que as ferramentas de migração devem corresponder exatamente. Este artigo explica a causa raiz do problema de pasta errada e fornece um checklist passo a passo para administradores garantirem que sua migração crie as pastas de canal corretas.

Por que os Arquivos do Teams Vão para a Pasta de Canal Errada

O Microsoft Teams armazena arquivos de cada canal em uma biblioteca de documentos do SharePoint. O caminho segue um padrão rigoroso:

Site do SharePoint > Documents > Nome do Canal (a pasta real do canal)

A pasta do canal não é uma pasta comum. É uma pasta do SharePoint que o processo de provisionamento do Teams cria ao criar um canal. Essa pasta tem um tipo de conteúdo especial e está vinculada ao canal do Teams. Se você migrar arquivos diretamente para a raiz da biblioteca Documents ou para uma pasta com nome diferente, o Teams não exibirá esses arquivos dentro do canal. Os arquivos aparecerão na biblioteca do SharePoint, mas não na guia Arquivos do Teams.

A Estrutura de Pastas Oculta

Ao criar uma equipe com canais, o Teams cria um site do SharePoint com uma biblioteca de documentos chamada “Documents.” Dentro dessa biblioteca, ele cria uma pasta para cada canal. Por exemplo, um canal chamado “Marketing” recebe uma pasta em Documents/Marketing. Essa pasta fica oculta na navegação padrão do SharePoint, mas é visível na biblioteca de documentos. O nome da pasta deve corresponder exatamente ao nome do canal, incluindo a diferenciação entre maiúsculas e minúsculas em algumas ferramentas de migração.

Por que as Ferramentas de Migração Mapeiam Incorretamente

A maioria das ferramentas de migração permite mapear uma pasta de origem para uma pasta de destino. Se você mapear a origem para a raiz do site do SharePoint ou para a raiz da biblioteca Documents em vez da pasta específica do canal, os arquivos vão parar no lugar errado. Algumas ferramentas também não criam a pasta do canal se ela ainda não existir. O resultado é que os arquivos vão para a pasta General ou para uma pasta recém-criada que não está vinculada a nenhum canal.

Checklist do Administrador: Etapas para Mapear Pastas de Canal Corretamente

Siga este checklist antes e durante sua migração para garantir que os arquivos caiam na pasta de canal correta.

Etapa 1: Verifique se o Canal do Teams Existe

1. Abra o centro de administração do Teams
   Vá para Centro de administração do Teams > Equipes > Gerenciar equipes. Selecione a equipe de destino e clique em Canais. Verifique se o canal para o qual você pretende migrar arquivos está listado. Se o canal não existir, crie-o primeiro. O nome do canal deve corresponder ao nome da pasta que você usará no SharePoint.

Etapa 2: Identifique a URL do Site do SharePoint

1. Obtenha a URL do site do SharePoint
   No Teams, vá para o canal de destino e clique na guia Arquivos. Clique em Abrir no SharePoint. O navegador abrirá a biblioteca de documentos do SharePoint para esse canal. Copie a URL completa da barra de endereços. A URL será semelhante a: https://sualocatario.sharepoint.com/sites/NomeDaEquipe/Shared%20Documents/Forms/AllItems.aspx
2. Anote a URL do conjunto de sites
   A partir da URL, extraia a parte do conjunto de sites: https://sualocatario.sharepoint.com/sites/NomeDaEquipe. Este é o site de destino para sua ferramenta de migração.

Etapa 3: Mapeie a Pasta de Origem para a Pasta do Canal

1. Configure o mapeamento na ferramenta de migração
   Em sua ferramenta de migração (Ferramenta de Migração do SharePoint, Sharegate ou ferramenta de terceiros), defina o destino como a URL do site do SharePoint da Etapa 2. Defina a biblioteca de destino como Documents. Defina a pasta de destino como o nome exato do canal, por exemplo Marketing. Não inclua o caminho completo como Documents/Marketing no campo de pasta, a menos que a ferramenta solicite explicitamente.
2. Teste com um pequeno conjunto de arquivos
   Antes de migrar todos os arquivos, execute um teste com cinco arquivos. Após o teste, abra o canal do Teams e verifique a guia Arquivos. Os arquivos devem aparecer dentro do canal. Se aparecerem no canal General ou na raiz de Documents, o mapeamento está errado. Ajuste o nome da pasta de destino e teste novamente.

Etapa 4: Verifique o Tipo de Conteúdo da Pasta do Canal

1. Verifique as propriedades da pasta no SharePoint
   Na biblioteca de documentos do SharePoint, clique na pasta do canal e selecione Detalhes. No painel direito, role até Tipo de conteúdo. Deve mostrar Pasta de Canal. Se mostrar Pasta ou Conjunto de Documentos, a pasta não está vinculada a um canal do Teams. Exclua a pasta e recrie o canal no Teams. Em seguida, mapeie a migração para a nova pasta.

Etapa 5: Verifique as Permissões na Pasta do Canal

1. Verifique as permissões da pasta
   No SharePoint, selecione a pasta do canal e clique em Gerenciar acesso. As permissões devem ser herdadas do site, não quebradas. Se as permissões forem exclusivas, o Teams pode não exibir os arquivos corretamente. Redefina a herança de permissões, se necessário.

Se os Arquivos Ainda Forem para a Pasta Errada Após a Migração

Arquivos Aparecem no Canal General em Vez do Canal de Destino

Isso acontece quando a ferramenta de migração mapeia arquivos para a raiz da biblioteca Documents ou para a pasta General. A pasta General é a pasta de canal padrão para o primeiro canal. Para corrigir, exclua os arquivos da pasta General e execute novamente a migração com a pasta de destino correta definida como o nome do canal de destino.

Arquivos Aparecem na Biblioteca do SharePoint, mas Não no Teams

Se os arquivos estiverem visíveis na biblioteca Documents do SharePoint, mas ausentes na guia Arquivos do Teams, o tipo de conteúdo da pasta está errado. Verifique o tipo de conteúdo da pasta conforme descrito na Etapa 4. Se o tipo de conteúdo não for Pasta de Canal, a pasta não está conectada a um canal do Teams. Exclua a pasta e recrie o canal no Teams. Em seguida, execute a migração novamente.

Ferramenta de Migração Cria uma Nova Pasta em Vez de Usar a Pasta de Canal Existente

Algumas ferramentas de migração criam uma nova pasta se o nome da pasta de destino não existir. Isso cria uma pasta duplicada que não está vinculada a nenhum canal. Para evitar isso, sempre verifique se a pasta do canal existe no SharePoint antes de mapear. Use o nome do canal exatamente como aparece no Teams, incluindo maiúsculas e minúsculas. Se a ferramenta criar uma nova pasta, exclua-a e execute novamente a migração com a pasta existente correta.

Opções de Mapeamento de Pasta de Canal: Ferramenta de Migração vs. Manual

Item	Mapeamento com Ferramenta de Migração	Upload Manual
Pasta de destino	Definida como nome do canal na ferramenta	Abra o canal no Teams, clique na guia Arquivos e depois em Upload
Criação de pasta	A ferramenta usa a pasta de canal existente	Nenhuma criação de pasta necessária
Tipo de conteúdo	Deve corresponder a Pasta de Canal	Correto automaticamente
Migração em massa	Suporta milhares de arquivos	Não é prático para grandes conjuntos
Tratamento de erros	Logs mostram erros de caminho de pasta	Sem logs

As ferramentas de migração são o único método prático para movimentações em massa de arquivos. O upload manual funciona para pequenos lotes, mas não escala. Sempre use uma ferramenta que suporte mapeamento de pastas do SharePoint e verifique se a pasta de destino existe.

Agora você conhece a causa exata do problema de pasta de canal errada e tem um checklist de cinco etapas para evitá-lo. Comece verificando se o canal existe e obtendo a URL correta do site do SharePoint. Em seguida, mapeie sua ferramenta de migração para a pasta com o nome do canal, não para a raiz da biblioteca. Após a migração, sempre verifique se o tipo de conteúdo da pasta é Pasta de Canal. Para migrações futuras, crie um canal de teste primeiro e execute um pequeno conjunto de arquivos para validar o mapeamento antes de mover todos os dados.