Compartilhar via


Lista do SharePoint Online

Resumo

Item Descrição
Estado de lançamento Disponibilidade geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Fabric (Dataflow Gen2)
Power Apps (fluxos de dados)
Customer Insights do Dynamics 365
Tipos de autenticação com suporte Anônimo
Windows
Conta da Microsoft
Principal de Serviço
Documentação de referência de função SharePoint.Contents
SharePoint.Files
SharePoint.Tables

Nota

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.

Nota

Se você selecionar Principal de Serviço como o tipo de autenticação no serviço do Power BI, será necessário conceder a ela permissões exclusivas para aplicativos por meio dos Serviços de Controle de Acesso do Azure (ACS). Para obter mais informações, acesse Concedendo acesso somente com o aplicativo do SharePoint.

Capacidades suportadas

  • URL do site

Determinar a URL do site

Ao se conectar a um site do SharePoint, você será solicitado a inserir a URL do site. Para localizar a URL do site que contém sua lista do SharePoint Online, primeiro abra uma página no SharePoint. Em uma página do SharePoint, você geralmente 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 mais tarde.

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

Conectar-se a uma lista do SharePoint Online do Power Query Desktop

Para se conectar a uma lista do SharePoint Online:

  1. Selecione lista do SharePoint Online na opção de obter dados. A experiência de obtenção de dados no Power Query Desktop varia entre aplicativos. Para obter mais informações sobre a experiência de obter dados do 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 de URL inserido for inválido, um í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 à lista do SharePoint Online v2.0

    Selecione OK para continuar.

  3. Se esta for a primeira vez que você visitar 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. Em seguida, selecione Conectar.

    Escolha a conta da 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, é 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.

    Marque a caixa de seleção da lista.

Conectar-se a uma lista do SharePoint Online do Power Query Online

Para se conectar a uma lista do SharePoint Online:

  1. Selecione a opção lista do SharePoint Online na experiência de obtenção de dados. Aplicativos diferentes têm diferentes maneiras de acessar a experiência de obtenção de dados do Power Query Online. Para obter mais informações sobre como acessar a experiência de obtenção de dados do Power Query Online por meio do seu aplicativo, acesse Onde obter dados.

    Captura de tela da janela de obtenção de 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 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, é possível selecionar um local e transformar os dados no editor do Power Query ao selecionar Transformar dados.

    Navegador com dados.

Conectar-se à lista do SharePoint Online v2.0

Na versão de outubro de 2020 do Power BI Desktop, introduzimos 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 geralmente está disponível 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 caso ainda não esteja selecionado.

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

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

  • Todos
  • Padrão

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 lista do SharePoint Online.

O modo de exibição padrão é o que você verá ao examinar a lista online em qualquer modo de exibição definido 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 da exibição padrão da lista do SharePoint Online.

Nota

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

Resolução de problemas

Usar o endereço raiz do SharePoint

Forneça 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 notar que os dados de fuso horário não correspondem ao que você esperaria do navegador. O cliente baseado na Web do SharePoint faz uma conversão de fuso horário local com base no conhecimento do navegador sobre o fuso horário do usuário.

A API de back-end do SharePoint usa o tempo 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 para o usuário.

Para obter tempo no horário local, o usuário deve fazer a mesma conversão que o cliente do SharePoint faz. Confira o seguinte exemplo com as 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 datetimezonee a segunda a converte na hora local do computador.

Limite de junção do SharePoint

Nota

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

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á à medida que as consultas do SharePoint falharem quando mais de 12 colunas forem acessadas simultaneamente de 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.

Usando o OData para acessar uma lista do SharePoint Online

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