Importação de arquivos do SharePoint e do OneDrive for Business

o Power Query oferece uma série de maneiras de obter acesso a arquivos hospedados em SharePoint ou OneDrive for Business.

Procurar arquivos

Observação

no momento, você só pode procurar OneDrive for Business arquivos do usuário autenticado dentro do Power Query Online para PowerApps.

Power Query fornece um botão procurar OneDrive ao lado da caixa de texto caminho do arquivo ou URL quando você cria um fluxo de arquivos no PowerApps usando qualquer um destes conectores:

Procurar OneDrive... dentro da janela configurações de conexão do conector de Excel.

Ao selecionar esse botão, você será solicitado a passar pelo processo de autenticação. depois de concluir esse processo, uma nova janela é exibida com todos os arquivos dentro da OneDrive for Business do usuário autenticado.

nova janela para procurar os arquivos da OneDrive for Business do usuário autenticado.

Você pode selecionar o arquivo de sua escolha e, em seguida, selecionar o botão abrir . Depois de selecionar abrir, você será levado de volta à página Configurações de conexão inicial, onde verá que a caixa de texto caminho do arquivo ou URL agora contém a URL exata para o arquivo que você selecionou em onedrive for Business.

Janela de configurações de conexão com a URL para o arquivo selecionado hospedado em OneDrive for Business.

Você pode selecionar o botão Avançar no canto inferior direito da janela para continuar o processo e obter seus dados.

Do conector da Web usando uma URL de arquivo

  1. Navegue até o local do seu OneDrive for Business usando um navegador. Clique no arquivo que você deseja usar e selecione Abrir no Excel.

    Observação

    A interface do navegador pode não ser exatamente igual à imagem a seguir. Há várias maneiras de selecionar Abrir no Excel para arquivos em sua interface de navegador do OneDrive for Business. Você pode usar qualquer opção que permite abrir o arquivo no Excel.

    Captura de tela do OneDrive em um navegador mostrando a seleção de Abrir no Excel.

  2. em Excel, selecione arquivo > informações e, em seguida, selecione o botão copiar caminho .

    Captura de tela do menu Informações mostrando a seleção do botão Copiar caminho.

Para usar o link que você acabou de copiar no Power Query, execute as seguintes etapas:

  1. Selecione Obter Dados > Web.

    captura de tela da faixa de opção obter dados no Power BI Desktop, mostrando a seleção da Web.

  2. Na caixa de diálogo da Web, selecione a opção básico e cole o link na URL.

  3. Remova a cadeia de caracteres ? Web = 1 no final do link para que Power Query possa navegar corretamente até o arquivo e, em seguida, selecione OK.

    Captura de tela da caixa de diálogo da Web, mostrando como remover uma cadeia de caracteres do campo URL.

  4. se Power Query solicitar credenciais, escolha Windows (para sites SharePoint locais) ou conta organizacional (para Microsoft 365 ou OneDrive for Business sites). o Conexão select.

    captura de tela da Power BI Desktop solicitação de credencial, enfatizando a Windows ou a seleção de conta organizacional.

    Cuidado

    ao trabalhar com arquivos hospedados em OneDrive para página inicial, o arquivo ao qual você deseja se conectar precisa estar disponível publicamente. Ao definir o método de autenticação para essa conexão, selecione a opção anônimo .

quando a caixa de diálogo navegador for exibida, você poderá selecionar na lista de tabelas, planilhas e intervalos encontrados na pasta de trabalho do Excel. De lá, você pode usar o arquivo do OneDrive for Business da mesma forma que qualquer outro arquivo do Excel. Você pode criar relatórios e usá-los em conjuntos de dados como faria com qualquer outra fonte de dados.

Observação

Para usar um arquivo do OneDrive for Business como fonte de dados no serviço do Power BI, com Atualização de Serviço habilitada para esse arquivo, selecione OAuth2 como o Método de autenticação ao configurar as definições de atualização. Caso contrário, você pode encontrar um erro (como Falha ao atualizar as credenciais de fonte de dados) ao tentar se conectar ou atualizar. Selecionar OAuth2 como método de autenticação resolve esse erro de credenciais.

conector de pasta SharePoint

você pode ler um guia passo a passo detalhado sobre como se conectar aos arquivos hospedados no site do SharePoint no artigo SharePoint pasta .

depois de estabelecer a conexão com êxito, você será avisado com uma visualização de tabela que mostra os arquivos em seu site de SharePoint. Selecione o botão transformar dados na parte inferior direita da janela.

visualização de tabela depois de se conectar a um SharePoint site usando o conector de pasta SharePoint mostrando os arquivos encontrados no site SharePoint.

A seleção do botão transformar dados levará você a uma exibição dos dados, chamada de exibição do sistema de arquivos. cada uma das linhas nesta tabela representa um arquivo encontrado no site SharePoint.

visualização de tabela dos arquivos no site de SharePoint depois de selecionar o botão transformar dados.

A tabela tem uma coluna chamada Content que contém o arquivo em um formato binário. Os valores na coluna de conteúdo têm uma cor diferente do restante dos valores nas outras colunas da tabela, o que indica que eles são selecionáveis.

Ao selecionar um valor binário na coluna conteúdo , Power Query adicionará automaticamente uma série de etapas em sua consulta para navegar até o arquivo e interpretar seu conteúdo sempre que possível.

Por exemplo, na tabela mostrada na imagem anterior, você pode selecionar a segunda linha em que o campo nome tem um valor de 02-February.csv. Power Query criará automaticamente uma série de etapas para navegar e interpretar o conteúdo do arquivo como um arquivo CSV.

Conteúdo de um arquivo CSV com o nome 02-February.csv que foram automaticamente interpretados pelo Power Query conforme mostrado na seção etapas aplicadas.

Observação

Você pode interagir com a tabela aplicando filtros, classificações e outras transformações antes de navegar até o arquivo de sua escolha. Depois de concluir essas transformações, selecione o valor binário que você deseja exibir.

experiência OneDrive for Business

o conector de pasta SharePoint e sua experiência também funcionam para arquivos hospedados no OneDrive for Business. no entanto, a URL que você precisa usar é diferente da que você usaria para um site SharePoint. para localizar sua url exclusiva, acesse seu portal de OneDrive for Business e copie a url do seu navegador. Essa URL pode ser semelhante ao exemplo a seguir:

https://contoso-my.sharepoint.com/personal/user123_contoso_com/_layouts/15/onedrive.aspx

Você não precisa da URL completa, mas apenas as primeiras partes. A URL que você precisa usar em Power Query terá o seguinte formato:

https://<unique_tenant_name>.sharepoint.com/personal/<user_identifier>

Por exemplo:

https://contoso-my.sharepoint/personal/user123_contoso_com

SharePoint. Função de conteúdo

embora o conector de pasta SharePoint ofereça uma experiência em que você possa ver todos os arquivos disponíveis em seu SharePoint ou OneDrive for Business site de uma vez, você também pode optar por uma experiência diferente. nessa experiência, você pode navegar pelas pastas SharePoint ou OneDrive for Business e acessar a (s) pasta (ns) em que você está interessado.

Essa experiência é fornecida por meio da SharePoint.Contents função. Execute as seguintes etapas para usar esta função:

  1. Crie uma consulta em branco.

  2. altere o código na barra de fórmulas para SharePoint.Contents("url") onde url está o mesmo formato usado para o conector de pasta SharePoint. Por exemplo:       SharePoint.Contents("https://contoso.sharepoint.com/marketing/data")

    Observação

    por padrão, essa função tenta usar SharePoint a versão 14 da API para se conectar. se você não tiver certeza da versão da API que está sendo usada pelo site SharePoint, talvez queira tentar usar o seguinte código de exemplo: SharePoint.Contents("https://contoso.sharepoint.com/marketing/data", [ApiVersion="Auto"]) .

  3. Power Query solicitará que você adicione um método de autenticação para sua conexão. use o mesmo método de autenticação que você usaria para o conector de arquivos de SharePoint.

  4. Navegue pelos diferentes documentos para as pastas ou arquivos específicos nos quais você está interessado.

    por exemplo, imagine um site SharePoint com uma pasta documentos compartilhados . Você pode selecionar o valor da tabela na coluna conteúdo para essa pasta e navegar diretamente para essa pasta.

    visualização de tabela depois de se conectar ao site de SharePoint com a função SharePoint. Conteúdo em que há uma pasta com o nome documentos compartilhados.

    Dentro dessa pasta documentos compartilhados , há uma pasta na qual a empresa armazena todos os relatórios de vendas. Essa pasta é denominada relatórios de vendas. Você pode selecionar o valor da tabela na coluna conteúdo para essa linha.

    Visualização da tabela depois de navegar para a pasta documentos compartilhados.

    Com todos os arquivos dentro da pasta Sales Reports , você pode selecionar o botão combinar arquivos (consulte visão geral de combinar arquivos) para combinar os dados de todos os arquivos nesta pasta para uma única tabela. Ou você pode navegar diretamente para um único arquivo de sua escolha selecionando o valor binário na coluna conteúdo .

    Visualização da tabela depois de navegar para a pasta de relatórios de vendas.

Observação

a experiência fornecida pela SharePoint.Contents função é ideal para ambientes SharePoint e OneDrive for Business com um grande número de arquivos.