Adobe Acrobat Sign pro Salesforce: Průvodce upgradem

Naposledy aktualizováno 17. 11. 2023

Přehled

Adobe Acrobat Sign pro Salesforce: Průvodce upgradem obsahuje pokyny k upgradu balíčku Adobe Acrobat Sign pro Salesforce ze starší verze na nejnovější vydanou verzi.

Adobe vyžaduje, abyste provedli upgrade na nejnovější verzi Adobe Acrobat Sign pro Salesforce z těchto důvodů:

  • Každá verze Adobe Acrobat Sign pro Salesforce má nové funkce a vylepšení, která mohou významně zlepšit vaše pracovní postupy s dokumenty. 
  • Adobe Acrobat Sign pro Salesforce poskytuje podporu pouze pro nejnovější verzi (N) a dvě hlavní verze před nejnovější verzí (N-1 a N-2).Nepodporované verze mají zvýšená bezpečnostní rizika a je jim odepřen přístup k rozhraní API služby Adobe Acrobat Sign.

Důležité poznámky k upgradu

  • Neodinstalujte svůj stávající balíček Adobe Acrobat Sign pro Salesforce, protože může dojít ke ztrátě dat Acrobat Sign v prostředí Salesforce.
  • Pokud máte ve vaší organizaci Salesforce uživatele, kteří patří k více účtům Acrobat Sign, před upgradem kontaktujte svého správce úspěchu klientů Adobe nebo Péče o zákazníky Adobe.
  • Před upgradem vašeho produkčního účtu musíte provést upgrade a test ve vašem testovacím prostředí.
    Ujistěte se, že e-mailová adresa v testovacím prostředí je taková, ke které máte přístup, pokud budete muset změnit e-mail pro účet Acrobat Sign.
  • Ujistěte se, že je zakázané nastavení 'Uzamknout relace na IP adresu, ze které pocházejí'.Ke konfiguraci přejděte na Nastavení > Nastavení > Zabezpečení > Nastavení relace.
  • Projděte si níže uvedené sekce Co je nového a určete, zda existují možnosti, které je třeba ručně nakonfigurovat.
    Každé vydání má mnoho nových funkcí a nastavení, která mohou vyžadovat ruční aktualizaci.
  • Informace o nejnovějších funkcích v Adobe Acrobat Sign pro Salesforce najdete v Adobe Acrobat Sign pro Salesforce: Poznámky k vydání.
  • Pokud instalujete novou instanci balíčku, přečtěte si Adobe Acrobat Sign pro Salesforce: Průvodce instalací.
  • Počínaje verzí 24.14 Adobe Acrobat Sign pro Salesforce nepodporuje model push založený na SOAP API pro spouštění automatických aktualizací stavu.Automatické aktualizace stavu smlouvy budou spouštěny pouze pomocí modelu pull založeného na REST API.
    Pokud jste nainstalovali balíček Adobe Acrobat Sign pro Salesforce verze 20.x nebo nižší, otestujte aktualizaci v testovací organizaci.Pokud upgrade stavu smlouvy nefunguje, přejděte na kartu Správce na stránce Adobe Acrobat Sign pro Salesforce a znovu spusťte Povolit automatickou aktualizaci stavu.
  • Uživatelé, kteří upgradují na Adobe Acrobat Sign pro Salesforce V 24.14, musí ručně přidat nové hodnoty seznamu pro nastavení připomínek ve smlouvách.Nové hodnoty seznamu jsou však ve výchozím nastavení dostupné pro uživatele, kteří provádějí čistou instalaci balíčku v 24.14. 

Ověřit aktuální verzi

Před upgradem zjistěte verzi aktuálně nainstalovaného balíčku:

  1. Přihlaste se do Salesforce pomocí přihlašovacích údajů správce.
  2. Přejděte do Setup > Platform Tools > Apps > Packaging > Installed Packages a zkontrolujte číslo verze balíčku Adobe Acrobat Sign.
Ověřte verzi nainstalované aplikace Adobe Acrobat Sign pro Salesforce.

Aktualizujte balíček

Přejděte do Salesforce AppExchange, kde získáte přístup k nejnovějšímu balíčku Adobe Acrobat Sign pro Salesforce, a poté vyberte Get It Now.

Vyberte možnost Přihlásit se do služby AppExchange a pokračujte zadáním přihlašovacích údajů.

Ve zobrazeném dialogovém okně:

  • Vyberte Install in Production, abyste nainstalovali balíček do produkčního prostředí.
  • Vyberte Install in Sandbox, abyste nainstalovali balíček do prostředí sandbox.

Doporučujeme, abyste každou instalaci nejprve otestovali v prostředí sandbox.

Zkontrolujte informace o instalaci a smluvní podmínky, potvrďte, že jste si je přečetli a souhlasíte s nimi, a poté vyberte Confirm and Install!

Když budete vyzváni k přihlášení do organizace Salesforce, zadejte přihlašovací údaje a poté vyberte Login to Salesforce.

Na stránce Upgrade Adobe Acrobat Sign, která se zobrazí, vyberte Install for All Users a poté vyberte Upgrade.

Poznámka: Instalace může trvat několik minut.

Upgradovat verzi balíčku Adobe Acrobat Sign pro Salesforce.

Pokud se zobrazí dialogové okno Approve Third-Party Access :

  • Zaškrtněte Yes, grant access to these third-party websites.
  • Vyberte Continue pro spuštění instalace.

Ve zprávě o tom, že instalace může nějakou dobu trvat, vyberte Done a čekejte na e-mail s oznámením o úspěšné instalaci balíčku.

Po obdržení potvrzovacího e-mailu se na stránce Installed Package zobrazí aktuální verze balíčku.

Pokud chcete nakonfigurovat nový balíček, přečtěte si informace o konfiguracích po instalaci.

Aktualizace verze balíčku Adobe Acrobat Sign pro Salesforce.

Nakonfigurujte aktualizovaný balíček

Musíte obnovit připojení OAuth mezi Adobe Acrobat Sign a Salesforce. 

Objekty Adobe Acrobat Sign pro Salesforce se mohou měnit s vývojem balíčku, proto musíte ověřit své pracovní postupy.Pokud vytvoříte vlastní řešení, které závisí na změněných objektech, možná budete muset aktualizovat své úpravy.

Přejděte na Nastavení > Nástroje platformy > Aplikace > Balení > Nainstalované balíčky.

U balíčku Adobe Acrobat Sign vyberte Konfigurovat.

Spustí se Průvodce nastavením Adobe Acrobat Sign pro Salesforce.

Poznámka: Pokud se Průvodce nastavením nespustí automaticky, přejděte na kartu Správce Adobe Acrobat Sign a vyberte Spustit průvodce nastavením.

Nastavení spouštění

V části „Krok 1: Propojte svůj účet Adobe se službou Salesforce" Průvodce nastavením:

  1. Vyberte Přihlásit se do Adobe. 
  2. Přihlaste se do Adobe Acrobat Sign pomocí svých přihlašovacích údajů správce.
  3. Po výzvě vyberte možnost Povolit přístup.

Zobrazí se zpráva s textem Podařilo se! Úspěšně jste autorizovali svůj účet Adobe.

Po úspěšném dokončení kroku 1 vyberte Další.

V části „Krok 2: Povolit automatické aktualizace stavu Adobe Sign":

  1. Vyberte možnost Povolit.
  2. Když budete vyzváni k povolení přístupu k Adobe Acrobat Sign, vyberte Povolit.

Zobrazí se zpráva Hotovo!Úspěšně jste aktivovali automatické aktualizace stavu pro svůj účet.

Klikněte na tlačítko Další.

Když Průvodce nastavením zobrazí Gratulujeme! Vaše nastavení je dokončeno, vyberte Hotovo.

Podle potřeby nakonfigurujte všechny ruční aktualizace uvedené v sekci Co je nového.

Poznámka

Po dokončení instalace a konfigurace nového balíčku byste měli najít příslušné sekce v Acrobat Sign pro Salesforce: Příručka upgradu s informacemi o tom, která nastavení a pole byla přidána v předchozích verzích.

Ručně povolte tato nová nastavení a hodnoty polí ve své organizaci, aby nový balíček fungoval správně. Například pokud upgradujete z verze 19 na verzi 23, měli byste povolit všechny ruční úpravy uvedené pro verze 20, 21 a 22.

Co je nového

Verze balíčku 24.26

Přidejte hodnotu výběrového seznamu „E-mailové OTP"

Pro mobilní uživatele upgradující z verze 24.26 není možnost E-mailové OTP ve výchozím nastavení povolena. Musíte ji povolit ručně takto:

  1. Přejděte na Nastavení > Správce objektů > Příjemce > Pole a vztahy > Metoda ověření podpisovatele.
  2. Posuňte se dolů do sekce Hodnoty a poté vyberte Nový.
  3. Zadejte Email OTP.
  4. Vyberte možnost Uložit.

Verze balíčku 24.14

  • Adobe Acrobat Sign pro Salesforce V 24.14 zahrnuje nové hodnoty výběrových seznamů (jak je znázorněno na obrázku níže) pro nastavení připomenutí v šabloně smlouvy a ve smlouvě.
    \nPři upgradu na balíček V 24.14 musí správci Salesforce ručně přidat následující hodnoty výběrových seznamů do vlastního pole „Automatická připomenutí" v šabloně smlouvy a do vlastního pole „Připomenout příjemci podpis" ve smlouvě:
    • Každý pracovní den, dokud nebude podepsáno
    • Každý druhý den, dokud nebude podepsáno
      \n
    • Každý třetí den, dokud nebude podepsáno
    • Každý pátý den, dokud nebude podepsáno
Adobe Acrobat Sign pro Salesforce V 24.14 přidává nové hodnoty výběrových seznamů pro odesílání připomenutí příjemcům nebo generování automatických připomenutí pro šablony smluv.
Adobe Acrobat Sign pro Salesforce V 24.14 přidává nové hodnoty výběrových seznamů pro odesílání připomenutí příjemcům nebo generování automatických připomenutí pro šablony smluv.

  • Pro povolení metody ověření Acrobat Sign musí správci Salesforce přidat novou hodnotu výběrového seznamu „Acrobat Sign" do pole „Metoda ověření podepisujícího" (název API echosign_dev1_Signer_Verification_Methodc) v objektu příjemce (název API echosign_dev1SIGN_Recipients_c).
NewSignerVerificationPickListValue.png

  • V 24.14 podporuje funkci zamknutí jména příjemce, která vyžaduje jméno příjemce pro ověření KBA u všech smluv.Pro úspěšnou implementaci nastavení požadovaného jména KBA musí správci přidat novou hodnotu výběrového seznamu „Ověření Acrobat Sign" do „Metody ověření interních podepisujících" v objektech Smlouva a Šablona smlouvy, jak je znázorněno níže. 
AgreementTemplateInternalSignerVerificationMethod.png

AgreementTemplateNewPicklistValue.png

  • Počínaje verzí 24.14 Adobe Acrobat Sign pro Salesforce nepodporuje model push založený na SOAP API pro spouštění automatických aktualizací stavu.Automatické aktualizace stavu dohody jsou nyní spouštěny pouze pomocí modelu „na vyžádání“ využívajícího rozhraní REST API.

Verze balíčku 23.x

Tato funkce byla zavedena, aby umožnila aplikaci Adobe Sign sběr údajů o používání pro zlepšení produktu.Tato data se používají pouze pro vývoj, nikoli pro marketingové účely.
\n

Správci mohou tuto funkci zapnout nebo vypnout na kartě Správa Adobe Sign nebo spuštěním průvodce instalací.

Počínaje verzí 23 balíčku služby Adobe Sign pro Salesforce se objekt úložiště dokumentů Soubory stane hlavním objektem používaným v budoucnu.

Zákazníci provádějící upgrade z verzí v23.0 nebo starších budou mít svůj stávající výchozí typ úložiště vyňatý z upgradu (přílohy obvykle) aby nedošlo k narušení procesu.

Správci by měli vyhodnotit dopad změny typu úložiště dokumentů na Files , aby co nejlépe využili budoucí funkce.

Aby měli správci lepší kontrolu nad volbou druhu úložiště souborů, byla přidán nový ovládací prvek, který se nachází v sadě ovládacích prvků Vlastní nastavení > Nastavení Adobe Sign.

Toto uživatelské rozhraní se mapuje na vlastní objekt: Agreement_Document_Storage_Type__c

Platné hodnoty nastavení jsou:

  • {empty} – pokud je hodnota prázdná, výchozí chování prvku je založené na nainstalované verzi balíčku
    • Verze 23.0 nebo novější bude mít jako výchozí typ úložiště Files
    • Verze 23.0 nebo starší mají jako výchozí typ úložiště standardně přílohy
  • Soubory – Napevno definuje jako druh úložiště souborů služby Adobe Sign objekt Soubory
  • Přílohy – Napevno definuje jako druh úložiště souborů služby Adobe Sign objekt Přílohy
Nastavení typu dokumentu

Verze balíčku 22.x

Zavedení pracovních postupů do balíčku Salesforce vyžaduje povolení dalších přístupových oprávnění.

Pokud hodláte používat pracovní postupy, musíte obnovit odkazy OAuth.

Nejsou vyžadovány žádné ruční konfigurace ani změny systému.

Verze balíčku 21.5.11
Povinný instalační balíček pro všechny verze starší než v21.5.9

Každá existující instalace, která se aktualizuje z verze 21.5.9 nebo starší, musí nejprve nainstalovat balíček 21.5.11 .

Po instalaci verze 21.5.11 můžete instalovat aktuální balíček.

Každá existující instalace, která se aktualizuje z verze 21.5.9 nebo starší, musí nejprve nainstalovat balíček 21.5.11.Po instalaci verze 21.5.9+ můžete instalovat aktuální balíček.

Pro instalaci balíčku v21.5.11 musí být povolen Chatter.

Před zahájením procesu aktualizace ověřte, zda je služba Salesforce Chatter povolena:

  1. Přejděte na Nastavení > Nástroje platformy > Nastavení funkcí > Chatter > Nastavení Chatter.
  2. Pokud je Chatter zakázán, vyberte Upravit.
  3. Zaškrtněte políčko Povoleno.
  4. Vyberte možnost Uložit.
Povolení služby Chatter

Verze balíčku v21.x

Poznámka

Verze 21.x přináší několik aktualizací způsobu, jakým pracuje služba Adobe Sign pro Salesforce. 

Důrazně doporučujeme nejprve nainstalovat v21.x do sandboxového prostředí, abyste ověřili, že všechny aspekty aplikace fungují podle očekávání. 

Vývojáři by měli pečlivě zkontrolovat změny v pořadí aktualizací a změnu v apex metodě. 

Od verze 21.0 je objekt SIGN_Signed_Agreement__c (název popisku: Signed Agreement“) zastaralý.

Zákazníci, kteří chtějí získat podepsanou dohodu URL, by měli použít hovor rozhraní REST API ohledně dohody GET /agreements/{agreementId}/combinedDocument/url.

Poznámka: Adresa URL získaná z hovoru rozhraní API je zabezpečená a lze ji používat pouze omezenou dobu.

Níže uvádíme pořadí (ve verzi 21.0), ve kterém se aktualizují dohody a jejich související objekty:

  1. Přílohy 
  2. Příjemci 
  3. Dohoda (stav a její další atributy)
  4. Události smlouvy
  5. Kanály Chatter

Od verze v21.x jsou všechny asynchronní procesy zahrnující automatické aktualizace a mapování dat přepnuty z future metod na queuebale, nový přístup doporučený společností Salesforce.

V důsledku této změny jakékoliv přizpůsobení v organizaci odběratele, které přidává úlohy do fronty Salesforce jako součást procesu automatické aktualizace a/nebo mapování dat, selže s chybou "System.LimitException: Too many queueable jobs added to the queue: 2"

K tomu dochází proto, že proces zařaditelný do fronty může přidat pouze jednu podřízenou úlohu zařaditelnou do fronty, kterou však již obsadila služba Adobe Sign (viz část „Limity metod Apex zařaditelných do fronty“ zde).

Při řetězení úloh můžete z provádějící úlohy přidat pouze jednu další úlohu voláním System.enqueueJob, což znamená, že pro každou nadřízenou úlohu zařaditelnou do fronty může existovat jen jedna podřízená úloha. Spuštění více podřízených úloh ze stejné úlohy zařaditelné do fronty není podporováno.“

Příznakem této chyby je fakt, že se nezmění stav dohody anebo že mapování dat neproběhne správně. 

Postup řešení této chyb: vyhledejte problematický spouštěč, tvůrce procesu nebo pracovní postup, a deaktivujte ho nebo přepněte na používání synchronního volání nebo jeho volání odložte do budoucnosti, například o 1 hodinu později.

  • Stav smlouvy je nyní aktualizován po aktualizaci dokumentů a příjemců.
    Pro verzi 21 nebo starší byl stav nastaven předtím.
  • Popisy událostí smlouvy nyní odpovídají popisu vrácenému rozhraním Sign API a auditním zprávám.
  • Proces aktualizace nyní běží jako nativní dávkový proces Apex, což je asynchronní proces v rámci systému Salesforce.
    Dříve to byla aktualizace prostřednictvím volání API z vnějšku systému Salesforce.Triggery těchto aktualizací stavu, které spouštějí asynchronní procesy, již nefungují, protože Salesforce omezuje volání dalšího asynchronního procesu z již běžícího asynchronního procesu.
  • Objekt smlouvy je nyní aktualizován vše v jedné transakci.
    Před v21 byly aktualizace atributů smlouvy rozděleny do samostatných aktualizačních volání.
  • Nyní jsou aktualizace spolehlivější, protože backend Sign automaticky opakuje neúspěšné události po určený počet krát.
    Před v21 mohly být neúspěšné smlouvy opakovány pouze provedením ruční aktualizace v rámci systému Salesforce
  • Ruční aktualizace nyní aktualizují všechny aspekty dohod, včetně souvisejících objektů.
  • Push smlouvy nyní běží v asynchronním režimu, stejně jako běžné aktualizace, a ostatní atributy jsou aktualizovány stejně jako běžné aktualizace.
  • Byla zavedena nová nastavení pro povolení a zakázání aktualizací různých aspektů smlouvy.
  • Když je podepsané PDF uloženo v systému Salesforce, již nebude na konec názvu souboru PDF přidán popisovač (-signed nebo -approved).

 

Po dokončení upgradu postupujte podle následujících kroků pro obnovení připojení OAuth k aplikaci Acrobat Sign:

  1. Vyberte záložku Adobe Acrobat Sign Admin.
  2. Vyberte Povolit automatické aktualizace stavu.
  3. Vyberte možnost Povolit.
  4. Vyberte možnost Povolit.

Ve v20 nebylo vyžadováno, aby uživatel Callback v systému Salesforce byl licencovaným uživatelem Adobe Sign. 

Vylepšení Push Mapping ve v21 vyžadují, aby uživatel Callback měl aktivní ID uživatele v účtu Acrobat Sign, který je připojen k organizaci Salesforce.

Zákazníci v20 používající Push Mapping musí zajistit, aby uživatel Callback byl již zřízen v aplikaci Adobe Acrobat Sign před upgradem.V opačném případě přestane Push Mapping fungovat (dokud nebude uživatel zřízen) po upgradu na v21.

Funkčnost Push mapping, která automaticky propojovala související objekty pomocí nastavení „Copy contact Account/Opportunity", byla rozšířena o smlouvy odeslané ze systému Salesforce.

  • např. Smlouvy odeslané ze systému Salesforce automaticky zkopírují vyhledávání Příležitosti prvního příjemce kontaktu do vyhledávání Příležitosti smlouvy a vyhledávání Účtu prvního příjemce kontaktu do vyhledávání Účtu smlouvy, pokud odeslané smlouvy nemají žádný propojený účet/příležitost

Před verzí 21 byly kanály služby Chatter vyplňovány pouze tehdy, pokud byla dohoda odeslána ze služby Salesforce.

Tato aktualizace rozšiřuje kanál Chatter o smlouvy odeslané z vnějšku systému Salesforce (Push smlouvy)

Před vydáním verze 21 aktualizovalo Zobrazení dohody URL souboru PDF teprve poté, co první příjemce dokončil svou akci.

Obraz a URL se nyní aktualizují dříve, pokud je zvolen stav Předvyplnění nebo Odesláno k podpisu k prvnímu příjemci.

 

Pro povolení této funkce není vyžadována žádná konfigurace.

Je zaváděn nový stav dohody Čeká na moje delegování, který bere v potaz, pokud dohoda čeká na delegování oprávnění aktuálního příjemce ze strany odesílatele.

 

Pro povolení tohoto stavu není vyžadována žádná konfigurace.

Šablona dohody má pole „Počet dnů do vypršení platnosti“ (echosign_dev1__Days_Until_Expiration__c).  Jedná se o číselné pole a ve verzi 21 je zastaralé.

Bylo přidáno nové pole „Dny do vypršení" (název api: echosign_dev1__Days_Until_Expiration2__c), ale je to textové pole, které umožňuje odkazovat na další pole v hlavním objektu (například{!Expiry_Date__c})

Při upgradu z předchozí verze jsou všechna data formuláře mapovaná do staršího pole vypršení platnosti automaticky kopírována do nového pole, takže není vyžadována žádná přímá akce.

Na stránce šablony již nejsou dostupná pole Účet, Příležitost, a Smlouva.

Správci mohou tato pole v šabloně konfigurovat s využitím funkce Mapovat data do polí dohody

Dříve mohli odesílatelé definovat svou absolutní pozici v zásobníku podpisů jako „Odesílatel podepisuje první" nebo „Odesílatel podepisuje poslední".

Toto pole již není dostupné na stránkách Nové šablony. Odesílatelé mají možnost vkládat svůj podpis na libovolnou pozici ve frontě podpisů.

Byl odstraněn přepínač pro řízení celkového postupu podepisování s možnostmi „Sekvenční“ nebo „Paralelní“.

Nový styl šablony umožňuje plně konfigurovatelný pracovní postup, který může být zcela postupný (index podepisujícího 1 až 1+N), paralelní (všechny indexy podepisujících jsou 1) nebo kombinace postupného a paralelního, kde je index podpisu nakonfigurován na specifický pracovní postup.

Ve verzi 21 je pět zastaralých nastavení. Všechna nastavení byla v části Nastavení Adobe Sign v nabídce Vlastní nastavení.

Jedná se o těchto pět nastavení:

  • Přidat PDF auditu do seznamu příloh – Povolením tohoto nastavení přiložíte po podepsání dohody dokument PDF protokolu auditu k záznamu dohody.
  • Přidávat podepsaná PDF jako jednotlivé přílohy – Povolením tohoto nastavení přiložíte PDF podepsaných dohod jako nezávislé dokumenty v případě, že bylo v rámci jedné transakce odesláno více dokumentů. Chcete-li přestat přijímat podepsanou smlouvu jako sloučený PDF, kontaktujte prosím zákaznickou péči Adobe pro pomoc. 
  • Přidat podpůrné soubory do seznamu příloh – Povolením tohoto nastavení přiložíte po podepsání dohody PDF podpůrných dokumentů k záznamu dohody. Pomocí polí pro podpůrné dokumenty v dohodě mohou podepisující odeslat a přiložit podpůrné dokumenty k transakci dohody.
  • Přidat odkaz na podepsaný PDF pro odesílané smlouvy (ve výchozím nastavení zapnuto) – Toto nastavení se vztahuje pouze na odesílané smlouvy odeslané mimo Salesforce. Zapněte toto nastavení, abyste přidali odkaz na podepsaný PDF k záznamu smlouvy.
  • Přidat podepsaný PDF pro odesílané smlouvy (ve výchozím nastavení zapnuto) – Nastavení se vztahuje na smlouvy odeslané z vnějšku Salesforce a odesílané do Salesforce. Zapněte toto nastavení, abyste připojili podepsaný soubor PDF k záznamu smlouvy. 

Zákazníci, kteří používají výše uvedená nastavení mohou konfigurovat nové nastavení v části Nastavení aktualizace dohod ve službě Adobe Sign.

Zastaralé nastavení (v části Nastavení Adobe Sign)

Nové nastavení (v části Nastavení aktualizace dohod ve službě Adobe Sign)

Přidat PDF auditu do seznamu příloh

Přidat zprávu auditu

Přidat podepsaná PDF jako jednotlivé přílohy

Přidat podepsaná PDF jako jednotlivé přílohy

Přidat podpůrné soubory do seznamu příloh

Přidat podpůrné soubory

Přidat odkaz na podepsaná PDF nabízených dohod

Přidat URL podepsaného PDF

Přidat podepsané PDF nabízených dohod 

Přidat podepsané PDF