Adobe Sign dla Salesforce: Simple Sign

Simple Sign to łatwy w obsłudze, bezpośrednio gotowy do użycia składnik umożliwiający użytkownikom portalu społecznościowego samodzielne podpisywanie określonych umów. Simple Sign można łatwo dodać do dowolnego portalu Salesforce Experience Cloud (np. klienta, partnera lub pracownika) lub płynnie osadzić w innych komponentach Lightning.

Funkcja „Simple Sign” jest dostępna z następujących portali w kilku różnych wersjach chmury społecznościowej Salesforce:

  • Portal B2C: logowanie użytkownika społecznościowego i logowanie użytkownika społecznościowego oraz licencje są używane przez klientów.
  • Portal B2B: licencja użytkownika społeczności partnerskiej

Ponieważ użytkownicy społeczności są użytkownikami zewnętrznymi, ich dostęp do danych organizacyjnych jest ograniczony. Domyślnie nie mają oni dostępu do danych wygenerowanych przez użytkowników wewnętrznych.

Aby używać dodatku Simple Sign do podpisywania umów na portalach społecznościowych, należy wykonać następujące kroki:

Wymagania wstępne

Aby uzyskać dostęp do funkcji Simple Sign i korzystać z niej, należy zweryfikować następujące elementy:

  • Zainstalowany jest pakiet Adobe Acrobat Sign dla Salesforce w wersji 21.0 lub nowszej.
  • Aby portal działał poprawnie, środowisko Lightning musi zostać włączone w Twojej organizacji Salesforce. Aby włączyć interfejs Lightning, z górnego menu wybierz opcję Przełącz na Lightning. W przeciwnym razie wybierz swoją nazwę i z menu rozwijanego wybierz opcję Przełącz na interfejs Lightning.
  • Upewnij się, że opcja Generuj przykładowe szablony umów jest wybrana podczas łączenia Salesforce z Adobe Acrobat Sign.
link-accounts

  • Jeśli szablony nie zostały wygenerowane podczas instalacji lub jeśli nastąpiła aktualizacja z poprzedniej wersji pakietu do wersji 19, należy przejść do karty Administrator Adobe Acrobat Sign i wybrać opcję Generuj przykładowy szablon umowy do samodzielnego podpisu.
  • Sprawdź, czy na karcie Szablony umów znajduje się szablon Testowa umowa społeczności.
verify-test-community-agreement

Włącz aplikację Chatter

Aby włączyć aplikację Chatter w organizacji SFDC:

  1. Przejdź do menu:  Konfiguracja > Narzędzia platformy > Ustawienia funkcji > Chatter > Ustawienia aplikacji Chatter.
  2. Wybierz opcję Edytuj.
  3. Zaznacz pole wyboru Włącz.
  4. Wybierz opcję Zapisz.

Włączanie procesów cyfrowych

Aby włączyć procesy cyfrowe:

  1. Przejdź do menu Konfiguracja > Narzędzia platformy > Ustawienia funkcji > Procesy cyfrowe > Ustawienia.
  2. Zaznacz pole wyboru Włącz procesy cyfrowe.
  3. Wprowadź nazwę domeny dla procesów.
    Jeśli twoje konto ma już utworzoną domenę, możesz użyć tej samej wartości dla procesów.
  4. Wybierz opcję Zapisz.
  5. W oknie dialogowym z ostrzeżeniem, że Twojej domeny nie można zmienić po jej ustanowieniu, wybierz opcję OK..

Aktywowanie dwóch zaufanych witryn CSP

Należy skonfigurować dwie Zaufane witryny CSP (zasady zabezpieczeń zawartości), aby zezwolić na adresy URL bazy dla konta Adobe Acrobat Sign. Aby to zrobić:

  1. Uzyskaj wartość odłamka konta Acrobat Sign w następujący sposób:

    1. Zaloguj się do konta Adobe Acrobat Sign.
    2. Z adresu URL skopiuj parametr znajdujący się przed częścią echosign.com (możliwe adobesign.com) (wartość fragmentu). 
      Na przykład adres URL https://caseyjones.na1.echosign.com ma wartość odłamka na1.
    3. Zamknij kartę.

    Dowiedz się, jak zidentyfikować środowisko konta Adobe Acrobat Sign.

    global-settings

  2. Przejdź do menu Konfiguracja > Ustawienia > Zabezpieczenia > Zaufane witryny CSP, a następnie wybierz opcję Nowa zaufana witryna.

    csp-trusted-sites

  3. Na nowej otwartej stronie Definicje witryn wypełnij wymagane pola w następujący sposób:

    1. Nazwa zaufanej witryny — podaj nazwę, np. Acrobat Sign
    2. Adres URL zaufanej witryny — wprowadź adres URL witryny https://secure.<shard>.adobesign.com
      Na przykład https://secure.na1.adobesign.com
      Jeśli Twoje konto nie zostało zaktualizowane do domeny adobesign.com, możesz zamiennie użyć echosign.com.
    3. Zaznacz pole wyboru Aktywne.
    4. Kontekst — wybierz opcję Witryny Experience Builder dla Kontekstu.
    5. Zaznacz pole wyboru Dyrektywa CSP: zezwalaj witrynie na fram-src.
    6. Wybierz opcję Zapisz.
    csp-trusted-site-definition

  4. Przejdź z powrotem do menu Konfiguracja > Ustawienia > Zabezpieczenia > Zaufane witryny CSP, a następnie wybierz opcję Nowa zaufana witryna.

  5. Na nowej otwartej stronie Definicje witryn wypełnij wymagane pola w następujący sposób:

    1. Nazwa zaufanej witryny — podaj nazwę, np. AcrobatSign2
    2. Adres URL zaufanej witryny — wprowadź adres URL witryny https://secure.adobesign.com
    3. Zaznacz pole wyboru Aktywne.
    4. Kontekst — wybierz opcję Witryny Experience Builder dla Kontekstu.
    5. Zaznacz pole wyboru Dyrektywa CSP: zezwalaj witrynie na fram-src.
    6. Wybierz opcję Zapisz.
    Druga zaufana witryna CSP

  6. Zweryfikuj dwie zaufane witryny CSP.

    Zaufane witryny CSP

Klonowanie profilu użytkownika społeczności

Aby skonfigurować profile użytkowników do korzystania z samoobsługowego portalu Adobe Acrobat Sign, należy sklonować i edytować jeden ze standardowych profili. Aby to zrobić:

  1. Przejdź do menu Konfiguracja > Administracja > Użytkownicy > Profile.

  2. W przypadku dowolnego standardowego profilu klienta wybierz opcję Klonuj.

    Istnieją cztery profile Społeczność klientów i można użyć dowolnego z nich do sklonowania i utworzenia profilu użytkownika. Zwróć uwagę na typ Licencji użytkownika klonowanego profilu.

    setup-profiles

  3. Podaj intuicyjną nazwę sklonowanego profilu, a następnie wybierz opcję Zapisz.

    cloned-profile-name

  4. Na stronie sklonowanego profilu wybierz opcję Edytuj.

    cloned-profile-edit

  5. Na stronie Edycja niestandardowa przewiń w dół do sekcji Uprawnienia obiektów niestandardowych i włącz wszystkie obiekty Adobe Acrobat Sign. Możesz zaznaczyć pole wyboru Modyfikuj wszystko lub wybrać tylko wymagane uprawnienia w celu zwiększenia bezpieczeństwa. 

    cloned-profile-custom-object-permissions

Tworzenie konta, kontaktu i użytkownika dla społeczności

Należy utworzyć Konto, Kontakt i Użytkownika dla Społeczności. 

Właściciel konta musi mieć przypisaną rolę, aby aktywować użytkowników portalu. Aby powiązać rolę z użytkownikiem Salesforce, przejdź do menu Konfiguracja > Administracja > Użytkownicy > Użytkownicy. Następnie z listy użytkowników wybierz opcję Edytuj dla użytkownika, a następnie na otwartej stronie otwórz menu rozwijane Rola wybierz rolę > wybierz opcję Zapisz.

Aby utworzyć konto:

  1. Uruchom aplikację Sales za pomocą narzędzia App Launcher.

  2. Otwórz menu rozwijane Konto i wybierz opcję +Nowe konto.

  3. Na otwartej stronie Nowe konto wprowadź wartość Nazwa konta, a następnie wybierz opcję Zapisz.

    Nazwa konta powinna identyfikować konto jako konto Adobe Acrobat Sign Portal. Nazwa konta jest jedyną wartością, którą należy w tym miejscu podać.

    create-new-account

Konfiguracja strony społeczności SFDC

  1. Przejdź do pozycji Konfiguracja > Narzędzia platformy > Ustawienia funkcji > Procesy cyfrowe > Wszystkie witryny.

  2. Wybierz opcję Nowe.

  3. Wybierz środowisko Obsługa klienta.

    Środowisko Obsługa klienta jest wymagane do składników samoobsługowych.

  4. Po załadowaniu strony Obsługa klienta wybierz przycisk Zacznij.

  5. Na stronie, która zostanie otwarta:

    1. Wypełnij pole Nazwa społeczności. Opcjonalnie możesz dodać określoną dla danej witryny nazwę do adresu URL, co jest przydatne w przypadku tworzenia wielu społeczności.
    2. Po skonfigurowaniu nazwy wybierz opcję Utwórz.

    Podczas tworzenia społeczności wyświetlana jest wspaniała prezentacja graficzna. Po zakończeniu zadania zostanie wyświetlona strona społeczności. 

    Nazwa społeczności jest wyświetlana w górnej części okna (podświetlona na żółto).

    Określony dla witryny ciąg znaków w adresie URL jest widoczny na pasku (podświetlony na turkusowo).

Konfiguracja przestrzeni roboczej Experience, aby aktywować użytkowników

  1. Przejdź do menu Konfiguracja > Narzędzia platformy > Ustawienia funkcji > Procesy cyfrowe > Wszystkie witryny.

  2. Dla swojej społeczności wybierz opcję Przestrzenie robocze.

  3. Na otwartej stronie Moje obszary robocze wybierz opcję Administracja.

  4. Na stronie administracyjnej społeczności:

    1. Z lewego panelu wybierz pozycję Ustawienia , a następnie wybierz opcję Aktywuj dla wskaźnika Status..
    2. W lewym panelu wybierz opcję Członkowie.
    3. Z rozwijanego menu Wyszukaj wybierz opcję Wszystko.
    4. Z listy Dostępne profile wybierz utworzony profil niestandardowy.
    5. Wybierz opcję Dodaj, aby przenieść profil na listę Wybrane profile.
    6. Wybierz opcję Zapisz.

Zmiana ustawienia Widoczność profilu dla ustawienia E-mail użytkownika społeczności na Publiczny

  1. Otwórz stronę Kontakt dla użytkownika, którego wykorzystujesz do wysyłania w jego imieniu, a następnie wybierz opcję Zaloguj się do Experience jako użytkownik.

    Zaloguj się do Experience jako użytkownik

  2. W prawym górnym rogu otwartego interfejsu portalu wybierz nazwę użytkownika, a następnie z menu rozwijanego wybierz opcję Moje ustawienia.

  3. Na otwartej stronie Moje ustawienia:

    1. W sekcji Widoczność profilu ustaw wartość ustawienia E-mail na Publiczny.
    2. Wybierz opcję Zapisz.

Dodawanie składnika Adobe Simple Sign do Przestrzeni roboczej

  1. Przejdź do menu Konfiguracja Narzędzia platformy Ustawienia funkcji > Procesy cyfrowe > Wszystkie witryny.

  2. Dla swojej społeczności wybierz opcję Przestrzenie robocze.

  3. W sekcji Moje obszary robocze wybierz pozycję Builder.

  4. W lewym górnym rogu strony wybierz ikonę Komponenty, przewiń do dołu menu i przeciągnij opcję Adobe Simple Sign na układ strony.

    Upuść składnik w miejscu, w którym mają być wyświetlane umowy Adobe Sign.

    Przeciągnij Simple Sign do szablonu portalu.

    Strona zostanie odświeżona, aby pokazać dodany składnik na układzie strony i wyświetlić panel zarządzania składnika w prawym górnym rogu.

  5. W panelu zarządzania wybierz pozycję Szablon umowy, a następnie wybierz opcję Publikuj, aby udostępnić portal.

    Uwaga:

    Po każdej zmianie portalu lub ustawień należy ponownie opublikować portal.

Osadź kod Simple Sign w komponentach środowiska Lightning.

Komponent Simple Sign można osadzić w innym komponencie Lightning za pomocą poniższego przykładowego kodu:

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

Podczas programowego osadzania komponentu w innym komponencie można określić dodatkowe parametry:

  • agreementId — identyfikator Salesforce umowy w realizacji lub w szkicu. Szkice umów muszą mieć skonfigurowaną opcję Wyślij w imieniu.
  • templateId — identyfikator Salesforce szablonu, od którego zależą generowane umowy.
  • pollingInterval — czas w milisekundach przed każdą próbą pobrania podpisującego adresu URL. Minimalna wartość to 500, maksymalna wartość to 50000, a wartość domyślna to 1000.
  • showSigningModal — w przypadku ustawienia wartości false zwracany jest tylko adres signingURL bez ładowania strony podpisu elektronicznego w oknie modalnym nakładki. W przypadku ustawienia wartości true zwracany jest adres signingURL, a strona podpisu elektronicznego jest ładowana w nakładce modalnej. Wartość domyślna to true.

Parametry podlegają następującym regułom:

  • Zmienna agreementID lub templateID musi być określona. Jeśli obie są określone, używany będzie parametr agreementID. Jeśli nie określono żadnej z nich, zostanie zwrócony błąd.
  • W przypadku używania parametru agreementID umowa musi mieć stan szkicu lub wysłana do podpisu, przy czym oczekiwany jest podpis co najmniej jednego odbiorcy.
  • Jeśli umowa jest w wersji roboczej, zostanie wysłana w takiej postaci, w jakiej jest, a adres URL do podpisywania zostanie wyświetlony.
  • Jeśli umowa jest w toku, adres URL podpisywania zostanie pobrany i wyświetlony.
  • Jeśli umowa zostanie zakończona, zostanie wyświetlony błąd.
  • W przypadku korzystania z identyfikatora templateID funkcja automatycznego wysyłania jest włączona niezależnie od tego.
  • W przypadku używania parametru agreementID uwzględniane jest ustawienie Automatyczne wysyłanie na szablonie.
  • Dla szablonów umów Simple Sign typem obiektu nadrzędnego musi być Kontakt.
  • Opcja Wyślij w imieniu jest zdecydowanie zalecana, ponieważ paczka zbiorcza użytkowników społeczności nie ma zwykle licencji na wysyłanie.

Komponent może również publikować zdarzenia dla klientów. Poniżej przykładowy element obsługi zdarzenia:

<aura:handler name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"/>

Poniższa tabela zawiera listę dostępnych zdarzeń:

Umowa wysłana

name="notifyAgreementSent" event="echosign_dev1:AgreementSentEvent" action="{!c.onAgreementSent}"

Umowa załadowana z szablonu

name="notifyAgreementLoaded" event="echosign_dev1:AgreementLoadedEvent" action="{!c.onAgreementLoaded}"

Strona podpisywania otwarta

name="notifySigningLoaded" event="echosign_dev1:SigningLoadedEvent" action="{!c.onSigningLoaded}"

Podpisane

name="notifyRecipientCompleted" event="echosign_dev1:RecipientCompletedEvent" action="{!c.onRecipientCompleted}"

Brak podpisu

name="notifyRecipientNotCompleted" event="echosign_dev1:RecipientNotCompletedEvent" action="{!c.onRecipientNotCompleted}"

Błąd podczas dowolnej operacji

name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"

Konfiguracja szablonu umowy dla funkcji Simple Sign

Udzielanie dostępu do danych integracji Salesforce

Niestandardowe obiekty naszego pakietu są domyślnie ustawione jako „prywatne” dla użytkowników zewnętrznych. Zestawy uprawnień użytkowników społeczności zapewniają dostęp do niestandardowych obiektów i ich pól, ale nie do rekordów utworzonych przez innych użytkowników (zarówno wewnętrznych, jak i zewnętrznych).

W ramach portali społecznościowych administratorzy mają następujące dwie opcje konfigurowania obiegów eSign:

  • Skorzystaj z naszych gotowych komponentów (podpis własny i simple-sign).
  • Twórz własne obiegi za pomocą naszych interfejsów API Apex. 

W obu przypadkach administratorzy często używają szablonów umów, aby umożliwić użytkownikom społeczności inicjowanie lub uczestniczenie w obiegach eSign. Aby to działało, użytkownicy społeczności muszą mieć dostęp tylko do odczytu do szablonów umów i powiązanych zasobów, takich jak obiekty scalania i mapowania danych, które są zwykle tworzone przez użytkowników wewnętrznych.

Typ licencji użytkownika społeczności określa sposób przyznawania dostępu:

  • Licencja logowania użytkownika społeczności: administratorzy mogą włączyć opcję „ViewAll” dla szablonów umów i obiektów scalania/mapowania danych za pośrednictwem profilu użytkownika społeczności w celu przyznania dostępu.
  • Licencja Community User Login PLUS i licencja Partner Community User: włączenie dostępu „ViewAll” za pośrednictwem profilu nie jest możliwe. Administratorzy muszą korzystać z reguł udostępniania opartych na rolach, aby zapewnić dostęp.

Udzielanie dostępu do szablonów umów i powiązanych obiektów

Aby użytkownicy społeczności mogli tworzyć umowy przy użyciu szablonów umów, muszą mieć dostęp „ViewAll” do szablonów umów i powiązanych z nimi obiektów.

  • Szablon umowy (echosign_dev1__Agreement_Template__c)
  • Mapowanie scalania (echosign_dev1__SIGN_Merge_Mapping__c)
  • Mapowanie danych (echosign_dev1__SIGN_Data_Mapping__c)

Jeśli szablony Acrobat Sign Document Builder są używane z szablonem umowy jako załącznikiem do pliku, poniższe obiekty muszą mieć przyznany dostęp dla użytkowników społeczności:

  • Szablon Document Builder (adobesign__Document_Template__c)

  • Mapowanie pól obiektów (adobesign__Object_Field_Mapping__c)

Proste ograniczenia podpisów

  • Jeśli szablon nie jest skonfigurowany z włączoną opcją Tylko nadawca podpisuje, użytkownicy społeczności napotkają błąd informujący, że nie jest dla nich dostępny adres URL podpisywania.

  • Jeśli szablon nie ma opcji Włącz podgląd i pola pozycji, umowa pozostaje w stanie przed wysłaniem i nie zostanie wczytany adres URL podpisywania.

  • Jeśli szablon nie ma opcji Włącz podpis hostowany, podpisy hostowane nie będą obsługiwane.

  • Simple Sign nie obsługuje delegacji. Inni odbiorcy nie uzyskają dostępu do adresu URL podpisywania.

  • Simple Sign nie obsługuje funkcji Zastąp sygnatariusza (forma delegowania). Nowi sygnatariusze nie uzyskają dostępu do adresu URL podpisywania.

  • Aby zapewnić dostęp do notatek i załączników obiektu Salesforce, administratorzy muszą włączyć opcję „Zezwól użytkownikom klienta na dostęp do notatek i załączników” w Ustawieniach społeczności.

Pomoc dostępna szybciej i łatwiej

Nowy użytkownik?