Lista SharePoint Online

Podsumowanie

Element opis
Stan wydania Ogólna dostępność
Produkty Excel
Power BI (modele semantyczne)
Power BI (przepływy danych)
Sieć szkieletowa (Dataflow Gen2)
Power Apps (przepływy danych)
Dynamics 365 Customer Insights
Obsługiwane typy uwierzytelniania Anonimowe
Windows
Microsoft Account
Jednostka usługi
Dokumentacja referencyjna funkcji SharePoint.Contents
SharePoint.Files
SharePoint.Tables

Uwaga

Typ uwierzytelniania jednostki usługi nie jest obsługiwany w przypadku korzystania z lokalnej bramy danych ani bramy danych sieci wirtualnej.

Uwaga

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Obsługiwane funkcje

  • Adres URL witryny

Określanie adresu URL witryny

Podczas nawiązywania połączenia z witryną programu SharePoint zostanie wyświetlony monit o wprowadzenie adresu URL witryny. Aby znaleźć adres URL witryny zawierający listę usługi SharePoint Online, najpierw otwórz stronę w programie SharePoint. Na stronie w programie SharePoint zazwyczaj można uzyskać adres witryny, wybierając pozycję Strona główna w okienku nawigacji lub ikonę witryny u góry. Skopiuj adres z paska adresu przeglądarki internetowej i zapisz go później.

Obraz z lokalizacjami strony głównej w okienku nawigacji, ikoną w górnej części witryny i wynikowym adresem URL.

Połączenie do listy usługi SharePoint Online z programu Power Query Desktop

Aby nawiązać połączenie z listą usługi SharePoint Online:

  1. Wybierz pozycję Lista usługi SharePoint Online w środowisku pobierania danych. Środowisko pobierania danych w programie Power Query Desktop różni się między aplikacjami. Aby uzyskać więcej informacji na temat środowiska pobierania danych dla aplikacji w programie Power Query Desktop, zobacz Gdzie uzyskać dane.

  2. Wklej skopiowany adres URL witryny programu SharePoint w polu Określanie adresu URL witryny do pola Adres URL witryny w otwartym oknie dialogowym.

    Wybór folderu.

    Jeśli wprowadzony adres URL jest nieprawidłowy, Ikona ostrzeżenia.obok pola tekstowego Adres URL witryny zostanie wyświetlona ikona ostrzeżenia.

    Możesz również wybrać implementację tego łącznika w wersji 1.0 lub implementację 2.0. Więcej informacji: Połączenie do listy usługi SharePoint Online w wersji 2.0

    Naciśnij OK, aby kontynuować.

  3. Jeśli po raz pierwszy odwiedzisz ten adres witryny, wybierz odpowiednią metodę uwierzytelniania. Wprowadź poświadczenia i wybierz poziom, do którego mają być stosowane te ustawienia. Następnie wybierz pozycję Połączenie.

    Wybierz pozycję Konto Microsoft.

    Aby uzyskać więcej informacji na temat metod uwierzytelniania i ustawień na poziomie, zobacz Uwierzytelnianie za pomocą źródła danych.

  4. W nawigatorze możesz wybrać lokalizację, a następnie przekształcić dane w edytorze Power Query, wybierając pozycję Przekształć dane lub załadować dane, wybierając pozycję Załaduj.

    Zaznacz pole wyboru listy.

Połączenie do listy usługi SharePoint Online z usługi Power Query Online

Aby nawiązać połączenie z listą usługi SharePoint Online:

  1. Wybierz opcję Listy usługi SharePoint Online w środowisku pobierania danych. Różne aplikacje mają różne sposoby uzyskiwania danych w usłudze Power Query Online. Aby uzyskać więcej informacji na temat sposobu uzyskiwania danych z aplikacji w usłudze Power Query Online, przejdź do obszaru Gdzie uzyskać dane.

    Zrzut ekranu przedstawiający okno pobierania danych z podkreśloną listą usługi SharePoint Online.

  2. Wklej skopiowany adres URL witryny programu SharePoint w polu Określanie adresu URL witryny do pola Adres URL witryny w otwartym oknie dialogowym.

    Wybór listy online.

  3. W razie potrzeby wprowadź nazwę lokalnej bramy danych.

  4. Wybierz rodzaj uwierzytelniania i wprowadź wymagane poświadczenia.

  5. Wybierz Dalej.

  6. W nawigatorze możesz wybrać lokalizację, a następnie przekształcić dane w edytorze Power Query, wybierając pozycję Przekształć dane.

    Nawigator z danymi.

Połączenie do listy usługi SharePoint Online w wersji 2.0

W wersji programu Power BI Desktop z października 2020 r. wprowadziliśmy zaktualizowaną wersję łącznika listy usługi SharePoint Online. Ten łącznik ma ulepszone interfejsy API i większą użyteczność, ale nie jest do tyłu zgodny z użyciem wersji łącznika 1.0. Wersja łącznika 2.0 jest ogólnie dostępna od września 2022 r.

Aby uzyskać do niego dostęp, należy wprowadzić ten sam ekran łącznika w kroku 2 w Połączenie do listy usługi SharePoint Online z poziomu programu Power Query Desktop. Upewnij się jednak, że wybrano pozycję 2.0 w obszarze Implementacja , jeśli nie została jeszcze wybrana.

Ekran przedstawiający przykład ustawień listy usługi SharePoint Online.

Dzięki tej aktualizacji łącznikowi udostępniamy dwa różne widoki dla tych samych danych:

  • Wszystkich
  • Wartość domyślna

Widok Wszystkie zawiera wszystkie kolumny utworzone przez użytkownika i zdefiniowane przez system. Możesz zobaczyć, jakie kolumny znajdują się na poniższym ekranie.

Ekran przedstawiający przykładowe ustawienia widoku dla określonego widoku na liście usługi SharePoint Online.

Widok domyślny jest wyświetlany podczas przeglądania listy w trybie online w dowolnym widoku ustawionym jako Domyślny w ustawieniach. W przypadku edytowania tego widoku w celu dodania lub usunięcia kolumn utworzonych przez użytkownika lub zdefiniowanych przez system albo utworzenia nowego widoku i ustawienia go jako domyślnego te zmiany będą propagowane za pośrednictwem łącznika.

Ekran przedstawiający przykład widoku domyślnego listy usługi SharePoint Online.

Uwaga

Jeśli ustawisz widok domyślny w witrynie programu SharePoint na Widok kalendarza lub Widok tablicy , program SharePoint zwróci tylko kolumny wyświetlane w wybranym widoku. W tym scenariuszu usługa Power BI nie pobierze wszystkich kolumn na liście, mimo że wybierzesz opcję Wszystkie . Jest to celowe.

Rozwiązywanie problemów

Użyj głównego adresu programu SharePoint

Należy się upewnić, że podajesz adres główny witryny SharePoint, bez żadnych podfolderów i dokumentów. Można na przykład użyć łącza podobnego do https://contoso.sharepoint.com/teams/ObjectModel/.

Problemy ze strefą czasową

W przypadku korzystania z łącznika listy usługi SharePoint Online (wersja 1.0) możesz zauważyć, że dane strefy czasowej nie są zgodne z oczekiwaniami w przeglądarce. Klient internetowy programu SharePoint wykonuje lokalną konwersję strefy czasowej na podstawie wiedzy przeglądarki o strefie czasowej użytkownika.

Interfejs API zaplecza dla programu SharePoint używa czasu UTC i wysyła ten czas UTC bezpośrednio do usługi Power BI. Usługa Power BI nie konwertuje tej godziny UTC, ale raportuje ją do użytkownika.

Aby uzyskać czas lokalny, użytkownik musi wykonać taką samą konwersję, jak robi to klient programu SharePoint. Przykładowe operacje kolumn, które mogłyby to zrobić, to:

#"Changed Type" = Table.TransformColumnTypes(#"Renamed Columns",{{"Datewithtime", type datetimezone}}),
#"Timezone Shifted" = Table.TransformColumns(#"Changed Type", {"Datewithtime", DateTimeZone.ToLocal})

Pierwsza operacja zmienia typ na datetimezone, a druga operacja konwertuje go na czas lokalny komputera.

Limit sprzężenia programu SharePoint

Uwaga

Ten problem jest ograniczony do łącznika listy usługi SharePoint Online w wersji 2.0.

Łącznik listy usługi SharePoint Online w wersji 2.0 używa innego interfejsu API niż łącznik w wersji 1.0, a w związku z tym podlega maksymalnie 12 operacjom sprzężenia na zapytanie, jak opisano w dokumentacji usługi SharePoint Online w obszarze Próg wyszukiwania widoku listy. Ten problem będzie manifestem, ponieważ zapytania programu SharePoint kończą się niepowodzeniem, gdy dostęp do ponad 12 kolumn jest uzyskiwany jednocześnie z listy programu SharePoint. Można jednak obejść tę sytuację, tworząc widok domyślny z mniej niż 12 kolumnami odnośników.

Uzyskiwanie dostępu do listy usługi SharePoint Online przy użyciu usługi OData

Jeśli używasz źródła danych OData do uzyskiwania dostępu do listy usługi SharePoint Online, istnieje ograniczenie około 2100 znaków do adresu URL używanego do nawiązania połączenia. Więcej informacji: Maksymalna długość adresu URL