Considerazioni sui problemi noti e sulle best practice

Prima di iniziare a utilizzare le API di comunicazione, esamina le considerazioni seguenti, i problemi noti e le domande frequenti:

Considerazioni

Dati modulo

Le API di comunicazione accettano come input sia una struttura del modulo generalmente creata in Designer che i dati del modulo XML. Per compilare un documento con i dati, nei dati del modulo XML deve esistere un elemento XML per ogni campo del modulo che si desidera compilare. Il nome dell'elemento XML deve corrispondere al nome del campo. Un elemento XML viene ignorato se non corrisponde a un campo modulo o se il nome dell’elemento XML non corrisponde al nome del campo. Non è necessario stabilire una corrispondenza con l’ordine di visualizzazione degli elementi XML. Il fattore importante è che gli elementi XML sono specificati con i valori corrispondenti.

Prendi in considerazione il seguente modulo di richiesta di prestito:

Modulo di domanda di prestito

Per unire i dati alla struttura del modulo, creare un’origine dati XML corrispondente al modulo. L'XML seguente rappresenta un'origine dati XML corrispondente al modulo di applicazione per l'ipoteca di esempio.

<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
    - <Layer>
        <closeDate>1/26/2007</closeDate>
        <lastName>Johnson</lastName>
        <firstName>Jerry</firstName>
        <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
        <city>New York</city>
        <zipCode>00501</zipCode>
        <state>NY</state>
        <dateBirth>26/08/1973</dateBirth>
        <middleInitials>D</middleInitials>
        <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
        <phoneNumber>5555550000</phoneNumber>
    </Layer>
    - <Mortgage>
        <mortgageAmount>295000.00</mortgageAmount>
        <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
        <purchasePrice>300000</purchasePrice>
        <downPayment>5000</downPayment>
        <term>25</term>
        <interestRate>5.00</interestRate>
    </Mortgage>
</data>
</xfa:data>
</xfa:datasets>

Tipi di documenti supportati

Per un accesso completo alle funzionalità di rendering delle API di comunicazione, si consiglia di utilizzare un file XDP come input. A volte è possibile utilizzare un file PDF. Tuttavia, l’utilizzo di un file PDF come input presenta alcune limitazioni:

Un documento PDF che non contiene un flusso XFA non può essere rappresentato come PostScript, PCL o ZPL. Le API di comunicazione possono eseguire il rendering dei documenti PDF con flussi XFA (ovvero moduli creati in Designer) in formati laser ed etichette. Se il documento PDF è firmato, certificato o contiene diritti di utilizzo (applicati utilizzando il servizio AEM Forms Reader Extensions), non può essere sottoposto a rendering in questi formati di stampa.

Aree stampabili

Il margine non stampabile predefinito da 0,25" non è esatto per le stampanti di etichette e varia dalla stampante alla stampante e dalle dimensioni dell'etichetta alle dimensioni dell'etichetta, tuttavia, si consiglia di mantenere il margine di 0,25" o ridurlo. Tuttavia, si consiglia di non aumentare il margine non stampabile. In caso contrario, le informazioni contenute nell'area stampabile non vengono stampate correttamente.

Assicurarsi sempre di utilizzare il file XDC corretto per la stampante. Ad esempio, evitare di scegliere un file XDC per una stampante a 300 dpi e inviare il documento a una stampante a 200 dpi.

Script solo per i moduli XFA (XDP/PDF)

Una struttura del modulo utilizzata con le API di comunicazione può contenere script eseguiti sul server. Assicurarsi che una struttura del modulo non contenga script eseguiti sul client. Per informazioni sulla creazione degli script di struttura del modulo, vedere Guida di Designer.

Mappatura dei font

Per progettare un modulo che utilizza font residenti nella stampante, scegliere un nome di font corrispondente ai font disponibili nella stampante in Designer. Un elenco di font supportati per PCL o PostScript si trova nei corrispondenti profili dispositivo (file XDC). In alternativa, è possibile creare la mappatura dei font per associare i font non residenti nella stampante ai font residenti nella stampante con un nome di font diverso. Ad esempio, in uno scenario PostScript, i riferimenti al carattere Arial® possono essere mappati al carattere Helvetica® residente nella stampante.

Se un font è installato in un computer client, è disponibile nell’elenco a discesa in Designer. Se il font non è installato, è necessario specificare manualmente il nome del font. L’opzione "Sostituisci definitivamente font non disponibili" in Designer può essere disattivata. In caso contrario, quando il file XDP viene salvato in Designer, il nome del font sostitutivo viene scritto nel file XDP. Ciò significa che il font residente nella stampante non viene utilizzato.

Esistono due tipi di font OpenType®. Un tipo è un font TrueType OpenType® supportato da PCL. L'altro è CFF OpenType®. L'output PDF e PostScript supporta i font incorporati Type-1, TrueType e OpenType®. L'output PCL supporta i font TrueType incorporati.

I font Type-1 e OpenType® non sono incorporati nell'output PCL. Il contenuto formattato con font Type-1 e OpenType® viene rasterizzato e generato come immagine bitmap di grandi dimensioni e più lento da generare.

I font scaricati o incorporati vengono sostituiti automaticamente durante la generazione dell’output PostScript, PCL o PDF. Ciò significa che solo il sottoinsieme dei glifi di font necessari per il corretto rendering del documento generato è incluso nell’output generato.

Utilizzo dei file di profilo del dispositivo (file XDC)

Un profilo dispositivo (file XDC) è un file di descrizione della stampante in formato XML. Questo file consente alle API di comunicazione di inviare i documenti come formati laser o di stampa delle etichette. Le API di comunicazione utilizzano i file XDC, tra cui:

  • hppcl5c.xdc

  • hppcl5e.xdc

  • ps_plain_level3.xdc

  • ps_plain.xdc

  • zpl300.xdc

  • zpl600.xdc

  • zpl300.xdc

  • ipl300.xdc

  • ipl400.xdc

  • tpcl600.xdc

  • dpl300.xdc

  • dpl406.xdc

  • dpl600.xdc

È possibile utilizzare i file XDC forniti per generare documenti di stampa o modificarli in base alle proprie esigenze.

Questi file sono file XDC di riferimento che supportano le caratteristiche di stampanti specifiche, ad esempio font residenti, vassoi di carta e graffette. Lo scopo di questo riferimento è quello di aiutarti a capire come impostare le tue stampanti utilizzando i profili dei dispositivi. Il riferimento è anche un punto di partenza per stampanti simili della stessa linea di prodotti.

Utilizzo del file di configurazione XCI

Le API di comunicazione utilizzano un file di configurazione XCI per eseguire attività quali controllare se l’output è un singolo pannello o impaginato. Anche se questo file contiene impostazioni che possono essere impostate, non è tipico modificare questo valore.

Puoi trasmettere un file XCI modificato mentre utilizzi un’API di comunicazione. In questo modo, crea una copia del file predefinito, modifica solo i valori che richiedono modifiche per soddisfare i requisiti aziendali e utilizza il file XCI modificato.

Le API di comunicazione iniziano con il file XCI predefinito (o il file modificato). Quindi applica i valori specificati utilizzando le API di comunicazione. Questi valori sostituiscono le impostazioni XCI.

La tabella seguente specifica le opzioni XCI.

Opzione XCI Descrizione
config/current/pdf/creator Identifica il creatore del documento utilizzando la voce Creatore nel dizionario Informazioni documento. Per informazioni su questo dizionario, consultare la guida di riferimento di PDF.
config/present/pdf/produttore Identifica il produttore del documento utilizzando la voce Produttore nel dizionario Informazioni documento. Per informazioni su questo dizionario, consultare la guida di riferimento di PDF.
configurazione/attuale/layout Controlla se l'output è un singolo pannello o impaginato.
config/current/pdf/compressione/level Specifica il grado di compressione da utilizzare per la generazione di un documento PDF.
config/current/pdf/scriptModel Controlla se le informazioni specifiche di XFA sono incluse nel documento PDF di output.
config/current/common/data/adjustData Controlla se l'applicazione XFA regola i dati dopo l'unione.
config/current/pdf/renderPolicy Controlla se la generazione del contenuto della pagina viene eseguita sul server o differita al client.
config/present/common/locale Specifica le impostazioni internazionali predefinite utilizzate nel documento di output.
configurazione/presente/destinazione Se contenuto da un elemento presente, specifica il formato di output. Se contenuto in un elemento openAction, specifica l'azione da eseguire all'apertura del documento in un client interattivo.
configurazione/attuale/uscita/tipo Specifica il tipo di compressione da applicare a un file o il tipo di output da produrre.
config/current/common/temp/uri Specifica l’URI del modulo.
config/present/common/template/base Fornisce una posizione di base per gli URI nella struttura del modulo. Quando questo elemento è assente o vuoto, la posizione della struttura del modulo viene utilizzata come base.
config/present/common/log/to Controlla la posizione in cui vengono scritti i dati di registro o di output.
config/current/output/to Controlla la posizione in cui vengono scritti i dati di registro o di output.
config/present/script/currentPage Specifica la pagina iniziale all'apertura del documento.
config/present/script/exclude Indica alle API server/comunicazioni di AEM Forms gli eventi da ignorare.
config/current/pdf/linearized Controlla se il documento PDF di output è linearizzato.
config/present/script/runScripts Controlla quale insieme di script viene eseguito da AEM Forms.
config/present/pdf/tagged Controlla l’inclusione dei tag nel documento PDF di output. I tag, nel contesto di PDF, sono informazioni aggiuntive incluse in un documento per esporre la struttura logica del documento. I tag facilitano gli strumenti di accessibilità e la riformattazione. Ad esempio, un numero di pagina può essere contrassegnato come artefatto in modo che l’assistente vocale non lo pronunci al centro del testo. Anche se i tag rendono un documento più utile, aumentano anche le dimensioni del documento e il tempo di elaborazione necessario per crearlo.
config/present/pdf/version Specifica la versione del documento PDF da generare.

Problemi noti

  • È possibile utilizzare un tipo di rendering specifico (PDF, STAMPA) una sola volta nell'elenco delle opzioni di stampa. Ad esempio, non è possibile avere due opzioni PRINT ciascuna che specificano un tipo di rendering PCL.

  • Per una configurazione batch, una sola istanza di combinazione di valori di OutputType(PDF, PRINT) e RenderType(PostScript, PCL, IPL, ZPL, ecc.) è consentito.

  • Per le API asincrone (elaborazione in batch), il livello di record predefinito è impostato su 2. È possibile utilizzare un valore XCI personalizzato per modificare il livello di record a 1.

  • Quando è configurato il file XCI predefinito, include il percorso fino al rendering originale. Esempio /content/dam/formsanddocuments/default.xci/jcr:content/renditions/original

Best practice

  • Adobe consiglia di ospitare l’archivio dei contenitori BLOB di file di dati nell’area cloud utilizzata da AEM Cloud Service.

Domande frequenti

È possibile utilizzare una cartella controllata o altri meccanismi di archiviazione per memorizzare l'input e l'output?

Al momento, è possibile utilizzare l’archiviazione Microsoft Azure per salvare i dati di input e i documenti generati. L’archiviazione di Microsoft Azure offre diverse opzioni per automatizzare le operazioni di spostamento dei dati.

Un account di archiviazione Microsoft Azure è incluso con la licenza di Cloud Service Experience Manager Forms?

L’account di archiviazione Microsoft Azure è indipendente dalla licenza del Cloud Service Experience Manager Forms.

Le API di comunicazione memorizzano i dati sui server di Cloud Service Experience Manager Forms?

I dati di input e output vengono salvati solo nell’archiviazione Microsoft Azure.

Le API di comunicazione sono disponibili solo per il Cloud Service Experience Manager Forms? Posso ottenere funzionalità simili in ambiente on-premise?

È possibile utilizzare il servizio AEM Forms Output per combinare un modello (XFA o PDF) con i dati dei clienti per generare documenti nei formati PDF, PS, PCL e ZPL.

Rispetto all'ambiente on-premise, il Cloud Service offre ulteriori vantaggi in termini di scalabilità automatica ed efficienza in termini di costi.

È possibile eseguire più operazioni batch contemporaneamente?
Sì, è possibile eseguire più operazioni batch contemporaneamente. Utilizzare sempre cartelle di origine e di destinazione diverse per ogni operazione per evitare conflitti.

In questa pagina