Adobe Sign for Salesforce: Automatizované postupy s nástrojem Process Builder

Přehled

Process Builder služby Salesforce je grafický nástroj založený na principu „ukázat a kliknout“, který umožňuje automatizovat akce na základě spouštění událostí v prostředí služby Salesforce.

Procesy se vytvářejí na základě logického rozhodování typu pokud/pak a obsahují jednu událost spouštěče, alespoň jednu podmínku a alespoň jednu akci, která může proběhnout v reálném čase nebo jako naplánovaná událost.

Služba Adobe Sign podporuje dva typy akcí: Aktualizace záznamů a Apex

Každý typ akce obsahuje několik vyvolatelných akcí:

• Odeslat
• Zrušit
• Odstranit
• Připomen.
• Aktualizovat
• Akce Načíst (šablona) je dostupná pouze při použití typu akce Apex

Nástroj Process Builder je velice výkonný a kompletní popis jeho fungování přesahuje rozsah tohoto dokumentu.

Tento dokument popisuje akce, které jsou dostupné ve verzi v20 balíčku Adobe Sign for Salesforce.

Pokud se chcete dozvědět další obecné informace o nástroji Process Builder, projděte si dokumentaci a interaktivní úvod do práce s nástrojem, které poskytuje společnost Salesforce.

Procesy, které používají „Aktualizovat záznamy" jako typ akce

Tento přístup používá typ akce Aktualizovat záznamy nástroje Salesforce Process Builder k nastavení pole rozevíracího seznamu Akce na pozadí na záznamu dohody tak, aby vyvolalo akci.

Můžete vytvořit nový proces (který se bude spouštět na základě událostí změn záznamu), který následně vyvolá akci v související dohodě služby Adobe Sign. Uživatelé mohou kontrolovat, kdy se akce provede (tj.po které aktualizaci pole v hlavním záznamu) a které související dohody jsou vybrány pro akci.

V současnosti jsou podporovány následující akce:

• Odeslat
• Zrušit
• Odstranit
• Připomen.
• Aktualizovat

Věnujte pozornost následujícím záležitostem:

• Všechny chyby zjištěné v průběhu procesu se uloží do pole Chybová zpráva a lze je zobrazit na odpovídající stránce Dohoda
• Jsou podporovány plánované akce
• Jsou podporovány dokumenty knihovny Adobe Sign
• Vybrat lze jednu nebo více nadřazených nebo podřízených dohod
• Při aktualizaci záznamu dohody je souvisejícím záznamem objekt echosign_dev1
  • Objekt echosign_dev1 je přidružen k běžným objektům služby Salesforce (účet, příležitost, kontakt apod.). Pokud dohody souvisejí s vlastním objektem, bude název jedinečný pro příslušnou organizaci.

• Akce se spustí po aktualizaci pole rozevíracího seznamu Akce na pozadí v záznamu dohody odpovídající hodnotou akce

• Záznam dohody již musí existovat. Nelze ho vytvořit nebo načíst ze šablony dohody pomocí typu akce „Aktualizovat záznamy“

Procesy, které používají Apex jako typ akce

Tento přístup používá typ akce Apex nástroje Salesforce Process Builder k vyvolání vyvolatelné metody obsažené ve spravovaném balíčku, která slouží k provedení odpovídající akce. 

Můžete vytvořit nový proces (který se bude spouštět na základě událostí změn záznamu), který následně vyvolá akci v související dohodě služby Adobe Sign.

Jsou nadefinovány následující vyvolatelné akce:

• Vyvolatelná akce načtení šablony dohody
  • AgreementTemplateLoadInvocableAction.load
    • Předejte ID šablony a hlavní ID a případné proměnné běhového prostředí.
    • Předejte volitelný parametr, který řídí, jestli vytvoření šablony proběhne v asynchronním režimu
      • Povinné, pokud šablona obsahuje dokument z knihovny služby Adobe Sign
    • Vrátí vytvořené ID záznamu dohody nebo případnou chybovou zprávu
      • Uživatelé, kteří akci spuštění provedli, chybu neuvidí

Při volání akce Načíst třídu typ dohody máte k dispozici čtyři volby pole, které můžete nakonfigurovat:

• ID hlavního záznamu – ID záznamu služby Salesforce objektu, ke kterému se má dohoda vztahovat. 
  • Obvykle se nastavuje na typ Odkaz na pole a hodnotu „[Object].Id“, kde objekt představuje příležitost, účet apod.
• ID šablony dohody – ID záznamu služby Salesforce šablony dohody, která se má načíst. Nastavte typ na „ID“ a hodnotu na ID záznamu
• Proměnné běhového prostředí šablony dohody – Příjemci nebo dokumenty z proměnné. 
  • Jedna proměnná: myRecipient=auserguy@adobe.com 
  • Dvě proměnné: myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
• Asynchronní zpracování – Volitelné, nezadávat, pokud to není nutné. Ve výchozím nastavení bude toto false, takže vyvolání šablony poběží v synchronním režimu (tj. stejná transakce/vlákno)
  • Pokud bude šablona dohody načítat dokument knihovny služby Adobe Sign, nastavte tuto volbu na true
  • Pokud je funkce AutoSend pro šablonu nastavena na true, nastavte tuto volbu na false
  • Společně s dokumenty knihovny ve službě Adobe Sign nelze použít funkci automatického odesílání
  • Pokud je proces vyvolán z dávky nebo jiného asynchronního procesu, věnujte pozornost vestavěným omezením služby Salesforce

• Vyvolatelná akce zrušení dohody
  • AgreementCancelInvocableAction.cancelAgreement
    • Předejte ID dohody
    • Vrátí případnou chybovou zprávu

• Invocable akce odstranění dohody
  
  • AgreementDeleteInvocableAction.deleteAgreement
    • Předejte ID dohody
    • Vrátí případnou chybovou zprávu

• Vyvolatelná akce připomenutí dohody
  • AgreementRemindInvocableAction.sendReminder
    • Předejte ID dohody
    • Vrátí případnou chybovou zprávu

• Invocable akce odeslání dohody
  
  • AgreementSendInvocableAction.sendAgreement
    • Předejte ID dohody
    • Vrátí případnou chybovou zprávu

• Invocable akce aktualizace dohody
  
  • AgreementUpdateInvocableAction.updateAgreement
    • Předejte ID dohody
    • Vrátí případnou chybovou zprávu

Akce Zrušit, Odstranit, Připomenout, Odeslat a Aktualizovat vyžadují pouze ID dohody, na kterou se bude akce vztahovat:

Věnujte pozornost následujícím záležitostem:

• Jsou podporovány plánované akce
• Šablony dohod s automatickým odesíláním jsou podporované (tj. generovat a odeslat)
• Všechny akce dokáží při jednom vyvolání přijmout více požadavků
• Všechny výjimky se zachytí a uloží do výsledného záznamu a protokolují se jako chyby do protokolu ladění Apex tak, aby nedošlo k zablokování provádění procesu.
• Parametr funkce Načtení šablony (Asynchronní zpracování) řídí, jestli zpracování šablony proběhne v synchronním nebo asynchronním režimu. Volající musí stanovit, jestli má načtení šablony proběhnout v synchronním nebo asynchronním režimu 
  • Výchozí proces proběhne v synchronním režimu. Většina procesů by měla probíhat synchronně
  • Pokud je povolené automatické odeslání, musí být proces v synchronním režimu
  • Asynchronní proces je třeba použít v případě, že potřebujete načíst dokument knihovny služby Adobe Sign

Omezení:

• Kombinace šablon s automatickým odesláním a dokumentů knihovny ve službě Adobe Sign není podporována z důvodu omezení služby Salesforce, kde jedno vlákno nemůže vyřadit druhé vlákno
  
• U parametrů předaných do vyvolatelné akce lze odkazovat pouze na nadřazená pole (nikoliv na podřízená pole). Akce nelze použít na podřízené dohody v hlavním záznamu
• Hodnoty navrácené z vyvolání Apex nelze v nástroji Process Builder zpracovat. Nejsou podporované žádné akce, které vrací Hodnotu (tj. získat informace o dokumentu nebo získat URL pro podpis).

Queueable služba

Byla implementována nová vrstva služby, která vyvolá akce dohody prostřednictvím rozhraní služby Salesforce zařaditelného do fronty. Další informace o zařazování do fronty se nacházejí zde. Tyto akce vyvolají rozhraní API služby jádra, která následně volají rozhraní služby Adobe Sign. 

Podporovány jsou následující akce:

• Odeslat
• Zrušit
• Odstranit
• Připomen.
• Aktualizovat

Globální třída echosign_dev1.AdobeSignApiQueueableService je třída služby Apex, která přijímá parametr typu echosign_dev1.QueueableServiceParameter, který obsahuje akci, která se má vyvolat a ID záznamu dohody: