Obiekty Salesforce

Podsumowanie

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 swojej osobistej strony Salesforce, otwórz ustawienia profilu, a następnie wyszukaj i upewnij się, że pole wyboru Interfejs API włączony jest zaznaczone. Pamiętaj, że konta wersji próbnej usługi Salesforce nie mają dostępu do interfejsu API.

Obsługiwane możliwości

• Produkcja
• Niestandardowe
  • Domeny niestandardowe
  • Przekierowania rekordów CNAME
  • Kolumny relacji

Nawiązywanie połączenia z obiektami usługi Salesforce z poziomu 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łącz. Aby uzyskać więcej informacji, przejdź do Gdzie uzyskać dane.

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. Obecnie niestandardowe adresy URL obsługują tylko domeny salesforce.com i cloudforce.com.

   Uwaga / Notatka

   Adresy URL Lightning nie są obsługiwane.

   Ponadto możesz wybrać pozycję Uwzględnij kolumny relacji. Ten wybór zmienia zapytanie poprzez uwzględnienie kolumn, które mogą być związane kluczem obcego z innymi tabelami. Jeśli to pole jest niezaznaczone, nie widzisz tych kolumn.

   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 Connect.

4. Jeśli logujesz się po raz pierwszy 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, który zapyta, czy chcesz, aby aplikacja używana przez Ciebie miała dostęp 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.

Nawiązywanie połączenia z obiektami usługi Salesforce z poziomu usługi Power Query Online

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

1. Wybierz Obiekty Salesforce z listy łączników danych specyficznych dla produktu, a następnie wybierz Połącz. Aby uzyskać więcej informacji, przejdź do Gdzie uzyskać dane.

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 korzystasz z adresu URL produkcyjnego Salesforce (https://www.salesforce.com) do logowania.

   

   Uwaga / Notatka

   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. Ten wybór zmienia zapytanie poprzez uwzględnienie kolumn, które mogą być związane kluczem obcego z innymi tabelami. Jeśli to pole jest niezaznaczone, nie widzisz tych kolumn.

3. Jeśli po raz pierwszy tworzysz 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órej usługa Salesforce nie obsługuje, zostanie wyświetlony komunikat o błędzie wskazujący, że określono nieobsługiwaną usługę 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 Obiektów usługi Salesforce 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ć ApiVersion, użyj Edytora Zaawansowanego i jawnie dodaj ApiVersion jako parametr. Przykład:

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

  Salesforce okresowo wycofuje wersje API, dlatego upewnij się, że określasz wspieraną wersję API przez 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 odnaleźć pole wyboru Interfejs API włączony.

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

• Operacje "Utwórz rekord" i "Aktualizuj rekord" nie obsługują pól niestandardowych typu Picklist (Multi-Select).

• Adresy URL Lightning nie są obsługiwane.

• Niestandardowe adresy URL obsługują tylko domeny salesforce.com i cloudforce.com. Użycie innych domen powoduje błąd "Nieprawidłowe argumenty".

• Usługa Salesforce ogranicza liczbę współbieżnych zapytań, które może wykonywać 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. Ten limit obejmuje wszystkie aplikacje klienckie (nie tylko konektor PowerQuery) korzystające z interfejsu API Salesforce. Aby zmniejszyć prawdopodobieństwo wystąpienia tego błędu:

  • Upewnij się, że liczba zapytań usługi Salesforce jest zachowana do minimum.
  • Użyj dostępnych opcji (takich jak przepływy danych), aby etapować dane z usługi Salesforce.
  • Upewnij się, że inne zastosowania interfejsu API usługi Salesforce z tym samym kontem nie są zaplanowane współbież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).