Lista do SharePoint Online

Resumo

Item Descrição
Estado da versão Disponibilidade geral
Produtos Power BI (Conjuntos de dados)
Power BI (Fluxos de dados)
Power Apps (Fluxos de dados)
Excel
Customer Insights do Dynamics 365
Tipos de autenticação com suporte Anônima
Windows
Conta da Microsoft
Documentação de referência de 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 agendas de implantação e recursos específicos do host.

Funcionalidades com suporte

  • URL do site

Determinar a URL do site

Ao se conectar a um site SharePoint, você será solicitado a inserir a URL do site. Para encontrar a URL do site que contém sua SharePoint Online, primeiro abra uma página SharePoint. Em uma página no SharePoint, geralmente você pode obter o endereço do site selecionando 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 uso posterior.

Imagem com os locais de Início no painel de navegação, o ícone na parte superior do site e o endereço da URL resultante.

Conexão uma lista SharePoint Online do Power Query Desktop

Para se conectar a uma SharePoint Online:

  1. Em Obter Dados, selecione SharePoint Online.

  2. Colar a URL SharePoint site que você copiou em Determinar a URL do site para o campo URL do Site na caixa de diálogo aberta.

    Seleção de pasta.

    Se o endereço de URL inserido for inválido, um ícone  de Aviso. O ícone de aviso será exibido 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 beta 2.0. Mais informações: Conexão para SharePoint Online v2.0 (Beta)

    Selecione OK para continuar.

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

    Escolha conta Microsoft.

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

  4. No Navegador, você pode selecionar um local e, em seguida, transformar os dados no editor Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

    Marque a caixa de seleção lista.

Conexão uma lista SharePoint Online do Power Query Online

Para se conectar a uma SharePoint Online:

  1. Na página Fontes de dados, selecione SharePoint Online.

  2. Colar a URL SharePoint site que você copiou em Determinar a URL do site para o campo URL do Site na caixa de diálogo aberta.

    Seleção de lista online.

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

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

  5. Selecione Avançar.

  6. No Navegador, você pode selecionar um local e transformar os dados no editor Power Query, selecionando Transformar dados.

    Navegador com dados.

Conexão lista SharePoint Online v2.0 (Beta)

Na versão de outubro de 2020 do Power BI Desktop, introduzimos uma versão atualizada do conector de lista SharePoint Online. Esse conector tem APIs aprimoradas e maior usabilidade, mas não é compatível com versões anteriores com o uso da versão do conector 1.0.

Para acessá-lo, você inserirá a mesma tela do conector por meio da etapa 2 Conexão uma lista SharePoint Online do Power Query Desktop. No entanto, certifique-se de selecionar 2.0 (Beta) em Implementação se ele ainda não estiver selecionado.

Uma tela mostrando um exemplo de SharePoint Online List.

Com essa atualização para o 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. Você pode ver quais colunas estão incluídas na tela a seguir.

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

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

Uma tela mostrando um exemplo de SharePoint exibição padrão de lista online.

Solução de problemas

Usar o endereço SharePoint raiz

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

Problemas de timezone

Ao usar o conector SharePoint online (v1.0), você pode observar que os dados de timezone não são compatíveis com o que você esperaria do navegador. O SharePoint cliente baseado na Web faz uma conversão de timezone local com base no conhecimento do navegador sobre o timezone do usuário.

A API de back-SharePoint usa a hora UTC e envia essa hora UTC diretamente para Power BI. Power BI não converte essa hora UTC, mas a relata para o usuário.

Para obter tempo no horário local, o usuário deve fazer a mesma conversão que o SharePoint cliente faz. Um exemplo das operações de coluna que faria 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 e a segunda operação o converte na hora local do computador.

SharePoint de junção

Esse problema é limitado ao conector SharePoint Online v2.0

O conector v2.0 da lista do SharePoint Online usa uma API diferente do conector v1.0 e, como tal, está sujeito a um máximo de 12 operações de junção por consulta, conforme documentado na documentação do SharePoint Online em Limite de pesquisa de exibição de lista . Esse problema se manifesta como SharePoint que falham quando mais de 12 colunas são acessadas simultaneamente de uma lista SharePoint dados.

Usando o OData para acessar uma lista SharePoint Online

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