Obiekty Salesforce

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 Analysis Services
Obsługiwane typy uwierzytelniania	Konto usługi Salesforce

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.

Ostrzeżenie

Domyślnie usługa Salesforce nie obsługuje programu Internet Explorer 11, który jest używany jako część środowiska uwierzytelniania do Usługi online w programie Power Query Desktop. W celu uzyskania rozszerzonej pomocy technicznej dotyczącej uzyskiwania dostępu do środowiska lightning przy użyciu programu Microsoft Internet Explorer 11. Możesz również przejrzeć dokumentację usługi Salesforce dotyczącą konfigurowania programu Internet Explorer. W tej chwili użytkownicy będą osłabieni w zakresie uwierzytelniania, ale przechowywane poświadczenia powinny nadal działać do momentu wygaśnięcia istniejących tokenów uwierzytelniania. Aby rozwiązać ten problem, przejdź do artykułu Włączanie przeglądarki Microsoft Edge (Chromium) na potrzeby uwierzytelniania OAuth w programie Power BI Desktop.

Wymagania wstępne

Aby korzystać z łącznika Salesforce Objects, musisz mieć nazwę użytkownika i hasło konta usługi Salesforce.

Ponadto należy włączyć dostęp do interfejsu API usługi Salesforce. Aby zweryfikować ustawienia dostępu, przejdź do osobistej strony usługi Salesforce, otwórz ustawienia profilu i wyszukaj i upewnij się, że zaznaczono pole wyboru Włączone interfejs API. Pamiętaj, że konta wersji próbnej usługi Salesforce nie mają dostępu do interfejsu API.

Obsługiwane możliwości

• Produkcyjne
• Niestandardowe
  • Niestandardowe domeny
  • Przekierowania rekordów CNAME
  • Kolumny relacji

Połączenie do obiektów usługi Salesforce z programu Power Query Desktop

Aby nawiązać połączenie z danymi obiektów usługi Salesforce:

1. Wybierz pozycję Obiekty usługi Salesforce z listy łączników danych specyficznych dla produktu, a następnie wybierz pozycję Połączenie.

2. W obszarze Obiekty usługi Salesforce wybierz adres URL produkcji , jeśli do logowania użyjesz adresu URL produkcyjnego usługi Salesforce (https://www.salesforce.com).

   

   Możesz również wybrać pozycję Niestandardowy i wprowadzić niestandardowy adres URL, aby się zalogować. Ten niestandardowy adres URL może być domeną niestandardową utworzoną w usłudze Salesforce, taką jak https://contoso.salesforce.com. Możesz również użyć niestandardowego wyboru adresu URL, jeśli używasz własnego rekordu CNAME, który przekierowuje do usługi Salesforce. Pamiętaj, że adresy URL pioruna nie są obsługiwane.

   Ponadto możesz wybrać pozycję Uwzględnij kolumny relacji. To zaznaczenie zmienia zapytanie, dołączając kolumny, które mogą mieć relacje klucza obcego z innymi tabelami. Jeśli to pole jest niezaznaczone, te kolumny nie będą widoczne.

   Po wybraniu adresu URL wybierz przycisk OK , aby kontynuować.

3. Wybierz pozycję Zaloguj się , aby zalogować się do konta usługi Salesforce.

   

   Po pomyślnym zalogowaniu wybierz pozycję Połączenie.

4. Jeśli po raz pierwszy zalogowano się przy użyciu określonej aplikacji, zostanie wyświetlony monit o zweryfikowanie autentyczności przez wprowadzenie kodu wysłanego na adres e-mail. Następnie zostanie wyświetlony monit o to, czy aplikacja, której używasz do uzyskiwania dostępu do danych. Na przykład zostanie wyświetlony monit o zezwolenie programowi Power BI Desktop na dostęp do danych usługi Salesforce. Zaznacz Zezwól.

5. W oknie dialogowym Nawigator wybierz obiekty usługi Salesforce, które chcesz załadować. Następnie możesz wybrać pozycję Załaduj , aby załadować dane, lub wybrać pozycję Przekształć dane , aby przekształcić dane.

Połączenie do obiektów usługi Salesforce z usługi Power Query Online

Aby nawiązać połączenie z danymi obiektów usługi Salesforce:

1. Wybierz pozycję Obiekty usługi Salesforce z listy łączników danych specyficznych dla produktu, a następnie wybierz pozycję Połączenie.

2. W obszarze Obiekty usługi Salesforce wybierz adres URL, którego chcesz użyć do nawiązania połączenia. Wybierz adres URL produkcji, jeśli do logowania użyjesz adresu URL produkcyjnego usługi Salesforce (https://www.salesforce.com).

   

   Uwaga

   Obecnie może być konieczne wybranie niestandardowego adresu URL, wprowadzenie https://www.salesforce.com w polu tekstowym, a następnie wybranie pozycji Produkcja w celu nawiązania połączenia z danymi.

   Możesz również wybrać pozycję Niestandardowy i wprowadzić niestandardowy adres URL, aby się zalogować. Ten niestandardowy adres URL może być domeną niestandardową utworzoną w usłudze Salesforce, taką jak https://contoso.salesforce.com. Możesz również użyć niestandardowego wyboru adresu URL, jeśli używasz własnego rekordu CNAME, który przekierowuje do usługi Salesforce.

   Ponadto możesz wybrać pozycję Uwzględnij kolumny relacji. To zaznaczenie zmienia zapytanie, dołączając kolumny, które mogą mieć relacje klucza obcego z innymi tabelami. Jeśli to pole jest niezaznaczone, te kolumny nie będą widoczne.

3. Jeśli po raz pierwszy nawiązano to połączenie, w razie potrzeby wybierz lokalną bramę danych.

4. Wybierz pozycję Zaloguj się , aby zalogować się do konta usługi Salesforce. Po pomyślnym zalogowaniu wybierz pozycję Dalej.

5. W oknie dialogowym Nawigator wybierz obiekty usługi Salesforce, które chcesz załadować. Następnie wybierz pozycję Przekształć dane , aby przekształcić dane.

Określanie wersji interfejsu API usługi Salesforce

Wymagamy określenia obsługiwanej wersji interfejsu API usługi Salesforce do korzystania z łącznika usługi Salesforce. Możesz to zrobić, modyfikując zapytanie przy użyciu zaawansowanego edytora Power Query. Na przykład Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48]).

Jeśli określisz wersję, która nie jest obsługiwana przez usługę Salesforce, zostanie wyświetlony komunikat o błędzie wskazujący, że określono nieobsługiwaną wersję ApiVersion.

Aby uzyskać więcej informacji na temat wersji i obsługi interfejsu API usługi Salesforce, odwiedź witrynę internetową usługi Salesforce.

Znane problemy i ograniczenia

• Jeśli w wynikach łącznika Salesforce Objects brakuje tabel, jedną z przyczyn może być to, że parametr ApiVersion musi zostać określony lub zaktualizowany do wersji obsługiwanej przez usługę Salesforce. Aby określić lub zaktualizować parametr ApiVersion, użyj Edytor zaawansowany i jawnie dodaj ApiVersion parametr . Na przykład:

  Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

  Interfejsy APIVersion są okresowo przestarzałe przez usługę Salesforce, dlatego upewnij się, że określasz obsługiwaną usługę ApiVersion usługi Salesforce.

• Istnieje limit liczby pól, które może zawierać zapytanie do usługi Salesforce. Limit różni się w zależności od typu kolumn, liczby obliczonych kolumn itd. Gdy wystąpi Query is either selecting too many fields or the filter conditions are too complicated błąd, oznacza to, że zapytanie przekracza limit. Aby uniknąć tego błędu, użyj opcji Zaawansowane wybieranie zapytania i określ pola, których naprawdę potrzebujesz.

• Ustawienia sesji usługi Salesforce mogą blokować tę integrację. Upewnij się, że ustawienie Zablokuj sesje na adres IP, z którego pochodzą , jest wyłączone.

• Należy włączyć dostęp do interfejsu API usługi Salesforce. Aby zweryfikować ustawienia dostępu, przejdź do ustawień profilu bieżącego użytkownika i wyszukaj pole wyboru "Włączony interfejs API".

• Konta wersji próbnej usługi Salesforce nie mają dostępu do interfejsu API.

• Pola niestandardowe typu "Lista wyboru (wybór wielokrotny)" nie są obsługiwane przez operacje "Utwórz rekord" i "Aktualizuj rekord".

• Adresy URL błyskawic nie są obsługiwane.

• Usługa Salesforce ogranicza liczbę współbieżnych zapytań, które mogą być wykonywane przez pojedyncze konto. Błąd "INVALID_QUERY_LOCATOR" Jest to limit usługi Salesforce i może wystąpić, gdy istnieje wiele współbieżnych zapytań względem usługi Salesforce przy użyciu tego samego konta. Obejmuje to wszystkie aplikacje klienckie (nie tylko łącznik PowerQuery) przy użyciu interfejsu API usługi Salesforce. Aby zmniejszyć prawdopodobieństwo wystąpienia tego błędu, upewnij się, że liczba zapytań usługi Salesforce jest ograniczona do minimum, użyj dostępnych opcji (takich jak przepływy danych), aby przygotować dane z usługi Salesforce i potwierdzić, że inne zastosowania interfejsu API usługi Salesforce z tym samym kontem nie są zaplanowane jednocześnie.

Aby uzyskać więcej informacji na temat wewnętrznych limitów interfejsu API usługi Salesforce, zobacz Salesforce Developer Limits and Allocations Quick Reference (Limity deweloperów i alokacje usługi Salesforce — krótkie informacje).