Nota:
Il pacchetto per flusso di lavoro SharePoint non è più disponibile per le nuove installazioni.
Microsoft ora supporta l’idea di flussi di lavoro tramite l’applicazione Microsoft Flow.
Flow è ora integrato in SharePoint e supportato da Adobe Sign.
Questa documentazione viene mantenuta per supportare i clienti del precedente pacchetto per flusso di lavoro.
Le azioni per flussi di lavoro di Adobe Sign per SharePoint Online consentono agli amministratori dei flussi di lavoro SharePoint di aggiungere le azioni di Adobe Sign ai flussi di lavoro SharePoint mediante SharePoint Workflow Designer. La soluzione è disponibile come plug-in per le istanze di Microsoft SharePoint Online. Consente agli utenti di creare un flusso di lavoro per un elenco personalizzato o una libreria di documenti, che gli utenti di SharePoint possono usare per:
- Inviare documenti a un unico destinatario o a un gruppo di destinatari tramite gli elenchi di SharePoint e dati di mappatura dagli elenchi di SharePoint nei documenti, quando questi vengono inviati per la firma.
- Verificare lo stato dell’accordo.
- Annullare l’accordo dopo che è stato inviato per la firma.
- Scaricare l’accordo firmato nell’allegato di un elenco (nel caso di elenchi personalizzati) o come un documento con nome diverso (nel caso di librerie documenti).
La soluzione Adobe Sign può essere installata e configurata solo da un amministratore di Microsoft SharePoint; per l'installazione, sono inoltre necessari privilegi di amministratore in un server SharePoint. Consulta la documentazione di SharePoint e l’amministratore SharePoint della tua organizzazione per delle autorizzazioni aggiuntive per i sistemi eventualmente necessarie per installare i plug-in di SharePoint. Per configurare la soluzione, è inoltre necessario un account di amministratore di Adobe Sign e disporre di accesso alla chiave API dell'account Adobe Sign. I requisiti di sistema illustrati di seguito includono i componenti sia server sia client necessari per installare ed eseguire correttamente Adobe Sign per SharePoint.
- Microsoft SharePoint in hosting
- Internet Explorer 11+
Nota:
Le azioni Ottieni stato accordo e Annulla accordo funzionano solo per i clienti che utilizzano l’istanza NA1.
1. Ottieni l’ultimo pacchetto .wsp dal tuo Success Manager (solo per installazioni esistenti).
- Nota: il pacchetto per flusso di lavoro è ora obsoleto e non è disponibile per le nuove installazioni. Consulta piuttosto le istruzioni su Microsoft Flow.
2. Passa a Raccolta siti > Impostazioni sito > Gallerie designer Web > Soluzioni
Nota: _catalogs/solutions/Forms/AllItems.aspx


4. Attiva la funzionalità del sito manualmente:
- Passa a Impostazioni sito > Azioni sito > Gestisci funzioni sito
- Fai clic sul pulsante Attiva accanto all'opzione Azioni del flusso di lavoro eSign di Adobe
- Fai clic sul pulsante Attiva accanto all'opzione Elenco di configurazione delle azioni del flusso di lavoro eSign di Adobe

L'inserimento dei dati nell'elenco delle configurazioni di eSign richiede di generare e immettere diversi campi univoci.
Si consiglia di aprire Blocco note o qualche altro editor di testo in modo da poter salvare le chiavi generate, per poi inserirle tutte in una volta.
È necessario:
- Generare il valore eSignIntegrationKey (nell'app di Adobe Sign)
- Ottenere il valore spTenantID in SharePoint
- Generare il valore spClientID e le chiavi spClientSecret in SharePoint
- Concedere le autorizzazioni per la nuova entità servizio in SharePoint
- Inserire eSignConnectorURL
Per generare una chiave di integrazione in Adobe Sign:
1. Accedi al tuo account di amministratore dell'account Adobe Sign
2. Passa a Account > API Adobe Sign > Informazioni API
3. Fai clic sul collegamento Chiave di integrazione al centro della pagina

Viene aperta l'interfaccia Crea chiave di integrazione:
1. Fornisci un nome intuitivo per la chiave (ad esempio SharePoint).
2. È necessario che i seguenti elementi della chiave di integrazione siano abilitati:
- agreement_read
- agreement_write
- agreement_send
- library_read

3. Una volta configurata la chiave, fai clic su Salva.
Viene visualizzata la pagina Token di accesso in cui sono riportate le chiavi definite nel tuo account.
4. Fai clic sulla definizione della chiave creata per SharePoint.
- Il collegamento Chiave di integrazione viene visualizzato sopra la descrizione.
5. Fai clic sul collegamento Chiave di integrazione.

Viene visualizzata la chiave di integrazione:
6. Copia questa chiave e salvala per aggiungerla all'elenco delle configurazioni di eSign
7. Fai clic su OK.
- A questo punto, l'operazione nell'applicazione Adobe Sign è terminata e puoi disconnetterti

Per ottenere il valore spTenantID:
1. Passa a Impostazioni sito > Utenti e autorizzazioni > Autorizzazioni app sito.
2. In Identificatore app, copia la parte dopo @
- ad esempio: i:0i.t|ms.sp.ext|d559ac84-d8e6-4515-9229-89w01@870fe83b-ye9d-96d3-n1d0-9et51ar2e792e

Per generare le chiavi spClientID e spClientSecret:
1. Nell'URL del sito SharePoint, dopo sharepoint.com/sites/{yoursite} incolla la stringa seguente: _layouts/15/appregnew.aspx

Nota:
Non dimenticare il carattere di sottolineatura davanti a layouts
- Si apre una nuova pagina che consente di generare entrambe le chiavi
2. Fai clic sui pulsanti Genera sia per ID cliente che per Segreto cliente
3. Copia entrambe le chiavi e salvale per inserirle nell'elenco delle configurazioni di eSign
4. Inserisci i seguenti valori letterali nei campi rimanenti:
- Titolo: Adobe Sign
- Dominio app: spintegration.echosign.com/sharepoint
- URL di reindirizzamento: https://spintegration.echosign.com/sharepoint

5. Fai clic su Crea
- In questo modo, puoi inserire la nuova entità servizio in Azure AD
- Puoi riutilizzare la stessa entità nelle raccolte siti
Concedi alla nuova entità servizio le autorizzazioni al sito nel modo seguente
1. Nell'URL del sito SharePoint, dopo sharepoint.com/sites/{il tuo sito} incolla la stringa seguente: _layouts/15/appinv.aspx
- È necessario eseguire questa operazione in tutti i siti dove è prevista l'esecuzione dei flussi di lavoro

Nota:
Non dimenticare il carattere di sottolineatura davanti a layouts
I campi devono includere il contenuto dell'applicazione del passaggio precedente:
- ID app: questo è l'ID cliente appena generato
- Titolo: Adobe Sign
- Dominio app: spintegration.echosign.com/sharepoint
- URL di reindirizzamento: https://spintegration.echosign.com/sharepoint
2. Copia e incolla il codice seguente nel campo XML richiesta di autorizzazione:
<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" /> </AppPermissionRequests>

Nota:
L'app consente all'utente di eseguire con le autorizzazioni dell'app (Controllo completo nell'esempio riportato sopra. Puoi ridurre la concessione delle autorizzazioni per consentire pieno controllo di un sito o un livello inferiore.)


1. Nell'opzione Contenuti sito del sito dove è stata attivata la funzione Elenco di configurazione del flusso di lavoro eSign di Adobe, individua e fai clic sull'elenco Configurazione di eSign
2. Crea un nuovo elemento per aprire un nuovo modulo di configurazione

3. Compila i seguenti valori:
- Titolo: “Configurazione”
- spClientID: inserisci il valore ID cliente indicato al Passaggio 3
- spClientSecret: inserisci il valore Segreto cliente indicato al Passaggio 3
- spTenantID: inserisci il valore ID tenant indicato al Passaggio 2
- eSignIntegrationKey: inserisci la chiave di integrazione di Adobe Sign indicata al Passaggio 1
- eSignConnectorURL: inserisci https://spintegration.echosign.com/sharepoint
- debugStatements: No
4. Fai clic su Salva.
Considerazioni relative alla sicurezza per la lettura dell'elenco di configurazione di eSign dall'azione del flusso di lavoro
È buona norma consentire solo agli amministratori della raccolta siti l'accesso all'elenco di configurazione di eSign.
Se il flusso di lavoro viene avviato dall'utente che ha accesso all'elenco di configurazione di eSign, il flusso di lavoro funziona senza problemi. Tuttavia, se l'utente non ha accesso all'elenco, le azioni del flusso di lavoro devono essere racchiuse nel passaggio dell'app.
1. Sul sito in cui il flusso di lavoro viene pubblicato
- Passa a Impostazioni sito > Funzioni sito
- Attiva la funzione I flussi di lavoro possono utilizzare le autorizzazioni app.
2. Ottieni l'ID dell'entità servizio del flusso di lavoro
- Passa a Impostazioni sito > Autorizzazioni app sito
Esempio: flusso di lavoro i:0i.t|ms.sp.ext|d55e6c84-d8e6-4515-9229-896we4554601@870f107b-dc9d-47d3-9ad0-9d851rr2e762e
3. Concedi le autorizzazioni all'entità servizio del flusso di lavoro in _layouts/15/appinv.aspx seguendo la stessa procedura illustrata per l'applicazione effettiva

4. Ritieni attendibile l'entità servizio del flusso di lavoro
A questo punto, il passaggio dell'app dovrebbe essere disponibile in SharePoint Designer (è necessario riavviare):

Scarica