DocumentazioneAEM as a Cloud ServiceGuida utente

As a Cloud Service Connetti AEM Forms con Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Intermedio
  • Amministratore
  • Utente
Versione
Collegamento articolo
AEM 6.5
Fai clic qui
AEM as a Cloud Service
Questo articolo

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:

  1. Un account sviluppatore Adobe Acrobat Sign attivo.
  2. Applicazione API Adobe Acrobat Sign.
  3. Credenziali (ID client e segreto client) dell'applicazione API Adobe Acrobat Sign.
  4. (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.

  1. Nell'istanza Autore 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 per archiviare i Cloud Service. Verificare che il nome della cartella non contenga spazio.

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

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

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

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

    Configurazione Adobe Acrobat Sign Solutions

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

  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 Acrobat Sign:

    1. Apri una finestra del browser e accedi al tuo account sviluppatore Adobe Acrobat Sign.

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

    3. Nella casella URL di reindirizzamento, aggiungi l'URL copiato in un passaggio precedente (passaggio 8) e fai clic su Salva.

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

    È possibile modificare il modificatore ambiti da self a account direttamente dall'interfaccia utente dell'AEM, come indicato nel passaggio 12.

    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.

    Configurazione OAuth

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

  12. Nella sezione Ambito autorizzazione è possibile modificare gli ambiti in "account" o "self" aggiungendo il prefisso "self" o "account" agli ambiti, in base alle esigenze.
    Ambito autorizzazione

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

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

    Configurazione cloud Adobe Acrobat Sign completata

  15. Seleziona Crea per creare la configurazione di Adobe Acrobat Sign.

  16. Seleziona la configurazione e fai clic su Publish, seleziona la configurazione e fai clic su Publish. Replica la configurazione negli ambienti di pubblicazione corrispondenti.

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

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

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:

Errore di configurazione

  1. Copiare l'URL presente nella finestra del browser corrente in un blocco note e rimuovere la parte /ui#/aem dall'URL.
  2. Apri una finestra del browser e accedi al tuo account sviluppatore Adobe Acrobat Sign.
  3. Selezionare l'applicazione configurata per AEM Forms e selezionare Configura OAuth per l'applicazione.
  4. 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

Flusso di lavoro Adobe Sign per enti pubblici

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

  1. Nell'istanza di Forms as a Cloud Service Author, 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 per archiviare i Cloud Service. Verificare che il nome della 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. Copiare l'URL della finestra del browser corrente in un blocco note e rimuovere /ui#/aem 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).

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

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

    Configurazione cloud Adobe Acrobat Sign completata

  9. Seleziona Crea per creare la configurazione.

  10. Seleziona la configurazione e fai clic su Publish, seleziona la configurazione e fai clic su Publish. Replica la configurazione negli ambienti di pubblicazione corrispondenti.

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

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.

Domande frequenti

  • Q: posso eseguire il rendering della pagina Adobe Sign GovCloud Signature in un iframe?
  • A: Sì, è possibile eseguire il rendering della pagina Adobe Sign GovCloud Signature in un iframe.
Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab