Na stránce Salesforce lightning přejděte na kartu Adobe Acrobat Sign Admin.
Naposledy aktualizováno
16. 10. 2024
Nedaří se vám odesílat dohody ze Salesforce? Selhává při mapování dat aktualizace polí Salesforce?
Adobe Acrobat Sign pro Salesforce – Průvodce odstraňováním potíží je navržen tak, aby vám pomohl vyřešit problémy s odesíláním dohod ze Salesforce, mapováním dat nebo automatickými aktualizacemi stavu. Zjistěte více o:
- Odstraňování potíží s chybami při mapování dat
- Odstraňování potíží s chybami při odesílání dohod
- Odstraňování potíží s chybami při automatických aktualizacích stavu
- Odstraňování potíží, které mohou nastat po povolení rozšířených domén
- Řešení problémů při hledání leadů v prostředí Government Cloud
- Kontaktovat podporu
Mapování dat služby Acrobat Sign aktualizuje objekty služby Salesforce po podepsání dohody Acrobat Sign nebo v určité fázi pracovního postupu dohody. Každé mapování dat se nastavuje předem a zahrnuje pravidla mapování dat. Každé pravidlo mapování dat definuje zdroj dat a cílové pole ve službě Salesforce, které musí aktualizovat. Podrobnosti naleznete v části Mapování dat Salesforce.
Pokud se při mapování dat nepodaří pole Salesforce aktualizovat, proveďte následující kroky pro identifikaci a odstranění problému:
Postup:
Vyberte možnost Povolit. Zobrazí se zpráva „Pro tuto organizaci jsou povoleny automatické aktualizace stavu.“
Ujistěte se, že uživatel automatické aktualizace stavu (obvykle správce účtu Sign, který jste použili k nastavení integrace) a odesílatel mají přístup k objektům, které se pomocí funkce Mapování dat snažíte aktualizovat.
Pokud chcete zkontrolovat hodnotu pole, můžete pole přidat do zobrazení Seznamu dohod, použít vývojářskou konzoli nebo Workbench.
Ujistěte se, že pole „Data Mapping Result" u objektu „Agreement" má hodnotu buď „Completed", nebo „Failed". Pokud tam žádná hodnota není, znamená to, že mapování dat nebylo vůbec spuštěno.Pokud je hodnota prázdná a v poli „Mapování dat“ je vyplněno ID uživatele, zkuste mapování dat znovu spustit následujícím způsobem:
Do pole Chyba mapování dat se ukládají chyby z mapování dat. Hodnotu pole můžete zkontrolovat tak, že pole přidáte do zobrazení Seznam dohod, pomocí vývojářské konzole nebo workbench. Níže je uveden seznam běžných chyb a odpovídajících kroků k jejich řešení:
| Chyba | Datové pole se nepodařilo namapovat: Aktualizace System.DmlException se nezdařila. První výjimka v řádku 0 s ID 00ZxxqwertasdmjVUAR; první chyba: STRING_TOO_LONG, název vlastníka: datová hodnota je příliš velká: Adobe Acrobat Sign Adobe inc (max. length=20): [Owner_Title__c] (echosign_dev1) 165 |
Řešení: Tato chyba znamená, že data ve formulářovém poli aktualizovaného dokumentu přesahují limit velikosti pole Salesforce, které se snažíte aktualizovat. Abyste problém vyřešili:
|
|
| Chyba |
Byl proveden pokus o namapování odkazu na propojený objekt, který nebyl v dohodě nastaven: <název API pole v objektu Salesforce, který chcete aktualizovat>” |
Řešení: Tato chyba znamená, že mezi objektem dohody a objektem Salesforce, který se pokoušíte aktualizovat, nebylo vytvořeno žádné spojení. Viz krok 4 výše. |
|
| Chyba |
Chyba při přiřazování datového pole: System.NullPointerException Pokus o odstranění reference na nulový objekt (echosign_dev1) 656 |
Řešení Tato chyba znamená, že mapování dat selhalo, protože se nepodařilo získat přístup k požadovanému objektu. K vyřešení potíží proveďte následující kroky:
|
Vzorový uživatel:
John Smith
Příklad případu použití:
John chce:
- Odeslat dohody z vlastního objektu s názvem „Demo 1“ pomocí šablony dohody,
- Získat informace z jiného vlastního objektu s názvem „Demo 2“, který je přiřazen k objektu „Demo 1“, a přenést je do dohody a
- Po podpisu dohody přenést informace do záznamu objektu „Demo 2“.
Kroky nezbytné pro tento případ použití:
- V objektu Acrobat Sign „Dohoda“ vytvořte vyhledávací pole pro objekt „Demo 1“.
- U objektu „Demo 1" vytvořte vyhledávací pole pro objekt „Demo 2".
Nemůžete získávat ani odesílat informace ze souvisejícího seznamu nebo do něj. - Následujícím způsobem vytvořte šablonu mapování dat:
- Zadejte jedinečný název šablony.
- V části Mapování polí vyberte možnost Vybraný objekt a z rozevírací nabídky vyberte možnost Demo 1.
- V druhé rozevírací nabídce, která se načte, vyberte ID Demo 2.
- Ve třetí rozevírací nabídce, která se načte, ponechte možnost „Žádné“ a vyberte možnost Vybrat.
- V části „Které pole Salesforce má být aktualizováno?“ vyberte název pole, které chcete aktualizovat.
- Pro dokončení nastavení mapování dat postupujte podle kroků uvedených v části Použití mapování dat k přenosu dat a souborů podepisujícího do záznamů Salesforce v příručce Mapování a šablony.
- Následujícím způsobem vytvořte šablonu mapování sloučení:
- Zadejte jedinečný název šablony.
- Vyberte možnost Přidat mapování polí.
- V části Hodnota zdroje vyberte možnost Vybraný objekt a z rozevírací nabídky vyberte možnost Demo 1.
- V druhé rozevírací nabídce, která se načte, vyberte ID Demo 2.
- V další rozevírací nabídce, která se načte, vyberte název pole s hodnotou, kterou potřebujete získat, a vyberte možnost Hotovo.
- Pro dokončení nastavení mapování sloučení postupujte podle části Použití mapování sloučení pro generování dokumentů s daty Salesforce v příručce Mapování a šablony.
- Vytvořte šablonu dohody podle pokynů v části Vytvoření pracovních postupů šablon.
- Zkontrolujte, že v šabloně dohody, kterou jste vytvořili výše, jsou v části „Mapování dat“ zahrnuty šablony mapování sloučení a mapování dat.
- V šabloně dohody přejděte do části Podrobnosti šablony a vyberte pro objekt Salesforce položku Demo 1.
- Vyberte možnost Mapování dat do polí dohody a v zobrazeném dialogovém okně pak:
- Vyberte možnost Vybrat z objektu.
- V části Typ zdroje vyberte položku ID Demo 1.
- V části Pole cílové dohody vyberte ve vyhledávacím poli objekt Demo 1.
- Vyberte možnost Uložit.
- V šabloně smlouvy vyberte Uložit.
Vytvoří se šablona smlouvy propojená s objektem „Demo 1" s povoleným mapováním sloučení a mapováním dat. - Otevřete záznam objektu „Demo 1“ a vyberte možnost
> Upravit stránku. Poté z části Vlastní spravované na levém panelu přetáhněte položku AgreementPanel a vyberte možnost Uložit. - Vyberte možnost Aktivace a přiřaďte stránku záznamu podle svých potřeb. Pro účely testování vyberte možnost „Přiřadit jako výchozí v organizaci“, čímž panel „AgreementPanel“ zpřístupníte všem uživatelům.
- Vyberte možnost Další a Uložit.
- Přejděte na záznam objektu „Demo 1“ a obnovte stránku. Měl by se zobrazit panel „AgreementPanel“, který jste přidali.
- Vyberte možnost Odeslat dohodu k podpisu. Zobrazí se šablona dohody, kterou jste vytvořili.
- Vyberte šablonu dohody a podle pokynů na obrazovce dohodu odešlete. Zkontrolujte, zda dohoda obsahuje sloučená data z „Demo 2“.
- Podepište dohodu. Zobrazí se aktualizovaný záznam „Demo 2“ s hodnotou z dohody.
Pokud se vám nedaří odesílat dohody ze Salesforce, postupujte podle následujících kroků:
Zkontrolujte, že používáte podporovanou verzi Adobe Acrobat Sign. Viz Podporované verze.
Ujistěte se, že máte jako odesílatel požadovaná oprávnění.
Viz jak uživatelům udělit potřebný přístup. Kromě objektů a polí uvedených v příručce musí mít odesílatel přístup k dalším objektům Salesforce, které se v pracovním postupu používají.
Zkontrolujte, zda váš objekt „Dohoda“ nebo jiné objekty Acrobat Sign v Salesforce obsahují přizpůsobení, jako jsou spouštěče, pracovní postupy nebo pravidla. Pokud ano, zakažte všechna přizpůsobení a odešlete testovací smlouvu, abyste viděli, zda projde.
Pokud je smlouva po zakázání přizpůsobení úspěšně odeslána, prostudujte si naši příručku pro vývojáře, kde najdete pokyny.
Poznámka
Podporu pro odstraňování potíží s přizpůsobeními neposkytujeme.
K identifikaci typu chyby, která se při odesílání dohody vyskytla, použijte jeden z následujících způsobů:
- Otevřete záznam dotčené dohody v systému Salesforce a zkontrolujte, zda se na něm neobjevil červený banner s chybovou zprávou. Tato chyba by měla naznačovat hlavní příčinu.
- V objektu „Oznámení o dohodě“ zkontrolujte pole „Chybová zpráva“.
- Kontrola prostřednictvím konzole pro vývojáře a provedení následujícího dotazu SOQL:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
Informace o řešení chyb a kroků naleznete v následující tabulce:
|
Chyba |
Řešení |
|---|---|
|
Záhlaví x-api-user obsahuje neplatné ID nebo e-mail uživatele Nemáte platný uživatelský účet Adobe Acrobat Sign |
Tyto chyby označují, že odesílatel nemá platnou licenci Acrobat Sign. Odstraňování potíží:
|
|
Formát souboru není podporován |
K této chybě dochází, když dokument, který se pokoušíte odeslat k podpisu, není v podporovaném formátu. V části Podporované formáty dokumentů v rámci Systémových požadavků aplikace Acrobat Sign zkontrolujte, které formáty souborů jsou podporovány pro odesílání do služby Acrobat Sign. |
|
V tlačítku podpisu se používá nesprávné ID objektu |
K této chybě dochází, když je ID šablony tlačítka Odeslat jménem nebo hlavní ID objektu neplatné. Doporučujeme zadat správné ID objektu a proces opakovat. |
Pokud se dohoda neaktualizuje do správného stavu, proveďte pro vyřešení potíží následující kroky:
Zkontrolujte, zda jste implementovali potřebné náležitosti a poinstalační nastavení (povinná) uvedená v příručce Adobe Acrobat Sign pro Salesforce – Instalační příručka.
Na stránce Salesforce Lightning přejděte do části Adobe Acrobat Sign Admin > Povolit automatické aktualizace stavu a zkontrolujte, že se zobrazuje zpráva „Pro tuto organizaci jsou povoleny automatické aktualizace stavu.“
Pokud se zpráva nezobrazuje, zkuste následující postup:
- Odhlaste se a znovu se přihlaste jako správce systému.
- Přejděte do části Adobe Acrobat Sign Admin > Povolit automatické aktualizace stavu a vyberte možnost Povolit.
- V zobrazeném dialogovém okně „Povolit přístup ke službě Acrobat Sign“:
- Všimněte si e-mailové adresy v dolní části dialogového okna.
- Ujistěte se, že tato e-mailová adresa má platnou licenci Sign a je správcem systému v Salesforce.
- Zkontrolujte, že má uživatel přiřazeno oprávnění „Uživatel integrace Adobe Sign“.
- Vyberte možnost Povolit.
Měla by se zobrazit zpráva „Pro tuto organizaci jsou povoleny automatické aktualizace stavu.“
V objektu „Oznámení o dohodě“ zkontrolujte pole Chybová zpráva. Pro kontrolu hodnoty pole spusťte v konzoli pro vývojáře níže uvedený dotaz SOQL:
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>'
Pokud se jedná o dohodu push, která byla vytvořena mimo prostředí Salesforce, ujistěte se, že postupujete podle servisní příručky Adobe Acrobat Sign pro Salesforce: Velké dokumenty a dohody Push.
Přejděte na kartu Dohody, vyberte všechny dohody, které se nepodařilo aktualizovat, a poté v pravém horním rohu vyberte možnost Aktualizovat dohodu.
Zkontrolujte, zda se stav těchto dohod aktualizuje. Pokud se aktualizují, zkontrolujte, zda lze problém opakovat i s novou testovací dohodou. Pokud ano, pokračujte v řešení problémů podle následujících kroků.
Pokud problém opakovat nelze, mohlo se jednat o ojedinělý případ a pokud se problém objeví znovu, doporučujeme se obrátit na tohoto průvodce řešením problémů.
Zkontrolujte, zda váš objekt „Dohoda“ nebo jiné objekty Acrobat Sign v Salesforce obsahují přizpůsobení, jako jsou spouštěče, pracovní postupy nebo pravidla.
Pokud ano, zakažte všechna přizpůsobení a odešlete zkušební dohodu podle obvyklých kroků, abyste zjistili, zda procesem projde. Stav by se měl změnit z „Předběžná verze" na „Předáno k podpisu“.
Pokud se stav dohody po zakázání přizpůsobení změní na „Předáno k podpisu“, přečtěte si pokyny v naší příručce pro vývojáře.
Pokud se stav neaktualizuje, odešlete zkušební dohodu přímo z karty "Dohody" s vypnutými přizpůsobeními a zkontrolujte, zda procesem projde. Pokud se stav stále nemění, zkontrolujte kroky č. 1 a č. 2 uvedené výše.
Poznámka
Podporu pro odstraňování potíží s přizpůsobeními neposkytujeme.
| Objekty Acrobat Sign | ||
|---|---|---|
| Přidání souborů příloh | Mapování souborů | Mapování dat do polí dohody |
| Přidání šablon polí formuláře | Import polí formuláře | Mapování sloučení |
| Přidání příjemců | Mapování podřízených polí formuláře | Vzájemně vyloučené přístupy |
| dohody | Položka mapování podřízených polí formuláře | Mapování objektů |
| Události dohody | Mapování polí formuláře | Příjemci |
| Šablony dohod | Položky mapování polí formuláře | Podepsaná dohoda |
| Mapování dat | Mapování skupin | Spouštěče |
| Mapování polí | Šablony knihovny | Výsledky synchronizace uživatelů |
| Typ dohody | ||
Všechny organizace mají nyní ve výchozím nastavení povoleny rozšířené domény Salesforce. Na balíček Acrobat Sign pro Salesforce toto nemá vliv. U zákazníků, kteří své weby nakonfigurovali na stahování velkých souborů a push dohody, však při povolených rozšířených doménách dochází k problémům, což má za následek změnu adres URL webů a nefunkčnost dohod.
Aby bylo zajištěno bezproblémové fungování dohod, musí zákazníci aktualizovat vlastní nastavení stahování velkých souborů tak, aby odráželo aktualizovanou adresu URL webu.
Pro aktualizaci URL adresy zpětného volání pro push dohody musí zákazníci kontaktovat podporu a poskytnout požadované informace. Další informace naleznete v části Konfigurace jednotlivých služeb pro účet Acrobat Sign.
Pokud jsou jako typ příjemce vybrány Leady, umožňuje aplikace Acrobat Sign pro Salesforce vyhledávat a přidávat potenciální leady jako příjemce dohody. Pokud však uživatelé služby Government Cloud vytvářejí leady, kontakty nebo uživatele, ale nemohou je pomocí vyhledávacího pole najít, mohou správci Saleforce v organizaci postupovat podle těchto kroků:
- Přejděte do nabídky Nastavení > Správce objektů a vyhledejte položku Lead.
- V levém panelu vyberte možnost Pole a vztahy.
- Zkontrolujte přístup uživatelů ke všem požadovaným polím (např. jméno, e-mailová adresa, číslo mobilního telefonu atd.). Postup:
- Vyberte pole, které chcete zkontrolovat. Vyberte například možnost Mobilní telefon.
- U všech uživatelů, kterým chcete přístup k poli povolit, zaškrtněte políčko Viditelné.
- Vyberte možnost Uložit.
Pokud se problém nevyřeší ani po provedení výše uvedených kroků, kontaktujte podporu a poskytněte nám následující údaje:
- Popis problému
- E-mailová adresa správce účtu Acrobat Sign, která byla použita k nastavení integrace
- E-mailová adresa správce účtu Acrobat Sign, která byla použita k povolení automatických aktualizací stavů:
- Verze balíčku Acrobat Sign nainstalovaná v Salesforce
- ID organizace Salesforce
- ID záznamů Salesforce o dotčených dohodách
- E-mailová adresa dotčeného uživatele
- Je problém opakovatelný, občasný nebo jednorázový?
- Datum posledního výskytu: <uveďte datum / čas / časové pásmo posledního výskytu>
- Kroky pro replikaci problému
- Očekávané chování: <Popište chování, které po provedení kroků očekáváte>
- Poznámky k řešení problémů: <Uveďte podrobnosti o dosud provedených řešeních problémů podle této dokumentace>
Zefektivněte svou práci s aplikací Acrobat Sign
Rychle a snadno spravujte a podepisujte dokumenty online
