Na stronie Salesforce Lightning przejdź do karty Administrator Adobe Acrobat Sign.
- Integracje z usługą Adobe Acrobat Sign
- Nowości
- Wersje produktów i cykl eksploatacji
- Acrobat Sign dla Salesforce
- Instalacja pakietu
- Konfiguracja pakietu
- Podręcznik użytkownika
- Włączanie uwierzytelniania cyfrowego
- Podręcznik dla programistów
- Instrukcja wprowadzania ustawień zaawansowanych
- Instrukcja mapowania pól i szablonów
- Podręcznik użytkownika aplikacji mobilnej
- Przewodnik automatyzacji obiegów
- Przewodnik narzędzia Document Builder
- Konfigurowanie dużych dokumentów
- Instrukcja aktualizacji
- Informacje o wydaniu
- Często zadawane pytania
- Przewodnik rozwiązywania problemów
- Dodatkowe artykuły
- Acrobat Sign dla Microsoft
- Acrobat Sign dla Microsoft 365
- Acrobat Sign dla Outlook
- Acrobat Sign dla programu Word/PowerPoint
- Acrobat Sign dla Teams
- Acrobat Sign dla Microsoft PowerApps i Power Automate
- Łącznik Acrobat Sign dla Microsoft Search
- Acrobat Sign dla Microsoft Dynamics
- Acrobat Sign dla Microsoft SharePoint
- Omówienie
- SharePoint On-Prem: Instrukcja instalacji
- SharePoint On-Prem: Instrukcja mapowania szablonu
- SharePoint On-Prem: Podręcznik użytkownika
- SharePoint On-Prem: Informacje o wydaniu
- SharePoint Online: Instrukcja instalacji
- SharePoint Online: Instrukcja mapowania szablonu
- SharePoint Online: Podręcznik użytkownika
- SharePoint Online: Instrukcja mapowania formularzy internetowych
- SharePoint Online: Informacje o wydaniu
- Acrobat Sign dla Microsoft 365
- Acrobat Sign dla ServiceNow
- Acrobat Sign dla HR ServiceNow
- Acrobat Sign dla SAP SuccessFactors
- Acrobat Sign dla oprogramowania Workday
- Acrobat Sign dla NetSuite
- Adobe Acrobat Sign dla SugarCRM
- Acrobat Sign dla VeevaVault
- Acrobat Sign dla Coupa BSM Suite
- Acrobat Sign dla Zapier
- Acrobat Sign — dokumentacja programisty
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ć:
-
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ńczony” lub „Niepowodzenie”. Brak wartości oznacza, ż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żna pobierać ani przesył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.
- Na szablonie umowy wybierz opcję Zapisz.
Tworzy szablon umowy powiązany 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 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.
-
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
LubNie 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:
- 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. - 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.
- Zaloguj się w Acrobat Sign przy użyciu poświadczeń administratora.
- Przejdź do opcji Konto > Użytkownicy i wyszukaj adres e-mail.
- 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”.
- 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.
- 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.
- Sprawdź pole Zarejestrowany nadawca w rekordzie umowy, aby zidentyfikować nadawcę umowy.
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.
-
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.
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
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>