Adobe Sign dla Salesforce: automatyczne obiegi pracy przy użyciu narzędzia Tworzenie procesów

Opis ogólny

Narzędzie Tworzenie procesów w Salesforce to narzędzie graficzne z interfejsem typu wskaż-i-kliknij umożliwiające automatyzację operacji w oparciu o wywoływanie zdarzeń w środowisku Salesforce.

Procesy są tworzone w oparciu o przepływ logiki zależnie od instrukcji warunkowych i zawierają jedno zdarzenie wyzwalające, co najmniej jeden warunek oraz co najmniej jedną operację, która może się zdarzyć w czasie rzeczywistym i/lub jako zdarzenie zaplanowane.

Aplikacja Adobe Sign obsługuje dwa typy operacji: uaktualnianie rekordów i Apex

Każdy typ operacji ma kilka możliwych operacji:

• Wyślij
• Anuluj
• Usuń
• Przypomnij
• Zaktualizuj
• Wczytanie (szablonu) jest dostępne tylko w przypadku korzystania z operacji typu Apex

Narzędzie Tworzenie procesów jest bardzo rozbudowane i pełen opis jego działania wykracza poza zakres tego dokumentu.

Ten dokument przedstawia operacje dostępne w wersji 20 pakietu Adobe Sign dla Salesforce.

Więcej informacji ogólnych o narzędziu Tworzenie procesów możesz znaleźć w dokumentacji oraz kursach Trailhead od Salesforce.

Procesy, które używają „Aktualizuj rekordy" jako typu akcji

Ta metoda używa operacji typu Zaktualizuj rekordy w narzędziu Tworzenie procesów Salesforce do konfiguracji pola listy wyboru operacji w tle na rekordzie umowy w celu wywołania operacji.

Możesz utworzyć nowy proces (na podstawie zdarzeń zmian w rekordach), który może następnie wywołać operację dotyczącą powiązanej umowy Adobe Sign. Użytkownicy mogą sterować tym, kiedy akcja nastąpi (np. po którym aktualizacji pola w rekordzie głównym) i które powiązane umowy są wybrane dla akcji.

Aktualnie obsługiwane są następujące operacje:

• Wyślij
• Anuluj
• Usuń
• Przypomnij
• Zaktualizuj

Ważne kwestie:

• Każdy błąd wykryty podczas procesu jest przechowywany w polu Komunikat o błędzie i można go wyświetlić na odpowiedniej stronie umowy
• Obsługiwane są zaplanowane operacje
• Obsługiwane są dokumenty biblioteki Adobe Sign
• Można wybrać jedną lub więcej umów nadrzędnych lub podrzędnych
• Podczas aktualizowania rekordu umowy powiązany rekord jest obiektemechosign_dev1
  • Obiekt echosign_dev1 jest powiązany z typowymi obiektami Salesforce (Konto, Okazja, Kontakt itp.). Jeśli umowy są powiązane z obiektem niestandardowym, nazwa ta będzie unikatowa dla organizacji.

• Operacje są wyzwalane poprzez zaktualizowanie pola listy wyboru Operacje w tle w rekordzie umowy o odpowiedniej wartości operacji

• Rekord umowy musi już istnieć. Nie można go utworzyć ani wczytać z szablonu umowy za pomocą operacji typu Zaktualizuj rekordy

Procesy, które używają Apex jako typu akcji

To podejście wykorzystuje operacje typu Apex w narzędziu Tworzenie procesów Salesforce, aby wywołać metodę dołączoną do pakietu zarządzanego w celu wykonania odpowiedniej operacji. 

Możesz utworzyć nowy proces (na podstawie zdarzeń zmian w rekordach), który może następnie wywołać operację dotyczącą powiązanej umowy Adobe Sign.

Zdefiniowano następujące operacje:

• Operacja wczytywania szablonu umowy
  • AgreementTemplateLoadInvocableAction.load
    • Przekazuj szablon i identyfikatory nadrzędne oraz dowolne zmienne środowiska wykonawczego.
    • Przekaż parametr opcjonalny, aby określić, czy generowanie szablonów działa w trybie asynchronicznym
      • Wymagane, jeśli szablon zawiera dokument z biblioteki Adobe Sign
    • Zwraca wygenerowany identyfikator rekordu umowy lub komunikat o błędzie, jeśli istnieje
      • Błąd nie będzie widoczny dla użytkowników uruchamiających operację wyzwalającą

W przypadku wywołania klasy Wczytaj typ umowy dostępne są cztery opcje pól, które można skonfigurować:

• Identyfikator rekordu głównego — identyfikator rekordu Salesforce obiektu, z którym powinna być powiązana umowa. 
  • Zwykle typu Odniesienia do pola i o wartości „[Object].Id”, gdzie Obiekt to Okazja, Konto itp.
• Identyfikator szablonu umowy — identyfikator rekordu Salesforce szablonu umowy do wczytania. Ustaw typ na „ID”, a wartość na identyfikator rekordu
• Zmienne środowiska wykonawczego szablonu umowy — odbiorcy i/lub dokumenty ze zmiennej. 
  • Jedna zmienna: myRecipient=auserguy@adobe.com 
  • Dwie zmienne: myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
• Przetwarzanie asynchroniczne — ustawienie opcjonalne, nie należy określać, jeśli nie jest konieczne. Domyślnie będzie to false, więc wywołanie szablonu będzie działać w trybie synchronicznym (tj.ta sama transakcja/wątek)
  • Ustaw wartość „true” (prawda), jeśli szablon umowy wczytuje dokument biblioteki Adobe Sign
  • Upewnij się, że wartość została ustawiona na „false” (fałsz), jeśli właściwość AutoSend dla szablonu ma wartość „true” (prawda)
  • Opcji automatycznego wysyłania nie można skonfigurować wraz z dokumentami biblioteki Adobe Sign
  • Pamiętaj o wewnętrznych ograniczeniach Salesforce, jeśli proces jest wywoływany z sekwencji wsadowej lub innego procesu asynchronicznego

• Operacja anulowania umowy
  • AgreementCancelInvocableAction.cancelAgreement
    • Przekazuje identyfikator umowy
    • Zwraca komunikaty o błędach

• Akcja wywoływalna usuwania umowy
  
  • AgreementDeleteInvocableAction.deleteAgreement
    • Przekazuje identyfikator umowy
    • Zwraca komunikaty o błędach

• Operacja przypominania o umowie
  • AgreementRemindInvocableAction.sendReminder
    • Przekazuje identyfikator umowy
    • Zwraca komunikaty o błędach

• Akcja wywoływalna wysyłania umowy
  
  • AgreementSendInvocableAction.sendAgreement
    • Przekazuje identyfikator umowy
    • Zwraca komunikaty o błędach

• Wywoływalna akcja aktualizacji umowy
  
  • AgreementUpdateInvocableAction.updateAgreement
    • Przekazuje identyfikator umowy
    • Zwraca komunikaty o błędach

Operacje Anuluj, Usuń, Przypomnij, Wyślij i Aktualizujwymagają tylko identyfikatora umowy objętej operacją:

Ważne kwestie:

• Obsługiwane są zaplanowane operacje
• Szablony umów z automatycznym wysyłaniem są obsługiwane (np. wygeneruj i wyślij)
• Wszystkie operacje mogą przyjmować wiele żądań w jednym wywołaniu
• Wszelkie wyjątki są przechwytywane i przechowywane w rekordzie wyników i rejestrowane jako błąd w dzienniku debugowania Apex, co zapobiega blokowaniu wykonania procesu.
• Parametr funkcji Wczytywanie szablonu (przetwarzanie asynchroniczne) określa, czy przetwarzanie szablonów odbywa się w trybie synchronicznym czy asynchronicznym. Osoba wywołująca musi określić, czy wczytywanie szablonu powinno odbywać się w trybie synchroniczny czy asynchronicznym. 
  • Domyślny proces jest wykonywany w trybie synchronicznym. Grupa procesów powinna być wykonywana w trybie synchronicznym.
  • Jeśli funkcja automatycznego wysyłania jest włączona, proces musi być wykonywany w trybie synchronicznym.
  • Przykładem procesu asynchronicznego jest wczytywanie dokumentu z biblioteki Adobe Sign.

Ograniczenia:

• Połączenie szablonów automatycznego wysyłania i dokumentów biblioteki Adobe Sign nie jest obsługiwane z powodu ograniczenia Salesforce, przez które jeden wątek nie może rozpoczynać innego wątku
  .
• W przypadku parametrów przekazanych do określonej operacji można odwoływać się tylko do pól nadrzędnych (nie pól podrzędnych). Nie można podejmować operacji na umowach podrzędnych podlegających rekordowi głównemu
• Wartości zwracane z wywołania Apex nie mogą być wykorzystywane w tworzeniu procesu. Żadne akcje, które zwracają wartość, nie są obsługiwane (np. pobierz informacje o dokumencie lub pobierz adres URL podpisywania).

Usługa kolejkowa

W celu wywołania operacji umowy z poziomu interfejsu kolejkowania Salesforce zaimplementowano nową warstwę usługi. Więcej informacji na temat usługi kolejkowania Queueable można znaleźć tutaj. Operacje wywołują podstawowy interfejs API usługi, który następnie wywołuje interfejs API Adobe Sign. 

Obsługiwane są następujące operacje:

• Wyślij
• Anuluj
• Usuń
• Przypomnij
• Zaktualizuj

Globalna echosign_dev1.AdobeSignApiQueueableService klasa usługi Apex przyjmuje wartość parametru echosign_dev1.QueueableServiceParameter zawierającego operację wywołania oraz identyfikator rekordu umowy: