Podręcznik użytkownika Anuluj

Acrobat Sign dla Salesforce — przewodnik z zakresu rozwiązywania problemów

Nie możesz wysyłać umów z Salesforce? Czy mapowania danych nie aktualizują pól Salesforce?

Adobe Acrobat Sign dla Salesforce: przewodnik z zakresu rozwiązywania problemów ma na celu pomoc w rozwiązywaniu problemów związanych z wysyłaniem umów z Salesforce, mapowaniem danych lub automatycznymi aktualizacjami statusu. Zobacz, jak działają następujące funkcje:

Rozwiązywanie problemów z błędami mapowania danych

Mapowania danych Acrobat Sign aktualizują obiekty Salesforce podczas podpisywania umowy Acrobat Sign lub na określonym etapie obiegu pracy umowy. Każde mapowanie danych jest wcześniej konfigurowane i obejmuje reguły mapowania danych. Każda reguła mapowania danych określa źródło danych oraz docelowe pole Salesforce, które mają one zaktualizować. Szczegółowe informacje można znaleźć na stronie Mapowanie danych Salesforce.

Jeśli mapowanie danych nie zaktualizuje pola Salesforce, wykonaj następujące kroki, aby zidentyfikować i naprawić problem:

Używanie mapowania danych i mapowania scalania do wysyłania umów: przykładowy scenariusz

Przykładowy użytkownik:

Jan Kowalski

Przykład zastosowania:

Jan chce:

  • Wysyłać umowy z niestandardowego obiektu o nazwie „Demo 1” przy użyciu szablonu umowy,
  • Pobierać informacje z innego niestandardowego obiektu o nazwie „Demo 2”, który jest powiązany z obiektem „Demo 1” i przekazywać je do umowy, oraz
  • Przesłać informacje do rekordu obiektu „Demo 2” po podpisaniu umowy. 

 Kroki w celu osiągnięcia przypadku użycia:

  1. W obiekcie Acrobat Sign „Umowa” utwórz pole wyszukiwania dla obiektu „Demo 1”.
  2. W obiekcie „Demo 1” utwórz pole wyszukiwania dla obiektu „Demo 2”.
    Nie można pobierać ani przesyłać informacji z/do powiązanej listy.
  3. Utwórz szablon mapowania danych w następujący sposób:
    1. Podaj unikalną nazwę szablonu.
    2. W obszarze Mapowanie pól wybierz opcję Wybrane obiekty, a następnie z menu rozwijanego wybierz opcję Demo.
    3. Z drugiej listy rozwijanej, która się załaduje, wybierz opcję Demo 2 ID.
    4. W trzecim rozwijanym menu, które się załaduje, pozostaw „Brak” i wybierz Wybierz.
    5. W polu „Które pole Salesforce zaktualizować?” wybierz nazwę pola, które chcesz zaktualizować. 
    6. Aby ukończyć konfigurację mapowania danych, wykonaj czynności opisane w sekcji Użyj mapowania danych, aby przesłać dane i pliki sygnatariuszy do rekordów Salesforce w Przewodniku po mapowaniach i szablonach.
  4. Utwórz szablon mapowania scalania w następujący sposób:
    1. Podaj unikalną nazwę szablonu.
    2. Wybierz opcję Dodaj mapowanie pola
    3. W obszarze Wartość źródłowa wybierz opcję Wybrany obiekt, a następnie z menu rozwijanego wybierz opcję Demo 1.
    4. Z drugiej listy rozwijanej, która się załaduje, wybierz opcję Demo 2 ID.
    5. Z następnej listy rozwijanej, która się załaduje, wybierz nazwę pola z wartością, którą chcesz pobrać i wybierz opcję Gotowe.
    6. Aby ukończyć konfigurację mapowania scalania, postępuj zgodnie z sekcją Użyj mapowania scalania, aby wygenerować dokumenty z danymi Salesforce w Przewodniku po mapowaniach i szablonach.
  5. Utwórz szablon umowy, wykonując czynności opisane w sekcji Tworzenie szablonów obiegów pracy.
  6. W szablonie umowy utworzonym powyżej upewnij się, że szablony mapowania scalania i mapowania danych znajdują się w sekcji „Mapowanie danych”.
  7. W sekcji Szczegóły szablonu szablonu umowy wybierz obiekt Salesforce jako Demo 1.
  8. Wybierz opcję Mapuj dane do pól umowy, a następnie w wyświetlonym oknie dialogowym:
    1. Wybierz opcję Wybierz z obiektu.
    2. W części Typ źródławybierz opcję Demo 1 ID.
    3. W sekcji Pole umowy docelowej wybierz obiekt Demo 1 w polu wyszukiwania.
    4. Wybierz opcję Zapisz.
  9. Na szablonie umowy wybierz opcję Zapisz.
    Tworzy szablon umowy powiązany z obiektem „Demo 1” z włączonym mapowaniem scalania i mapowaniem danych.
  10. Otwórz rekord obiektu „Demo 1” i wybierz opcję  > Edytuj stronę. Następnie z sekcji Niestandardowe zarządzane w lewym panelu przeciągnij i upuść opcję AgreementPanel i wybierz opcję Zapisz.
  11. Wybierz opcję Aktywacja i przypisz stronę rekordu zgodnie z własnymi potrzebami. Do celów testowych wybierz opcję „Przypisz jako domyślna organizacja”, co udostępni „AgreementPanel” wszystkim użytkownikom.
  12. Wybierz opcje Dalej i Zapisz.
  13. Przejdź do rekordu obiektu „Demo 1” i odśwież stronę. Powinien zostać wyświetlony dodany panel „AgreementPanel”.
  14. Wybierz opcję Wyślij umowę do podpisania. Zostanie wyświetlony utworzony szablon umowy.
  15. Wybierz szablon umowy i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby wysłać umowę. Sprawdź, czy umowa zawiera scalone dane z „Demo 2”. 
  16. Podpisz umowę. Pokazuje rekord „Demo 2” zaktualizowany o wartość z umowy. 

Rozwiązywanie problemów z niepowodzeniem w wysyłaniu umów z Salesforce

Jeśli nie możesz wysyłać umów z Salesforce, wykonaj następujące kroki rozwiązywania problemów:

  1. Upewnij się, że korzystasz z obsługiwanej wersji programu Adobe Acrobat Sign. Patrz artykuł Obsługiwane wersje

  2. Upewnij się, że jako nadawca masz wymagane uprawnienia.
    Zobacz, jak przyznać wymagany dostęp użytkownikom. Oprócz obiektów i pól wymienionych w przewodniku nadawca musi mieć dostęp do innych obiektów Salesforce, które są używane w obiegu pracy.

  3. Sprawdź, czy obiekt „Umowa” lub inne obiekty Acrobat Sign w Salesforce mają dostosowania, takie jak wyzwalacze, obiegi pracy lub reguły. Jeśli tak, wyłącz wszystkie dostosowania i wyślij umowę testową, aby sprawdzić, czy zostanie ona zaakceptowana.
    Jeśli umowa zostanie pomyślnie wysłana po wyłączeniu dostosowań, zapoznaj się z naszym przewodnikiem dla programistów , aby uzyskać wskazówki.

    Uwaga:

    Nie zapewniamy wsparcia w zakresie rozwiązywania problemów z dostosowaniami.

  4. Użyj jednego z poniższych sposobów, aby zidentyfikować typ błędu otrzymanego podczas wysyłania umowy:

    • Otwórz rekord umowy w Salesforce i sprawdź, czy nie wyświetla się czerwony baner z komunikatem o błędzie. Ten błąd powinien wskazywać główną przyczynę.
    • Sprawdź pole „Komunikat o błędzie” w obiekcie „Powiadomienie o umowie”.
    • Aby sprawdzić za pomocą konsoli Developer Console i wykonać następujące zapytanie SOQL:

    Wybierz echosign_dev1__Error_Message__c z

    echosign_dev1__Agreement_Notification__c, gdzie

    echosign_dev1__Agreement__c = ‘<enter agreement id>

  5. W poniższej tabeli przedstawiono błędy i czynności, które należy wykonać w celu rozwiązania problemu:

    Błąd

    Rozwiązanie

    Nieprawidłowy identyfikator użytkownika lub adres e-mail podany w nagłówku x-api-user
    Lub

    Nie masz prawidłowego konta użytkownika Adobe Acrobat Sign

    Te błędy oznaczają, że nadawca nie ma ważnej licencji Acrobat Sign. Aby rozwiązać problem:

    1. Sprawdź pole Zarejestrowany nadawca w rekordzie umowy, aby zidentyfikować nadawcę umowy.
      Jeśli użytkownika w polu Zarejestrowany nadawca nie można znaleźć w Salesforce, pakiet Acrobat Sign użyje pola Utworzony przez jako „nadawcy” umowy.
    2. Przejdź do strony Szczegóły użytkownika nadawcy w Salesforce i upewnij się, że pole E-mail zawiera prawidłowy adres e-mail i aktywną licencję Sign dla przedsiębiorstw. Aby sprawdzić, czy adres e-mail ma aktywną licencję Sign dla przedsiębiorstw.
      1. Zaloguj się w Acrobat Sign przy użyciu poświadczeń administratora.
      2. Przejdź do opcji Konto > Użytkownicy i wyszukaj adres e-mail.
      3. Użytkownik powinien mieć status aktywny. Użytkownicy, którzy nie mają statusu „aktywnego”, nie mogą wysyłać umów. Jeśli użytkownik nie jest aktywny, zobacz, jak dodawać użytkowników i zarządzać nimi, i zapoznaj się z krokami w sekcji „Adres e-mail jest używany, ale status użytkownika nie jest aktywny”.
      4. W przypadku korzystania z funkcji Wyślij w imieniu (SOB) sprawdź poprawność adresu e-mail, zaznaczając pole Wyślij w imieniu w obiekcie Umowa. Upewnij się, że adres e-mail tego użytkownika ma ważną licencję Sign, logując się do Acrobat Sign. Upewnij się, że pole Zezwalaj na wysyłanie jako inni użytkownicy jest włączone na stronie użytkownika SOB Szczegóły użytkownika. To pole może nie być domyślnie widoczne w układzie strony obiektu użytkownika.
    3. Zweryfikuj uprawnienia użytkownika, jak wspomniano w kroku 2 powyżej. Zobacz, jak przyznać wymagany dostęp użytkownikom.

    Nieobsługiwany format pliku

    Błąd ten występuje, gdy dokument, który próbujesz wysłać do podpisu, nie ma obsługiwanego formatu.

    Zapoznaj się z sekcją Obsługiwane formaty dokumentów na stronie Wymagania systemowe usługi Acrobat Sign, aby sprawdzić, które formaty plików są obsługiwane podczas przesyłania do usługi Acrobat Sign.

    Użyto nieprawidłowego identyfikatora obiektu w przycisku podpisu

     Błąd ten występuje, gdy identyfikator szablonu przycisku Wyślij w imieniu lub identyfikator nadrzędny obiektu są nieprawidłowe.

    Sugerujemy wprowadzenie poprawnego identyfikatora obiektu i podjęcie kolejnej próby.

Rozwiązywanie problemów z automatyczną aktualizacją statusu

Jeśli umowa nie zostanie zaktualizowana z prawidłowym statusem, należy wykonać następujące kroki rozwiązywania problemów:

  1. Upewnij się, że zaimplementowano wymagania wstępne i konfiguracje poinstalacyjne (wymagane) wymienione w dokumencie Adobe Acrobat Sign dla Salesforce: podręcznik instalacji.

  2. Na stronie Salesforce lightning przejdź do menu Administrator Adobe Acrobat Sign > Włącz automatyczne aktualizacje statusu i upewnij się, że widzisz komunikat „Automatyczne aktualizacje statusu są włączone dla tej organizacji”.

    salesforce-faq-status-update-enabled

    Jeśli komunikat nie zostanie wyświetlony, wykonaj następujące czynności:

    1. Wyloguj się i zaloguj ponownie jako administrator systemu.
    2. Przejdź do menu Administrator Adobe Acrobat Sign > Włącz automatyczne aktualizacje statusu i wybierz opcję Włącz.
    3. W wyświetlonym oknie dialogowym „Zezwalaj na dostęp do Acrobat Sign”:
      1. Zwróć uwagę na adres e-mail w dolnej części okna dialogowego.
      2. Upewnij się, że ten adres e-mail ma ważną licencję Sign i jest administratorem systemu w Salesforce.
      3. Upewnij się, że użytkownik ma przypisane uprawnienie „Użytkownik integracji Adobe Sign". 
      4. Wybierz opcję Zezwól.

    Powinien zostać wyświetlony komunikat „Automatyczne aktualizacje statusu są włączone dla tej organizacji.”

  3. W obiekcie „Powiadomienie o umowie” zaznacz pole Komunikat o błędzie. Aby sprawdzić wartość pola, wykonaj poniższe zapytanie SOQL w konsoli Developer Console:

    SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'

  4. Jeśli umowa jest umową wypychaną utworzoną poza środowiskiem Salesforce, należy postępować zgodnie z instrukcjami Adobe Acrobat Sign dla Salesforce: podręcznik obsługi dużych dokumentów i wypychanych umów.

  5. Wybierz kolejno pozycje Ustawienia > Ustawienia niestandardowe > Ustawienia aktualizacji umowy Adobe Sign > Zarządzaj > Nowy (lub Edytuj). Na otwartej stronie upewnij się, że pole wyboru Aktualizuj status umowy (znajdujące się w sekcji „Domyślna wartość poziomu organizacji”) jest włączone.

  6. Przejdź do karty Umowy, zaznacz wszystkie umowy, których aktualizacja nie powiodła się, a następnie w prawym górnym rogu wybierz opcję Aktualizuj umowę.

    salesforce-faq-update-agreement

  7. Sprawdź, czy status tych umów jest aktualizowany. Jeśli zostaną teraz zaktualizowane, sprawdź, czy problem nadal można odtworzyć za pomocą nowej umowy testowej. Jeśli jest to powtarzalne, kontynuuj poniższe kroki rozwiązywania problemów.

    Jeśli problemu nie można odtworzyć, może to być jednorazowy przypadek, więc sugerujemy skorzystanie z tego przewodnika rozwiązywania problemów, gdy problem wystąpi ponownie. 

  8. Sprawdź, czy obiekt „Umowa” lub inne obiekty Acrobat Sign w Salesforce mają dostosowania, takie jak wyzwalacze, obiegi pracy lub reguły.

    Jeśli tak, wyłącz wszystkie dostosowania i wyślij umowę testową, postępując zgodnie ze zwykłymi krokami, i sprawdź, czy zostanie ona zaakceptowana. Stan powinien zmienić się z „Wersja robocza” na „Wysłano do podpisu”.

    Jeśli stan umowy zmieni się na „Wysłano do podpisu” po wyłączeniu dostosowań, zapoznaj się z naszym przewodnikiem dla programistów, aby uzyskać wskazówki.

    Jeśli stan nie zostanie zaktualizowany, wyślij umowę testową bezpośrednio z karty „Umowy” z wyłączonymi dostosowaniami i sprawdź, czy zostanie ona zaakceptowana. Jeśli stan nadal się nie zmienia, sprawdź kroki 1 i 2 wymienione powyżej.

    Uwaga:

    Nie zapewniamy wsparcia w zakresie rozwiązywania problemów z dostosowaniami.

    Obiekty Acrobat Sign
    Dodaj załączniki Mapowania plików Mapuj dane w polach umowy
    Dodawanie szablonów pól formularza Importy pola formularza Mapowania scalające
    Dodaj odbiorców Mapowanie podrzędnych pól formularza Muteksy
    Umowy Wpis mapowania podrzędnych pól formularza Mapowania obiektów
    Zdarzenia umowy Mapowania pól formularza Odbiorcy
    Szablony umowy Wpisy mapowania pól formularza Podpisana umowa
    Mapowania danych Mapowania do grup Wyzwalacze
    Mapowania pól Szablony biblioteki Wyniki synchronizacji użytkownika
    Rodzaj umowy    

Rozwiązywanie problemów, które mogą wystąpić po włączeniu rozszerzonych domen

Wszystkie organizacje mają teraz domyślnie włączone rozszerzone domeny Salesforce, co nie ma wpływu na pakiet Acrobat Sign dla Salesforce. Jednak klienci, którzy skonfigurowali swoje witryny do pobierania dużych plików i umów wypychanych, napotykają problemy po włączeniu rozszerzonych domen, co skutkuje zmianą adresów URL witryn i zerwaniem umów.

Aby zapewnić sprawne funkcjonowanie umów, klienci muszą zaktualizować niestandardowe ustawienia pobierania dużych plików, aby odzwierciedlić zaktualizowany adres URL witryny.

Aby zaktualizować adres URL oddzwaniania umów wypychanych, klienci muszą skontaktować się z pomocą techniczną i podać wymagane informacje. Szczegółowe informacje można znaleźć na stronie Uzyskaj konfigurację poszczególnych usług dla konta Acrobat Sign.

Rozwiązywanie problemów i poszukiwanie wskazówek dotyczących środowiska Government Cloud

Acrobat Sign dla Salesforce umożliwia wyszukiwanie i dodawanie potencjalnych klientów jako odbiorców umowy, gdy jako typ odbiorcy wybrano opcję Potencjalni klienci. Jeśli jednak użytkownicy Government Cloud tworzą potencjalnych klientów, kontakty lub użytkowników, ale nie mogą ich znaleźć za pomocą pola wyszukiwania, administratorzy organizacji Saleforce mogą wykonać następujące kroki:

  1. Przejdź do menu Konfiguracja > Menedżer obiektów, a następnie wyszukaj opcję Potencjalny klient.
  2. Z lewego panelu wybierz pozycję Pola i relacje.
  3. W przypadku wszystkich wymaganych pól (takich jak imię i nazwisko, adres e-mail, telefon komórkowy i inne) sprawdź dostępność dla użytkowników. Aby to zrobić:
    1. Wybierz dowolne pole, które chcesz sprawdzić. Na przykład wybierz opcję Telefon komórkowy.
    2. W przypadku wszystkich użytkowników, którym chcesz umożliwić dostęp do pola, zaznacz pole wyboru Widoczne.
    3. Wybierz opcję Zapisz.
Wysyłaj umowy do potencjalnych klientów z Acrobat Sign dla Salesforce w usłudze Government Cloud.

Wysyłaj umowy do potencjalnych klientów z Acrobat Sign dla Salesforce w usłudze Government Cloud.

Skontaktuj się z działem pomocy technicznej

Jeśli problem nie został rozwiązany nawet po wykonaniu powyższych kroków rozwiązywania problemów, Skontaktuj się z pomocą techniczną i podaj nam następujące szczegóły:

  • Opis problemu
  • Adres e-mail administratora konta Acrobat Sign, który został użyty do skonfigurowania integracji
  • Adres e-mail administratora konta Acrobat Sign, który został użyty do włączenia automatycznych aktualizacji stanu:
  • Wersja pakietu Acrobat Sign zainstalowana w Salesforce
  • Identyfikator organizacji Salesforce
  • Salesforce rejestruje identyfikatory odpowiednich umów
  • Adres e-mail odpowiedniego użytkownika
  • Czy problem jest powtarzalny, sporadyczny, czy jednorazowy?
  • Data ostatniego wystąpienia: <Podaj datę/godzinę/strefę czasową ostatniego znanego wystąpienia>
  • Kroki w celu odtworzenia problemu
  • Oczekiwane zachowanie: <Opisz zachowanie, jakiego oczekujesz po wykonaniu kroków>
  • Uwagi dotyczące rozwiązywania problemów: <Podaj szczegóły rozwiązywania problemów wykonane dotychczas w ramach tej dokumentacji>

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?