Na stronie Salesforce Lightning przejdź do karty Administrator Adobe Acrobat Sign.
Ostatnia aktualizacja
16 paź 2024
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
- Rozwiązywanie problemów z niepowodzeniem wysyłania umów
- Rozwiązywanie problemów z automatycznymi aktualizacjami stanu
- Rozwiązywanie problemów, które mogą wystąpić po włączeniu rozszerzonych domen
- Rozwiązywanie problemów i poszukiwanie wskazówek dotyczących środowiska Government Cloud
- Skontaktuj się z działem pomocy technicznej
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:
Aby to zrobić:
Wybierz polecenie Zezwól. Zostanie wyświetlony komunikat „Automatyczne aktualizacje statusu są włączone dla tej organizacji.”
Upewnij się, że użytkownik automatycznej aktualizacji statusu (zazwyczaj administrator konta Sign, który został użyty do skonfigurowania integracji) i nadawca mają dostęp do obiektów, które próbujesz zaktualizować za pomocą mapowania danych.
Aby sprawdzić wartość pola, można dodać pole do widoku listy umów, skorzystać z konsoli programisty lub użyć panelu.
Upewnij się, że pole „Wynik mapowania danych" w obiekcie „Umowa" ma wartość „Ukończono" lub „Niepowodzenie". Jeśli nie ma wartości, oznacza to, że mapowanie danych nie zostało w ogóle uruchomione. Jeśli wartość jest pusta i jeśli pole „Mapowanie danych” zawiera identyfikator użytkownika, spróbuj ponownie uruchomić mapowanie danych w następujący sposób:
W polu Błąd mapowania danych przechowywane są błędy mapowania danych. Wartość pola można sprawdzić, dodając pole do widoku listy umów, korzystając z konsoli programisty lub Workbench. Poniżej znajduje się lista typowych błędów i odpowiadających im kroków rozwiązania:
| Błąd | Failed to map data field: System.DmlException Update failed. First exception on row 0 with id 00ZxxqwertasdmjVUAR; first error: STRING_TOO_LONG, Owner Title: data value too large: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165 |
Rozwiązanie: Ten błąd oznacza, że dane w polu formularza zaktualizowanego dokumentu przekraczają limit rozmiaru pola Salesforce, które próbujesz zaktualizować. W celu rozwiązania:
|
|
| Błąd |
Attempted to map to a related object reference which wasn’t set on the agreement: <api name of field on the Salesforce object you are trying to update>” |
Rozwiązanie: Ten błąd oznacza, że nie ustanowiono połączenia między obiektem umowy a obiektem Salesforce, który próbujesz zaktualizować. Patrz krok 4 powyżej. |
|
| Błąd |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Rozwiązanie Ten błąd oznacza, że mapowanie danych nie powiodło się, ponieważ nie można było uzyskać dostępu do wymaganego obiektu. Aby rozwiązać błąd, wypróbuj wykonać poniższe czynności:
|
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:
- W obiekcie Acrobat Sign „Umowa” utwórz pole wyszukiwania dla obiektu „Demo 1”.
- W obiekcie „Demo 1" utwórz pole wyszukiwania dla obiektu „Demo 2".
Nie możesz pobierać ani wysyłać informacji z/do powiązanej listy. - Utwórz szablon mapowania danych w następujący sposób:
- Podaj unikalną nazwę szablonu.
- W obszarze Mapowanie pól wybierz opcję Wybrane obiekty, a następnie z menu rozwijanego wybierz opcję Demo.
- Z drugiej listy rozwijanej, która się załaduje, wybierz opcję Demo 2 ID.
- W trzecim rozwijanym menu, które się załaduje, pozostaw „Brak” i wybierz Wybierz.
- W polu „Które pole Salesforce zaktualizować?” wybierz nazwę pola, które chcesz zaktualizować.
- 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.
- Utwórz szablon mapowania scalania w następujący sposób:
- Podaj unikalną nazwę szablonu.
- Wybierz opcję Dodaj mapowanie pola.
- W obszarze Wartość źródłowa wybierz opcję Wybrany obiekt, a następnie z menu rozwijanego wybierz opcję Demo 1.
- Z drugiej listy rozwijanej, która się załaduje, wybierz opcję Demo 2 ID.
- Z następnej listy rozwijanej, która się załaduje, wybierz nazwę pola z wartością, którą chcesz pobrać i wybierz opcję Gotowe.
- 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.
- Utwórz szablon umowy, wykonując czynności opisane w sekcji Tworzenie szablonów obiegów pracy.
- W szablonie umowy utworzonym powyżej upewnij się, że szablony mapowania scalania i mapowania danych znajdują się w sekcji „Mapowanie danych”.
- W sekcji Szczegóły szablonu szablonu umowy wybierz obiekt Salesforce jako Demo 1.
- Wybierz opcję Mapuj dane do pól umowy, a następnie w wyświetlonym oknie dialogowym:
- Wybierz opcję Wybierz z obiektu.
- W części Typ źródławybierz opcję Demo 1 ID.
- W sekcji Pole umowy docelowej wybierz obiekt Demo 1 w polu wyszukiwania.
- Wybierz opcję Zapisz.
- W szablonie umowy wybierz Zapisz.
Tworzy szablon umowy połączony z obiektem „Demo 1" z włączonym mapowaniem scalania i mapowaniem danych. - 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. - 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.
- Wybierz opcje Dalej i Zapisz.
- Przejdź do rekordu obiektu „Demo 1” i odśwież stronę. Powinien zostać wyświetlony dodany panel „AgreementPanel”.
- Wybierz opcję Wyślij umowę do podpisania. Zostanie wyświetlony utworzony szablon umowy.
- 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”.
- Podpisz umowę. Pokazuje rekord „Demo 2” zaktualizowany o wartość z umowy.
Jeśli nie możesz wysyłać umów z Salesforce, wykonaj następujące kroki rozwiązywania problemów:
Upewnij się, że korzystasz z obsługiwanej wersji programu Adobe Acrobat Sign. Patrz artykuł Obsługiwane wersje.
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.
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 testową umowę, aby sprawdzić, czy przejdzie.
Jeśli umowa zostanie pomyślnie wysłana po wyłączeniu dostosowań, zapoznaj się z naszym przewodnikiem dla programistów, aby uzyskać wytyczne.
Spostrzeżenie
Nie zapewniamy wsparcia w zakresie rozwiązywania problemów z dostosowaniami.
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>
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 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:
|
|
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. |
Jeśli umowa nie zostanie zaktualizowana z prawidłowym statusem, należy wykonać następujące kroki rozwiązywania problemów:
Upewnij się, że zaimplementowano wymagania wstępne i konfiguracje poinstalacyjne (wymagane) wymienione w dokumencie Adobe Acrobat Sign dla Salesforce: podręcznik instalacji.
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”.
Jeśli komunikat nie zostanie wyświetlony, wykonaj następujące czynności:
- Wyloguj się i zaloguj ponownie jako administrator systemu.
- Przejdź do menu Administrator Adobe Acrobat Sign > Włącz automatyczne aktualizacje statusu i wybierz opcję Włącz.
- W wyświetlonym oknie dialogowym „Zezwalaj na dostęp do Acrobat Sign”:
- Zwróć uwagę na adres e-mail w dolnej części okna dialogowego.
- Upewnij się, że ten adres e-mail ma ważną licencję Sign i jest administratorem systemu w Salesforce.
- Upewnij się, że użytkownik ma przypisane uprawnienie „Użytkownik integracji Adobe Sign".
- Wybierz opcję Zezwól.
Powinien zostać wyświetlony komunikat „Automatyczne aktualizacje statusu są włączone dla tej organizacji.”
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>'
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.
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ę.
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.
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.
Spostrzeżenie
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 | ||
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.
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:
- Przejdź do menu Konfiguracja > Menedżer obiektów, a następnie wyszukaj opcję Potencjalny klient.
- Z lewego panelu wybierz pozycję Pola i relacje.
- 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ć:
- Wybierz dowolne pole, które chcesz sprawdzić. Na przykład wybierz opcję Telefon komórkowy.
- W przypadku wszystkich użytkowników, którym chcesz umożliwić dostęp do pola, zaznacz pole wyboru Widoczne.
- Wybierz opcję Zapisz.
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>
Usprawnij pracę z usługą Acrobat Sign
Szybkie i łatwe zarządzanie dokumentami i podpisywanie ich w Internecie.
