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.
Conectar-se a uma lista do SharePoint Online do Power Query Desktop
Para se conectar a uma lista do SharePoint Online:
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.
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 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.
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.
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.
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 a uma lista do SharePoint Online do Power Query Online
Para se conectar a uma lista do SharePoint Online:
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.
Cole a URL do site do SharePoint copiada em Determinar URL do site no campo URL do Site, na caixa de diálogo aberta.
Insira o nome de um gateway de dados local, se necessário.
Selecione o tipo de autenticação e insira as credenciais necessárias.
Selecione Avançar.
No Navegador, é possível selecionar um local e transformar os dados no editor do Power Query ao selecionar Transformar 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.
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.
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.
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 datetimezone
e 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