Compartilhar via

Lista do SharePoint Online

  • Artigo

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Excel
Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Power Apps (Fluxos de dados)
Dynamics 365 Customer Insights
Tipos de autenticação compatíveis Anônimo
Windows
Conta Microsoft
Entidade de Serviço
Documentação de referência da função SharePoint.Contents
SharePoint.Files
SharePoint.Tables

Observação

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

Funcionalidades com suporte

  • URL do site

Determinar a URL do site

Quando você estiver se conectando a um site do SharePoint, será solicitado a inserir a URL do site. Para localizar a URL do site que contém sua lista do SharePoint, primeiro abra uma página no SharePoint. Em uma página do SharePoint, é possível obter o endereço do site ao selecionar a Página Inicial no painel de navegação ou o ícone do site na parte superior. Copie o endereço da barra de endereços do navegador da Web e salve para usar mais tarde.

Imagem com a localização da Página Inicial no painel de navegação, o ícone na parte superior do site e o endereço da URL resultante.

Conectar-se à lista do SharePoint Online no Power Query Desktop

Para se conectar a uma lista do SharePoint Online:

  1. Selecione a lista do SharePoint Online na experiência para obter dados. A experiência para obter dados no Power Query Desktop varia entre aplicativos. Para saber mais informações sobre a experiência para obter dados no Power Query Desktop para seu aplicativo, acesse Onde obter dados.

  2. Cole a URL do site do SharePoint copiada em Determinar URL do site no campo URL do Site, na caixa de diálogo aberta.

    Seleção de pasta.

    Se o endereço do URL inserido for inválido, um ícone de aviso Ícone de Aviso. aparecerá ao lado da caixa de texto URL do site.

    Você também pode selecionar a implementação 1.0 desse conector ou a implementação 2.0. Mais informações: Conectar-se à lista do SharePoint Online v2.0

    Selecione OK para continuar.

  3. Se esta for a primeira vez que você visita esse endereço de site, selecione o método de autenticação apropriado. Insira suas credenciais e escolha o nível no qual você deseja aplicar essas configurações. Depois, selecione Conectar.

    Escolha a conta Microsoft.

    Para obter mais informações sobre métodos de autenticação e as configurações de nível, acesse Autenticação com uma fonte de dados.

  4. No Navegador, é possível selecionar um local e transformar os dados no editor do Power Query ao selecionar Transformar Dados ou carregar os dados ao selecionar Carregar.

    Selecionar caixa de seleção da lista.

Conectar-se à lista do SharePoint Online no Power Query Online

Para se conectar a uma lista do SharePoint Online:

  1. Selecione a opção lista do SharePoint Online na experiência para obter dados. Cada aplicativo acessa de uma forma diferente a experiência para obter dados do Power Query Online. Para saber mais informações sobre como acessar a experiência para obter dados do Power Query Online pelo seu aplicativo, acesse Onde obter dados.

    Captura de tela da janela obter dados com a lista do SharePoint Online enfatizada.

  2. Cole a URL do site do SharePoint copiada em Determinar URL do site no campo URL do Site, na caixa de diálogo aberta.

    Seleção da lista online.

  3. Insira o nome de um gateway de dados local, se necessário.

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

  5. Selecione Avançar.

  6. No Navegador, é possível selecionar um local e transformar os dados no editor do Power Query ao selecionar Transformar dados.

    Navegador com dados.

Conectar à lista do SharePoint Online v2.0

Na versão de outubro de 2020 do Power BI Desktop, apresentamos uma versão atualizada do conector de lista do SharePoint Online. Esse conector melhorou as APIs e a usabilidade, mas não é compatível com versões anteriores, como a versão do conector 1.0. A versão do conector 2.0 está disponível para o público em geral a partir de setembro de 2022.

Para acessá-lo, você inserirá a mesma tela do conector por meio da etapa 2 em Conectar-se a uma lista do SharePoint Online no Power Query Desktop. No entanto, selecione 2.0 em Implementação se ainda não estiver selecionado.

Uma tela mostrando um exemplo das configurações da Lista do SharePoint Online.

Com essa atualização do conector, estamos disponibilizando duas exibições diferentes para os mesmos dados:

  • Todos
  • Default

A exibição Todos inclui todas as colunas criadas pelo usuário e definidas pelo sistema. É possível ver quais colunas estão incluídas na tela a seguir.

Uma tela mostrando um exemplo das configurações de uma exibição específica na lista do SharePoint Online.

A exibição padrão é o que você verá ao examinar a lista online em qualquer exibição definida como Padrão nas configurações. Se você editar essa exibição para adicionar ou remover colunas criadas pelo usuário ou definidas pelo sistema, ou ao criar uma nova exibição e definindo-o como padrão, essas alterações serão propagadas por meio do conector.

Uma tela mostrando um exemplo da exibição padrão da lista do SharePoint Online.

Observação

Se você definir o modo de exibição padrão em seu site do SharePoint como o modo de exibição Calendário ou Quadro, o SharePoint retornará apenas as colunas mostradas no modo de exibição selecionado. Nesse cenário, o Power BI não recuperará todas as colunas na lista, mesmo que você escolha a opção Tudo. Isso ocorre por design.

Solução de problemas

Usar o endereço raiz do SharePoint

Certifique-se de fornecer o endereço raiz do site do SharePoint, sem subpastas ou documentos. Por exemplo, use um link semelhante a https://contoso.sharepoint.com/teams/ObjectModel/.

Problemas de fuso horário

Ao usar o conector da lista do SharePoint Online (v1.0), você pode observar que os dados de fuso horário não correspondem ao esperado no navegador. O cliente baseado na Web do SharePoint faz uma conversão de fuso horário local conforme o conhecimento do navegador sobre o fuso horário do usuário.

A API de back-end do SharePoint usa a hora UTC e envia esse horário UTC diretamente para o Power BI. O Power BI não converte esse horário UTC, mas o relata ao usuário.

Para obter a hora local, o usuário deve fazer a mesma conversão que o cliente do SharePoint faz. A seguir, há um exemplo das operações de coluna que fariam isso:

#"Changed Type" = Table.TransformColumnTypes(#"Renamed Columns",{{"Datewithtime", type datetimezone}}),
#"Timezone Shifted" = Table.TransformColumns(#"Changed Type", {"Datewithtime", DateTimeZone.ToLocal})

A primeira operação altera o tipo para datetimezone. Já a segunda operação converte-o na hora local do computador.

Limite de junção do SharePoint

Observação

Esse problema é limitado ao conector de lista do SharePoint Online v2.0.

O conector da lista do SharePoint Online v2.0 usa uma API diferente do conector v1.0 e está sujeito a um máximo de 12 operações de junção por consulta, conforme a Documentação do SharePoint Online em Limite de pesquisa de exibição da lista. Esse problema se manifestará nos erros das consultas do SharePoint quando mais de 12 colunas forem acessadas simultaneamente em uma lista do SharePoint. No entanto, você pode contornar essa situação criando uma exibição padrão com menos de 12 colunas de pesquisa.

Usar o OData para acessar uma lista do SharePoint Online

Se você usar um feed do OData para acessar uma lista do SharePoint Online, haverá uma limitação de aproximadamente 2100 caracteres para a URL que você usa para se conectar. Mais informações: Comprimento máximo da URL