Creazione di flussi di output dei documenti creating-document-output-streams
Informazioni sul servizio di output
Il servizio Output consente di inviare i documenti come PDF (inclusi i documenti PDF/A), PostScript, PCL (Printer Control Language) e i seguenti formati di etichetta:
- Zebra - ZPL
- Intermec - IPL
- Datamax - DPL
- TecToshiba - TPCL
Tramite il servizio Output è possibile unire i dati del modulo XML a una struttura del modulo e inviare il documento a una stampante o a un file di rete.
Esistono due modi per passare una struttura del modulo (un file XDP) al servizio Output. Puoi passare un com.adobe.idp.Document
istanza che contiene una struttura del modulo per il servizio Output. In alternativa, è possibile passare un valore URI che specifica la posizione della struttura del modulo. Entrambi questi modi sono discussi in Programmazione con moduli AEM.
Nelle sezioni seguenti viene illustrato come passare una struttura del modulo al servizio Output utilizzando un valore URI:
Nelle sezioni seguenti viene illustrato come passare una struttura del modulo all’interno di un com.adobe.idp.Document
istanza:
Quando si decide quale tecnica utilizzare, occorre tenere presente che la struttura del modulo deve essere ricevuta da un altro servizio AEM Forms e quindi trasmessa all’interno di un com.adobe.idp.Document
istanza. Entrambi i Trasmissione di documenti al servizio di output e Creazione di documenti PDF tramite frammenti Le sezioni mostrano come ottenere una struttura del modulo da un altro servizio AEM Forms. La prima sezione recupera la struttura del modulo da Content Services (obsoleto). La seconda sezione recupera la struttura del modulo dal servizio Assembler.
Se si ottiene la struttura del modulo da una posizione fissa, ad esempio il file system, è possibile utilizzare una di queste tecniche. In altre parole, è possibile specificare il valore URI in un file XDP o utilizzare un com.adobe.idp.Document
istanza.
Per passare un valore URI che specifichi la posizione della struttura del modulo durante la creazione di un documento PDF, utilizzare la generatePDFOutput
metodo . Allo stesso modo, per passare un com.adobe.idp.Document
istanza al servizio Output durante la creazione di un documento PDF, utilizzare il generatePDFOutput2
metodo .
Quando si invia un flusso di output a una stampante di rete, è inoltre possibile utilizzare una di queste tecniche. Per inviare un flusso di output a una stampante passando una com.adobe.idp.Document
istanza che contiene una struttura del modulo, utilizzare sendToPrinter2
metodo . Per inviare un flusso di output a una stampante passando un valore URI, utilizzare il comando sendToPrinter
metodo . La Invio di flussi di stampa alle stampanti utilizza la sezione sendToPrinter
metodo .
Puoi eseguire queste attività utilizzando il servizio Output:
- Creazione di documenti PDF
- Creazione di documenti PDF/A
- Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output
- Creazione di documenti PDF tramite frammenti
- Stampa su file
- Invio di flussi di stampa alle stampanti
- Creazione di più file di output
- Creazione di regole di ricerca
- Flatting dei documenti PDF
Creazione di documenti PDF creating-pdf-documents
È possibile utilizzare il servizio Output per creare un documento PDF basato su una struttura del modulo e sui dati del modulo XML forniti. Il documento PDF creato dal servizio Output non è un documento PDF interattivo; un utente non può immettere o modificare i dati del modulo.
Per creare un documento PDF destinato all’archiviazione a lungo termine, è consigliabile creare un documento PDF/A. (Vedi Creazione di documenti PDF/A.)
Per creare un modulo PDF interattivo che consenta all’utente di immettere i dati, utilizzare il servizio Forms. (Vedi Rendering di PDF forms interattivi.)
Riepilogo dei passaggi summary-of-steps
Per creare un documento PDF, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Impostare le opzioni di runtime di PDF.
- Imposta le opzioni di esecuzione del rendering.
- Genera un documento PDF.
- Recupera i risultati dell’operazione.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceService
oggetto.
Riferimento a un’origine dati XML
Per unire i dati alla struttura del modulo, è necessario fare riferimento a un’origine dati XML contenente i dati. Per ogni campo del modulo che si intende compilare con i dati deve esistere un elemento XML. 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. Se vengono specificati tutti gli elementi XML, non è necessario stabilire una corrispondenza con l’ordine in cui vengono visualizzati gli elementi XML.
Prendi in considerazione il seguente modulo di richiesta di prestito.
Per unire i dati alla struttura del modulo, è necessario creare un’origine dati XML corrispondente al modulo. Il seguente XML rappresenta un'origine dati XML XDP che corrisponde al modulo di applicazione per ipoteca di esempio.
<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="https://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>
Impostare le opzioni di runtime di PDF
Impostare l’opzione URI del file durante la creazione di un documento PDF. Questa opzione specifica il nome e la posizione del file PDF generato dal servizio Output.
Impostare le opzioni di esecuzione del rendering
È possibile impostare le opzioni di esecuzione del rendering durante la creazione di un documento PDF. Sebbene queste opzioni non siano necessarie (a differenza delle opzioni di runtime di PDF richieste), è possibile eseguire attività quali il miglioramento delle prestazioni del servizio Output. Ad esempio, è possibile memorizzare nella cache la struttura del modulo utilizzata dal servizio Output per migliorarne le prestazioni.
Se si utilizza un modulo Acrobat con tag come input, non è possibile utilizzare Java del servizio di output o API del servizio Web per disattivare l’impostazione con tag. Se tenti di impostare questa opzione a livello di programmazione su false
, il risultato del documento PDF è ancora contrassegnato.
RenderOptionsSpec
riferimento della classe. (Vedi Riferimento API di AEM Forms).Generare un documento PDF
Dopo aver fatto riferimento a un’origine dati XML valida contenente i dati del modulo e aver impostato le opzioni di esecuzione, è possibile richiamare il servizio Output, generando un documento PDF.
Quando si genera un documento PDF, è necessario specificare i valori URI richiesti dal servizio Output per creare un documento PDF. Una struttura del modulo può essere memorizzata in posizioni quali il file system del server o come parte di un’applicazione AEM Forms. È possibile fare riferimento a una struttura del modulo (o ad altre risorse, ad esempio un file immagine) esistente nell’ambito di un’applicazione Forms utilizzando il valore URI della directory principale contenuto repository:///
. Ad esempio, considerare la seguente struttura del modulo denominata Loan.xdp all'interno di un'applicazione Forms denominata Applicazioni/FormsApplication:
Per accedere al file Loan.xdp mostrato nell'illustrazione precedente, specifica repository:///Applications/FormsApplication/1.0/FormsFolder/
come terzo parametro trasmesso al OutputClient
dell’oggetto generatePDFOutput
metodo . Specifica il nome del modulo (Loan.xdp) come secondo parametro trasmesso al OutputClient
dell’oggetto generatePDFOutput
metodo .
Se il file XDP contiene immagini (o altre risorse come frammenti), posiziona le risorse nella stessa cartella dell’applicazione del file XDP. AEM Forms utilizza l’URI della directory principale del contenuto come percorso di base per risolvere i riferimenti alle immagini. Ad esempio, se il file Loan.xdp contiene un'immagine, accertati di inserire l'immagine in Applications/FormsApplication/1.0/FormsFolder/
.
OutputClient
dell’oggetto generatePDFOutput
o generatePrintedOutput
metodi.Recupera i risultati dell'operazione
Dopo l'esecuzione di un'operazione, il servizio Output restituisce vari elementi di dati, ad esempio dati XML di stato, che specificano se l'operazione ha avuto esito positivo.
Consulta anche
Creare un documento PDF utilizzando l’API Java
Creare un documento PDF utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Creare un documento PDF utilizzando l’API Java create-a-pdf-document-using-the-java-api
Creare un documento PDF utilizzando l’API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML utilizzata per compilare il documento PDF utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore. Passa lajava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di runtime di PDF.
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Imposta l'opzione URI file richiamando il
PDFOutputOptionsSpec
dell’oggettosetFileURI
metodo . Passa un valore stringa che specifica la posizione del file PDF generato dal servizio Output. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client.
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output richiamando il
RenderOptionsSpec
dell’oggettosetCacheEnabled
e di passaggiotrue
.
note note NOTE Non è possibile impostare la versione del documento di PDF utilizzando il RenderOptionsSpec
dell’oggettosetPdfVersion
se il documento di input è un modulo Acrobat (un modulo creato in Acrobat) o un documento XFA firmato o certificato. Il documento PDF di output conserva la versione originale di PDF. Allo stesso modo, non è possibile impostare l’opzione Adobe PDF con tag richiamando ilRenderOptionsSpec
dell’oggettosetTaggedPDF
* se il documento di input è un modulo Acrobat o un documento XFA firmato o certificato. *note note NOTE Non è possibile impostare l’opzione linearized PDF utilizzando RenderOptionsSpec
dell’oggettosetLinearizedPDF
se il documento di input PDF è certificato o firmato digitalmente. (Vedi Firma digitale di documenti PDF.) - Crea un
-
Genera un documento PDF.
Creare un documento PDF richiamando il
OutputClient
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo.
La
generatePDFOutput
restituisce unOutputResult
oggetto contenente i risultati dell'operazione.note note NOTE Quando si genera un documento PDF richiamando il generatePDFOutput
tenere presente che non è possibile unire dati con un modulo XFA PDF firmato o certificato. (Vedi Firma digitale e certificazione dei documenti.)note note NOTE La OutputResult
dell’oggettogetRecordLevelMetaDataList
restituisce il metodonull
.note note NOTE È inoltre possibile creare un documento PDF richiamando il OutputClient
dell’oggettogeneratePDFOutput2
metodo . (Vedi Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output.) - A
-
Recupera i risultati dell’operazione.
- Recupera un
com.adobe.idp.Document
che rappresenta lo statogeneratePDFOutput
richiamando ilOutputResult
dell’oggettogetStatusDoc
metodo . Questo metodo restituisce dati XML di stato che specificano se l'operazione è riuscita. - Crea un
java.io.File
oggetto contenente i risultati dell'operazione. Assicurati che l'estensione del nome file sia .xml. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetStatusDoc
metodo).
Anche se il servizio Output scrive il documento PDF nel percorso specificato dall'argomento passato al
PDFOutputOptionsSpec
dell’oggettosetFileURI
è possibile recuperare in modo programmatico il documento PDF/A richiamando ilOutputResult
dell’oggettogetGeneratedDoc
metodo . - Recupera un
Consulta anche
Avvio rapido (modalità EJB): Creazione di un documento PDF tramite l’API Java
Avvio rapido (modalità SOAP): Creazione di un documento PDF tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Creare un documento PDF utilizzando l’API del servizio Web create-a-pdf-document-using-the-web-service-api
Creare un documento PDF utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati XML che verranno uniti al documento PDF. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file XML contenente i dati del modulo. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di runtime di PDF
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Impostare l'opzione URI file assegnando un valore stringa che specifica la posizione del file PDF generato dal servizio Output nel
PDFOutputOptionsSpec
dell’oggettofileURI
membro dati. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client.
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output assegnando il valore
true
alRenderOptionsSpec
dell’oggettocacheEnabled
membro dati.
note note NOTE Non è possibile impostare la versione del documento di PDF utilizzando il RenderOptionsSpec
dell’oggettosetPdfVersion
se il documento di input è un modulo Acrobat (un modulo creato in Acrobat) o un documento XFA firmato o certificato. Il documento PDF di output conserva la versione originale di PDF. Allo stesso modo, non è possibile impostare l’opzione Adobe PDF con tag richiamando ilRenderOptionsSpec
dell’oggettosetTaggedPDF
* se il documento di input è un modulo Acrobat o un documento XFA firmato o certificato.*note note NOTE Non è possibile impostare l’opzione linearized PDF utilizzando RenderOptionsSpec
dell’oggettolinearizedPDF
se il documento di input PDF è certificato o firmato digitalmente. (Vedi Firma digitale di documenti PDF.) - Crea un
-
Genera un documento PDF.
Creare un documento PDF richiamando il
OutputServiceService
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i metadati generati che descrivono il documento. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i dati dei risultati. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - Un
OutputResult
oggetto contenente i risultati dell'operazione. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web).
note note NOTE Quando si genera un documento PDF richiamando il generatePDFOutput
tenere presente che non è possibile unire dati con un modulo XFA PDF firmato o certificato. (Vedi Firma digitale e certificazione dei documenti.)note note NOTE È inoltre possibile creare un documento PDF richiamando il OutputClient
dell’oggettogeneratePDFOutput2
metodo . (Vedi Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output.) - A
-
Recupera i risultati dell’operazione.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta una posizione di file XML contenente i dati dei risultati. Assicurati che l'estensione del nome file sia .xml. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto popolato con i dati dei risultati daOutputServiceService
dell’oggettogeneratePDFOutput
(l'ottavo parametro). Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
field
. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte nel file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
Consulta anche
- Crea un
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
OutputServiceService
dell’oggetto generateOutput
è obsoleto.Creazione di documenti PDF/A creating-pdf-a-documents
È possibile utilizzare il servizio Output per creare un documento PDF/A. Poiché PDF/A è un formato di archiviazione per la conservazione a lungo termine del contenuto del documento, tutti i font vengono incorporati e il file non viene compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non contiene contenuti audio e video. Come per altre attività del servizio Output, è possibile fornire una struttura del modulo e i dati da unire a una struttura del modulo per creare un documento PDF/A.
La specifica PDF/A-1 è costituita da due livelli di conformità, ossia a e b. La differenza principale tra i due riguarda il supporto della struttura logica (accessibilità), che non è necessario per il livello di conformità b. Indipendentemente dal livello di conformità, PDF/A-1 determina che tutti i font sono incorporati nel documento PDF/A generato.
Anche se PDF/A è lo standard per l’archiviazione dei documenti PDF, non è obbligatorio utilizzare PDF/A per l’archiviazione se un documento PDF standard soddisfa le esigenze aziendali. Lo scopo dello standard PDF/A è quello di stabilire un file PDF che possa essere archiviato per un lungo periodo di tempo e che soddisfi i requisiti di conservazione dei documenti. Ad esempio, non è possibile incorporare un URL in un PDF/A perché nel tempo l’URL potrebbe non essere valido.
L'organizzazione deve valutare le proprie esigenze, il periodo di tempo previsto per la conservazione del documento, le dimensioni del file e determinare la propria strategia di archiviazione. È possibile determinare a livello di programmazione se un documento PDF è conforme a PDF/A utilizzando il servizio DocConverter. (Vedi Determinazione programmatica della conformità PDF/A.)
Un documento PDF/A deve utilizzare il font specificato nella struttura del modulo e i font non possono essere sostituiti. Di conseguenza, se un font che si trova all’interno di un documento PDF non è disponibile nel sistema operativo host (OS), si verifica un’eccezione.
Quando un documento PDF/A viene aperto in Acrobat, viene visualizzato un messaggio che conferma che il documento è un documento PDF/A, come illustrato nella figura seguente.
Riepilogo dei passaggi summary_of_steps-1
Per creare un documento PDF/A, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Impostare le opzioni di esecuzione di PDF/A.
- Imposta le opzioni di esecuzione del rendering.
- Genera un documento PDF/A.
- Recupera i risultati dell’operazione.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione personalizzata utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceService
oggetto.
Riferimento a un’origine dati XML
Per unire i dati alla struttura del modulo, è necessario fare riferimento a un’origine dati XML contenente i dati. Per ogni campo del modulo che si desidera compilare con i dati deve esistere un elemento XML. 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. Se vengono specificati tutti gli elementi XML, non è necessario stabilire una corrispondenza con l’ordine in cui vengono visualizzati gli elementi XML.
Impostare le opzioni di esecuzione di PDF/A
È possibile impostare l’opzione URI file durante la creazione di un documento PDF/A. L’URI è relativo al server applicazioni J2EE che ospita AEM Forms. In altre parole, se si imposta C:\Adobe, il file viene scritto nella cartella sul server, non nel computer client. L’URI specifica il nome e la posizione del file PDF/A generato dal servizio Output.
Impostare le opzioni di esecuzione del rendering
È possibile impostare le opzioni di esecuzione del rendering durante la creazione di documenti PDF/A. Le due opzioni relative a PDF/A che è possibile impostare sono le seguenti: PDFAConformance
e PDFARevisionNumber
valori. La PDFAConformance
Il valore si riferisce al modo in cui un documento PDF aderisce ai requisiti che specificano il modo in cui vengono conservati i documenti elettronici a lungo termine. I valori validi per questa opzione sono A
e B
. Per informazioni sulla conformità ai livelli a e b, vedere la specifica ISO PDF/A-1 denominata ISO 19005-1 Gestione dei documenti.
La PDFARevisionNumber
Il valore si riferisce al numero di revisione di un documento PDF/A. Per informazioni sul numero di revisione di un documento PDF/A, vedere la specifica ISO PDF/A-1 denominata ISO 19005-1 Gestione dei documenti.
false
durante la creazione di un documento PDF/A 1A. PDF/A 1A sarà sempre un documento PDF con tag. Inoltre, non è possibile impostare l’opzione Adobe PDF con tag su true
durante la creazione di un documento PDF/A 1B. PDF/A 1B sarà sempre un documento PDF senza tag.Generare un documento PDF/A
Dopo aver fatto riferimento a un’origine dati XML valida contenente i dati del modulo e aver impostato le opzioni di esecuzione, è possibile richiamare il servizio Output generando un documento PDF/A.
Recupera i risultati dell'operazione
Dopo l'esecuzione di un'operazione, il servizio Output restituisce vari elementi di dati, ad esempio dati XML, che specificano se l'operazione ha avuto esito positivo.
Consulta anche
Creare un documento PDF/A utilizzando l’API Java
Creare un documento PDF/A utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Creare un documento PDF/A utilizzando l’API Java create-a-pdf-a-document-using-the-java-api
Crea un documento PDF/A utilizzando l’API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML utilizzata per compilare il documento PDF/A utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di esecuzione di PDF/A.
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Imposta l'opzione URI file richiamando il
PDFOutputOptionsSpec
dell’oggettosetFileURI
metodo . Passa un valore stringa che specifica la posizione del file PDF generato dal servizio Output. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client.
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Imposta la
PDFAConformance
richiamando ilRenderOptionsSpec
dell’oggettosetPDFAConformance
e passare unPDFAConformance
valore enum che specifica il livello di conformità. Ad esempio, per specificare il livello di conformità A, passarePDFAConformance.A
. - Imposta la
PDFARevisionNumber
richiamando ilRenderOptionsSpec
dell’oggettosetPDFARevisionNumber
metodo e passaggioPDFARevisionNumber.Revision_1
.
note note NOTE La versione PDF di un documento PDF/A è 1.4 indipendentemente dal valore specificato per il RenderOptionsSpec
dell’oggettosetPdfVersion
metodo . - Crea un
-
Genera un documento PDF/A.
Crea un documento PDF/A richiamando il
OutputClient
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF/A, specificareTransformationFormat.PDFA
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto che contiene l’origine dati XML contenente i dati da unire alla struttura del modulo.
La
generatePDFOutput
restituisce unOutputResult
oggetto contenente i risultati dell'operazione.note note NOTE La OutputResult
dell’oggettogetRecordLevelMetaDataList
restituisce il metodonull
* *note note NOTE È inoltre possibile creare un documento PDF/A richiamando il OutputClient
dell’oggettogeneratePDFOutput
metodo 2. (Vedi Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output.) - A
-
Recupera i risultati dell’operazione.
- Crea un
com.adobe.idp.Document
che rappresenta lo statogeneratePDFOutput
richiamando il metodoOutputResult
dell’oggettogetStatusDoc
metodo . - Crea un
java.io.File
oggetto che conterrà i risultati dell'operazione. Assicurati che l'estensione del nome file sia .xml. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetStatusDoc
metodo).
note note NOTE Anche se il servizio Output scrive il documento PDF/A nel percorso specificato dall'argomento passato al PDFOutputOptionsSpec
dell’oggettosetFileURI
è possibile recuperare in modo programmatico il documento PDF/A richiamando ilOutputResult
dell’oggettogetGeneratedDoc
* metodo.* - Crea un
Consulta anche
Avvio rapido (modalità SOAP): Creazione di un documento PDF/A tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione.
Creare un documento PDF/A utilizzando l’API del servizio Web create-a-pdf-a-document-using-the-web-service-api
Crea un documento PDF/A utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati che verranno uniti al documento PDF/A. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF da crittografare e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di esecuzione di PDF/A.
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Impostare l'opzione URI file assegnando un valore stringa che specifica la posizione del file PDF generato dal servizio Output nel
PDFOutputOptionsSpec
dell’oggettofileURI
membro dati. L'opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Imposta la
PDFAConformance
assegnando un valorePDFAConformance
valore enum perRenderOptionsSpec
dell’oggettoPDFAConformance
membro dati. Ad esempio, per specificare il livello di conformità A, assegnarePDFAConformance.A
a questo membro dati. - Imposta la
PDFARevisionNumber
assegnando un valorePDFARevisionNumber
valore enum perRenderOptionsSpec
dell’oggettoPDFARevisionNumber
membro dati. AssegnaPDFARevisionNumber.Revision_1
a questo membro dati.
note note NOTE La versione PDF di un documento PDF/A è 1.4 indipendentemente dal valore specificato. - Crea un
-
Genera un documento PDF/A.
Creare un documento PDF richiamando il
OutputServiceService
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- Un valore di enumerazione TransformationFormat. Per generare un documento PDF, specificare
TransformationFormat.PDFA
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i metadati generati che descrivono il documento. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i dati dei risultati. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - Un
OutputResult
oggetto contenente i risultati dell'operazione. Questo valore di parametro è necessario solo per la chiamata al servizio Web.
note note NOTE È inoltre possibile creare un documento PDF/A richiamando il OutputClient
dell’oggettogeneratePDFOutput
metodo 2. (Vedi Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output.) - Un valore di enumerazione TransformationFormat. Per generare un documento PDF, specificare
-
Recupera i risultati dell’operazione.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta una posizione di file XML contenente i dati dei risultati. Assicurati che l'estensione del nome file sia .xml. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto popolato con i dati dei risultati daOutputServiceService
dell’oggettogeneratePDFOutput
(l'ottavo parametro). Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
campo . - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte nel file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Trasmissione di documenti situati in Content Services (obsoleto) al servizio di output passing-documents-located-in-content-services-deprecated-to-the-output-service
Il servizio Output esegue il rendering di un modulo PDF non interattivo basato su una struttura del modulo generalmente salvata come file XDP e creata in Designer. Puoi trasmettere un com.adobe.idp.Document
oggetto contenente la struttura del modulo al servizio Output. Il servizio Output esegue quindi il rendering della struttura del modulo che si trova nel com.adobe.idp.Document
oggetto.
Il vantaggio di passare un com.adobe.idp.Document
l'oggetto al servizio Output è che altre operazioni del servizio AEM Forms restituiscono un com.adobe.idp.Document
istanza. Cioè, puoi ottenere un com.adobe.idp.Document
istanza da un'altra operazione di servizio ed esegui il rendering. Ad esempio, si supponga che un file XDP sia memorizzato in un nodo Content Services (obsoleto) denominato /Company Home/Form Designs
, come illustrato nella figura seguente.
È possibile recuperare in modo programmatico il file Loan.xdp da Content Services (obsoleto) e passare il file XDP al servizio Output all'interno di un com.adobe.idp.Document
oggetto.
Riepilogo dei passaggi summary_of_steps-2
Per passare un documento ottenuto da Content Services (obsoleto) al servizio Output, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Output e un oggetto API client di gestione documenti.
- Recupera la struttura del modulo da Content Services (obsoleto).
- Eseguire il rendering del modulo PDF non interattivo.
- Esegui un'azione con il flusso di dati.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.
Creare un oggetto Output e un oggetto API client di gestione documenti
Prima di eseguire un’operazione API del servizio di output a livello di programmazione, creare un oggetto API client di output. Inoltre, poiché questo flusso di lavoro recupera un file XDP da Content Services (obsoleto), crea un oggetto API di gestione dei documenti.
Recupera la struttura del modulo da Content Services (obsoleto)
Recupera il file XDP da Content Services (obsoleto) utilizzando l’API Java o del servizio Web. Il file XDP viene restituito all'interno di un com.adobe.idp.Document
istanza (o BLOB
(se utilizzi servizi web). È quindi possibile passare il com.adobe.idp.Document
al servizio Output.
Rendering del modulo PDF non interattivo
Per eseguire il rendering di un modulo non interattivo, passare la com.adobe.idp.Document
istanza restituita da Content Services (obsoleto) al servizio Output.
generatePDFOutput2
e g eneratePrintedOutput2
accettare com.adobe.idp.Document
oggetto contenente una struttura del modulo. È inoltre possibile passare un com.adobe.idp.Document
che contiene la struttura del modulo al servizio Output quando si invia un flusso di stampa a una stampante di rete.Eseguire un’azione con il flusso di dati del modulo
È possibile salvare il modulo non interattivo come file PDF. Il modulo può essere visualizzato in Adobe Reader o Acrobat.
Consulta anche
Trasmettere i documenti al servizio di output utilizzando l’API Java
Trasmettere i documenti al servizio di output utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Creazione di documenti PDF tramite frammenti
Trasmettere i documenti al servizio di output utilizzando l’API Java pass-documents-to-the-output-service-using-the-java-api
Passa un documento recuperato da Content Services (obsoleto) utilizzando il servizio di output e l’API Content Services (obsoleto):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar e adobe-contentservices-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Output e un oggetto API client di gestione documenti.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.) - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto. - Crea un
DocumentManagementServiceClientImpl
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Recupera la struttura del modulo da Content Services (obsoleto).
Richiama il
DocumentManagementServiceClientImpl
dell’oggettoretrieveContent
e passare i seguenti valori:- Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. Lo store predefinito è
SpacesStore
. Questo valore è un parametro obbligatorio. - Valore stringa che specifica il percorso completo del contenuto da recuperare (ad esempio,
/Company Home/Form Designs/Loan.xdp
). Questo valore è un parametro obbligatorio. - Valore stringa che specifica la versione. Questo valore è un parametro facoltativo ed è possibile trasmettere una stringa vuota. In questa situazione, viene recuperata la versione più recente.
La
retrieveContent
restituisce unCRCResult
oggetto che contiene il file XDP. Recupera uncom.adobe.idp.Document
richiamando laCRCResult
dell’oggettogetDocument
metodo . - Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. Lo store predefinito è
-
Eseguire il rendering del modulo PDF non interattivo.
Richiama il
OutputClient
dell’oggettogeneratePDFOutput2
e passare i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica la directory principale del contenuto in cui si trovano le risorse aggiuntive, ad esempio le immagini.
- A
com.adobe.idp.Document
oggetto che rappresenta la struttura del modulo (utilizzare l'istanza restituita dalCRCResult
dell’oggettogetDocument
metodo). - A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo.
La
generatePDFOutput2
restituisce unOutputResult
oggetto contenente i risultati dell'operazione. - A
-
Eseguire un’azione con il flusso di dati del modulo.
- Recupera un
com.adobe.idp.Document
oggetto che rappresenta il modulo non interattivo richiamando ilOutputResult
dell’oggettogetGeneratedDoc
metodo . - Crea un
java.io.File
oggetto contenente i risultati dell'operazione. Assicurati che l'estensione del nome file sia .pdf. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetGeneratedDoc
metodo).
- Recupera un
Consulta anche
Avvio rapido (modalità EJB): Trasmissione di documenti al servizio di output tramite l’API Java
Avvio rapido (modalità SOAP): Trasmissione di documenti al servizio di output tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Trasmettere i documenti al servizio di output utilizzando l’API del servizio Web pass-documents-to-the-output-service-using-the-web-service-api
Passa un documento recuperato da Content Services (obsoleto) utilizzando il servizio di output e l’API Content Services (obsoleto) (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Poiché questa applicazione client richiama due servizi AEM Forms, crea due riferimenti al servizio. Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Output:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Document Management:
http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
.Perché
BLOB
il tipo di dati è comune a entrambi i riferimenti di servizio e definisce completamente ilBLOB
tipo di dati quando viene utilizzato. All'avvio rapido del servizio Web corrispondente,BLOB
le istanze sono completamente qualificate.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto Output e un oggetto API client di gestione documenti.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
). Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.) -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
.
- Assegnare il nome utente del modulo di AEM al campo
-
Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
note note NOTE Ripeti questi passaggi per DocumentManagementServiceClient
* client di servizio. * -
-
Recupera la struttura del modulo da Content Services (obsoleto).
Recupera il contenuto richiamando il
DocumentManagementServiceClient
dell’oggettoretrieveContent
e passando i seguenti valori:- Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. Lo store predefinito è
SpacesStore
. Questo valore è un parametro obbligatorio. - Valore stringa che specifica il percorso completo del contenuto da recuperare (ad esempio,
/Company Home/Form Designs/Loan.xdp
). Questo valore è un parametro obbligatorio. - Valore stringa che specifica la versione. Questo valore è un parametro facoltativo ed è possibile trasmettere una stringa vuota. In questa situazione, viene recuperata la versione più recente.
- Parametro di output della stringa che memorizza il valore del collegamento di ricerca.
- A
BLOB
parametro di output che memorizza il contenuto. Puoi utilizzare questo parametro di output per recuperare il contenuto. - A
ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
parametro di output che memorizza gli attributi di contenuto. - A
CRCResult
parametro di output. Invece di utilizzare questo oggetto, è possibile utilizzare ilBLOB
parametro di output per recuperare il contenuto.
- Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. Lo store predefinito è
-
Eseguire il rendering del modulo PDF non interattivo.
Richiama il
OutputServiceClient
dell’oggettogeneratePDFOutput2
e passare i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica la directory principale del contenuto in cui si trovano le risorse aggiuntive, ad esempio le immagini.
- A
BLOB
che rappresenta la struttura del modulo (utilizzareBLOB
istanza restituita da Content Services (obsoleto). - A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - Uscita
BLOB
oggetto popolato dageneratePDFOutput2
metodo . LageneratePDFOutput2
popola l'oggetto con i metadati generati che descrivono il documento. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - Uscita
OutputResult
oggetto contenente i risultati dell'operazione. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web).
La
generatePDFOutput2
restituisce unBLOB
che contiene il modulo PDF non interattivo. - A
-
Eseguire un’azione con il flusso di dati del modulo.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF interattivo e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
BLOB
oggetto recuperato dalgeneratePDFOutput2
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Trasferimento dei documenti presenti nell'archivio al servizio di output passing-documents-located-in-the-repository-to-the-output-service
Il servizio Output esegue il rendering di un modulo PDF non interattivo basato su una struttura del modulo generalmente salvata come file XDP e creata in Designer. Puoi trasmettere un com.adobe.idp.Document
oggetto contenente la struttura del modulo al servizio Output. Il servizio Output esegue quindi il rendering della struttura del modulo che si trova nel com.adobe.idp.Document
oggetto.
Il vantaggio di passare un com.adobe.idp.Document
l'oggetto al servizio Output è che altre operazioni del servizio AEM Forms restituiscono un com.adobe.idp.Document
istanza. Cioè, puoi ottenere un com.adobe.idp.Document
istanza da un'altra operazione di servizio ed esegui il rendering. Ad esempio, si supponga che un file XDP sia memorizzato nell’archivio AEM Forms, come illustrato di seguito.
La FormsFolder La cartella è una posizione definita dall’utente nell’archivio AEM Forms (questa posizione è un esempio e non esiste per impostazione predefinita). In questo esempio, una struttura del modulo denominata Loan.xdp si trova in questa cartella. Oltre alla struttura del modulo, in questa posizione è possibile memorizzare altre informazioni collaterali come le immagini. Il percorso di una risorsa situata nell’archivio AEM Forms è:
Applications/Application-name/Application-version/Folder.../Filename
È possibile recuperare in modo programmatico il file Loan.xdp dall'archivio AEM Forms e passarlo al servizio Output all'interno di un com.adobe.idp.Document
oggetto.
È possibile creare un PDF basato su un file XDP presente nell’archivio utilizzando uno dei due modi seguenti: Puoi passare la posizione XDP tramite riferimento oppure recuperare l'XDP dal repository a livello di programmazione e passarlo al servizio Output all'interno di un file XDP.
Avvio rapido (modalità EJB): Creazione di un documento PDF basato su un file XDP dell’applicazione utilizzando l’API Java (mostra come passare la posizione del file XDP tramite riferimento).
Avvio rapido (modalità EJB): Trasmissione di un documento situato nell’archivio AEM Forms al servizio Output tramite l’API Java (mostra come recuperare in modo programmatico il file XDP dall’archivio AEM Forms e passarlo al servizio Output all’interno di un com.adobe.idp.Document
(istanza). (Questa sezione illustra come eseguire questa attività)
Riepilogo dei passaggi summary_of_steps-3
Per passare un documento ottenuto dall'archivio AEM Forms al servizio Output, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Output e un oggetto API client di gestione documenti.
- Recupera la struttura del modulo dall’archivio AEM Forms.
- Eseguire il rendering del modulo PDF non interattivo.
- Esegui un'azione con il flusso di dati.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, includi i file proxy.
Creare un oggetto Output e un oggetto API client di gestione documenti
Prima di eseguire un’operazione API del servizio di output a livello di programmazione, creare un oggetto API client di output. Inoltre, poiché questo flusso di lavoro recupera un file XDP da Content Services (obsoleto), crea un oggetto API di gestione dei documenti.
Recuperare la struttura del modulo dall’archivio AEM Forms
Recupera il file XDP dall’archivio AEM Forms utilizzando l’API Repository. (Vedi Lettura delle risorse.)
Il file XDP viene restituito all'interno di un com.adobe.idp.Document
istanza (o BLOB
(se utilizzi servizi web). È quindi possibile passare il com.adobe.idp.Document
istanza del servizio Output.
Rendering del modulo PDF non interattivo
Per eseguire il rendering di un modulo non interattivo, passare la com.adobe.idp.Document
istanza restituita utilizzando l’API del repository di AEM Forms.
generatePDFOutput2
e generatePrintedOutput2
accettare com.adobe.idp.Document
oggetto contenente una struttura del modulo. È inoltre possibile passare un com.adobe.idp.Document
che contiene la struttura del modulo al servizio Output quando si invia un flusso di stampa a una stampante di rete.Eseguire un’azione con il flusso di dati del modulo
È possibile salvare il modulo non interattivo come file PDF. Il modulo può essere visualizzato in Adobe Reader o Acrobat.
Consulta anche
Trasmettere al servizio di output i documenti presenti nell’archivio utilizzando l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
ResourceRepositoryClient
Trasmettere al servizio di output i documenti presenti nell’archivio utilizzando l’API Java pass-documents-located-in-the-repository-to-the-output-service-using-the-java-api
Passa un documento recuperato dall’archivio utilizzando il servizio di output e l’API dell’archivio (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar e adobe-repository-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Output e un oggetto API client di gestione documenti.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. (Vedi Impostazione delle proprietà di connessione.) - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto. - Crea un
DocumentManagementServiceClientImpl
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Recupera la struttura del modulo dall’archivio AEM Forms.
Richiama il
ResourceRepositoryClient
dell’oggettoreadResourceContent
e passare un valore stringa che specifica la posizione URI nel file XDP. Ad esempio,/Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. Questo valore è obbligatorio. Questo metodo restituisce uncom.adobe.idp.Document
istanza che rappresenta il file XDP. -
Eseguire il rendering del modulo PDF non interattivo.
Richiama il
OutputClient
dell’oggettogeneratePDFOutput2
e passare i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica la directory principale del contenuto in cui si trovano le risorse aggiuntive, ad esempio le immagini. Esempio:
repository:///Applications/FormsApplication/1.0/FormsFolder/
. - A
com.adobe.idp.Document
oggetto che rappresenta la struttura del modulo (utilizzare l'istanza restituita dalResourceRepositoryClient
dell’oggettoreadResourceContent
metodo). - A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo.
La
generatePDFOutput2
restituisce unOutputResult
oggetto contenente i risultati dell'operazione. - A
-
Eseguire un’azione con il flusso di dati del modulo.
- Recupera un
com.adobe.idp.Document
oggetto che rappresenta il modulo non interattivo richiamando ilOutputResult
dell’oggettogetGeneratedDoc
metodo . - Crea un
java.io.File
oggetto contenente i risultati dell'operazione. Assicurati che l'estensione del nome file sia .pdf. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetGeneratedDoc
metodo).
- Recupera un
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Creazione di documenti PDF tramite frammenti creating-pdf-documents-using-fragments
È possibile utilizzare i servizi Output e Assembler per creare un flusso di output, ad esempio un documento PDF, basato sui frammenti. Il servizio Assembler assembla un documento XDP basato su frammenti che si trovano in più file XDP. Il documento XDP assemblato viene passato al servizio Output, che crea un documento PDF. Anche se questo flusso di lavoro mostra un documento PDF in fase di generazione, il servizio Output può generare altri tipi di output, ad esempio ZPL, per questo flusso di lavoro. Un documento PDF viene utilizzato solo a scopo di discussione.
L’illustrazione seguente mostra questo flusso di lavoro.
Prima della lettura Creazione di documenti PDF tramite frammenti, si consiglia di acquisire familiarità con l'utilizzo del servizio Assembler per assemblare più documenti XDP. (Vedi Assemblaggio di più frammenti XDP.)
Riepilogo dei passaggi summary_of_steps-4
Per creare un documento PDF basato sui frammenti, procedere come segue:
- Includi file di progetto.
- Creare un oggetto client Output e Assembler.
- Utilizzare il servizio Assembler per generare la struttura del modulo.
- Utilizzare il servizio Output per generare il documento PDF.
- Salvare il documento PDF come file PDF.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
Creare un oggetto client Output e Assembler
Prima di eseguire un’operazione API del servizio Output a livello di programmazione, creare un oggetto API client di output. Inoltre, poiché questo flusso di lavoro richiama il servizio Assembler per creare la struttura del modulo, creare un oggetto API client Assembler.
Utilizzare il servizio Assembler per generare la struttura del modulo
Utilizzare il servizio Assembler per generare la struttura del modulo utilizzando i frammenti. Il servizio Assembler restituisce un com.adobe.idp.Document
istanza che contiene la struttura del modulo.
Utilizzare il servizio Output per generare il documento PDF
È possibile utilizzare il servizio Output per generare un documento PDF utilizzando la struttura del modulo creata dal servizio Assembler. Passa la com.adobe.idp.Document
istanza restituita dal servizio Assembler al servizio Output.
Salvare il documento PDF come file PDF
Dopo la generazione di un documento PDF da parte del servizio Output, è possibile salvarlo come file PDF.
Consulta anche
Creare un documento PDF basato sui frammenti utilizzando l’API Java
Creare un documento PDF basato sui frammenti utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Assemblaggio di più frammenti XDP
Creare un documento PDF basato sui frammenti utilizzando l’API Java create-a-pdf-document-based-on-fragments-using-the-java-api
Crea un documento PDF basato sui frammenti utilizzando l’API del servizio di output e l’API del servizio Assembler (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto client Output e Assembler.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto. - Crea un
AssemblerServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Utilizzare il servizio Assembler per generare la struttura del modulo.
Richiama il
AssemblerServiceClient
dell’oggettoinvokeDDX
e trasmettere i seguenti valori richiesti:- A
com.adobe.idp.Document
oggetto che rappresenta il documento DDX da utilizzare. - A
java.util.Map
oggetto che contiene i file XDP di input. - A
com.adobe.livecycle.assembler.client.AssemblerOptionSpec
oggetto che specifica le opzioni di esecuzione, incluso il carattere predefinito e il livello del registro di lavoro.
La
invokeDDX
restituisce uncom.adobe.livecycle.assembler.client.AssemblerResult
oggetto contenente il documento XDP assemblato. Per recuperare il documento XDP assemblato, eseguire le operazioni seguenti:- Richiama il
AssemblerResult
dell’oggettogetDocuments
metodo . Questo metodo restituisce unjava.util.Map
oggetto. - Itera attraverso il
java.util.Map
finché non trovi il risultatocom.adobe.idp.Document
oggetto. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
metodo per estrarre il documento XDP assemblato.
- A
-
Utilizzare il servizio Output per generare il documento PDF.
Richiama il
OutputClient
dell’oggettogeneratePDFOutput2
e passare i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
- Valore stringa che specifica la directory principale del contenuto in cui si trovano le risorse aggiuntive, ad esempio le immagini.
- A
com.adobe.idp.Document
oggetto che rappresenta la struttura del modulo (utilizzare l'istanza restituita dal servizio Assembler) - A
PDFOutputOptionsSpec
oggetto contenente le opzioni di esecuzione di PDF - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering - La
com.adobe.idp.Document
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo
La
generatePDFOutput2
restituisce unOutputResult
oggetto contenente i risultati dell'operazione - A
-
Salvare il documento PDF come file PDF.
- Recupera un
com.adobe.idp.Document
oggetto che rappresenta il documento PDF richiamando ilOutputResult
dell’oggettogetGeneratedDoc
metodo . - Crea un
java.io.File
oggetto contenente i risultati dell'operazione. Assicurati che l'estensione del nome del file sia .pdf. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file. (Assicurati di utilizzare ilcom.adobe.idp.Document
oggetto chegetGeneratedDoc
restituito.).
- Recupera un
Consulta anche
Avvio rapido (modalità EJB): Creazione di un documento PDF basato su frammenti tramite l’API Java
Avvio rapido (modalità SOAP): Creazione di un documento PDF basato su frammenti tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione.
Creare un documento PDF basato sui frammenti utilizzando l’API del servizio Web create-a-pdf-document-based-on-fragments-using-the-web-service-api
Crea un documento PDF basato sui frammenti utilizzando l’API del servizio di output e l’API del servizio Assembler (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Output:
code language-as3 http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.
Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Assembler:
code language-as3 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.
Perché
BLOB
il tipo di dati è comune a entrambi i riferimenti di servizio e definisce completamente ilBLOB
tipo di dati quando viene utilizzato. All'avvio rapido del servizio Web corrispondente,BLOB
le istanze sono completamente qualificate.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto client Output e Assembler.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente dei moduli di AEM al
OutputServiceClient.ClientCredentials.UserName.UserName
campo . - Assegna il valore della password corrispondente al
OutputServiceClient.ClientCredentials.UserName.Password
campo . - Assegna il valore costante
HttpClientCredentialType.Basic
alBasicHttpBindingSecurity.Transport.ClientCredentialType
campo .
- Assegnare il nome utente dei moduli di AEM al
-
Assegna
BasicHttpSecurityMode.TransportCredentialOnly
valore costante nelBasicHttpBindingSecurity.Security.Mode
campo .
note note NOTE Ripeti questi passaggi per AssemblerServiceClient
* oggetto. * -
-
Utilizzare il servizio Assembler per generare la struttura del modulo.
Richiama il
AssemblerServiceClient
dell’oggettoinvokeDDX
e passare i seguenti valori:- A
BLOB
oggetto che rappresenta il documento DDX - La
MyMapOf_xsd_string_To_xsd_anyType
oggetto contenente i file richiesti - Un
AssemblerOptionSpec
oggetto che specifica le opzioni di esecuzione
La
invokeDDX
restituisce unAssemblerResult
oggetto contenente i risultati del processo ed eventuali eccezioni. Per ottenere il documento XDP appena creato, esegui le seguenti operazioni:- Accedere al
AssemblerResult
dell’oggettodocuments
un campoMap
oggetto contenente i documenti PDF risultanti. - Itera attraverso il
Map
oggetto per recuperare la struttura del modulo assemblato. Cast del membro della matricevalue
aBLOB
. Passa questoBLOB
al servizio Output.
- A
-
Utilizzare il servizio Output per generare il documento PDF.
Richiama il
OutputServiceClient
dell’oggettogeneratePDFOutput2
e passare i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica la directory principale del contenuto in cui si trovano le risorse aggiuntive, ad esempio le immagini.
- A
BLOB
che rappresenta la struttura del modulo (utilizzareBLOB
istanza restituita dal servizio Assembler). - A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - Uscita
BLOB
oggetto chegeneratePDFOutput2
viene compilato. LageneratePDFOutput2
popola l'oggetto con i metadati generati che descrivono il documento. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - Uscita
OutputResult
oggetto contenente i risultati dell'operazione. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web).
La
generatePDFOutput2
restituisce unBLOB
che contiene il modulo PDF non interattivo. - A
-
Salvare il documento PDF come file PDF.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF interattivo e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
BLOB
oggetto recuperato dalgeneratePDFOutput2
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Stampa su file printing-to-files
È possibile utilizzare il servizio Output per stampare su un file flussi quali PostScript, PCL (Printer Control Language) o i seguenti formati di etichetta:
- Zebra - ZPL
- Intermec - IPL
- Datamax - DPL
- TecToshiba - TPCL
Utilizzando il servizio Output, è possibile unire i dati XML con una struttura del modulo e stampare il modulo in un file. L'illustrazione seguente mostra il servizio Output che crea file laser ed etichette.
Riepilogo dei passaggi summary_of_steps-5
Per stampare su un file, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Impostare le opzioni di esecuzione della stampa necessarie per stampare su un file.
- Stampa il flusso di stampa su un file.
- Recupera i risultati dell’operazione.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms. (Vedi Inclusione dei file libreria Java di AEM Forms.)
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceService
oggetto.
Riferimento a un’origine dati XML
Per stampare un documento contenente dati, è necessario fare riferimento a un'origine dati XML contenente elementi XML per ogni campo del modulo che si desidera compilare con i dati. 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. Se vengono specificati tutti gli elementi XML, non è necessario stabilire una corrispondenza con l’ordine in cui vengono visualizzati gli elementi XML.
Impostare le opzioni di esecuzione della stampa necessarie per stampare su un file
Per stampare su un file, è necessario impostare l'opzione File URI di esecuzione specificando la posizione e il nome del file su cui viene stampato il servizio Output. Ad esempio, per richiedere al servizio Output di stampare un file PostScript denominato MutuiForm.ps a C:\Adobe, specifica C:\Adobe\MortgageForm.ps.
PrintedOutputOptionsSpec
riferimento di classe in Riferimento API di AEM Forms.Stampa il flusso di stampa su un file
Dopo aver fatto riferimento a un'origine dati XML valida contenente i dati del modulo e aver impostato le opzioni di esecuzione della stampa, è possibile richiamare il servizio Output, che lo causa nella stampa di un file.
Recupera i risultati dell'operazione
Dopo l'esecuzione di un'operazione, il servizio Output restituisce vari elementi di dati, ad esempio dati XML, che specificano se l'operazione ha avuto esito positivo.
Consulta anche
Stampa su file utilizzando l’API Java
Stampa su file tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Stampa su file utilizzando l’API Java print-to-files-using-the-java-api
Stampa su un file utilizzando l’API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML utilizzata per compilare il documento utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di esecuzione della stampa necessarie per stampare su un file.
- Crea un
PrintedOutputOptionsSpec
utilizzando il relativo costruttore. - Specificare il file richiamando l'oggetto PraintOutputOptionsSpec
setFileURI
e passare un valore stringa che rappresenta il nome e la posizione del file. Ad esempio, se si desidera che il servizio Output venga stampato su un file PostScript denominato* MortagelForm.ps* situato in C:\Adobe, specificare C:\Adobe\MortgageForm.ps. - Specificare il numero di copie da stampare richiamando il
PrintedOutputOptionsSpec
dell’oggettosetCopies
e passare un valore intero che rappresenta il numero di copie.
- Crea un
-
Stampa il flusso di stampa su un file.
Stampa su un file richiamando il
OutputClient
dell’oggettogeneratePrintedOutput
e passando i seguenti valori:- A
PrintFormat
valore di enumerazione che specifica il formato del flusso di stampa da creare. Ad esempio, per creare un flusso di stampa PostScript, passarePrintFormat.PostScript
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la posizione dei relativi file collaterali, ad esempio i file immagine.
- Valore stringa che specifica la posizione del file XDC da utilizzare (è possibile passare
null
se è stato specificato il file XDC da utilizzare utilizzandoPrintedOutputOptionsSpec
oggetto). - La
PrintedOutputOptionsSpec
oggetto contenente le opzioni di esecuzione necessarie per la stampa in un file. - La
com.adobe.idp.Document
oggetto che contiene l'origine dati XML contenente i dati del modulo.
La
generatePrintedOutput
restituisce unOutputResult
oggetto contenente i risultati dell'operazione.note note NOTE La OutputResult
dell’oggettogetRecordLevelMetaDataList
restituisce il metodonull
* * - A
-
Recupera i risultati dell’operazione.
- Crea un
com.adobe.idp.Document
che rappresenta lo statogeneratePrintedOutput
richiamando il metodoOutputResult
dell’oggettogetStatusDoc
il metodoOutputResult
è stato restituito dall'oggettogeneratePrintedOutput
metodo). - Crea un
java.io.File
oggetto che conterrà i risultati dell'operazione. Assicurati che l'estensione del file sia XML. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetStatusDoc
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità SOAP): Stampa su un file tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione.
Stampa su file tramite l’API del servizio Web print-to-files-using-the-web-service-api
Stampa su un file utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati del modulo. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML contenente i dati del modulo. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativobinaryData
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di esecuzione della stampa necessarie per stampare su un file.
- Crea un
PrintedOutputOptionsSpec
utilizzando il relativo costruttore. - Specificare il file assegnando un valore stringa che rappresenta la posizione e il nome del file al
PrintedOutputOptionsSpec
dell’oggettofileURI
membro dati. Ad esempio, se si desidera che il servizio Output venga stampato in un file PostScript denominato MutuiForm.ps situato in C:\Adobe, specifica C:\Adobe\MortgageForm.ps. - Specificare il numero di copie da stampare assegnando un valore intero che rappresenta il numero di copie nel
PrintedOutputOptionsSpec
dell’oggettocopies
membri dati.
- Crea un
-
Stampa il flusso di stampa su un file.
Stampa su un file richiamando il
OutputServiceService
dell’oggettogeneratePrintedOutput
e passando i seguenti valori:- A
PrintFormat
valore di enumerazione che specifica il formato del flusso di stampa da creare. Ad esempio, per creare un flusso di stampa PostScript, passarePrintFormat.PostScript
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la posizione dei relativi file collaterali, ad esempio i file immagine.
- Valore stringa che specifica la posizione del file XDC da utilizzare (è possibile passare
null
se è stato specificato il file XDC da utilizzare utilizzandoPrintedOutputOptionsSpec
oggetto). - La
PrintedOutputOptionsSpec
oggetto contenente le opzioni di esecuzione della stampa necessarie per la stampa su un file. - La
BLOB
oggetto contenente l'origine dati XML contenente i dati del modulo. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i metadati generati che descrivono il documento. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i dati dei risultati. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - Un
OutputResult
oggetto contenente i risultati dell'operazione. Questo valore di parametro è necessario solo per la chiamata al servizio Web.
- A
-
Recupera i risultati dell’operazione.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta una posizione di file XML contenente i dati dei risultati. Assicurati che l'estensione del file sia XML. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto popolato con i dati dei risultati daOutputServiceService
dell’oggettogeneratePDFOutput
(l'ottavo parametro). Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte nel file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Invio di flussi di stampa alle stampanti sending-print-streams-to-printers
È possibile utilizzare il servizio Output per inviare flussi di stampa quali PostScript, PCL (Printer Control Language) o i seguenti formati di etichetta alle stampanti di rete:
- Zebra - ZPL
- Intermec - IPL
- Datamax - DPL
- TecToshiba - TPCL
Utilizzando il servizio Output, è possibile unire i dati XML con una struttura del modulo e generare il modulo come flusso di stampa. Ad esempio, è possibile creare un flusso di stampa PostScript e inviarlo a una stampante di rete. Nell'illustrazione seguente viene illustrato l'invio di flussi di stampa da parte del servizio Output a stampanti di rete.
Riepilogo dei passaggi summary_of_steps-6
Per inviare un flusso di stampa a una stampante di rete, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Impostare le opzioni di esecuzione della stampa
- Recupera un documento da stampare.
- Inviare il documento a una stampante di rete.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un oggetto Client di output
Prima di eseguire un'operazione del servizio Output a livello di programmazione, creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceClient
oggetto.
Riferimento a un’origine dati XML
Per stampare un documento contenente dati, è necessario fare riferimento a un'origine dati XML contenente elementi XML per ogni campo del modulo che si desidera compilare con i dati. 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. Se vengono specificati tutti gli elementi XML, non è necessario stabilire una corrispondenza con l’ordine in cui vengono visualizzati gli elementi XML.
Impostare le opzioni di esecuzione della stampa
È possibile impostare le opzioni di esecuzione durante l'invio di un flusso di stampa a una stampante, incluse le seguenti opzioni:
- Copie: Specifica il numero di copie da inviare alla stampante. Il valore predefinito è 1.
- graffetta: Quando si utilizza un ripiano, viene impostata un'opzione XCI. Questa opzione può essere specificata nel modello di configurazione dall'elemento di base e viene utilizzata solo per stampanti PS e PCL.
- OutputJog: L'opzione XCI viene impostata quando le pagine di output devono essere sottoposte a jogging (fisicamente spostate nella barra di uscita). Questa opzione è disponibile solo per stampanti PS e PCL.
- OutputBin: Valore XCI utilizzato per consentire al driver di stampa di selezionare il bin di output appropriato.
PrintedOutputOptionsSpec
riferimento della classe.Recupera un documento da stampare
Recupera un flusso di stampa da inviare a una stampante. Ad esempio, è possibile recuperare un file PostScript e inviarlo a una stampante.
Se la stampante supporta PDF, è possibile scegliere di inviare un file PDF. Tuttavia, un problema relativo all'invio di un documento PDF a una stampante è rappresentato dal fatto che ogni produttore della stampante ha implementato in modo diverso l'interprete PDF. Alcuni produttori di stampa utilizzano l'interpretazione Adobe PDF, ma dipende dalla stampante. Altre stampanti hanno un proprio interprete PDF. Di conseguenza, i risultati della stampa possono variare.
Un'altra limitazione dell'invio di un documento PDF a una stampante è la stampa; non può accedere a duplex, selezione del vassoio della carta e cucitura, ad eccezione delle impostazioni sulla stampante.
Per recuperare un documento da stampare, utilizzare la generatePrintedOutput
metodo . La tabella seguente specifica i tipi di contenuto impostati per un dato flusso di stampa quando si utilizza il generatePrintedOutput
metodo .
generatePrintedOutput2
metodo . Tuttavia, gli avvii rapidi associati alla sezione Invio di flussi di stampa a stampanti utilizzano la generatePrintedOutput
metodo .Inviare il flusso di stampa a una stampante di rete
Dopo aver recuperato un documento da stampare, è possibile richiamare il servizio Output, che lo fa inviare un flusso di stampa a una stampante di rete. Affinché il servizio Output possa individuare correttamente la stampante, è necessario specificare sia il server di stampa che il nome della stampante. Inoltre, è necessario specificare anche il protocollo di stampa.
Inviare un flusso di stampa a una stampante di rete utilizzando l'API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Riferimento a un’origine dati XML
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML utilizzata per compilare il documento utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di esecuzione della stampa
Crea un
PrintedOutputOptionsSpec
oggetto che rappresenta le opzioni di esecuzione della stampa. Ad esempio, è possibile specificare il numero di copie da stampare richiamando ilPrintedOutputOptionsSpec
dell’oggettosetCopies
metodo .note note NOTE Non è possibile impostare il valore di impaginazione utilizzando la variabile PrintedOutputOptionsSpec
dell’oggettosetPagination
se si sta generando un flusso di stampa ZPL. Allo stesso modo, non è possibile impostare le seguenti opzioni per un flusso di stampa ZPL: OutputJog, PageOffset e Staple. LasetPagination
* metodo non valido per la generazione PostScript. È valido solo per la generazione PCL. * -
Recupera un documento da stampare
-
Recupera un documento da stampare richiamando il
OutputClient
dell’oggettogeneratePrintedOutput
e passando i seguenti valori:- A
PrintFormat
valore di enumerazione che specifica il flusso di stampa. Ad esempio, per creare un flusso di stampa PostScript, passarePrintFormat.PostScript
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la posizione dei relativi file collaterali, ad esempio i file di immagine.
- Valore stringa che specifica la posizione del file XDC da utilizzare.
- La
PrintedOutputOptionsSpec
oggetto contenente le opzioni di esecuzione necessarie per la stampa in un file. - La
com.adobe.idp.Document
oggetto che rappresenta l’origine dati XML contenente i dati del modulo da unire alla struttura del modulo.
Questo metodo restituisce un
OutputResult
oggetto contenente i risultati dell'operazione. - A
-
Crea un
com.adobe.idp.Document
oggetto da inviare alla stampante richiamando ilOutputResult
oggetto ‘sgetGeneratedDoc
metodo . Questo metodo restituisce uncom.adobe.idp.Document
oggetto.
-
-
Inviare il flusso di stampa a una stampante di rete
Inviare il flusso di stampa a una stampante di rete richiamando il
OutputClient
dell’oggettosendToPrinter
e passando i seguenti valori:- A
com.adobe.idp.Document
oggetto che rappresenta il flusso di stampa da inviare alla stampante. - A
PrinterProtocol
valore di enumerazione che specifica il protocollo della stampante da utilizzare. Ad esempio, per specificare il protocollo SharedPrinter, passarePrinterProtocol.SharedPrinter
. - Valore stringa che specifica il nome del server di stampa. Ad esempio, supponendo che il nome del server di stampa sia PrintServer1, passare
\\\PrintSever1
. - Valore stringa che specifica il nome della stampante. Ad esempio, supponendo che il nome della stampante sia Printer1, passare
\\\PrintSever1\Printer1
.
note note NOTE La sendToPrinter
è stato aggiunto all’API AEM Forms nella versione 8.2.1. - A
Inviare un flusso di stampa a una stampante utilizzando l’API del servizio Web send-a-print-stream-to-a-printer-using-the-web-service-api
Inviare un flusso di stampa a una stampante di rete utilizzando l'API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
* con l’indirizzo IP del server che ospita AEM Forms. * -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati del modulo. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passare un valore di stringa che specifica la posizione del file XML contenente i dati del modulo. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. Determina la lunghezza della matrice dei byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di esecuzione della stampa.
Crea un
PrintedOutputOptionsSpec
utilizzando il relativo costruttore. Ad esempio, è possibile specificare il numero di copie da stampare assegnando un valore intero che rappresenta il numero di copie da stamparePrintedOutputOptionsSpec
dell’oggettocopies
membro dati.note note NOTE Non è possibile impostare il valore di impaginazione utilizzando la variabile PrintedOutputOptionsSpec
dell’oggettopagination
membro dati se si sta generando un flusso di stampa ZPL. Allo stesso modo, non è possibile impostare le seguenti opzioni per un flusso di stampa ZPL: OutputJog, PageOffset e Staple. Lapagination
* membro dati non valido per la generazione PostScript. È valido solo per la generazione PCL. * -
Recupera un documento da stampare.
-
Recupera un documento da stampare richiamando il
OutputServiceService
dell’oggettogeneratePrintedOutput
e passando i seguenti valori:- A
PrintFormat
valore di enumerazione che specifica il flusso di stampa. Ad esempio, per creare un flusso di stampa PostScript, passarePrintFormat.PostScript
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la posizione dei relativi file collaterali, ad esempio i file di immagine.
- Valore stringa che specifica la posizione del file XDC da utilizzare.
- La
PrintedOutputOptionsSpec
oggetto contenente le opzioni di esecuzione della stampa utilizzate per l'invio di un flusso di stampa a una stampante di rete. - La
BLOB
oggetto contenente l'origine dati XML contenente i dati del modulo. - A
BLOB
oggetto popolato dageneratePrintedOutput
metodo . LageneratePrintedOutput
popola l'oggetto con i metadati generati che descrivono il documento. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - A
BLOB
oggetto popolato dageneratePrintedOutput
metodo . LageneratePrintedOutput
popola l'oggetto con i dati dei risultati. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - Un
OutputResult
oggetto contenente i risultati dell'operazione. Questo valore di parametro è necessario solo per la chiamata al servizio Web.
- A
-
Crea un
BLOB
oggetto da inviare alla stampante ottenendo il valore delOutputResult
oggetto ‘sgeneratedDoc
metodo . Questo metodo restituisce unBLOB
oggetto contenente i dati PostScript restituiti dageneratePrintedOutput
metodo .
-
-
Inviare il flusso di stampa a una stampante di rete.
Inviare il flusso di stampa a una stampante di rete richiamando il
OutputClient
dell’oggettosendToPrinter
e passando i seguenti valori:- A
BLOB
oggetto che rappresenta il flusso di stampa da inviare alla stampante. - A
PrinterProtocol
valore di enumerazione che specifica il protocollo della stampante da utilizzare. Ad esempio, per specificare il protocollo SharedPrinter, passarePrinterProtocol.SharedPrinter
. - A
bool
che specifica se utilizzare il valore del parametro precedente. Passa il valoretrue
. Questo valore di parametro è necessario solo per la chiamata al servizio Web. - Valore stringa che specifica il nome del server di stampa. Ad esempio, supponendo che il nome del server di stampa sia PrintServer1, passare
\\\PrintSever1
. - Valore stringa che specifica il nome della stampante. Ad esempio, supponendo che il nome della stampante sia Printer1, passare
\\\PrintSever1\Printer1
.
note note NOTE La sendToPrinter
è stato aggiunto all’API AEM Forms nella versione 8.2.1. - A
Creazione di più file di output creating-multiple-output-files
Il servizio Output può creare documenti separati per ogni record all'interno di un'origine dati XML o di un singolo file contenente tutti i record (questa funzionalità è l'impostazione predefinita). Ad esempio, si supponga che dieci record si trovino all'interno di un'origine dati XML e si istruisce il servizio Output di creare documenti PDF separati (o altri tipi di output) per ciascun record utilizzando l'API del servizio di output. Di conseguenza, il servizio Output genera dieci documenti PDF. Invece di creare documenti, è possibile inviare più flussi di stampa a una stampante.
L'illustrazione seguente mostra anche il servizio Output che elabora un file di dati XML contenente più record. Tuttavia, si supponga di istruire il servizio Output per creare un singolo documento PDF contenente tutti i record di dati. In questa situazione, il servizio Output genera un documento contenente tutti i record.
Nell'illustrazione seguente viene illustrato il servizio Output che elabora un file di dati XML contenente più record. Si supponga di istruire il servizio Output per creare un documento PDF separato per ogni record di dati. In questa situazione, il servizio Output genera un documento PDF separato per ogni record di dati.
I seguenti dati XML mostrano un esempio di file di dati che contiene tre record di dati.
<?xml version="1.0" encoding="UTF-8"?>
<batch>
<LoanRecord>
<mortgageAmount>500000</mortgageAmount>
<lastName>Blue</lastName>
<firstName>Tony</firstName>
<SSN>555666777</SSN>
<PositionTitle>Product Manager</PositionTitle>
<Address>555 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>TBlue@NoMailServer.com</Email>
<PhoneNum>555-7418</PhoneNum>
<FaxNum>555-9981</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>300000</mortgageAmount>
<lastName>White</lastName>
<firstName>Sam</firstName>
<SSN>555666222</SSN>
<PositionTitle>Program Manager</PositionTitle>
<Address>557 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>SWhite@NoMailServer.com</Email>
<PhoneNum>555-7445</PhoneNum>
<FaxNum>555-9986</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>700000</mortgageAmount>
<lastName>Green</lastName>
<firstName>Steve</firstName>
<SSN>55566688</SSN>
<PositionTitle>Project Manager</PositionTitle>
<Address>445 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>SGreeb@NoMailServer.com</Email>
<PhoneNum>555-2211</PhoneNum>
<FaxNum>555-2221</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
</batch>
L’elemento XML che avvia e termina ogni record di dati è LoanRecord
. A questo elemento XML viene fatto riferimento dalla logica dell'applicazione che genera più file.
Riepilogo dei passaggi summary_of_steps-7
Per creare più file PDF basati su un’origine dati XML, effettua le seguenti operazioni:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Impostare le opzioni di runtime di PDF.
- Imposta le opzioni di esecuzione del rendering.
- Generare più file PDF.
- Recupera i risultati dell’operazione.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceService
oggetto.
Riferimento a un’origine dati XML
Fare riferimento a un'origine dati XML contenente più record. Per separare i record di dati è necessario utilizzare un elemento XML. Ad esempio, nell’origine dati XML di esempio mostrata in precedenza in questa sezione, l’elemento XML che separa i record di dati viene denominato LoanRecord
.
Per ogni campo del modulo che si desidera compilare con i dati deve esistere un elemento XML. 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. Se vengono specificati tutti gli elementi XML, non è necessario stabilire una corrispondenza con l’ordine in cui vengono visualizzati gli elementi XML.
Impostare le opzioni di runtime di PDF
Per creare correttamente più file in base a un'origine dati XML, è necessario impostare le seguenti opzioni di esecuzione per il servizio Output:
- Molti file: Specifica se il servizio Output crea uno o più documenti. È possibile specificare true o false. Per creare un documento separato per ogni record di dati nell'origine dati XML, specificare true.
- URI file: Specifica la posizione dei file generati dal servizio Output. Ad esempio, si supponga di specificare C:\Adobe\forms\Loan.pdf. In questa situazione, il servizio Output crea un file denominato Loan.pdf e inserisce il file nella cartella C:\Adobe\forms folder. In presenza di più file, i nomi dei file sono Loan0001.pdf, Loan002.pdf, Loan0003.pdf e così via. Se si specifica un percorso di file, i file vengono inseriti sul server, non sul computer client.
- Nome record: Specifica il nome dell'elemento XML nell'origine dati che separa i record di dati. Ad esempio, nell’origine dati XML di esempio mostrata in precedenza in questa sezione, viene chiamato l’elemento XML che separa i record di dati
LoanRecord
. Anziché impostare l’opzione di esecuzione Nome record, è possibile impostare il livello di record assegnandogli un valore numerico che indica il livello di elemento contenente i record di dati. Tuttavia, è possibile impostare solo il Nome record o il Livello record. Non è possibile impostare entrambi i valori.)
Impostare le opzioni di esecuzione del rendering
È possibile impostare le opzioni di esecuzione del rendering durante la creazione di più file. Sebbene queste opzioni non siano necessarie (a differenza delle opzioni di esecuzione dell'output, che sono necessarie), è possibile eseguire attività quali il miglioramento delle prestazioni del servizio Output. Ad esempio, è possibile memorizzare nella cache la struttura del modulo utilizzata dal servizio Output per migliorare le prestazioni.
Quando il servizio Output elabora i record batch, legge i dati che contengono più record in modo incrementale. In altre parole, il servizio Output legge i dati in memoria e rilascia i dati durante l'elaborazione del batch di record. Il servizio Output carica i dati in modo incrementale quando è impostata una delle due opzioni di runtime. Se si imposta l'opzione di esecuzione Nome record, il servizio Output legge i dati in modo incrementale. Allo stesso modo, se si imposta l'opzione di esecuzione a livello di record su 2 o superiore, il servizio di output legge i dati in modo incrementale.
È possibile controllare se il servizio di output esegue il caricamento incrementale utilizzando il PDFOutputOptionsSpec
o PrintedOutputOptionSpec
dell’oggetto setLazyLoading
metodo . Puoi trasmettere il valore false
a questo metodo che disattiva il caricamento incrementale.
Generare più file PDF
Dopo aver fatto riferimento a un'origine dati XML valida contenente più record di dati e aver impostato le opzioni di esecuzione, è possibile richiamare il servizio Output, che ne determina la generazione di più file. Quando si generano più record, il OutputResult
dell’oggetto getGeneratedDoc
restituisce il metodo null
.
Recupera i risultati dell'operazione
Dopo aver eseguito un'operazione, il servizio Output restituisce dati XML che specificano se l'operazione è riuscita. Il seguente XML viene restituito dal servizio Output. In questa situazione, il servizio di output ha generato 42 documenti.
<?xml version="1.0" encoding="UTF-8"?>
<printResult>
<status>0</status>
<requestId>4ad85f9e2</requestId>
<context/>
<messages>
<message>Printed all 42 records successfully.</message>
</messages>
<printSpec>
<input>
<validated>true</validated>
<dataFile recordIdField="" recordLevel="0" recordName="LoanRecord"/>
<sniffRules lookAhead="300"/>
<formDesign>Loan.xdp</formDesign>
<contentRoot>C:\Adobe</contentRoot>
<metadata-spec record="false"/>
</input>
<output>
<format>PDF</format>
<fileURI>C:\Adobe\forms\Loan.pdf</fileURI>
<optionString>cacheenabled=true&padebug=false&linearpdf=false&pdfarevisionnumber=1&pdfaconformance=A&taggedpdf=false&TransactionTimeOut=180</optionString>
<waitForResponse>true</waitForResponse>
<outputStream>multiple</outputStream>
</output>
</printSpec>
</printResult>
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Creare più file PDF utilizzando l’API Java create-multiple-pdf-files-using-the-java-api
Creare più file PDF utilizzando l’API di output (Java):
-
Includi file di progetto"
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java. .
-
Creare un oggetto Client di output
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Riferimento a un’origine dati XML
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML contenente più record utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Impostare le opzioni di runtime di PDF
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Imposta l'opzione Molti file richiamando il
PDFOutputOptionsSpec
dell’oggettosetGenerateManyFiles
metodo . Ad esempio, passa il valoretrue
istruzioni al servizio Output di creare un file PDF separato per ogni record nell'origine dati XML. (Se passifalse
, il servizio Output genera un singolo documento PDF contenente tutti i record. - Imposta l'opzione URI file richiamando il
PDFOutputOptionsSpec
dell’oggettosetFileUri
e passare un valore stringa che specifica la posizione dei file generati dal servizio Output. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client. - Imposta l’opzione Nome record richiamando la
OutputOptionsSpec
dell’oggettosetRecordName
e passare un valore stringa che specifica il nome dell'elemento XML nell'origine dati che separa i record di dati. Ad esempio, considerare l'origine dati XML mostrata in precedenza in questa sezione. Il nome dell'elemento XML che separa i record di dati è LoanRecord).
- Crea un
-
Impostare le opzioni di esecuzione del rendering
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output richiamando il
RenderOptionsSpec
dell’oggettosetCacheEnabled
e passando unBoolean
valoretrue
.
- Crea un
-
Generare più file PDF
Generare più file PDF richiamando il
OutputClient
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore enum. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo.
La
generatePDFOutput
restituisce unOutputResult
oggetto contenente i risultati dell'operazione. - A
-
Recupera i risultati dell'operazione
- Crea un
java.io.File
oggetto che rappresenta un file XML che conterrà i risultati delgeneratePDFOutput
metodo . Assicurati che l'estensione del nome file sia .xml. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito daapplyUsageRights
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità EJB): Creazione di più file PDF tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Creare più file PDF utilizzando l’API del servizio Web create-multiple-pdf-files-using-the-web-service-api
Creare più file PDF utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati del modulo contenenti più record. - Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passare un valore di stringa che rappresenta la posizione del file XML contenente più record. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Impostare le opzioni di runtime di PDF.
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Imposta l’opzione Molti file assegnando un valore booleano al
OutputOptionsSpec
dell’oggettogenerateManyFiles
membro dati. Ad esempio, assegna il valoretrue
a questo membro dati per istruire il servizio Output di creare un file PDF separato per ogni record nell'origine dati XML. (Se si assegnafalse
a questo membro dati, il servizio Output genera un singolo PDF che contiene tutti i record. - Impostare l'opzione URI del file assegnando un valore stringa che specifica la posizione dei file generati dal servizio Output nel
OutputOptionsSpec
dell’oggettofileURI
membro dati. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client. - Impostare l'opzione nome record assegnando un valore stringa che specifica il nome dell'elemento XML nell'origine dati che separa i record di dati dalla
OutputOptionsSpec
dell’oggettorecordName
membro dati. - Impostare l'opzione copie assegnando un valore intero che specifica il numero di copie generate dal servizio Output al
OutputOptionsSpec
dell’oggettocopies
membro dati.
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output assegnando il valore
true
alRenderOptionsSpec
dell’oggettocacheEnabled
membro dati.
- Crea un
-
Generare più file PDF.
Creazione di più file PDF richiamando il
OutputServiceService
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- Valore enum di TransformationFormat. Per generare un documento PDF, specificare
TransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i metadati generati che descrivono il documento. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i dati dei risultati. - Un
OutputResult
oggetto contenente i risultati dell'operazione.
- Valore enum di TransformationFormat. Per generare un documento PDF, specificare
-
Recupera i risultati dell'operazione
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta una posizione di file XML contenente i dati dei risultati. Assicurati che l'estensione del nome file sia .xml. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto popolato con i dati dei risultati daOutputServiceService
dell’oggettogeneratePDFOutput
(l'ottavo parametro). Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettobinaryData
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte nel file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Creazione di regole di ricerca creating-search-rules
È possibile creare regole di ricerca che consentono al servizio Output di esaminare i dati di input e utilizzare strutture del modulo diverse in base al contenuto dei dati per generare l’output. Ad esempio, se il testo mutuo si trova all'interno dei dati di input, quindi il servizio Output può utilizzare una struttura del modulo denominata Mortgage.xdp. Analogamente, se il testo automobile si trova nei dati di input, quindi il servizio Output può utilizzare una struttura del modulo salvata come AutomobileLoan.xdp. Sebbene il servizio Output possa generare diversi tipi di output, questa sezione presuppone che il servizio Output generi un file PDF. Il diagramma seguente mostra il servizio Output che genera un file PDF elaborando un file di dati XML e utilizzando una delle numerose strutture del modulo.
Inoltre, il servizio Output è in grado di generare pacchetti di documenti, in cui vengono forniti più record nel set di dati e ogni record viene associato a una struttura del modulo e viene generato un singolo documento composto da più strutture del modulo.
Riepilogo dei passaggi summary_of_steps-8
Per indicare al servizio di output di utilizzare le regole di ricerca durante la generazione di un documento, eseguire le operazioni seguenti:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Fare riferimento a un'origine dati XML.
- Definisci le regole di ricerca.
- Impostare le opzioni di runtime di PDF.
- Imposta le opzioni di esecuzione del rendering.
- Genera un documento PDF.
- Recupera i risultati dell’operazione.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (obbligatorio se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (obbligatorio se AEM Forms è distribuito su JBoss)
se AEM Forms è implementato su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms.
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output.
Riferimento a un’origine dati XML
Per ogni campo del modulo che si desidera compilare con i dati deve esistere un elemento XML. 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, purché siano specificati tutti gli elementi XML.
Definire le regole di ricerca
Per definire le regole di ricerca, è necessario definire uno o più pattern di testo ricercati dai servizi di output nei dati di input. Per ogni pattern di testo definito, specificare una struttura del modulo corrispondente da utilizzare se il pattern di testo è posizionato. Se si trova un pattern di testo, il servizio Output utilizza la struttura del modulo corrispondente per generare l’output. Un esempio di pattern di testo è mutuo.
Impostare le opzioni di runtime di PDF
Impostare le seguenti opzioni di esecuzione di PDF affinché il servizio Output possa creare correttamente un documento PDF basato su più strutture del modulo:
- URI file: Specifica il nome e la posizione del file PDF generato dal servizio Output.
- Regole: Specifica le regole definite.
- LookAHead: Specifica il numero di byte da utilizzare dall'inizio del file di dati di input per la ricerca dei pattern di testo definiti. Il valore predefinito è 500 byte.
Impostare le opzioni di esecuzione del rendering
È possibile impostare le opzioni di esecuzione del rendering durante la creazione di file PDF. Sebbene queste opzioni non siano necessarie (a differenza delle opzioni di runtime di PDF), è possibile eseguire attività quali il miglioramento delle prestazioni del servizio Output. Ad esempio, è possibile memorizzare nella cache la struttura del modulo utilizzata dal servizio Output per migliorare le prestazioni.
Generare un documento PDF
Dopo aver fatto riferimento a un'origine dati XML valida e aver impostato le opzioni di esecuzione, è possibile richiamare il servizio Output generando un documento PDF. Se il servizio Output individua un pattern di testo specificato nei dati di input, utilizza la struttura del modulo corrispondente. Se non si utilizza un pattern di testo, il servizio Output utilizza la struttura del modulo predefinita.
Recupera i risultati dell'operazione
Dopo aver eseguito un'operazione, il servizio Output restituisce dati XML che specificano se l'operazione è riuscita.
Consulta anche
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Creare regole di ricerca utilizzando l’API Java create-search-rules-using-the-java-api
Creare regole di ricerca utilizzando l’API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Fare riferimento a un'origine dati XML.
- Crea un
java.io.FileInputStream
oggetto che rappresenta l'origine dati XML utilizzata per compilare il documento PDF utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file XML. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Definisci le regole di ricerca.
- Crea un
Rule
utilizzando il relativo costruttore. - Definire un pattern di testo richiamando il
Rule
dell’oggettosetPattern
e passare un valore stringa che specifica un pattern di testo. - Definire la struttura del modulo corrispondente richiamando il
Rule
dell’oggettosetForm
metodo . Passa un valore stringa che specifica il nome della struttura del modulo.
note note NOTE Per ogni pattern di testo da definire, ripetere i tre passaggi secondari precedenti. - Crea un
java.util.List
utilizzando unjava.util.ArrayList
costruttore. - Per ogni
Rule
oggetto creato, richiamarejava.util.List
dell’oggettoadd
e passare ilRule
oggetto.
- Crea un
-
Impostare le opzioni di runtime di PDF.
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Specifica il nome e la posizione del file PDF generato dal servizio Output richiamando il
PDFOutputOptionsSpec
dell’oggettosetFileURI
metodo . Passa un valore stringa che specifica la posizione del file PDF. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client. - Imposta le regole definite richiamando il
PDFOutputOptionsSpec
dell’oggettosetRules
metodo . Passa lajava.util.List
oggetto che contieneRule
oggetti. - Impostare il numero di byte da analizzare per i pattern di testo definiti richiamando il
PDFOutputOptionsSpec
dell’oggettosetLookAhead
metodo . Passa un valore intero che rappresenta i numeri di byte.
- Crea un
-
Imposta le opzioni di esecuzione del rendering.
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output richiamando il
RenderOptionsSpec
dell’oggettosetCacheEnabled
e di passaggiotrue
.
- Crea un
-
Genera un documento PDF.
Generare un documento PDF basato su più strutture del modulo richiamando il
OutputClient
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo predefinita. In altre parole, la struttura del modulo utilizzata se non si trova un pattern di testo.
- Valore stringa che specifica la directory principale del contenuto in cui si trovano le strutture del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
com.adobe.idp.Document
oggetto che contiene i dati del modulo ricercati dal servizio Output per individuare i pattern di testo definiti.
La
generatePDFOutput
restituisce unOutputResult
oggetto contenente i risultati dell'operazione. - A
-
Recupera i risultati dell’operazione.
- Crea un
com.adobe.idp.Document
che rappresenta lo statogeneratePDFOutput
richiamando il metodoOutputResult
dell’oggettogetStatusDoc
metodo . - Crea un
java.io.File
oggetto che conterrà i risultati dell'operazione. Assicurati che l'estensione del file sia .xml. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito dagetStatusDoc
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità EJB): Creazione di regole di ricerca tramite l’API Java
Avvio rapido (modalità SOAP): Creazione di regole di ricerca tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Creare regole di ricerca utilizzando l’API del servizio Web create-search-rules-using-the-web-service-api
Crea le regole di ricerca utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Fare riferimento a un'origine dati XML.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare i dati che verranno uniti al documento PDF. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF da crittografare e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Definisci le regole di ricerca.
- Crea un
Rule
utilizzando il relativo costruttore. - Definire un pattern di testo assegnando un valore di stringa che specifica un pattern di testo
Rule
dell’oggettopattern
membro dati. - Definire la struttura del modulo corrispondente assegnando un valore stringa che specifica la struttura del modulo
Rule
dell’oggettoform
membro dati.
note note NOTE Per ogni pattern di testo da definire, ripetere i tre passaggi secondari precedenti. - Crea un
MyArrayOf_xsd_anyType
oggetto che memorizza le regole. - Assegna ogni
Rule
a un elemento delMyArrayOf_xsd_anyType
array. Richiama ilMyArrayOf_xsd_anyType
dell’oggettoAdd
metodo perRule
oggetto.
- Crea un
-
Impostare le opzioni di runtime di PDF
- Crea un
PDFOutputOptionsSpec
utilizzando il relativo costruttore. - Impostare l'opzione URI del file assegnando un valore stringa che specifica la posizione del file PDF generato dal servizio Output nel
PDFOutputOptionsSpec
dell’oggettofileURI
membro dati. L’opzione URI file è relativa al server applicazioni J2EE che ospita AEM Forms, non al computer client. - Impostare l'opzione copie assegnando un valore intero che specifica il numero di copie generate dal servizio Output al
PDFOutputOptionsSpec
dell’oggettocopies
membro dati. - Imposta le regole definite assegnando il
MyArrayOf_xsd_anyType
oggetto che memorizza le regole nelPDFOutputOptionsSpec
dell’oggettorules
membro dati. - Impostare il numero di byte da analizzare per i pattern di testo definiti assegnando un valore intero che rappresenta i numeri di byte da analizzare al
PDFOutputOptionsSpec
dell’oggettolookAhead
metodo data.
- Crea un
-
Impostare le opzioni di esecuzione del rendering
- Crea un
RenderOptionsSpec
utilizzando il relativo costruttore. - Memorizza in cache la struttura del modulo per migliorare le prestazioni del servizio Output assegnando il valore
true
alRenderOptionsSpec
dell’oggettocacheEnabled
membro dati.
note note NOTE Non è possibile impostare la versione del documento di PDF utilizzando il RenderOptionsSpec
dell’oggettopdfVersion
membro se il documento di input è un modulo Acrobat. Nel documento di output PDF viene mantenuta la versione PDF del modulo Acrobat. Allo stesso modo, non è possibile impostare l’opzione PDF con tag utilizzandoRenderOptionsSpec
dell’oggettotaggedPDF
se il documento di input è un modulo Acrobat.note note NOTE Non è possibile impostare l’opzione linearized PDF utilizzando RenderOptionsSpec
dell’oggettolinearizedPDF
se il documento di input PDF è certificato o firmato digitalmente. Per informazioni, consulta Firma digitale di documenti PDF. - Crea un
-
Generare un documento PDF
Creare un documento PDF richiamando il
OutputServiceService
dell’oggettogeneratePDFOutput
e passando i seguenti valori:- A
TransformationFormat
valore di enumerazione. Per generare un documento PDF, specificareTransformationFormat.PDF
. - Valore stringa che specifica il nome della struttura del modulo.
- Valore stringa che specifica la directory principale del contenuto in cui si trova la struttura del modulo.
- A
PDFOutputOptionsSpec
oggetto contenente le opzioni di runtime di PDF. - A
RenderOptionsSpec
oggetto contenente le opzioni di esecuzione del rendering. - La
BLOB
oggetto contenente l’origine dati XML contenente i dati da unire alla struttura del modulo. - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i metadati generati che descrivono il documento. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - A
BLOB
oggetto popolato dageneratePDFOutput
metodo . LageneratePDFOutput
popola l'oggetto con i dati dei risultati. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web). - Un
OutputResult
oggetto contenente i risultati dell'operazione. (Questo valore di parametro è richiesto solo per la chiamata al servizio Web).
note note NOTE Quando si genera un documento PDF richiamando il generatePDFOutput
metodo : non è possibile unire dati con un modulo XFA PDF firmato, certificato o contenente diritti di utilizzo. Per informazioni sui diritti di utilizzo, vedi Applicazione dei diritti di utilizzo ai documenti PDF. - A
-
Recupera i risultati dell'operazione
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta una posizione di file XML contenente i dati dei risultati. Assicurati che l'estensione del file sia XML. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto popolato con i dati dei risultati daOutputServiceService
dell’oggettogeneratePDFOutput
(l'ottavo parametro). Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivere il contenuto dell'array di byte nel file XML richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Flatting dei documenti PDF flattening-pdf-documents
È possibile utilizzare il servizio Output per trasformare un documento PDF interattivo in un PDF non interattivo. Un documento PDF interattivo consente agli utenti di immettere o modificare i dati presenti nei campi del documento di PDF. Il processo di trasformazione di un documento PDF interattivo in un documento PDF non interattivo è denominato appiattimento. Quando un documento PDF viene appiattito, un utente non può modificare i dati nei campi del documento. Un motivo per appiattire un documento di PDF è garantire che i dati non possano essere modificati.
È possibile appiattire i seguenti tipi di documenti PDF:
- Documenti XFA PDF interattivi
- Acrobat Forms
Il tentativo di appiattire un PDF che è un documento di PDF non interattivo causa un'eccezione.
Riepilogo dei passaggi summary_of_steps-9
Per appiattire un documento PDF interattivo a un documento PDF non interattivo, procedere come segue:
- Includi file di progetto.
- Creare un oggetto Client di output.
- Recupera un documento PDF interattivo.
- Trasforma il documento PDF.
- Salvare il documento PDF non interattivo come file PDF.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss)
- jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss)
se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sarà necessario sostituire i file adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms. Per informazioni sulla posizione di tutti i file JAR di AEM Forms, vedi Inclusione dei file libreria Java di AEM Forms.
Creare un oggetto Client di output
Prima di poter eseguire un'operazione del servizio Output a livello di programmazione, è necessario creare un oggetto client del servizio Output. Se utilizzi l’API Java, crea un OutputClient
oggetto. Se utilizzi l’API del servizio Web Output, crea un OutputServiceService
oggetto.
Recuperare un documento PDF interattivo
Recuperare un documento PDF interattivo da trasformare in un documento PDF non interattivo. Il tentativo di trasformare un documento PDF non interattivo causa un'eccezione.
Trasforma il documento PDF
Dopo aver recuperato un documento PDF interattivo, è possibile trasformarlo in un documento PDF non interattivo. Il servizio Output restituisce un documento PDF non interattivo.
Salvare il documento PDF non interattivo come file PDF
È possibile salvare il documento PDF non interattivo come file PDF.
Consulta anche
Appiattire un documento PDF utilizzando l’API Java
Appiattire un documento PDF utilizzando l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio di output
Appiattire un documento PDF utilizzando l’API Java flatten-a-pdf-document-using-the-java-api
Appiattisci un documento PDF interattivo a un documento PDF non interattivo utilizzando l’API di output (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-output-client.jar, nel percorso di classe del progetto Java.
-
Creare un oggetto Client di output.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
OutputClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Recupera un documento PDF interattivo.
- Crea un
java.io.FileInputStream
oggetto che rappresenta il documento PDF interattivo da trasformare utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del file PDF interattivo. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Trasforma il documento PDF.
Trasforma il documento PDF interattivo in un documento PDF non interattivo richiamando il
OutputServiceService
dell’oggettotransformPDF
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto contenente il documento interattivo di PDF. - A
TransformationFormat
valore enum. Per generare un documento PDF non interattivo, specificareTransformationFormat.PDF
. - A
PDFARevisionNumber
valore enum che specifica il numero di revisione. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificarenull
. - Valore stringa che rappresenta il numero e l'anno della modifica, separati da due punti. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificare
null
. - A
PDFAConformance
valore enum che rappresenta il livello di conformità PDF/A. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificarenull
.
La
transformPDF
restituisce uncom.adobe.idp.Document
oggetto contenente un documento PDF non interattivo. - La
-
Salvare il documento PDF non interattivo come file PDF.
- Crea un
java.io.File
e assicurati che l'estensione del nome del file sia .pdf. - Richiama il
Document
dell’oggettocopyToFile
per copiare il contenuto delDocument
al file (assicurati di utilizzareDocument
oggetto restituito datransformPDF
metodo).
- Crea un
Consulta anche
Avvio rapido (modalità EJB): Trasformazione di un documento PDF tramite l’API Java
Avvio rapido (modalità SOAP): Trasformazione di un documento PDF tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Appiattire un documento PDF utilizzando l’API del servizio Web flatten-a-pdf-document-using-the-web-service-api
Appiattisci un documento PDF interattivo a un documento PDF non interattivo utilizzando l’API di output (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Creare un oggetto Client di output.
-
Crea un
OutputServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
OutputServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/OutputService?blob=mtom
.) Non è necessario utilizzare illc_version
attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Tuttavia, specifica?blob=mtom
per utilizzare MTOM. -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delOutputServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
System.ServiceModel.BasicHttpBinding
dell’oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegnare il nome utente del modulo di AEM al campo
OutputServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della password corrispondente al campo
OutputServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera un documento PDF interattivo.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare il documento interattivo di PDF. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento interattivo di PDF. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Trasforma il documento PDF.
Trasforma il documento PDF interattivo in un documento PDF non interattivo richiamando il
OutputClient
dell’oggettotransformPDF
e passando i seguenti valori:- A
BLOB
oggetto contenente il documento interattivo di PDF. - A
TransformationFormat
valore di enumerazione. Per generare un documento PDF non interattivo, specificareTransformationFormat.PDF
. - A
PDFARevisionNumber
valore enum che specifica il numero di revisione. - Un valore booleano che specifica se la variabile
PDFARevisionNumber
viene utilizzato il valore enum. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificarefalse
. - Valore stringa che rappresenta il numero e l'anno della modifica, separati da due punti. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificare
null
. - A
PDFAConformance
valore enum che rappresenta il livello di conformità PDF/A. - Valore booleano che specifica se la variabile
PDFAConformance
viene utilizzato il valore enum. Poiché questo parametro è destinato a un documento PDF/A, è possibile specificarefalse
.
La
transformPDF
restituisce unBLOB
oggetto contenente un documento PDF non interattivo. - A
-
Salvare il documento PDF non interattivo come file PDF.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF non interattivo. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito datransformPDF
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef