Usa comunicazioni as a Cloud Service di AEM Forms

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à semplificate 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 throughput elevato).

  • un accesso sicuro ai dati. Le API di comunicazione si connettono e accedono ai dati solo dagli archivi di dati designati dal cliente, il che rende le comunicazioni altamente sicure.

Esempio di dichiarazione della carta di credito
È possibile creare un rendiconto della carta di credito utilizzando le API di comunicazione. Questa istruzione di esempio utilizza lo stesso modello ma dati separati per ogni cliente a seconda dell'uso della carta di credito.

Generazione di documenti

Le API per la generazione di documenti di comunicazione consentono di combinare un modello (XFA o PDF) con i dati dei 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 utilizzando Designer e utilizza le API di comunicazione per unire i dati con il modello. L'applicazione può inviare il documento di output a una stampante di rete, a una stampante locale o a un sistema di storage per l'archiviazione. I flussi di lavoro predefiniti e personalizzati si presentano come segue:

Workflow di generazione dei documenti di comunicazione

A seconda del caso d’uso, è anche possibile rendere disponibili questi documenti per il download tramite il sito web o un server di storage.

Alcuni esempi di API per la generazione di documenti sono:

Creare documenti PDF

È possibile utilizzare le API di generazione dei documenti per creare un documento PDF basato su una struttura del modulo e sui dati del modulo XML. L’output è un documento PDF non interattivo. In altre parole, gli utenti non possono immettere o modificare i dati del modulo. Un flusso di lavoro di base consiste nell’unire i dati del modulo XML a una struttura del modulo per creare un documento PDF. Nell’illustrazione seguente viene illustrato l’unione di una struttura del modulo e dei dati del modulo XML per produrre un documento PDF.

Creare documenti PDF
Figura: Flusso di lavoro tipico per la creazione di un documento PDF

Crea documento PostScript (PS), PCL (Printer Command Language), Zebra Printing Language (ZPL)

È possibile utilizzare le API per la generazione di documenti per creare documenti PostScript (PS), PCL (Printer Command Language) e Zebra Printing Language (ZPL) basati su una struttura del modulo XDP o su un documento PDF. Queste API consentono di unire una struttura del 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

È possibile utilizzare le API di generazione dei documenti per creare documenti separati per ogni record all'interno di un'origine dati batch XML. Puoi generare documenti in modalità collettiva e asincrona. Puoi configurare vari parametri per la conversione e quindi avviare il processo batch.

Creare documenti PDF

Manipolazione dei documenti

Le API di manipolazione dei documenti di comunicazione consentono di combinare, ridisporre e convalidare i documenti PDF. In genere, si crea un DDX e lo si invia alle API di manipolazione dei documenti per assemblare o ridisporre un documento. La 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 modi per assemblare documenti PDF:

  • Assemblare un semplice documento PDF
  • Creare un Portfolio PDF
  • Assemblare documenti crittografati
  • Assemblare documenti utilizzando la numerazione Bates
  • Flatten e assemblare documenti

Assemblaggio di un semplice documento PDF da più documenti PDF
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 in base ai segnalibri. In genere, questa attività è utile se il documento PDF è stato creato in origine da molti documenti, ad esempio da una raccolta di istruzioni.

  • Estrarre pagine da un documento di origine
  • Dividi un documento di origine basato sui segnalibri

Dividere un documento di origine basato sui segnalibri in più documenti
Figura: Dividere un documento di origine basato sui segnalibri in più documenti

Convertire e convalidare documenti conformi a PDF/A

È possibile utilizzare le API per la manipolazione dei documenti per convertire un documento PDF in un documento conforme a PDF/A e 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 contiene contenuto audio e video.

Tipi di API per le comunicazioni

Le comunicazioni forniscono API HTTP per la generazione di documenti on-demand e batch:

  • API sincrone sono adatti 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.

  • API batch (API asincrone) sono adatti a scenari di generazione pianificati, di alta velocità e di documenti multipli. Queste API generano documenti in batch. Ad esempio, bollette telefoniche, dichiarazioni con carta di credito e dichiarazioni con benefit generate ogni mese.

Onboarding

La funzionalità di comunicazione è disponibile come modulo indipendente e aggiuntivo per gli utenti as a Cloud Service di Forms. Per richiedere l'accesso, contatta il team di vendita di Adobe o il tuo rappresentante di 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 (utenti) as a Cloud Service di Forms della tua organizzazione per l’utilizzo delle API.

Dopo l’onboarding, per abilitare la funzionalità di comunicazione per l’ambiente as a Cloud Service Forms:

  1. Accedi a Cloud Manager e apri la tua istanza as a Cloud Service di AEM Forms.

  2. Apri l’opzione Modifica programma , vai alla scheda Soluzioni e componenti aggiuntivi e seleziona la Forms - Comunicazioni opzione .

    Comunicazioni

    Se hai già abilitato la Forms - Registrazione digitale , quindi seleziona la Forms - Componente aggiuntivo per le comunicazioni opzione .

    Addon

  3. Fai clic su Aggiorna.

  4. Esegui la pipeline di compilazione. Una volta che la pipeline di build ha esito positivo, le API di comunicazione sono abilitate per l’ambiente.

NOTA

Per abilitare e configurare le API di manipolazione dei documenti, aggiungi la seguente regola a Configurazione del Dispatcher:

# Allow Forms Doc Generation requests
/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }

In questa pagina