Partilhar via

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

  • Artigo

O Power Query oferece uma série de formas de obter acesso a ficheiros alojados no SharePoint ou no OneDrive para Empresas.

Procurar ficheiros

Nota

Atualmente, só pode procurar ficheiros do OneDrive para Empresas do utilizador autenticado dentro do Power Query Online para PowerApps.

Aviso

Esta funcionalidade requer que o seu navegador permita cookies de terceiros. Se o seu navegador bloqueou cookies de terceiros, a caixa de diálogo Procurar aparecerá, mas ficará completamente em branco, sem opção para fechar a caixa de diálogo.

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

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

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

Nova janela para procurar os arquivos do 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 para a página de 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 selecionado no OneDrive for Business.

Janela de configurações de conexão com a URL para o arquivo selecionado hospedado no 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 OneDrive for Business usando um navegador. Clique com o botão direito do rato no ficheiro que pretende utilizar e selecione Abrir no Excel.

    Nota

    A interface do navegador pode não se parecer exatamente com a imagem a seguir. Há muitas maneiras de selecionar Abrir no Excel para arquivos na interface do navegador do OneDrive for Business. Você pode usar qualquer opção que permita abrir o arquivo no Excel.

    Captura de ecrã do OneDrive num browser, mostrando a seleção Abrir no Excel.

  2. No Excel, selecione Informações do Arquivo>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 utilizar a ligação que acabou de copiar no Power Query, siga os seguintes passos:

  1. Selecione Obter dados>da Web.

    Captura de ecrã do friso 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 no URL.

  3. Remova a cadeia de caracteres ?web=1 no final da ligação para que o Power Query possa navegar corretamente para o ficheiro 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 o Power Query solicitar credenciais, escolha Windows (para sites do SharePoint locais) ou Conta Organizacional (para sites do Microsoft 365 ou OneDrive for Business). Selecione Conectar.

    Captura de tela do prompt de credenciais do Power BI Desktop, enfatizando a seleção de conta do Windows ou Organizacional.

    Atenção

    Ao trabalhar com arquivos hospedados no OneDrive for Home, 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. A partir daí, você pode usar o arquivo do OneDrive for Business como 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.

Nota

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

Conector de pasta do SharePoint

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

Depois de estabelecer a conexão com êxito, você será solicitado com uma visualização de tabela que mostra os arquivos em seu site do SharePoint. Selecione o botão Transformar dados no canto inferior direito da janela.

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

Selecionar o botão Transformar dados levará você a uma exibição dos dados chamada visualização do sistema de arquivos. Cada uma das linhas nesta tabela representa um arquivo que foi encontrado em seu site do SharePoint.

Visualização de tabela dos arquivos no site do SharePoint depois de selecionar o botão Transformar dados.

A tabela tem uma coluna chamada Conteúdo que contém seu arquivo em um formato binário. Os valores na coluna Conteúdo têm uma cor diferente do resto 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, o Power Query adicionará automaticamente uma série de passos na sua consulta para navegar até ao ficheiro e interpretar o respetivo conteúdo sempre que possível.

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

Conteúdo de um ficheiro CSV com o nome 02-February.csv que foram interpretados automaticamente pelo Power Query, conforme apresentado na secção Passos aplicados.

Nota

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

Experiência do OneDrive for Business

O conector de pasta do SharePoint e sua experiência também funcionam para arquivos hospedados no OneDrive for Business. No entanto, a URL que você precisa usar é diferente daquela que você usaria para um site do SharePoint. Para localizar o URL exclusivo, aceda ao portal do OneDrive para Empresas e copie o URL do browser. Este 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 do URL completo, mas apenas das primeiras partes. O URL que precisa de utilizar no 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

Função SharePoint.Contents

Embora o conector de pasta do SharePoint ofereça uma experiência em que você pode ver todos os arquivos disponíveis em seu site do SharePoint ou do OneDrive for Business de uma só vez, você também pode optar por uma experiência diferente. Nessa experiência, você pode navegar pelas pastas do SharePoint ou do OneDrive for Business e chegar à pasta ou ao(s) arquivo(s) em que está interessado.

Esta experiência é proporcionada através da SharePoint.Contents função. Siga os seguintes passos para utilizar esta função:

  1. Crie uma consulta em branco.

  2. Altere o código na barra de fórmulas para ser SharePoint.Contents("url") onde url é o mesmo formato usado para o conector de pasta do SharePoint. Por exemplo:

    SharePoint.Contents("https://contoso.sharepoint.com/marketing/data")

    Nota

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

  3. O 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 do SharePoint.

  4. Navegue pelos diferentes documentos até à(s) pasta(s) ou ficheiro(s) específico(s) em que está interessado.

    Por exemplo, imagine um site do SharePoint com uma pasta Documentos Compartilhados . Você pode selecionar o valor Tabela na coluna Conteúdo dessa pasta e navegar diretamente para essa pasta.

    Pré-visualização da Tabela depois de ligar ao site do SharePoint com a função SharePoint.Contents onde existe uma pasta com o nome Documentos Partilhados.

    Dentro desta pasta de Documentos Partilhados existe uma pasta onde a empresa armazena todos os relatórios de vendas. Esta pasta é denominada Relatórios de vendas. Você pode selecionar o valor Tabela na coluna Conteúdo dessa linha.

    Pré-visualização da tabela depois de navegar para a pasta Documentos Partilhados.

    Com todos os arquivos dentro da pasta Relatórios de vendas , você pode selecionar o botão Combinar arquivos (consulte Visão geral de combinar arquivos) para combinar os dados de todos os arquivos nessa pasta em uma única tabela. Ou você pode navegar diretamente para um único arquivo de sua escolha selecionando o valor binário na coluna Conteúdo.

    Pré-visualização da tabela depois de navegar para a pasta Relatórios de vendas.

Nota

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