DocumentazioneAEM 6.5Guida utente

Integrare Adobe Sign con AEM Forms integrate-adobe-sign-with-aem-forms

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore
  • Utente
  • Sviluppatore

Adobe consiglia di utilizzare l'acquisizione dati moderna ed estensibile Componenti coreper la creazione di un nuovo Forms adattivoo l'aggiunta di Forms adattivo alle pagine AEM Sites. Questi componenti rappresentano un progresso significativo nella creazione di Forms adattivi, garantendo esperienze utente straordinarie. Questo articolo descrive un approccio precedente all’authoring di Forms adattivi utilizzando i componenti di base.

Versione
Collegamento articolo
AEM as a Cloud Service
Fai clic qui
AEM 6.5
Questo articolo

Adobe Sign abilita i flussi di lavoro di firma elettronica per i moduli adattivi. 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 connetti Adobe Sign a tutte le istanze di AEM Forms Author e Publish:

Prerequisiti prerequisites

Per integrare Adobe Sign con AEM Forms è necessario quanto segue:

  • Un account sviluppatore Adobe Sign attivo.
  • Un server SSL abilitato AEM Forms.
  • Applicazione API Adobe Sign.
  • Credenziali (ID client e segreto client) dell'applicazione API Adobe Sign.
  • Durante la riconfigurazione, rimuovere la configurazione Adobe Sign esistente sia dall'istanza di authoring che da quella di pubblicazione.
  • Utilizza chiave di crittografia identica per le istanze di authoring e pubblicazione.

Configura Adobe Sign con AEM Forms configure-adobe-sign-with-aem-forms

Dopo aver impostato i prerequisiti, eseguire la procedura seguente per configurare Adobe Sign con AEM Forms nell'istanza di authoring:

  1. Nell'istanza dell'autore Forms dell'AEM, passare a Strumenti martello > Generale > Browser configurazioni.

  2. Nella pagina Browser configurazioni, selezionare Crea.

  3. Nella finestra di dialogo Crea configurazione, specifica un Titolo per la configurazione, abilita Configurazioni cloud e seleziona Crea. Crea un contenitore di configurazione.

  4. Passa a Strumenti martello > Cloud Service > Adobe Sign e seleziona il contenitore di configurazione creato nel passaggio precedente.

    note note
    NOTE
    È possibile eseguire i passaggi da 1 a 4 per creare un contenitore di configurazione e creare una configurazione Adobe Sign nel contenitore oppure utilizzare la cartella global esistente in Strumenti martello > Cloud Service > Adobe Sign. Se crei la configurazione nel nuovo contenitore di configurazione, assicurati di specificare il nome del contenitore nel campo Contenitore configurazione al momento della creazione di un modulo adattivo.
    note note
    NOTE
    Verificare che l'URL della pagina Configurazione Cloud Service inizi con HTTPS. In caso contrario, abilita SSL per il server AEM Forms.

  5. Nella pagina di configurazione, toccare Crea per creare la configurazione Adobe Sign nell'AEM Forms.

  6. Nella scheda Generale della pagina Crea configurazione Adobe Sign, specifica Nome per la configurazione e tocca Avanti. Facoltativamente, puoi specificare un titolo e cercare la miniatura da configurare.

  7. Ora puoi Selezionare la soluzione per selezionare Adobe Acrobat Sign.

    Adobe Acrobat Sign Solutions

  8. Copiare l'URL 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. Tocca Avanti.

  9. 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.

  10. Configurare le impostazioni OAuth per l'applicazione Adobe Sign:

    1. Apri una finestra del browser e accedi all'account sviluppatore Adobe Sign.

    2. Selezionare l'applicazione configurata per l'AEM Forms e selezionare Configura OAuth per l'applicazione.

    3. Copia l'ID client e il Segreto client in un blocco note.

    4. Nella casella URL di reindirizzamento, aggiungi l'URL HTTPS copiato nel passaggio precedente.

    5. Abilitare le seguenti impostazioni OAuth per l'applicazione Adobe Sign e fare clic su Salva.

    • agreement_read
    • agreement_write
    • agreement_send
    • widget_write
    • workflow_read

    Per informazioni dettagliate su come configurare le impostazioni OAuth per un'applicazione Adobe Sign e ottenere le chiavi, vedere Configurare le impostazioni OAuth per la documentazione per gli sviluppatori dell'applicazione.

    Configurazione OAuth

  11. Torna alla pagina Crea configurazione Adobe Sign. Nella scheda Impostazioni, specifica l'ID client (noto anche come ID applicazione) e il Segreto client. Utilizza l'ID client e segreto client dell'applicazione Adobe Sign creata per AEM Forms.

  12. Seleziona l'opzione Abilita Adobe Sign per gli allegati anche per aggiungere i file allegati a un modulo adattivo al documento Adobe Sign corrispondente inviato per la firma.

  13. 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 Sign.

    Configurazione cloud Adobe Acrobat Sign completata

  14. Tocca Crea per creare la configurazione di Adobe Sign.

  15. Apri la console web AEM. URL: https://'[server]:[port]'/system/console/configMgr

  16. Apri Servizio di configurazione comune di Forms.

  17. Nel campo Consenti, seleziona Tutti gli utenti - Tutti gli utenti, anonimi o connessi, possono visualizzare in anteprima gli allegati, verificare e firmare i moduli e fare clic su Salva.L'istanza Autore è configurata per l'utilizzo di Adobe Sign.

  18. Publish la configurazione.

  19. Utilizza replica per creare una configurazione identica nelle istanze di pubblicazione corrispondenti.

Ora Adobe Sign è integrato con AEM Forms ed è pronto per essere utilizzato nei moduli adattivi. Per utilizzare il servizio Adobe Sign in un modulo adattivo, specifica il contenitore di configurazione creato in precedenza nelle proprietà del modulo adattivo.

NOTE
Per configurare la sandbox di Adobe Sign, puoi seguire gli stessi passaggi di configurazione descritti in Adobe Sign.

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

adobe-acrobat-sign-govt-workflow

Prima di iniziare prerequisites-for-adobe-sign-for-acrobat-sign-for-government

Prima di iniziare a collegare AEM Forms alla soluzione Adobe Acrobat Sign,

Connettere AEM Forms ad Adobe Acrobat Sign Solutions for Government connect-adobe-acrobat-sign-for-government

Creare un URL di reindirizzamento per l’istanza AEM

  1. Nell'istanza di AEM Forms, passa a Strumenti martello > Generale > Browser configurazioni.

  2. Nella pagina Browser configurazioni, selezionare Crea.

  3. Nella finestra di dialogo Crea configurazione, specifica un Titolo per la configurazione, abilita Configurazioni cloud e seleziona Crea. Crea un contenitore di configurazione. Assicurati che il nome del contenitore/cartella non contenga spazio.

  4. Passa a Strumenti martello > 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.

  5. Nella pagina di configurazione, seleziona Crea per creare la configurazione Adobe Acrobat Sign in AEM Forms.

  6. Copia l’URL della finestra del browser corrente in un blocco note dall’URL. Questo URL è denominato re-direct URL. Nella sezione successiva, condividi re-direct URL e Scopes con il team di Adobe Sign e richiedi le credenziali (ID client e Segreto client).

NOTE
  • Un dominio re-direct URL deve contenere un dominio di primo livello. Ad esempio https://adobe.com/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global
  • Non utilizzare un URL locale come re-direct URL. Esempio: https://localhost:4502/libs/adobesign/cloudservices/adobesign/createcloudconfigwizard/cloudservices.html/conf/global.

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 collegare 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 rappresentante di Adobe Acrobat Sign for Government Solution membro del team Adobe Professional Services.

Ambiti

  • agreement_read
  • agreement_write
  • agreement_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

  1. Apri re-direct URL nel browser. Hai creato e annotato re-direct URL nell'ultimo passaggio della sezione Creare un URL di reindirizzamento nell'istanza AEM.

  2. 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.

  3. Nella scheda Impostazioni della pagina Crea configurazione Adobe Sign, per l'opzione Seleziona soluzione, selezionare Adobe Acrobat Sign Solutions for Government.

    Adobe Acrobat Sign Solutions per enti pubblici

  4. Nel campo E-mail, specifica l'indirizzo e-mail associato al tuo account Adobe Acrobat Sign Solutions for Government.

  5. 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.

  6. 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].

  7. 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.

  8. 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 Adobe Acrobat Sign for Government Solutions e , 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.

    Configurazione cloud Adobe Acrobat Sign completata

    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 account e fare clic su Consenti accesso.

  9. Seleziona Crea per creare la configurazione.

  10. Apri la console web AEM. URL: https://'[server]:[port]'/system/console/configMgr

  11. Apri Servizio di configurazione comune di Forms.

  12. Nel campo Consenti, seleziona Tutti gli utenti - Tutti gli utenti, anonimi o connessi, possono visualizzare in anteprima gli allegati, verificare e firmare i moduli e fare clic su Salva.L'istanza Autore è configurata per l'utilizzo di Adobe Sign.

  13. Publish la configurazione.

  14. Utilizza replica per creare una configurazione identica nelle istanze di pubblicazione corrispondenti.

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 Sign per sincronizzare lo stato di firma configure-adobe-sign-scheduler-to-sync-the-signing-status

Un modulo adattivo abilitato per Adobe Sign viene inviato solo dopo che tutti i firmatari hanno completato il processo di firma. Per impostazione predefinita, i servizi di pianificazione Adobe Sign controllano la risposta del firmatario (polling) ogni 24 ore. È possibile modificare l’intervallo predefinito per l’ambiente. Per modificare l’intervallo predefinito, effettua le seguenti operazioni:

  1. Accedi al server AEM Forms con le credenziali di amministratore e passa a Strumenti > Operazioni > Console Web.

    Puoi anche aprire il seguente URL in una finestra del browser:
    https://[localhost]:'port'/system/console/configMgr

  2. Individua e apri l'opzione Servizio di configurazione Adobe Sign. Specifica un'espressione cron nel campo Espressione modulo di pianificazione aggiornamento stato e fai clic su Salva. Ad esempio, per eseguire il servizio di configurazione ogni giorno alle 00:00, specificare 0 0 0 1/1 * ? * nel campo Espressione modulo di pianificazione aggiornamenti stato.

L'intervallo predefinito per sincronizzare lo stato di Adobe Sign è ora modificato.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2