As a Cloud Service Connetti AEM Forms con Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms
Adobe Acrobat Sign abilita i flussi di lavoro di firma elettronica per i flussi di lavoro di Forms adattivo e AEM. Le firme elettroniche consentono di migliorare i flussi di lavoro per l'elaborazione di documenti relativi a questioni legali, vendite, retribuzioni, gestione delle risorse umane e molte altre aree.
In uno scenario tipico di Adobe Acrobat Sign e Forms adattivo, un utente compila un modulo adattivo da applicare a un servizio. Ad esempio, la richiesta di una carta di credito e il modulo relativo ai benefit per i cittadini. Quando un utente compila, invia e firma il modulo di richiesta, questo viene inviato al fornitore di servizi per ulteriori azioni. Il provider di servizi esamina l'applicazione e utilizza Adobe Acrobat Sign per contrassegnarla come approvata. AEM Forms supporta sia Adobe Acrobat Sign che Adobe Acrobat Sign Solutions for Government. A seconda della licenza e dei requisiti, puoi integrare o collegare AEM Forms con una delle seguenti soluzioni:
Collegare AEM Forms a Adobe Acrobat Sign adobe-sign
Per connettere AEM Forms a Adobe Acrobat Sign, configura il software e gli account elencati nella sezione dei prerequisiti e configura Adobe Sign Cloud Service nelle istanze Forms as a Cloud Service Author e Publish:
Prerequisiti per collegare AEM Forms a Adobe Acrobat Sign prerequisites-for-adobe-sign
Per integrare Adobe Acrobat Sign con AEM Forms è necessario eseguire l'installazione seguente:
- Un account sviluppatore Adobe Acrobat Sign attivo.
- Applicazione API Adobe Acrobat Sign.
- Credenziali (ID client e segreto client) dell'applicazione API Adobe Acrobat Sign.
- (Solo per autenticazione basata su documento ufficiale) Abilitare il metodo di autenticazione per l'autenticazione tramite documento ufficiale.
Connettere le istanze di authoring e pubblicazione di AEM Forms con Adobe Acrobat Sign configure-adobe-sign-with-aem-forms
Dopo aver impostato i prerequisiti, eseguire la procedura seguente per configurare Adobe Acrobat Sign con AEM Forms nelle istanze di authoring.
-
Nell'istanza Autore AEM Forms, passa a Strumenti > Generale > Browser configurazioni.
-
Nella pagina Browser configurazioni, selezionare Crea.
-
Nella finestra di dialogo Crea configurazione, specifica un Titolo per la configurazione, abilita Configurazioni cloud e seleziona Crea. Crea un contenitore di configurazione per archiviare i Cloud Service. Verificare che il nome della cartella non contenga spazio.
-
Passa a Strumenti > Cloud Service > Adobe Acrobat Sign e apri il contenitore di configurazione creato nel passaggio precedente.
note note NOTE Quando crei un modulo adattivo, specifica il nome del contenitore nel campo Contenitore configurazione. -
Nella pagina di configurazione, seleziona Crea per creare la configurazione Adobe Acrobat Sign in AEM Forms.
-
Nella scheda Generale della pagina Crea configurazione Adobe Acrobat Sign, specifica un Nome per la configurazione e seleziona Avanti. Facoltativamente, puoi specificare un Titolo e cercare di selezionare una Miniatura per la configurazione.
-
Ora puoi Selezionare la soluzione per selezionare Adobe Acrobat Sign.
-
Copiare l'URL presente nella finestra del browser corrente in un blocco note e rimuovere la parte
/ui#/aem
dall'URL. L'URL modificato è quindi necessario per configurare l'applicazione Adobe Acrobat Sign con AEM Forms, in un passaggio successivo. Seleziona Avanti. -
Nella scheda Impostazioni,
-
il campo URL OAuth contiene l'URL predefinito che include la partizione del database di Adobe Sign. Il formato dell’URL è:
https://<shard>/public/oauth/v2
Ad esempio:
https://secure.na1.echosign.com/public/oauth/v2
-
il campo URL token di accesso contiene l'URL predefinito che include la partizione del database di Adobe Sign. Il formato dell’URL è:
https://<shard>/oauth/v2/token
Ad esempio:
https://api.na1.echosign.com/oauth/v2/token
Dove:
na1 fa riferimento alla partizione di database predefinita. È possibile modificare il valore della partizione del database. Verificare che le Adobe Acrobat Sign configurazioni cloud puntino alla partizione corretta.
note note NOTE - Mantieni aperta la pagina Crea configurazione Adobe Acrobat Sign. Non chiuderlo. È possibile recuperare ID client e Segreto client dopo aver configurato le impostazioni OAuth per l'applicazione Adobe Acrobat Sign come descritto nei passaggi successivi.
- Dopo aver effettuato l'accesso all'account Adobe Sign, passa a API Acrobat Sign > Informazioni API > Documentazione dei metodi REST API > Token di accesso OAuth per accedere alle informazioni relative all'URL OAuth di Adobe Sign e all'URL del token di accesso.
-
-
Configurare le impostazioni OAuth per l'applicazione Adobe Acrobat Sign:
-
Apri una finestra del browser e accedi al tuo account sviluppatore Adobe Acrobat Sign.
-
Selezionare l'applicazione configurata per AEM Forms e selezionare Configura OAuth per l'applicazione.
-
Nella casella URL di reindirizzamento, aggiungi l'URL copiato in un passaggio precedente (passaggio 8) e fai clic su Salva.
-
Abilitare l'ambito seguente per l'applicazione Adobe Acrobat Sign e fare clic su Salva.
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
Per informazioni dettagliate su come configurare le impostazioni OAuth per un'applicazione Adobe Acrobat Sign e ottenere le chiavi, vedere Configurare le impostazioni OAuth per la documentazione per gli sviluppatori dell'applicazione.
-
-
Tornare alla pagina Crea configurazione Adobe Acrobat Sign. Nella scheda Impostazioni, specifica [ID client (noto anche come ID applicazione) e Segreto client]. Utilizza l'ID client e segreto client dell'applicazione Adobe Acrobat Sign creati nel passaggio precedente.
-
Selezionare l'opzione Abilita Adobe Acrobat Sign per gli allegati per aggiungere i file allegati a un modulo adattivo al documento Adobe Acrobat Sign corrispondente inviato per la firma.
-
Selezionare Connetti a Adobe Acrobat Sign. Quando vengono richieste le credenziali, fornire nomeutente e password dell'account utilizzato durante la creazione dell'applicazione Adobe Acrobat Sign. Quando viene richiesto di confermare, accedere a
your developer account
, fare clic su Consenti accesso. Se le credenziali sono corrette e si consente a AEM Forms di accedere all'account sviluppatore Adobe Acrobat Sign, verrà visualizzato un messaggio di operazione riuscita simile al seguente. -
Seleziona Crea per creare la configurazione di Adobe Acrobat Sign.
-
Seleziona la configurazione e fai clic su Publish, seleziona la configurazione e fai clic su Publish. Replica la configurazione negli ambienti di pubblicazione corrispondenti.
-
Ripeti tutti i passaggi precedenti per le istanze di sviluppo, stage e produzione (qualsiasi sia rimasto) per completare la configurazione di Adobe Acrobat Sign con AEM Forms per il tuo ambiente.
Ora puoi utilizzare l'aggiunta di campi Adobe Acrobat Sign a un modulo adattivo. Assicurarsi di aggiungere il contenitore di configurazione utilizzato per il Cloud Service a tutti i Forms adattivi abilitati per Adobe Acrobat Sign. È possibile specificare un contenitore di configurazione dalle proprietà di un modulo adattivo.
Risoluzione dei problemi resolve-config-error
Quando si connette Adobe Acrobat Sign a AEM Forms e si trova un errore Unable to authorize access because the client configuration is invalid: invalid_request
, come illustrato nell'immagine seguente. Per risolvere il problema, segui questi passaggi:
- Copiare l'URL presente nella finestra del browser corrente in un blocco note e rimuovere la parte
/ui#/aem
dall'URL. - Apri una finestra del browser e accedi al tuo account sviluppatore Adobe Acrobat Sign.
- Selezionare l'applicazione configurata per AEM Forms e selezionare Configura OAuth per l'applicazione.
- Nella casella URL di reindirizzamento, aggiungi l'URL copiato in un passaggio precedente e fai clic su Salva.
Collegare AEM Forms ad Adobe Acrobat Sign Solutions for Government adobe-acrobat-sign-for-government
La connessione di AEM Forms ad Adobe Acrobat Sign Solutions for Government è un processo in più fasi. Comporta:
- Creazione di un URL di reindirizzamento per le istanze AEM
- Condivisione dell’URL di reindirizzamento e degli ambiti con il team Adobe Sign Solutions for Government
- Ricezione delle credenziali dal team di Adobe Sign
- Utilizzo delle credenziali ricevute per collegare AEM Forms ad Adobe Acrobat Sign Solutions for Government
AEM Forms as a Cloud Service fornisce ambienti di sviluppo, staging e produzione. È possibile iniziare con la connessione dell’ambiente di sviluppo per con Adobe Acrobat Sign Solutions for Government e collegare successivamente l’area di visualizzazione e gli ambienti di produzione.
Prima di iniziare prerequisites-for-adobe-sign-for-acrobat-sign-for-government
Prima di iniziare a collegare AEM Forms con la soluzione Adobe Acrobat Sign, assicurati che sia stato eseguito il provisioning del tuo account Adobe Acrobat Sign Solutions for Government.
Collegare AEM Forms as a Cloud Service ad Adobe Acrobat Sign Solutions for Government connect-adobe-acrobat-sign-for-government
Creare un URL di reindirizzamento per l’istanza AEM
- Nell'istanza di Forms as a Cloud Service Author, passare a Strumenti > Generale > Browser configurazioni.
- Nella pagina Browser configurazioni, selezionare Crea.
- Nella finestra di dialogo Crea configurazione, specifica un Titolo per la configurazione, abilita Configurazioni cloud e seleziona Crea. Crea un contenitore di configurazione per archiviare i Cloud Service. Verificare che il nome della cartella non contenga spazio.
- Passa a Strumenti > Cloud Service > Adobe Acrobat Sign e apri il contenitore di configurazione creato nel passaggio precedente. Quando crei un modulo adattivo, specifica il nome del contenitore nel campo Contenitore configurazione.
- Nella pagina di configurazione, seleziona Crea per creare la configurazione Adobe Acrobat Sign in AEM Forms.
- Copiare l'URL della finestra del browser corrente in un blocco note e rimuovere
/ui#/aem
dall'URL. Questo URL è denominatore-direct URL
.
Nella sezione successiva, condividire-direct URL
eScopes
con il team di Adobe Sign e richiedi le credenziali (ID client e Segreto client).
Condividi l’URL di reindirizzamento e gli ambiti con il team di Adobe Sign e ricevi le credenziali
Il team Adobe Acrobat Sign for Government Solutions richiede che re-direct URL
e gli ambiti specifici siano abilitati per l'applicazione Adobe Acrobat Sign (elencata di seguito) per generare le credenziali (ID client e segreto client) che consentono di connettere AEM Forms ad Adobe Acrobat Sign Solutions for Government.
Condividi scopes
(elencato di seguito) e re-direct URL
creati e annotati nell'ultimo passaggio della sezione precedente con il tuo rappresentante Adobe Acrobat Sign for Government Solution (membro del team Adobe Professional Services).
Ambiti
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
- offline_access
Il rappresentante genera e condivide le credenziali con te. Nella sezione successiva utilizzi le credenziali (ID client e Segreto client) per collegare AEM Forms ad Adobe Acrobat Sign Solutions for Government.
Utilizza le credenziali ricevute per collegare AEM Forms ad Adobe Acrobat Sign Solutions for Government
-
Apri
re-direct URL
nel browser. Hai creato e annotatore-direct URL
nell'ultimo passaggio della sezione Creare un URL di reindirizzamento nell'istanza AEM. -
Nella scheda Generale della pagina Crea configurazione Adobe Sign, specifica un Nome per la configurazione e seleziona Avanti. Facoltativamente, puoi specificare un Titolo e cercare di selezionare una Miniatura per la configurazione. Fai clic su Avanti.
-
Nella scheda Impostazioni della pagina Crea configurazione Adobe Sign, per l'opzione Seleziona soluzione, selezionare Adobe Acrobat Sign Solutions for Government.
-
Nel campo E-mail, specifica l'indirizzo e-mail associato al tuo account Adobe Acrobat Sign Solutions for Government.
-
Nella scheda Impostazioni,
-
il campo URL OAuth contiene l'URL predefinito che include la partizione del database di Adobe Sign. Il formato dell’URL è:
https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize
Ad esempio:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize
-
il campo URL token di accesso contiene l'URL predefinito che include la partizione del database di Adobe Sign. Il formato dell’URL è:
https://<shard>/api/gateway/adobesignauthservice/api/v1/token
Ad esempio:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token
Dove:
na1 fa riferimento alla partizione di database predefinita. È possibile modificare il valore della partizione del database. Verificare che le Adobe Acrobat Sign configurazioni cloud puntino alla partizione corretta.
note note NOTE - Dopo aver effettuato l'accesso al tuo account Adobe Sign, passa a API Acrobat Sign > Informazioni API > Documentazione dei metodi REST API > Token di accesso OAuth per accedere alle informazioni relative all'URL Adobe Sign oAuth e all'URL del token di accesso.
-
-
Utilizza le credenziali condivise da Adobe Acrobat Sign per il rappresentante di soluzioni governative ([membro del team Adobe Professional Services]) nella sezione precedente come [ID client e Segreto client].
-
Selezionare l'opzione Abilita Adobe Acrobat Sign per gli allegati per aggiungere i file allegati a un modulo adattivo al documento Adobe Acrobat Sign corrispondente inviato per la firma.
-
Seleziona Connetti ad Adobe Sign. Quando vengono richieste le credenziali, specificare il nome utente e la password dell'account utilizzato durante la creazione dell'applicazione Adobe Acrobat Sign. Quando viene richiesto di confermare l'accesso per
your developer account
, fare clic su Consenti accesso. Se le credenziali sono corrette e si consente a AEM Forms di accedere all'account sviluppatore Adobe Acrobat Sign, verrà visualizzato un messaggio di operazione riuscita simile al seguente. -
Seleziona Crea per creare la configurazione.
-
Seleziona la configurazione e fai clic su Publish, seleziona la configurazione e fai clic su Publish. Replica la configurazione negli ambienti di pubblicazione corrispondenti.
-
Ripeti tutti i passaggi precedenti per le istanze di sviluppo, stage e produzione (qualsiasi sia rimasto) per completare la configurazione di Adobe Acrobat Sign Solutions for Government con AEM Forms per il tuo ambiente.
Ora puoi utilizzare Aggiungi campi Adobe Acrobat Sign in un modulo adattivo o flusso di lavoro AEM. Assicurarsi di aggiungere il contenitore di configurazione utilizzato per la configurazione del Cloud Service a tutto il Forms adattivo abilitato per Adobe Acrobat Sign. È possibile specificare un contenitore di configurazione dalle proprietà di un modulo adattivo.
Configura l'utilità di pianificazione Adobe Acrobat Sign per sincronizzare lo stato di firma configure-adobe-sign-scheduler-to-sync-the-signing-status
AEM Forms as a Cloud Service fornisce un servizio di pianificazione che controlla lo stato dei firmatari a intervalli definiti. Gli scenari in cui si configura il servizio di pianificazione:
- Se si utilizza Invia il modulo (dopo che ogni destinatario ha completato la cerimonia di firma) per firmare un documento, il modulo verrà inviato solo dopo che tutti i firmatari avranno firmato il modulo.
- Se si utilizza il passaggio di firma in un flusso di lavoro AEM per firmare un documento, il passaggio di firma attende che tutti i firmatari firmino il documento prima di procedere al passaggio successivo del flusso di lavoro.
Per impostazione predefinita, i servizi di pianificazione Adobe Acrobat Sign controllano (polling) la risposta del firmatario dopo ogni 24 ore. È possibile modificare l’intervallo predefinito per l’ambiente.
Per modificare l'intervallo predefinito, specificare un'espressione cron per la proprietà sign.status.exp della configurazione Servizio di configurazione di Adobe Acrobat Sign.
Ad esempio, per eseguire il servizio di configurazione ogni giorno alle 00:00, impostare la proprietà sign.status.exp della configurazione Servizio di configurazione di Adobe Acrobat Sign per specificare 0 0 0 1/1 * ? *
. Il seguente file JSON mostra l’esempio per eseguire il servizio di configurazione ogni giorno alle 00:00:
{
"sign.status.exp":"0 0 0 1/1 * ? *"
}
Per impostare i valori di una configurazione, Genera configurazioni OSGi utilizzando l'SDK AEM e distribuisci la configurazione nell'istanza di Cloud Service.