Lista do SharePoint Online

Resumo

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.

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.

   

   Se o endereço do 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-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.

   

   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.

   

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.

   

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.

   

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.

   

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.

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.

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.

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

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