|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

Konektor do Salesforce

Konektor do Salesforce

  • Ostatnia aktualizacja

Dzięki konektorowi Salesforce® możesz używać poleceń do interakcji z Salesforce w ramach łańcucha. Na przykład, za pomocą tego złącza możesz:

  • Przesyłaj, wyodrębniaj i usuwaj dane w Salesforce za pomocą SOQL i operacji zbiorczych
  • Twórz obiekty Salesforce i zarządzaj nimi
  • Aktualizuj i twórz rekordy w Salesforce

Konektor współpracuje ze wszystkimi wersjami Salesforce Sales Cloud:

  • Salesforce Essentials®
  • Salesforce Net Zero Cloud
  • Lightning® Professional
  • Lightning Enterprise
  • Lightning Unlimited
Uwaga: To złącze jest zbudowane przez Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół pomocy technicznej może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani w inny sposób pomagać w przypadku jakichkolwiek problemów, które powstały poza platformą Workiva.

Wymagania

Aby udostępnić konektor do użytku w Twojej organizacji, administrator bezpieczeństwa org musi go najpierw włączyć.

Następnie możesz zabezpieczyć połączenie z Salesforce przy użyciu jednej z następujących metod:

  • Uwierzytelnianie Salesforce OAuth przy użyciu identyfikatora klienta, klucza tajnego i zakresu
  • Podstawowe uwierzytelnianie przy użyciu nazwy użytkownika i hasła
  • Poświadczenia klienta, wykorzystujące tylko identyfikator klienta i klucz tajny

Uwierzytelnianie Salesforce OAuth

Aby połączyć się z Workiva, będziesz potrzebować identyfikatora klienta i sekretu z Salesforce, a także zakresu OAuth połączonej aplikacji .

Uwierzytelnianie OAuth dodatkowo wymaga użycia aplikacji połączonej z Salesforce. Aby utworzyć tę stronę w Salesforce, skonfiguruj aplikację i skonfiguruj następujące wymagane ustawienia:

  • Dla Callback URL, wprowadź jeden z poniższych, który pasuje do Twojego AppSpot:
    • PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • W sekcji Wybrane zakresy OAuth, uwzględnij Wykonuj żądania w swoim imieniu w dowolnym momencie (refresh_token, offline_access) i co najmniej jeden inny zakres.

Podstawowe uwierzytelnianie

Aby połączyć się z Workiva, będziesz potrzebować nazwy użytkownika integracji , hasła i tokena bezpieczeństwa z Salesforce.

Podstawowe uwierzytelnianie wymaga użytkownika integracji z uprawnieniami obsługującymi API, oprócz uprawnień związanych z wszelkimi zadaniami, które będzie wykonywał łącznik.

Uwaga: Aby ustawić uprawnienia użytkownika integracji w Salesforce, wybierz Administer, Manage Users, Profiles i wybierz jego profil.
  1. W sekcji Uprawnienia administracyjne wybierz API Enabled.
  2. Aby umożliwić łącznikowi wykonanie polecenia, użytkownik musi mieć co najmniej uprawnienia Read do powiązanych z nim danych. 
  3. Aby wykonać zbiorcze aktualizacje obiektów Salesforce, użytkownik musi Edytuj uprawnienia do obiektu.

Uwierzytelnianie poświadczeń klienta

Aby połączyć się z Workiva, będziesz potrzebować identyfikatora klienta i sekretu z Salesforce.

Uwierzytelnianie poświadczeń klienta wymaga użycia aplikacji połączonej z Salesforce. Aby utworzyć to w Salesforce, skonfiguruj aplikację przy użyciu przepływu poświadczeń klienta .

Skonfiguruj konektor Salesforce do uwierzytelniania OAuth

Uwierzytelnianie OAuth umożliwia dostęp do Salesforce przy użyciu identyfikatora klienta i tajnego hasła. W przeciwieństwie do metody logowania z użyciem poświadczeń klienta, uwierzytelnianie OAuth obejmuje token odświeżania i wymaga zakresu.

Ta metoda jest zalecana w przypadku dłuższych poleceń, które w przeciwnym razie przekroczyłyby limit czasu przy użyciu metody poświadczeń klienta.

  1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
  2. W sekcji Connector Connection wybierz Salesforce i domyślny CloudRunner.
  3. W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
  4. W sekcji Properties wprowadź instancję Salesforce lub domenę niestandardową, z którą chcesz się połączyć:
    Właściwość Szczegóły
    Instancja Wprowadź instancję Salesforce, z którą chcesz się połączyć. Jeśli Twoja organizacja korzysta z niestandardowej domeny Salesforce, pozostaw puste pole.
    Uwaga: W adresie URL Salesforce znaki przed salesforce.com- takie jak na73- reprezentują instancję.
    Domena niestandardowa Wprowadź niestandardową domenę Salesforce, z którą chcesz się połączyć, jeśli jest używana.
    Uwaga: Aby wyświetlić domenę niestandardową w Salesforce, wybierz Ustawienia firmy, Moja domena. Domena niestandardowa zazwyczaj kończy się na .my.salesforce.com.
  5. W polu Typ uwierzytelniania wybierz Salesforce OAuth.
  6. Wprowadź identyfikator klienta, klucz tajny i zakres na stronie Authentication, a następnie kliknij Connect.2024-06-10_11-51-18.png
    Uwaga: Po pomyślnym nawiązaniu połączenia z Salesforce automatycznie wypełniane są pola konektora Refresh Token i Access Token. Jeśli połączenie nie powiedzie się, kliknij Stop i poczekaj na ponowne połączenie.
    Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania AES-256.
  7. Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
  8. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem List Reports konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Skonfiguruj konektor Salesforce do podstawowego uwierzytelniania

Uwierzytelnianie podstawowe pozwala zalogować się do Salesforce przy użyciu nazwy użytkownika i hasła użytkownika integracji.

  1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
  2. W sekcji Connector Connection wybierz Salesforce i domyślny CloudRunner.
  3. W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
  4. W sekcji Properties wprowadź instancję Salesforce lub domenę niestandardową, z którą chcesz się połączyć:
    Właściwość Szczegóły
    Instancja Wprowadź instancję Salesforce, z którą chcesz się połączyć. Jeśli Twoja organizacja korzysta z niestandardowej domeny Salesforce, pozostaw puste pole.
    Uwaga: W adresie URL Salesforce znaki przed salesforce.com- takie jak na73- reprezentują instancję.
    Domena niestandardowa Wprowadź niestandardową domenę Salesforce, z którą chcesz się połączyć, jeśli jest używana.
    Uwaga: Aby wyświetlić domenę niestandardową w Salesforce, wybierz Ustawienia firmy, Moja domena. Domena niestandardowa zazwyczaj kończy się na .my.salesforce.com.
  5. W polu Typ uwierzytelniania wybierz Basic Auth.
  6. W sekcji Authentication wprowadź nazwę użytkownika, hasło i token zabezpieczający użytkownika integracji.2024-06-10_11-41-07.png
    Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.
  7. Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
  8. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem List Reports konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Skonfiguruj konektor Salesforce dla poświadczeń klienta

Uwierzytelnianie poświadczeń klienta umożliwia dostęp do Salesforce przy użyciu identyfikatora klienta i tajnego hasła. Różni się to od metody logowania OAuth tym, że nie wymaga zakresu i nie musisz uwierzytelniać się w Salesforce za pomocą przycisku Connect. 

Ostrzeżenie: Ta metoda uwierzytelniania nie zawiera tokena odświeżania. Z tego powodu nie nadaje się do długotrwałych poleceń i może prowadzić do przekroczenia limitu czasu w niektórych łańcuchach.
  1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
  2. W sekcji Connector Connection wybierz Salesforce i domyślny CloudRunner.
  3. W sekcji Basic Info wprowadź unikalną nazwę i opis, które pomogą zidentyfikować złącze.
  4. W sekcji Properties wprowadź instancję Salesforce lub domenę niestandardową, z którą chcesz się połączyć:
    Właściwość Szczegóły
    Instancja Wprowadź instancję Salesforce, z którą chcesz się połączyć. Jeśli Twoja organizacja korzysta z niestandardowej domeny Salesforce, pozostaw puste pole.
    Uwaga: W adresie URL Salesforce znaki przed salesforce.com- takie jak na73- reprezentują instancję.
    Domena niestandardowa Wprowadź niestandardową domenę Salesforce, z którą chcesz się połączyć, jeśli jest używana.
    Uwaga: Aby wyświetlić domenę niestandardową w Salesforce, wybierz Ustawienia firmy, Moja domena. Domena niestandardowa zazwyczaj kończy się na .my.salesforce.com.
  5. Jako typ uwierzytelniania wybierz Client Credentials.2024-06-10_12-32-47.png
  6. W sekcji Authentication wprowadź identyfikator klienta i klucz tajny.
    Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania AES-256.
  7. Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
  8. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem List Reports konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Jeśli połączenie z Salesforce nie powiedzie się, możesz sprawdzić kilka ustawień konfiguracji, w zależności od typu uwierzytelniania.

Uwierzytelnianie OAuth2

Jeśli połączenie z połączoną aplikacją Salesforce nie powiedzie się po pierwszym kliknięciu Connect, kliknij Stop i poczekaj na ponowne połączenie. Jeśli połączenie nadal nie powiedzie się przy użyciu uwierzytelniania OAuth2:

  • Sprawdź, czy dla konektora wprowadzono prawidłową instancję Salesforce lub domenę niestandardową.
  • Sprawdź identyfikator klienta i klucz tajny połączonej aplikacji Salesforce, z której korzysta konektor.
  • W połączonej aplikacji Salesforce:
    • Sprawdź, czy adres URL wywołania zwrotnego to:
      • PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
      • EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
      • APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Upewnij się, że wybrane zakresy OAuth obejmują Wykonuj żądania w swoim imieniu w dowolnym momencie (refresh_token, offline_access) i co najmniej jeden inny zakres.

Jeśli konektor utraci połączenie z aplikacją Salesforce:

  1. Na stronie Chains kliknij Connectionscompare_arrows, wybierz złącze i kliknij Edit.
  2. W sekcji OAuth kliknij Reset.
  3. Aby umożliwić łączenie się konektora z Salesforce, kliknij Allow.

Podstawowe uwierzytelnianie

Jeśli połączenie nie powiedzie się przy użyciu podstawowego uwierzytelniania:

  • Zweryfikuj poświadczenia logowania użytkownika integracji i token bezpieczeństwa. Aby poprosić o nowy token bezpieczeństwa w Salesforce, zaloguj się jako użytkownik integracji i wybierz Ustawienia, Moje dane osobowe, a następnie kliknij Resetuj token bezpieczeństwa.
  • Sprawdź, czy dla konektora wprowadzono prawidłową instancję Salesforce lub domenę niestandardową.
  • Upewnij się, że użytkownik integracji ma uprawnienia API Enabled, oprócz uprawnień związanych z wszelkimi zadaniami wykonywanymi przez konektor.

Uwierzytelnianie poświadczeń klienta

Jeśli połączenie nie powiedzie się przy użyciu uwierzytelniania poświadczeń klienta:

  • Sprawdź, czy dla konektora wprowadzono prawidłową instancję Salesforce lub domenę niestandardową.
  • Sprawdź identyfikator klienta i klucz tajny połączonej aplikacji Salesforce, z której korzysta konektor.
Czy ten artykuł był pomocny?
Liczba użytkowników, którzy uważają ten artykuł za przydatny: 1 z 1
Dzięki konektorowi Salesforce® możesz używać poleceń do interakcji z Salesforce w ramach łańcucha. Na przykład, za po...