Usa elaborazione sincrona sync-processing-introduction
Forms as a Cloud Service - API di comunicazione consente di creare, assemblare e distribuire comunicazioni personalizzate e orientate al brand, ad esempio corrispondenza aziendale, documenti, rendiconti, lettere per l’elaborazione delle richieste di rimborso, note sui benefit, lettere per l’elaborazione delle richieste, fatture mensili e kit di benvenuto. Puoi utilizzare le API di comunicazione per combinare un modello (XFA o PDF) con i dati del cliente per generare documenti in formati PDF, PS, PCL, DPL, IPL e ZPL.
Si consideri uno scenario in cui sono presenti uno o più modelli e più record di dati XML per ciascun modello. Puoi utilizzare le API di comunicazione per generare un documento di stampa per ciascun record. Il risultato è un documento PDF non interattivo. Un documento PDF non interattivo non consente agli utenti di immettere dati nei relativi campi.
Forms as a Cloud Service - Communications fornisce API on-demand e batch (API asincrone) per la generazione pianificata dei documenti:
-
Le API sincrone sono adatte per casi di utilizzo su richiesta, a bassa latenza e per la generazione di documenti a record singolo. Queste API sono più adatte ai casi d’uso basati su azioni dell’utente. Ad esempio, la generazione di un documento dopo che un utente ha compilato un modulo.
-
Le API in batch (API asincrone) sono adatte per casi di utilizzo pianificati di generazione di documenti con throughput elevato. Queste API generano documenti in batch. Ad esempio, bollette telefoniche, rendiconti per carta di credito e rendiconti dei benefit generati ogni mese.
Utilizzare operazioni sincrone batch-operations
Un'operazione sincrona è un processo di generazione di documenti in modo lineare. Queste API sono classificate come API per tenant singolo e API per più tenant:
API per singolo tenant
- API per la generazione di documenti
- API di manipolazione dei documenti
Autenticazione di un'API a tenant singolo
Le operazioni API a tenant singolo supportano due tipi di autenticazione:
-
Autenticazione di base: l'autenticazione di base è uno schema di autenticazione semplice incorporato nel protocollo HTTP. Il client invia richieste HTTP con l'intestazione Authorization che contiene la parola Basic seguita da uno spazio e da una stringa con codifica base64 nomeutente:password. Ad esempio, per autorizzare come amministratore/amministratore, il client invia una stringa con codifica Basic [base64 nome utente]: [password stringa con codifica base64].
-
Autenticazione basata su token: L'autenticazione basata su token utilizza un token di accesso (token di autenticazione Bearer) per effettuare richieste ad Experience Manager as a Cloud Service. AEM Forms as a Cloud Service fornisce API per recuperare in modo sicuro il token di accesso. Per recuperare e utilizzare il token per autenticare una richiesta:
- Recupera le credenziali di Experience Manager as a Cloud Service da Developer Console.
- Installa le credenziali di Experience Manager as a Cloud Service nel tuo ambiente. (server applicazioni, server web o altri server non AEM) configurati per inviare richieste al servizio cloud (effettuare chiamate).
- Generare un token JWT e scambiarlo con le API Adobe IMS per un token di accesso.
- Esegui l’API Experience Manager con il token di accesso come token di autenticazione Bearer.
- Imposta le autorizzazioni appropriate per l'utente dell'account tecnico nell'ambiente Experience Manager.
note note NOTE Adobe consiglia di utilizzare l’autenticazione basata su token in un ambiente di produzione. note important IMPORTANT Per ulteriori informazioni, vedere Autenticazione server-to-server OAuth e Autenticazione server-to-server JWT.
Configurare risorse e autorizzazioni (solo per le API di generazione documenti)
Per utilizzare le API sincrone, è necessario quanto segue:
- Utenti con privilegi di amministratore Experience Manager
- Caricare modelli e altre risorse nell’istanza di Experience Manager Forms Cloud Service
Carica modelli e altre risorse nell’istanza di Experience Manager (solo per le API di generazione documenti)
In genere, un’organizzazione dispone di più modelli. Ad esempio, un modello per gli estratti conto della carta di credito, gli estratti conto benefit e le richieste di rimborso. Carica tutti i modelli XDP e PDF nella tua istanza Experience Manager. Per caricare un modello:
- Apri l’istanza di Experience Manager.
- Passa a Forms > Forms e documenti
- Fai clic su Crea > Cartella e crea una cartella. Apri la cartella.
- Fai clic su Crea > Carica file e carica i modelli.
Richiama un’API
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 fornisce anche un file di definizione API in formato .yaml. Puoi scaricare il file .yaml e caricarlo in Postman per verificare la funzionalità delle API.