Compartilhar via


Importação de arquivos corporativos ou de estudante do SharePoint e do OneDrive

O Power Query oferece uma série de maneiras de obter acesso a arquivos hospedados no SharePoint ou no Microsoft OneDrive para trabalho ou escola.

Procurar arquivos

Observação

Atualmente, você só pode procurar arquivos do OneDrive de trabalho ou escola do usuário autenticado no Power Query Online para PowerApps.

Aviso

Esse recurso requer que seu navegador permita cookies de terceiros. Se o navegador bloquear cookies de terceiros, a caixa de diálogo Procurar será exibida, mas estará em branco sem nenhuma opção para fechar a caixa de diálogo.

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

Captura de tela do painel Conectar à fonte de dados do conector do Excel com o botão Procurar no OneDrive enfatizado.

Ao selecionar esse botão, você será solicitado a passar pelo processo de autenticação. Depois de concluir esse processo, uma nova janela será exibida com todos os arquivos de usuário autenticados dentro do OneDrive para trabalho ou escola.

Captura de tela da nova janela que você usa para procurar os arquivos de usuário autenticados no OneDrive para trabalho ou escola.

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 de configurações de conexão inicial em que a caixa de texto Caminho do arquivo ou URL agora contém a URL exata para o arquivo selecionado no OneDrive para trabalho ou escola.

Captura de tela da janela de configurações de conexão com a URL para o arquivo selecionado hospedado no OneDrive para trabalho ou escola.

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

A partir do conector Web usando uma URL de arquivo

  1. Navegue até seu OneDrive para localização corporativa ou de estudante usando um navegador. Clique com o botão direito do mouse no arquivo que você deseja usar e selecione Abrir no Excel.

    Observação

    A interface do navegador pode não se parecer exatamente com a imagem a seguir. Há várias maneiras de selecionar Abrir no Excel para arquivos em sua interface do navegador do OneDrive para trabalho ou escola. Você pode usar qualquer opção que permita abrir o arquivo no Excel.

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

  2. No Excel, selecioneInformaçõ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>da Web.

    Captura de tela da faixa de opções 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 o Power Query possa navegar corretamente até o arquivo e depois 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 o Windows (para sites locais do SharePoint) ou a Conta Organizacional (para o Microsoft 365 ou o OneDrive para sites corporativos ou de estudante). Selecione Conectar.

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

    Cuidado

    Quando você trabalha com arquivos hospedados no OneDrive para uso doméstico, 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 OneDrive para arquivo corporativo ou de estudante, assim 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.

Observação

Para usar um arquivo do OneDrive para trabalho ou escola 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 as configurações de atualização. Caso contrário, você poderá 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ê verá uma pré-visualização de tabela que exibe os arquivos em seu site SharePoint. Selecione o botão Transformar dados na parte inferior direita da janela.

Captura de tela da 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.

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

Captura de tela da visualização da tabela dos arquivos no site do SharePoint depois de selecionar o botão Transformar dados.

A tabela tem uma coluna chamada Content que contém seu arquivo em um formato binário. Os valores na coluna 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.

Quando você seleciona um valor Binário na coluna Conteúdo , o Power Query adiciona automaticamente uma série de etapas em sua consulta para navegar até o arquivo e interpreta 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. O Power Query cria automaticamente uma série de etapas para navegar e interpreta o conteúdo do arquivo como um arquivo CSV.

Captura de tela do conteúdo de um arquivo CSV com o nome 02-February.csv que foram interpretados automaticamente pelo Power Query 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 deseja exibir.

OneDrive para experiência corporativa ou de estudante

O conector de pasta do SharePoint e sua experiência também funcionam para arquivos hospedados no OneDrive para trabalho ou escola. No entanto, a URL que você precisa usar é diferente daquela que você usaria para um site do SharePoint. Para localizar sua URL exclusiva, acesse o portal do OneDrive para o trabalho ou escola e copie a URL do 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 das primeiras partes. A URL que você precisa usar no Power Query tem 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 pastas do SharePoint ofereça uma experiência em que você possa ver todos os arquivos disponíveis em seu site corporativo ou de estudante do SharePoint ou oneDrive de uma só vez, você também pode optar por uma experiência diferente. Nessa experiência, você pode navegar por suas pastas corporativas ou de estudante do SharePoint ou do OneDrive e acessar a pasta ou os arquivos nos quais você está interessado.

Essa experiência é fornecida por meio da SharePoint.Contents função. Para usar essa função, execute as seguintes etapas:

  1. Criar uma consulta em branco.

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

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

    Observação

    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, talvez queira tentar usar o seguinte código de exemplo: SharePoint.Contents("https://contoso.sharepoint.com/marketing/data", [ApiVersion="Auto"]).

  3. Power Query solicita que você adicione um método de autenticação à 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é a pasta ou arquivos específicos nos quais você 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.

    Captura de tela do modo de exibição da tabela depois de se conectar ao site do SharePoint com a função SharePoint.Contents, em que há uma pasta chamada Documentos Compartilhados.

    Dentro dessa pasta Documentos Compartilhados , há uma pasta em que a empresa armazena todos os relatórios de vendas. Essa pasta se chama Relatórios de Vendas. Você pode selecionar o valor tabela na coluna Conteúdo dessa linha.

    Captura de tela da visualização da tabela depois de navegar até a pasta Documentos Compartilhados.

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

    Captura de tela da visualização da tabela depois de navegar até a pasta Relatórios de Vendas.

Observação

A experiência fornecida pela função SharePoint.Contents é otimizada para o SharePoint e o OneDrive em ambientes de trabalho ou escola com um grande número de arquivos.