Partilhar via


Importação de ficheiros SharePoint e OneDrive para trabalho ou escola

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

Navegar por ficheiros

Observação

Atualmente, só pode procurar no OneDrive ficheiros escolares ou profissionais do utilizador autenticado dentro do Power Query Online para PowerApps.

Advertência

Esta funcionalidade requer que o seu navegador permita cookies de terceiros. Se o seu navegador bloquear cookies de terceiros, a caixa de diálogo Procurar será exibida, mas ficará 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:

Captura de ecrã do conector do Excel no painel Ligar à origem de dados, com o botão Procurar no OneDrive realçado.

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 ecrã da nova janela que utiliza para procurar os ficheiros de utilizador 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 para a página de configurações de conexão inicial, onde 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 ecrã da janela de definições de ligação com o url para o ficheiro selecionado alojado 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.

Do conector da Web usando uma URL de arquivo

  1. Navegue até o OneDrive para o local do trabalho ou da escola usando um navegador. Clique com o botão direito do rato no ficheiro que pretende utilizar e selecione Abrir no Excel.

    Observação

    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 para trabalho ou escola. 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, 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 utilizar a ligação que acabou de copiar no Power Query, siga os seguintes passos:

  1. Selecione Obter dados>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 locais do SharePoint) ou Conta Organizacional (para Microsoft 365 ou OneDrive para sites corporativos ou escolares). 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

    Quando trabalha com ficheiros alojados no OneDrive para casa, o ficheiro ao qual pretende ligar tem de 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í, pode utilizar o ficheiro do OneDrive para trabalho ou escola como qualquer outro ficheiro 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 do 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ê 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 sucesso, ser-lhe-á exibida uma pré-visualização de tabela que mostra os ficheiros no seu site do SharePoint. Selecione o botão Transformar dados no canto inferior direito 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.

Selecionar o botão Transformar dados leva 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.

Captura de ecrã da pré-visualização da tabela dos ficheiros 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.

Quando seleciona um valor binário na coluna Conteúdo , o Power Query adiciona 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 cria automaticamente uma série de passos para navegar e interpreta o conteúdo do ficheiro como um ficheiro CSV.

Captura de ecrã do conteúdo de um ficheiro CSV com o nome 02-February.csv que foram interpretados automaticamente pelo Power Query na secção Passos aplicados.

Observação

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 exibir.

OneDrive para experiência escolar ou profissional

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 o URL exclusivo, aceda ao portal do OneDrive para trabalho ou escola 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 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 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 para trabalho ou escola de uma só vez, você também pode optar por uma experiência diferente. Nesta experiência, pode navegar pelas pastas do SharePoint ou do OneDrive para trabalho ou escola e aceder à pasta ou aos ficheiros em que está interessado.

Esta experiência é proporcionada através da SharePoint.Contents função. Para usar essa função, execute as seguintes etapas:

  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")

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

  3. O Power Query solicita-lhe que adicione um método de autenticação para a sua ligaçã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 em que 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 ecrã da vista de tabela depois de ligar ao site do SharePoint com a função SharePoint.Contents, onde existe uma pasta denominada Documentos Partilhados.

    Dentro desta pasta Documentos Compartilhados , há 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.

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

    Captura de ecrã da pré-visualização da tabela depois de navegar para a pasta Relatórios de Vendas.

Observação

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