Příručka uživatele Zrušit

Acrobat Sign pro Salesforce – Průvodce odstraňováním potíží

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

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:

Použití mapování dat a mapování sloučení k odesílání dohod: Vzorový scénář

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í:

  1. V objektu Acrobat Sign „Dohoda“ vytvořte vyhledávací pole pro objekt „Demo 1“.
  2. 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.
  3. Následujícím způsobem vytvořte šablonu mapování dat:
    1. Zadejte jedinečný název šablony.
    2. V části Mapování polí vyberte možnost Vybraný objekt a z rozevírací nabídky vyberte možnost Demo 1.
    3. V druhé rozevírací nabídce, která se načte, vyberte ID Demo 2.
    4. Ve třetí rozevírací nabídce, která se načte, ponechte možnost „Žádné“ a vyberte možnost Vybrat.
    5. V části „Které pole Salesforce má být aktualizováno?“ vyberte název pole, které chcete aktualizovat. 
    6. 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.
  4. Následujícím způsobem vytvořte šablonu mapování sloučení:
    1. Zadejte jedinečný název šablony.
    2. Vyberte možnost Přidat mapování polí.
    3. V části Hodnota zdroje vyberte možnost Vybraný objekt a z rozevírací nabídky vyberte možnost Demo 1.
    4. V druhé rozevírací nabídce, která se načte, vyberte ID Demo 2.
    5. 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.
    6. 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.
  5. Vytvořte šablonu dohody podle pokynů v části Vytvoření pracovních postupů šablon.
  6. 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.
  7. V šabloně dohody přejděte do části Podrobnosti šablony a vyberte pro objekt Salesforce položku Demo 1.
  8. Vyberte možnost Mapování dat do polí dohody a v zobrazeném dialogovém okně pak:
    1. Vyberte možnost Vybrat z objektu.
    2. V části Typ zdroje vyberte položku ID Demo 1.
    3. V části Pole cílové dohody vyberte ve vyhledávacím poli objekt Demo 1.
    4. Vyberte možnost Uložit.
  9. 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.
  10. 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.
  11. 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.
  12. Vyberte možnost DalšíUložit.
  13. Přejděte na záznam objektu „Demo 1“ a obnovte stránku. Měl by se zobrazit panel „AgreementPanel“, který jste přidali.
  14. Vyberte možnost Odeslat dohodu k podpisu. Zobrazí se šablona dohody, kterou jste vytvořili.
  15. Vyberte šablonu dohody a podle pokynů na obrazovce dohodu odešlete. Zkontrolujte, zda dohoda obsahuje sloučená data z „Demo 2“. 
  16. Podepište dohodu. Zobrazí se aktualizovaný záznam „Demo 2“ s hodnotou z dohody. 

Odstraňování potíží s chybami při odesílání dohod ze Salesforce

Pokud se vám nedaří odesílat dohody ze Salesforce, postupujte podle následujících kroků:

  1. Zkontrolujte, že používáte podporovanou verzi Adobe Acrobat Sign. Viz Podporované verze.

  2. 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í.

  3. 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.

  4. 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>

  5. 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
    nebo

    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íží:

    1. 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.
    2. 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.
      1. Přihlaste se do služby Acrobat Sign pomocí přihlašovacích údajů správce.
      2. Přejděte do části Účet > Uživatelé a vyhledejte požadovanou e-mailovou adresu.
      3. 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í“.
      4. 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é.
    3. 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.

Odstraňování potíží s chybami při automatické aktualizací stavu

Pokud se dohoda neaktualizuje do správného stavu, proveďte pro vyřešení potíží následující kroky:

  1. 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.

  2. 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.“

    salesforce-faq-status-update-enabled

    Pokud se zpráva nezobrazuje, zkuste následující postup:

    1. Odhlaste se a znovu se přihlaste jako správce systému.
    2. Přejděte do části Adobe Acrobat Sign Admin > Povolit automatické aktualizace stavu a vyberte možnost Povolit.
    3. V zobrazeném dialogovém okně „Povolit přístup ke službě Acrobat Sign“:
      1. Všimněte si e-mailové adresy v dolní části dialogového okna.
      2. Ujistěte se, že tato e-mailová adresa má platnou licenci Sign a je správcem systému v Salesforce.
      3. Zkontrolujte, že má uživatel přiřazeno oprávnění „Uživatel integrace Adobe Sign“. 
      4. Vyberte možnost Povolit.

    Měla by se zobrazit zpráva „Pro tuto organizaci jsou povoleny automatické aktualizace stavu.“

  3. 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>'

  4. 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.

  5. Přejděte do Nastavení > Vlastní nastavení > Nastavení aktualizace dohody Adobe Sign > Spravovat > Nový (nebo Upravit). Na stránce, která se otevře, se ujistěte, že je aktivní zaškrtávací políčko Aktualizovat stav dohody (umístěné v části „Výchozí hodnota úrovně organizace“).

  6. 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.

    salesforce-faq-update-agreement

  7. 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ů. 

  8. 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    

Odstraňování potíží, které mohou nastat po povolení rozšířených domén 

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.

Řešení problémů při hledání leadů v prostředí Government Cloud

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ů:

  1. Přejděte do nabídky Nastavení > Správce objektů a vyhledejte položku Lead.
  2. V levém panelu vyberte možnost Pole a vztahy.
  3. 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:
    1. Vyberte pole, které chcete zkontrolovat. Vyberte například možnost Mobilní telefon.
    2. U všech uživatelů, kterým chcete přístup k poli povolit, zaškrtněte políčko Viditelné.
    3. Vyberte možnost Uložit.
Odesílejte svým leadům dohody ze služby Acrobat Sign pro Salesforce v prostředí Government Cloud.

Odesílejte svým leadům dohody ze služby Acrobat Sign pro Salesforce v prostředí Government Cloud.

Kontaktujte podporu

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>

Získejte pomoc rychleji a snáze

Nový uživatel?