Pasta SharePoint

Resumo

Número Descrição
Estado de Lançamento Disponibilidade Geral
Produtos Excel
Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Fabric (Dataflow Gen2)
Power Apps (Fluxos de dados)
Dynamics 365 Customer Insights
Tipos de Autenticação Suportados Anônimo
Conta Microsoft
Windows
Conta Organizacional
Documentação de referência da função SharePoint.Contents
SharePoint.Ficheiros

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendamentos de implantação e recursos específicos do host.

Observação

O Microsoft Entra ID/OAuth para SharePoint on-premises não é suportado através do gateway de dados on-local.

Capacidades suportadas

  • Caminho da pasta
  • Combinar
    • Combinar e carregar
    • Combinar e transformar

Tipos de autenticação suportados

Observação

O suporte à identidade do espaço de trabalho para ficheiros SharePoint está a ser implementado com atualizações recentes do serviço e está disponível apenas em experiências suportadas no Fabric.
A disponibilidade pode variar consoante a carga de trabalho e o host (por exemplo, o Power BI Desktop não é suportado).

O conector de pasta SharePoint suporta os seguintes métodos de autenticação, dependendo da experiência de alojamento:

  • Conta organizacional: Utiliza o ID Microsoft Entra do utilizador para se autenticar no SharePoint.
  • Identidade do espaço de trabalho: No Microsoft Fabric, experiências suportadas (como Dataflows Gen2 e Power BI) podem autenticar-se aos ficheiros SharePoint usando a identidade do espaço de trabalho. Isto permite que o Fabric aceda ao conteúdo dos ficheiros SharePoint usando a identidade gerida do espaço de trabalho, sem depender de credenciais de utilizador ou autenticação antiga baseada em ACS.

Determinar o URL do site

Quando se liga à biblioteca de documentos num site SharePoint, é pedido que introduza o URL do site. Para encontrar o URL do site que contém a sua pasta SharePoint, abra primeiro uma página no SharePoint. A partir de uma página em SharePoint, normalmente pode obter o endereço do site selecionando Home no painel de navegação, ou o ícone do site no topo. Copie o endereço da barra de endereço do seu navegador da Web e salve para mais tarde.

Captura de ecrã que enfatiza as localizações do Home no painel de navegação, o ícone no topo do site e o endereço URL resultante.

Observação

Uma página clássica de URL do SharePoint não é suportada e não consegue ligar-se. Apenas uma home page moderna do SharePoint é suportada.

Seletor de sites do SharePoint

O seletor de sites do SharePoint permite-lhe encontrar e selecionar o site SharePoint correto durante a criação da ligação, sem ter de navegar para páginas separadas para localizar e copiar URLs manualmente.

Seleção simplificada de sites: Em vez de copiar URLs manualmente, use o menu suspenso URL do site para escolher entre os seus sites Recentes, Favoritos e todos os sites a que possa aceder.

Captura de ecrã da seleção de SharePoint site a partir SharePoint Site Picker.

Experiência rápida de pesquisa: Escreva palavras-chave na caixa de pesquisa suspensa para localizar rapidamente sites relevantes. Depois de selecionar um site, pode imediatamente avançar para carregar os dados para análise.

Captura de ecrã da pesquisa SharePoint site.

Observação

  • O seletor de site do SharePoint está disponível para fontes do SharePoint em Dataflow Gen2 e Gen1, na modelação Web do Power BI, em Pipelines, Copy Job e atalhos de Lakehouse, assim como como destino em Dataflow Gen2.
  • Na primeira vez que usa o seletor de sites do SharePoint, aparece uma janela de autenticação. Selecione a mesma conta com a qual tenha atualmente iniciado sessão. Se fechares ou ignorares a janela, o seletor de sites não funcionará, embora ainda possas colar manualmente os URLs do site do SharePoint como antes.
  • Ao usar o seletor de sites do SharePoint, pode ter problemas ao procurar sites alojados em regiões fora da sua própria geografia.

Ligue-se a uma pasta SharePoint a partir do Power Query Desktop

Para se ligar a uma pasta do SharePoint:

  1. A partir de Get Data, selecione SharePoint pasta. Para obter mais informações: Onde obter dados

  2. Cole o URL do site do SharePoint que copiou em Determine o URL do site na caixa de texto URL do site na caixa de diálogo Pasta do SharePoint. Neste exemplo, a URL do site é https://contoso.sharepoint.com/marketing/data. Se o URL do site inserido for inválido, um ícone de aviso de será exibido ao lado da caixa de texto URL.

    Captura de ecrã do diálogo da pasta SharePoint com o URL introduzido no Site URL.

    Selecione OK para continuar.

  3. Se você estiver visitando este endereço de site pela primeira vez, selecione o método de autenticação apropriado. Insira suas credenciais e escolha a qual nível aplicar essas configurações. Em seguida, selecione Conectar.

    Captura de ecrã da autenticação de pasta do SharePoint no ambiente de trabalho.

    Para obter mais informações sobre métodos de autenticação e configurações de nível, vá para Autenticação em aplicações de ambiente de trabalho.

  4. Depois de se ligar, a informação sobre todos os ficheiros dessa pasta SharePoint é apresentada. Além disso, informações de arquivo sobre quaisquer arquivos em qualquer subpasta também são exibidas.

    Captura de ecrã do Navegador a mostrar as informações da pasta.

  5. Selecione Combinar e Transformar Dados para combinar os dados nos ficheiros da pasta do SharePoint selecionada e carregar os dados no editor do Power Query para edição. Ou seleciona Combinar & Carregar para carregar os dados de todos os ficheiros na pasta SharePoint diretamente na aplicação.

    Captura de ecrã do Navegador com as opções de combinação sob o botão Combinar.

Observação

O Combinar & Transformar Dados e Combinar & Carregar botões são a forma mais fácil de combinar dados encontrados nos ficheiros da pasta SharePoint que especificas. Você também pode usar o botão Carregar ou os botões Transformar Dados para combinar os arquivos também, mas isso requer mais etapas manuais.

Ligue-se a uma pasta SharePoint a partir do Power Query Online

Para se ligar a uma pasta do SharePoint:

  1. A partir da página Fontes de dados, selecione SharePoint pasta.

  2. Se tiver acesso ao seletor de sites SharePoint, use-o para localizar e selecionar os sites diretamente na página de definições de ligação. Se não, copie o URL do site SharePoint e cole-o na caixa de texto URL do Site na caixa de diálogo Pasta do SharePoint. Neste exemplo, a URL do site é https://contoso.sharepoint.com/marketing/data.

    Captura de ecrã da seleção de pastas online e iniciar sessão.

  3. Se a pasta do SharePoint for local, insira o nome de um gateway de dados local.

  4. Selecione o tipo de autenticação e insira as credenciais necessárias.

  5. Selecione Avançar.

  6. Quando selecionas a pasta SharePoint que queres usar, a informação dos ficheiros sobre todos os ficheiros dessa pasta SharePoint é exibida. Além disso, informações de arquivo sobre quaisquer arquivos em qualquer subpasta também são exibidas.

    Captura de ecrã do Navegador online a mostrar as informações da pasta.

  7. Selecione Combine para combinar os dados nos ficheiros da pasta de SharePoint selecionada e carregar os dados no editor de Power Query para edição.

    Observação

    O botão Combine é a forma mais fácil de combinar dados encontrados nos ficheiros da pasta SharePoint que especificas. Você também pode usar os botões Transformar dados para combinar os arquivos, mas isso requer mais etapas manuais.

Solução de problemas

Combinando arquivos

Todos os ficheiros na pasta SharePoint que selecionares estão incluídos nos dados a serem combinados. Se tiver ficheiros de dados localizados numa subpasta da pasta SharePoint que selecionar, todos estes ficheiros também estão incluídos. Para garantir que a combinação dos dados do arquivo funcione corretamente, certifique-se de que todos os arquivos na pasta e nas subpastas tenham o mesmo esquema.

Em alguns casos, pode ter várias pastas no seu site SharePoint contendo diferentes tipos de dados. Neste caso, você precisa excluir os arquivos desnecessários. Para eliminar estes ficheiros:

  1. Na lista de ficheiros da pasta SharePoint que escolheste, seleciona Transformar Dados.

    Captura de ecrã da lista de exemplos de ficheiros de pasta SharePoint.

  2. No editor Power Query, desça para encontrar os ficheiros que quer manter.

    Captura de ecrã do editor de Power Query onde encontras os ficheiros a guardar.

  3. Neste exemplo, os arquivos necessários são as últimas linhas da tabela. Selecione Remover Linhas>Remover Linhas Superiores, insira o valor da última linha antes dos ficheiros que deseja manter (neste caso, 909) e selecione o OK.

    Captura de ecrã do editor de Power Query com a opção Remover linhas enfatizada.

  4. Depois de remover todos os arquivos desnecessários, selecione Combinar arquivos na faixa de opções do Home para combinar os dados de todos os arquivos restantes.

Para mais informações sobre como combinar ficheiros, consulte a visão geral da combinação de ficheiros.

Caracteres especiais do nome do arquivo

Se um nome de arquivo contiver determinados caracteres especiais, isso pode levar a erros de autenticação devido ao nome do arquivo ser truncado na URL. Se você estiver recebendo erros de autenticação incomuns, verifique se todos os nomes de arquivos que você está usando não contêm nenhum dos seguintes caracteres especiais.

# % $

Se esses caracteres estiverem presentes no nome do arquivo, o proprietário do arquivo deverá renomeá-lo para que ele não contenha nenhum desses caracteres.

Permissões

Ao solicitar o conteúdo da biblioteca de documentos, deve ter acesso de leitura ao site SharePoint, à biblioteca de documentos e a quaisquer pastas que conduzam ao ficheiro solicitado.

Autenticação do Microsoft Entra ID

A autenticação Microsoft Entra ID não é suportada para fontes SharePoint locais.