Na stránce Salesforce lightning přejděte na kartu Adobe Acrobat Sign Admin.
- Integrace služby Adobe Acrobat Sign
- Co je nového
- Verze a životní cyklus produktu
- Služba Adobe Sign pro Salesforce
- Instalace balíčku
- Konfigurace balíčku
- Uživatelská příručka
- Povolit digitální ověření
- Příručka pro vývojáře
- Příručka pro pokročilé přizpůsobení
- Příručka mapování polí a šablon
- Uživatelská příručka pro mobilní aplikace
- Příručka automatizace toků
- Příručka Document Builder
- Konfigurace rozsáhlých dokumentů
- Příručka pro upgrade
- Poznámky k vydání
- Časté dotazy
- Průvodce řešením potíží
- Další články
- Acrobat Sign pro Microsoft
- Služba Acrobat Sign pro Microsoft 365
- Služba Acrobat Sign pro Outlook
- Služba Acrobat Sign pro Word/PowerPoint
- Služba Acrobat Sign pro Teams
- Služba Acrobat Sign pro Microsoft PowerApps a Power Automate
- Konektor Acrobat Sign pro Microsoft Search
- Služba Acrobat Sign pro Microsoft Dynamics
- Přehled
- Systém Dynamics Online: instalační příručka
- Systém Dynamics Online: uživatelská příručka
- Služba Dynamics On-Prem: instalační příručka
- Služba Dynamics On-Prem: uživatelská příručka
- Příručka pro pracovní postupy služby Dynamics
- Služba Dynamics 365 for Talent
- Příručka pro upgrade
- Poznámky k vydání
- Služba Adobe Sign pro Microsoft SharePoint
- Přehled
- Služba SharePoint On-Prem: instalační příručka
- Služba SharePoint On-Prem: průvodce mapováním šablon
- Služba SharePoint On-Prem: uživatelská příručka
- Služba SharePoint On-Prem: poznámky k vydání
- Služba SharePoint Online: instalační příručka
- Služba SharePoint Online: průvodce mapováním šablon
- Služba SharePoint Online: uživatelská příručka
- Služba SharePoint Online: mapování webových formulářů
- Služba SharePoint Online: poznámky k vydání
- Služba Acrobat Sign pro Microsoft 365
- Acrobat Sign pro ServiceNow
- Služba Acrobat Sign pro HR ServiceNow
- Služba Acrobat Sign pro SAP SuccessFactors
- Acrobat Sign pro Workday
- Služba Acrobat Sign pro NetSuite
- Služba Acrobat Sign pro SugarCRM
- Služba Acrobat Sign pro VeevaVault
- Služba Acrobat Sign pro Coupa BSM Suite
- Služba Acrobat Sign pro Zapier
- Vývojová dokumentace služby Acrobat Sign
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:
-
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 „Výsledek mapování dat“ v objektu „Dohoda“ má hodnotu „Dokončeno“ nebo „Neúspěšné“. Pokud není uvedena žádná hodnota, 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“.
- V objektu „Demo 1“ vytvořte vyhledávací pole pro objekt „Demo 2“.
Informace z/do přidruženého seznamu nelze načíst ani přenést. - 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ě dohody vyberte možnost Uložit.
Vytvoří se šablona dohody 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 jako odesílatel máte nezbytná 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, všechna přizpůsobení zakažte a odešlete zkušební dohodu, abyste zjistili, zda procesem projde.
Pokud je dohoda po zakázání přizpůsobení úspěšně odeslána, přečtěte si pokyny v naší příručce pro vývojáře.
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
neboNemáte platný uživatelský účet Adobe Acrobat Sign
Tyto chyby označují, že odesílatel nemá platnou licenci Acrobat Sign. Odstraňování potíží:
- V záznamu dohody zaškrtněte pole Odesílatel zaznamenán, abyste identifikovali odesílatele dohody.
Pokud uživatele v poli Odesílatel zaznamenán nelze v Salesforce nalézt, balíček Acrobat Sign použije jako „odesílatele“ dohody uživatele v poli Vytvořil. - Přejděte na stránku Podrobnosti o uživateli odesílatele v Salesforce a ujistěte se, že v poli E-mail je uvedena platná e-mailová adresa a aktivní licence služby Sign pro podniky. Pokud chcete zkontrolovat, zda má e-mailová adresa aktivní licenci Sign pro podniky.
- Přihlaste se do služby Acrobat Sign pomocí přihlašovacích údajů správce.
- Přejděte do části Účet > Uživatelé a vyhledejte požadovanou e-mailovou adresu.
- Stav uživatele by měl být „aktivní“. Uživatelé, kteří nemají stav „aktivní“, nemohou dohody odesílat. Pokud uživatel není aktivní, podívejte se, jak přidávat a spravovat uživatele, a postupujte podle kroků v části „E-mail je používán, ale stav uživatele není Aktivní“.
- Pokud je použita funkce Odeslat jménem, potvrďte e-mailovou adresu zaškrtnutím pole s názvem Odeslat jménem v objektu Dohoda. Přihlášením do služby Acrobat Sign se ujistěte, že e-mailová adresa tohoto uživatele má platnou licenci Sign. Ujistěte se, že je na stránce Podrobnosti o uživateli, jehož jménem se dohoda odesílá, povoleno pole Povolit odesílání jako jiný uživatel. Toto pole nemusí být ve výchozím nastavení rozvržení na stránce uživatelského objektu viditelné.
- Ověřte oprávnění uživatele, jak je výše uvedeno v kroku 2. Viz jak uživatelům udělit potřebný přístup.
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.
- V záznamu dohody zaškrtněte pole Odesílatel zaznamenán, abyste identifikovali odesílatele dohody.
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.
-
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>