API di comunicazione di AEM Forms as a Cloud Service frequently-asked-questions
La funzionalità di comunicazione consente di creare documenti approvati, personalizzati e standardizzati per il marchio, ad esempio corrispondenze aziendali, dichiarazioni, lettere di elaborazione delle richieste di rimborso, note sui benefit, fatture mensili o kit di benvenuto.
La funzionalità fornisce API per generare e manipolare i documenti. È possibile generare o manipolare un documento su richiesta oppure creare un processo batch per generare più documenti a intervalli definiti. Le API di comunicazione forniscono:
-
funzionalità ottimizzate di generazione della documentazione on-demand e batch.
-
capacità di combinare, ridisporre e convalidare documenti PDF su richiesta.
-
API HTTP per una più semplice integrazione con sistemi esterni. Sono incluse API separate per le operazioni on-demand (bassa latenza) e batch (operazioni con produttività elevata).
-
un accesso sicuro ai dati. Le API di comunicazione si connettono e accedono ai dati solo dagli archivi di dati designati dal cliente e dalla cliente, il che rende le comunicazioni estremamente sicure.
Generazione di documenti
Le API di comunicazione per la generazione di documenti consentono di combinare un modello (XFA o PDF) con i dati dei clienti e delle clienti (XML) per generare documenti in formati PDF e Print come i formati PS, PCL, DPL, IPL e ZPL. Queste API utilizzano modelli PDF e XFA con dati XML per generare un singolo documento su richiesta o più documenti utilizzando un processo batch.
In genere, si crea un modello con Designer e si utilizzano le API di comunicazione per unire i dati al modello. L’applicazione può inviare il documento di output a una stampante di rete, a una stampante locale o a un sistema di archiviazione. I flussi di lavoro predefiniti e personalizzati si presentano così:
A seconda del tipo di uso, è possibile rendere disponibili questi documenti anche per il download tramite il sito web o un server di archiviazione.
Alcuni esempi di API per la generazione di documenti:
Creazione di documenti PDF create-pdf-documents
Le API per la generazione dei documenti possono essere utilizzate per creare un documento PDF basato sulla struttura di un modulo e sui dati del modulo XML. L’output è un documento PDF non interattivo. In altre parole, gli utenti non possono inserire o modificare i dati del modulo. Un flusso di lavoro fondamentale consiste nell’unire i dati del modulo XML a una struttura del modulo per creare un documento PDF. Nell’immagine seguente viene illustrata l’unione della struttura di un modulo e dei dati del modulo XML per produrre un documento PDF.
Figura: flusso di lavoro tipico per la creazione di un documento PDF
Creazione di documenti PostScript (PS), PCL (Printer Command Language) e Zebra Printing Language (ZPL) create-PS-PCL-ZPL-documents
È possibile utilizzare le API di generazione dei documenti per creare documenti PostScript (PS), Printer Command Language (PCL) e Zebra Printing Language (ZPL) basati su un progetto di modulo XDP o su un documento PDF. Queste API consentono di unire la struttura di un modulo ai dati del modulo per generare un documento. È possibile salvare il documento in un file e sviluppare un processo personalizzato per inviarlo a una stampante.
Elaborazione di dati batch per creare più documenti processing-batch-data-to-create-multiple-documents
Le API per la generazione di documenti possono essere utilizzate per creare documenti separati per ogni record all’interno di una fonte di dati batch XML. Puoi generare documenti in blocco e in modalità asincrona. Puoi configurare vari parametri per la conversione e quindi avviare l’elaborazione in batch.
Manipolazione documento
Le API per la manipolazione dei documenti di comunicazione (Document Transformation) consentono di combinare e ridisporre i documenti di PDF. In genere, si crea un DDX e lo si invia alle API di manipolazione dei documenti per assemblare o ridisporre un documento. Il Documento DDX fornisce istruzioni su come utilizzare i documenti di origine per produrre un set di documenti richiesti. La documentazione di riferimento DDX fornisce informazioni dettagliate su tutte le operazioni supportate. Alcuni esempi di manipolazione dei documenti sono:
assemblare documenti PDF
È possibile utilizzare le API di manipolazione dei documenti per assemblare due o più documenti PDF o XDP in un singolo documento PDF o Portfolio PDF. Di seguito sono riportati alcuni dei modi in cui è possibile assemblare i documenti PDF:
- Assemblare un semplice documento PDF
- Creare un portfolio PDF
- Assemblare documenti crittografati
- Assemblare documenti utilizzando la numerazione Bates
- Uniformare e assemblare documenti
Figura: assemblaggio di un semplice documento PDF da più documenti PDF
Separare i documenti PDF
È possibile utilizzare le API di manipolazione del documento per smontare un documento PDF. Le API possono estrarre pagine dal documento di origine o dividere un documento di origine basato sui segnalibri. In genere, questa attività è utile se il documento PDF è stato creato in origine da molti documenti singoli, ad esempio da una raccolta di istruzioni.
- Estrarre pagine da un documento di origine
- Dividere un documento di origine basato sui segnalibri
Figura: dividere un documento di origine basato sui segnalibri in più documenti
Estrazione documento
La funzionalità di estrazione dei documenti si trova nel programma Early Adopter. Per partecipare al programma per i primi utilizzatori, richiedi l’accesso alla funzionalità inviando una e-mail dal tuo account ufficiale all’indirizzo aem-forms-ea@adobe.com.
Il servizio di estrazione documenti consente di ottenere le proprietà di un documento PDF, ad esempio i diritti di utilizzo, le proprietà e i metadati del PDF. Le funzionalità di estrazione dei documenti sono:
- Ottiene le proprietà di un documento PDF, ad esempio se il PDF dispone di allegati, commenti, versione Acrobat e molto altro.
- Estrai i diritti di utilizzo abilitati in un documento PDF, gli utenti recuperano i diritti di utilizzo abilitati o disabilitati in un documento PDF per l’estensibilità di Adobe Acrobat Reader.
- Ottenere le informazioni sui metadati presenti in un documento PDF; i metadati sono informazioni sul documento, distinte dal contenuto del documento, ad esempio testo e grafica. L'Adobe Piattaforma di metadati estensibili (XMP) è uno standard per la gestione dei metadati dei documenti. Il servizio XMP Utilities può recuperare i metadati XMP dai documenti PDF ed esportare i metadati XMP nei documenti PDF.
La documentazione di riferimento API fornisce informazioni dettagliate su tutti i parametri, i metodi di autenticazione e i servizi forniti dalle API. La documentazione di riferimento API è disponibile anche in formato .yaml. Puoi scaricare il file .yaml e caricarlo su Postman per verificare la funzionalità delle API.
Conversione documento
Convertire e convalidare documenti conformi a PDF/A
Le API per la conversione di documenti di comunicazione consentono di convertire un documento PDF in PDF/A. È possibile utilizzare le API per convertire un documento PDF in un documento conforme a PDF/A e anche per determinare se un documento PDF è conforme a PDF/A. PDF/A è un formato di archiviazione destinato alla conservazione a lungo termine del contenuto del documento. I font vengono incorporati nel documento e il file non è compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non include contenuti audio e video.
Converti PDF in XDP convert-pdf-to-xdp
La funzionalità Converti PDF in XDP si trova nel programma Early Adopter. Per partecipare al programma per i primi utilizzatori, richiedi l’accesso alla funzionalità inviando una e-mail dal tuo account ufficiale all’indirizzo aem-forms-ea@adobe.com.
Converte un documento PDF in un file XDP. Affinché un documento PDF possa essere convertito correttamente in un file XDP, il documento PDF deve contenere un flusso XFA nel dizionario.
Document Assurance doc-assurance
Il servizio DocAssurance include le API Signature e Encryption:
API di firma
Le API di firma consentono all’organizzazione di proteggere la sicurezza e la privacy dei documenti Adobe PDF che distribuisce e riceve. Le funzionalità di protezione vengono applicate al documento stesso, che rimane protetto e controllato per l'intero ciclo di vita. Il documento rimane protetto oltre il firewall, quando viene scaricato offline e quando viene inviato nuovamente alla tua organizzazione. Puoi eseguire le seguenti attività utilizzando le API di firma:
- Aggiungere un campo di firma visibile a un documento PDF.
- Aggiungere un campo firma invisibile a un documento PDF.
- Firma il campo della firma specificato in un documento PDF.
- Certifica un documento PDF
API di crittografia
Le API di crittografia consentono di crittografare e decrittografare i documenti. Quando un documento viene crittografato, il suo contenuto diventa illeggibile. Un utente autorizzato può decrittografare il documento per ottenere l’accesso al contenuto. Se un documento PDF è crittografato con una password, l’utente deve specificare la password di apertura prima che il documento possa essere visualizzato in Adobe Reader o Adobe Acrobat.
Puoi eseguire queste attività utilizzando le API di crittografia:
- Crittografa un documento PDF con una password.
- Rimuovere la crittografia basata su password da un documento PDF.
- Recuperare il tipo di protezione applicato a un documento PDF.
- Restituisce il tipo di protezione applicato a un documento PDF.
Sia le API di firma che quelle di crittografia sono API sincrone.
Utilità documenti doc-utility
Le utilità per documenti con API sincrone consentono di convertire i documenti tra i formati di file PDF e XDP. Applicare i diritti di utilizzo a un documento ed estrarre i diritti di utilizzo attivati da un documento. Eseguire una query sulle informazioni relative a un documento PDF. I dettagli delle API per i diritti di utilizzo sono riportati di seguito:
API per i diritti di utilizzo (estensione Reader)
La funzionalità Diritti di utilizzo (estensione Reader) è inclusa nel programma Early Adopter. Per partecipare al programma per i primi utilizzatori, richiedi l’accesso alla funzionalità inviando una e-mail dal tuo account ufficiale all’indirizzo aem-forms-ea@adobe.com.
La funzionalità Diritti di utilizzo consente all’organizzazione di condividere facilmente i documenti interattivi di PDF estendendo la funzionalità di Adobe Reader con diritti di utilizzo aggiuntivi. Il servizio funziona con Adobe Reader 7.0 o versione successiva e aggiunge diritti di utilizzo a un documento PDF. Questa azione attiva caratteristiche che in genere non sono disponibili quando un documento PDF viene aperto mediante Adobe Reader, ad esempio l’aggiunta di commenti a un documento, la compilazione di moduli e il salvataggio del documento.
Quando ai documenti PDF vengono aggiunti i diritti di utilizzo appropriati, i destinatari possono eseguire le seguenti attività da Adobe Reader:
- Compilazione di documenti e moduli PDF in linea o non in linea, consentendo ai destinatari di salvare localmente le copie dei propri record e di mantenere intatte le informazioni aggiunte.
- Salvare i documenti PDF su un disco rigido locale per conservare il documento originale ed eventuali commenti, dati o allegati aggiuntivi.
- Allegare file e clip multimediali a documenti PDF.
- Firma, certifica e autentica i documenti di PDF applicando firme digitali utilizzando tecnologie PKI (Public Key Infrastructure) standard.
- Inviare elettronicamente i documenti PDF completati o con annotazioni.
- Utilizzare i documenti e i moduli di PDF come sviluppo front-end intuitivo per i database interni e i servizi Web.
- Condividere documenti PDF con altri utenti in modo che i revisori possano aggiungere commenti utilizzando strumenti di markup intuitivi. Questi strumenti includono note adesive elettroniche, timbri, evidenziazioni e barrati di testo. Le stesse funzioni sono disponibili in Acrobat.
- Supporto della decodifica Forms in codice a barre.
Queste funzionalità speciali relative ai diritti di utilizzo vengono attivate automaticamente quando si apre un documento PDF con abilitazione per i diritti in Adobe Reader. Al termine dell’utilizzo di un documento abilitato ai diritti, tali funzioni vengono nuovamente disabilitate in Adobe Reader. Rimangono disattivati finché l’utente non riceve un altro documento di PDF abilitato per i diritti.
Attivare o disattivare i diritti di utilizzo
Le varie funzionalità relative ai diritti di utilizzo per l’estensione dei servizi di Reader PDF sono:
-
Decodifica dei codici a barre: per decodificare i codici a barre all'interno del documento PDF.
-
Commenti: per aggiungere commenti non in linea al documento di PDF.
-
Commenti in linea: per aggiungere commenti in linea al documento di PDF.
-
Firma digitale: per aggiungere firme digitali a un documento PDF.
-
Campi modulo dinamici: per aggiungere campi modulo a un documento PDF.
-
Pagine modulo dinamico: per aggiungere pagine modulo a un documento PDF.
-
File incorporati: per incorporare file in un documento PDF.
-
Importazione dati modulo: per importare i dati del modulo in un documento PDF.
-
Esportazione dati modulo: per importare i dati del modulo in un documento PDF.
-
Compilazione modulo: per compilare i campi modulo all'interno di un documento PDF.
-
Forms in linea: per accedere a un servizio Web o a un database da un documento di PDF.
-
Invia in modo autonomo: per inviare i dati del modulo in modalità non in linea da un documento PDF.
Altre funzionalità
- Messaggio: il messaggio visualizzato in Adobe Acrobat Reader all'apertura di un documento PDF con uno o più diritti di utilizzo applicati.
- Sblocca password: password necessaria per aprire un documento PDF crittografato. In genere si tratta della password di apertura del documento, ma se il documento PDF è protetto anche da una password di autorizzazione, è possibile utilizzarlo per aprirlo.
La documentazione di riferimento API fornisce informazioni dettagliate su tutti i parametri, i metodi di autenticazione e i vari servizi forniti dalle API. La documentazione di riferimento API è disponibile anche in formato .yaml. Puoi scaricare il file .yaml e caricarlo su Postman per verificare la funzionalità delle API.
Tipi di API di comunicazione types
Le comunicazioni forniscono API HTTP per la generazione di documenti on-demand e batch:
-
Le API sincrone sono adatte a scenari di generazione di documenti a richiesta, a bassa latenza e a record singolo. Queste API sono più adatte ai casi d’uso basati su azioni dell’utente. Ad esempio, la generazione di un documento al termine della compilazione del modulo da parte dell’utente.
-
Le API batch (API asincrone) sono adatte a scenari di generazione pianificati, di produttività elevata e di documenti multipli. Queste API generano documenti in batch. Ad esempio, bollette telefoniche, estratti conto della carta di credito e rendiconti benefit vengono generati ogni mese.
Onboarding
La funzionalità di comunicazione è disponibile come modulo indipendente e aggiuntivo per gli utenti e le utenti di Forms as a Cloud Service. Per richiedere l’accesso, puoi contattare il team di vendita Adobe o il tuo rappresentante Adobe. Adobe abilita l’accesso per la tua organizzazione e fornisce i privilegi richiesti alla persona designata come amministratore dell’organizzazione. L’amministratore può concedere l’accesso agli sviluppatori Forms as a Cloud Service (utenti) dell’organizzazione per l’utilizzo delle API.
Dopo l’onboarding, per abilitare le funzionalità di comunicazione per l’ambiente Forms as a Cloud Service:
-
Accedi a Cloud Manager e apri la tua istanza AEM Forms as a Cloud Service.
-
Apri l’opzione Modifica programma, vai alla scheda Soluzioni e componenti aggiuntivi e seleziona l’opzione Forms - Comunicazioni.
Se hai già abilitato l’opzione Forms - Registrazione digitale, allora seleziona l’opzione Forms - Componente aggiuntivo per le comunicazioni.
-
Fai clic su Aggiorna.
-
Esegui la pipeline di compilazione. Una volta che la pipeline di compilazione ha esito positivo, le API di comunicazione sono abilitate per l’ambiente.
# Allow Forms Doc Generation requests/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }