Adobe Sign per Salesforce - Simple Sign

La funzione “Simple Sign” è disponibile per l’accesso dai seguenti portali di alcune edizioni diverse del cloud della community Salesforce:

• Portale B2C: i clienti utilizzano il login utente della comunità e il login utente della comunità più le licenze
• Portale B2B: licenza utente della community partner

Poiché gli utenti della community sono utenti esterni, il loro accesso ai dati dell’organizzazione è limitato. Per impostazione predefinita, non sono in grado di accedere ai dati generati dagli utenti interni.

Per utilizzare Simple Sign per firmare gli accordi sui portali della community, è necessario implementare i passaggi seguenti:

• Verificare i prerequisiti
  
• Abilitare Chatter
• Abilitare le esperienze digitali
• Attivare due siti CSP affidabili
• Clonare il profilo utente per la community
• Creare un account, un referente e un utente per la community
• Configurare la pagina della community SFDC
• Configurare l’area di lavoro dell’esperienza per abilitare gli utenti
• Impostare su Pubblico le impostazioni Visibilità profilo per l’impostazione e-mail dell’utente della community
• Aggiungere il componente Adobe Simple Sign all’area di lavoro
• Incorporare il codice Simple Sign nei componenti di Lightning
• Concedere l’accesso ai dati di integrazione di Salesforce
• Concedere l’accesso ai modelli di accordo e agli oggetti correlati
• Scoprire le limitazioni di Firma autonoma

Per accedere e utilizzare la funzionalità Simple Sign, è necessario verificare quanto segue:

• È installata la versione 21.0 o successiva del pacchetto Adobe Acrobat Sign per Salesforce.
• Assicurati che Lightning sia abilitato nell’organizzazione Salesforce affinché il portale funzioni. Per abilitare l’interfaccia Lightning, dal menu in alto seleziona Passa a Lightning. Oppure, seleziona il tuo nome e dal menu a discesa seleziona Passa all’esperienza Lightning.
• Assicurati che l’opzione Genera modelli di accordo di esempio sia stata selezionata quando colleghi Salesforce a Adobe Acrobat Sign.

• Se durante l’installazione non sono stati generati i modelli, oppure se hai eseguito l’aggiornamento alla versione 19 da una versione precedente del pacchetto, accedi alla scheda Amministratore Adobe Acrobat Sign e seleziona Genera modello per accordi di firma autonoma di esempio.

• Verifica che la scheda Modelli di accordo contenga il modello Test Community Agreement:
  

Abilitare Chatter

Per abilitare Chatter nella tua organizzazione SFDC:

1. Passa a  Configurazione > Strumenti piattaforma > Impostazioni funzionalità > Chatter > Impostazioni Chatter.
2. Seleziona Modifica.
3. Seleziona la casella di controllo Abilita.
4. Seleziona Salva.

Abilitare le esperienze digitali

Per abilitare le esperienze digitali:

1. Passa a Configurazione > Strumenti piattaforma > Impostazioni funzionalità > Esperienze digitali > Impostazioni.
2. Seleziona la casella di controllo Abilita esperienze digitali.
3. Fornisci un nome di dominio per le esperienze.
   Se il tuo account ha un dominio già definito, puoi utilizzare lo stesso valore anche per le esperienze.
4. Seleziona Salva.
5. Nella finestra di dialogo con il messaggio di avvertenza Impossibile modificare il dominio una volta definito, seleziona OK.

Attivare due siti CSP affidabili

È necessario configurare due siti CSP affidabili (Content Security Policy) per consentire gli URL di base per l’account di Adobe Acrobat Sign. Per eseguire questa operazione:

Clonare il profilo utente per la comunità

Per configurare i profili utente in modo che utilizzino il portale self-service Adobe Acrobat Sign, è necessario clonare e modificare uno dei profili standard. Per eseguire questa operazione:

Creare un account, un referente e un utente per la comunità

È necessario creare un account, un contatto e un utente per la community. 

Per abilitare gli utenti del portale, il proprietario dell’account deve essere assegnato a un ruolo. Per associare un ruolo al tuo utente Salesforce, passa a Configurazione > Amministrazione > Utenti > Utenti. Dall’elenco degli utenti seleziona Modifica per un utente e quindi nella pagina che si apre, apri il menu a discesa Ruolo > seleziona un ruolo > seleziona Salva.

Per creare un account:

Configurare la pagina della community SFDC

Configurare l’area di lavoro dell’esperienza per abilitare gli utenti

Impostare su Pubblico le impostazioni Visibilità profilo per l’impostazione E-mail dell’utente della comunità

Aggiungi il componente Adobe Simple Sign all’area di lavoro

Incorporare il codice Simple Sign nei componenti Lightning

Puoi incorporare il componente Simple Sign in un altro componente lightning utilizzando il seguente codice di esempio:

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

Quando incorpori il componente a livello di programmazione in un altro componente, puoi specificare parametri aggiuntivi:

• agreementId: ID Salesforce dell’accordo in corso o bozza. Per gli accordi impostati come bozza deve essere configurato il parametro Invia per conto di.
• templateId: ID Salesforce del modello che regola gli accordi generati.
• pollingInterval: tempo in millisecondi prima di ogni tentativo di recuperare l’URL di firma. Il valore minimo è 500, quello massimo è 50000 e quello predefinito è 1000.
• showSigningModal: se questa opzione è impostata su false, viene restituito solo il valore signingURL e non viene caricata la pagina della firma elettronica in una finestra modale in sovrapposizione. Se è impostato su true, viene restituito signingURL e la pagina della firma elettronica viene caricata nella finestra modale in sovrapposizione. Il valore predefinito è true.

I parametri sono soggetti a queste regole:

• È necessario specificare agreementID o templateID. Se sono specificati entrambi, verrà utilizzato agreementID. Se non ne viene specificato nessuno, viene restituito un errore.
• Quando si utilizza agreementID, l’accordo deve trovarsi in stato Bozza o Inviato per la firma, con almeno un destinatario che deve ancora firmare.
• Se l’accordo è in stato Bozza, verrà inviato così com’è e verrà mostrato l’URL per la firma.
• Se l’accordo è in corso, l’URL di firma viene recuperato e visualizzato.
• Se l’accordo è stato completato, viene visualizzato un errore.
• Quando si utilizza un ID modello, l’opzione Invio automatico è abilitata indipendentemente dall’impostazione.
• Quando si utilizza agreementID, viene rispettata l’impostazione di invio automatico definita dal modello.
• Nei modelli di accordi Simple Sign, il tipo di oggetto principale deve essere Contatto.
• Si consiglia vivamente di impostare Invia per conto di perché la maggior parte degli utenti della community solitamente non dispone di una licenza che consente l’invio.

Il componente può anche pubblicare gli eventi ai clienti. Di seguito è riportato un esempio di gestione eventi:

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

Nella tabella seguente sono elencati gli eventi disponibili:

Configurare il modello di accordo per Simple Sign

Concedere l’accesso ai dati di integrazione di Salesforce

Per impostazione predefinita, gli oggetti personalizzati del nostro pacchetto sono inizialmente impostati come “privati” per gli utenti esterni. I set di autorizzazioni per gli utenti della community consentono di accedere agli oggetti personalizzati e ai relativi campi, ma non ai record creati da altri utenti (sia interni che esterni).

All’interno dei portali della community, per impostare i flussi per la firma elettronica, gli amministratori dispongono delle due opzioni seguenti:

• Utilizzare i nostri componenti predefiniti (firma autonoma e firma semplice).
• Creare i propri flussi utilizzando le nostre API Apex. 

In entrambi i casi, gli amministratori spesso utilizzano i modelli di accordo per consentire agli utenti della community di avviare o partecipare ai flussi di firma elettronica. A tale scopo, gli utenti della community devono disporre dell’accesso in sola lettura ai modelli di accordo e alle risorse correlate, ad esempio gli oggetti di unione e mappatura dati, che vengono in genere creati da utenti interni.

Il tipo di licenza utente della community determina il modo in cui può essere concesso l’accesso:

• Licenza di accesso utente della community: gli amministratori possono abilitare “ViewAll” per i modelli di accordo e gli oggetti di mappatura unione/dati tramite il profilo utente della community per concedere l’accesso.
• Licenza di accesso utente della community PLUS e licenza utente della community partner: impossibile abilitare l’accesso “ViewAll” tramite il profilo. Per fornire l’accesso, gli amministratori devono utilizzare regole di condivisione basate sui ruoli.

Concedere l’accesso ai modelli di accordo e agli oggetti correlati

Per consentire agli utenti della community di creare accordi utilizzando i modelli di accordo, è necessario concedere loro l’accesso “Visualizza tutto” per accedere ai modelli di accordo e gli oggetti associati.

• Modello di accordo (echosign_dev1__Agreement_Template__c)
• Mappatura unione (echosign_dev1__SIGN_Merge_Mapping__c)

• Mappatura dati (echosign_dev1__SIGN_Data_Mapping__c)

Se i modelli del Document Builder di Acrobat Sign vengono utilizzati con il modello di accordo come file allegato, agli utenti della community deve essere consesso l’accesso per gli oggetti seguenti:

• Modello Document Builder (adobesign__Document_Template__c)

• Mappatura campi dell’oggetto (adobesign__Object_Field_Mapping__c)

Limitazioni di Simple Sign

• Se il modello non è configurato con Firma solo il mittente attivato, gli Utenti della community riscontreranno un errore che segnala che non è disponibile alcun URL di firma.

• Se il modello non dispone dell’opzione Abilita campi anteprima e posizione, l’accordo rimane in uno stato di pre-invio e non verrà caricato alcun URL di firma.

• Se il modello non dispone dell’opzione Abilita firma ospitata, le firme ospitate non saranno supportate.

• Simple Sign non supporta la delega.Gli altri destinatari non accederanno all’URL di firma.

• Simple Sign non supporta Sostituisci firmatario (una forma di delega).I nuovi firmatari non accederanno all’URL di firma.

• Per accedere alle note e agli allegati di un oggetto Salesforce, gli amministratori devono abilitare “Consenti agli utenti Cliente di accedere a note e allegati” nelle impostazioni delle community.