Partilhar via

Lista do SharePoint Online

  • Artigo

Resumo

Item Description
Estado de Lançamento Disponibilidade Geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Malha (Dataflow Gen2)
Power Apps (Fluxos de Dados)
Dynamics 365 Customer Insights
Tipos de autenticação suportados Anónimo
Windows
Conta Microsoft
Principal de Serviço
Documentação de referência da função SharePoint.Conteúdos
SharePoint.Arquivos
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.

Capacidades suportadas

  • URL do site

Determinar o URL do site

Quando estiver a ligar a um site do SharePoint, ser-lhe-á pedido que introduza o 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 no 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ço do seu navegador da Web e salve para mais tarde.

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

Ligar a uma lista do SharePoint Online a partir do Power Query Desktop

Para se conectar a uma lista do SharePoint Online:

  1. Selecione a lista do SharePoint Online na lista Obter experiência de dados. A experiência de obtenção de dados no Power Query Desktop varia entre aplicações. Para obter mais informações sobre a experiência de obter dados do Power Query Desktop para a sua aplicação, aceda a Onde obter dados.

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

    Seleção de pastas.

    Se o endereço URL introduzido for inválido, será apresentado um Ícone de aviso.ícone de aviso junto à caixa de texto URL do Site.

    Você também pode selecionar a implementação 1.0 desse conector ou a implementação 2.0. Para obter 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 este 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 Conta Microsoft.

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

  4. A partir do Navegador, pode selecionar uma localização e, em seguida, transformar os dados no editor do Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

    Marque a caixa de seleção da lista.

Ligar a uma lista do SharePoint Online a partir do Power Query Online

Para se conectar a uma lista do SharePoint Online:

  1. Selecione a opção de lista do SharePoint Online na experiência obter dados. Diferentes aplicações têm formas diferentes de aceder à experiência de obtenção de dados do Power Query Online. Para obter mais informações sobre como aceder à experiência de obter dados do Power Query Online a partir da sua aplicação, aceda a Onde obter dados.

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

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

    Seleção de listas 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 Seguinte.

  6. A partir do Navegador, pode selecionar uma localização e, em seguida, transformar os dados no editor do Power Query selecionando 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. Este conector tem APIs melhoradas e maior usabilidade, mas não é compatível com o uso da versão do conector 1.0. A versão do conector 2.0 está disponível em setembro de 2022.

Para aceder ao mesmo, introduza o mesmo ecrã de conector através do passo 2 em Ligar a uma lista do SharePoint Online a partir do Power Query Desktop. No entanto, certifique-se de selecionar 2.0 em Implementação se ainda não estiver selecionado.

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

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

  • Tudo
  • Predefinição

O modo de 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 modo de exibição para um modo de exibição específico na lista do SharePoint Online.

A vista predefinida é o que verá quando olhar para a lista online em qualquer vista que tenha definido como Predefinida nas suas definições. Se você editar esse modo de exibição para adicionar ou remover colunas criadas pelo usuário ou definidas pelo sistema, ou criando um novo modo de exibição e definindo-o como padrão, essas alterações serão propagadas pelo conector.

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

Nota

Se você definir o modo de exibição padrão em seu site do SharePoint como modo de exibição de calendário ou modo de exibição de painel , 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 Todos . Esta ação é propositada.

Resolução de Problemas

Usar endereço raiz do SharePoint

Certifique-se de que fornece o endereço de raiz do site do SharePoint, sem quaisquer subpastas ou documentos. Por exemplo, utilize uma ligação semelhante a https://contoso.sharepoint.com/teams/ObjectModel/.

Problemas de fuso horário

Ao usar o conector de lista do SharePoint Online (v1.0), você pode notar que os dados de fuso horário não correspondem ao que você esperaria do seu 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 para SharePoint usa a hora UTC e envia essa hora UTC diretamente para o Power BI. O Power BI não converte esta hora UTC, mas reporta-a ao utilizador.

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

#"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 converte-o para a hora local do computador.

Limite de associação do SharePoint

Nota

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

O conector de lista v2.0 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 associação por consulta, conforme documentado na documentação do SharePoint Online em Limite de pesquisa de modo de exibição de lista. Esse problema se manifestará quando 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 um modo de exibição padrão com menos de 12 colunas de pesquisa.

Usando OData para acessar uma lista do SharePoint Online

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