Erstellen von Dokumentausgabe-Streams creating-document-output-streams
Über den Ausgabeservice
Mit dem Ausgabeservice können Sie Dokumente in den Formaten PDF (einschließlich PDF/A-Dokumente), PostScript, Printer Control Language (PCL) und den folgenden Beschriftungsformaten ausgeben:
- Zebra (ZPL)
- Intermec (IPL)
- Datamax (DPL)
- TecToshiba (TPCL)
Mithilfe des Ausgabeservice können Sie XML-Formulardaten mit einem Formularentwurf zusammenführen und das Dokument an einen Netzwerkdrucker oder eine Datei ausgeben.
Es gibt zwei Möglichkeiten, einen Formularentwurf (eine XDP-Datei) an den Ausgabeservice zu übergeben. Sie können entweder eine com.adobe.idp.Document
-Instanz, die einen Formularentwurf enthält, an den Ausgabeservice übergeben. Sie können auch einen URI-Wert übergeben, der den Speicherort des Formularentwurfs angibt. Beide Methoden werden in Programmieren mit AEM Forms erläutert.
Die folgenden Abschnitte zeigen, wie Sie einen Formularentwurf mithilfe eines URI-Werts an den Ausgabeservice übergeben:
Die folgenden Abschnitte zeigen, wie Sie einen Formularentwurf in eine com.adobe.idp.Document
-Instanz übergeben:
Bei der Entscheidung über die zu verwedende Technik sollten Sie den Formularentwurf, wenn Sie ihn von einem anderen AEM Forms-Service abrufen, innerhalb einer com.adobe.idp.Document
-Instanz übergeben. Beide Abschnitte Übergeben von Dokumenten an den Ausgabeservice und Erstellen von PDF-Dokumenten mithilfe von Fragmenten zeigen, wie Sie einen Formularentwurf von einem anderen AEM Forms-Service abrufen. Im ersten Abschnitt wird der Formularentwurf aus Content Services (nicht mehr unterstützt) abgerufen. Im zweiten Abschnitt wird der Formularentwurf aus dem Assembler-Service abgerufen.
Wenn Sie den Formularentwurf aus einem festen Speicherort wie dem Dateisystem abrufen, können Sie beide Verfahren verwenden. Das heißt, Sie können den URI-Wert für eine XDP-Datei angeben oder eine com.adobe.idp.Document
-Instanz verwenden.
Um beim Erstellen eines PDF-Dokuments einen URI-Wert zu übergeben, der den Speicherort des Formularentwurfs angibt, verwenden Sie die generatePDFOutput
-Methode. Entsprechend müssen Sie beim Erstellen eines PDF-Dokuments zum Übergeben einer com.adobe.idp.Document
-Instanz an den Ausgabeservice die generatePDFOutput2
-Methode verwenden.
Wenn Sie einen Ausgabestream an einen Netzwerkdrucker senden, können Sie ebenfalls eine der beiden Methoden verwenden. Um einen Ausgabestream an einen Drucker durch Übergeben einer com.adobe.idp.Document
-Instanz, die einen Formularentwurf enthält, zu senden, verwenden Sie die sendToPrinter2
-Methode. Um einen Ausgabestream an einen Drucker durch Übergeben eines URI-Werts zu senden, verwenden Sie die sendToPrinter
-Methode. Der Abschnitt Senden von Druckstreams an Drucker verwendet die sendToPrinter
-Methode.
Sie können diese Aufgaben mithilfe des Ausgabeservice ausführen:
- Erstellen von PDF-Dokumenten
- Erstellen von PDF/A-Dokumenten
- Übergeben von Dokumenten in Content Services (nicht mehr unterstützt) an den Ausgabeservice
- Erstellen von PDF-Dokumenten mithilfe von Fragmenten
- Drucken in Dateien
- Senden von Druck-Streams an Drucker
- Erstellen mehrerer Ausgabedateien
- Erstellen von Suchregeln
- Reduzieren von PDF-Dokumenten
Erstellen von PDF-Dokumenten creating-pdf-documents
Sie können den Ausgabeservice verwenden, um ein PDF-Dokument zu erstellen, das auf einem Formularentwurf und XML-Formulardaten basiert, die Sie bereitstellen. Das vom Ausgabeservice erstellte PDF-Dokument ist kein interaktives PDF-Dokument. Benutzer können keine Formulardaten eingeben oder ändern.
Wenn Sie ein PDF-Dokument für eine langfristige Speicherung erstellen möchten, wird empfohlen, ein PDF/A-Dokument zu erstellen. (Siehe Erstellen von PDF/A-Dokumenten.)
Verwenden Sie den Forms-Service, um ein interaktives PDF-Formular zu erstellen, mit dem Benutzer Daten eingeben können. (Siehe Rendern interaktiver PDF-Formulare.)
Zusammenfassung der Schritte summary-of-steps
Um ein PDF-Dokument zu erstellen, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Legen Sie PDF-Laufzeitoptionen fest.
- Legen Sie Rendering-Laufzeitoptionen fest.
- Generieren Sie ein PDF-Dokument.
- Rufen Sie die Ergebnisse des Vorgangs ab.
Einbinden von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver bereitgestellt wird, der nicht JBoss ist, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird.
Erstellen eines Output-Client-Objekts
Bevor Sie einen Output-Service-Vorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt für den Output-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Output-Webservice-API verwenden, erstellen Sie ein OutputServiceService
-Objekt.
Referenzieren einer XML-Datenquelle
Um Daten mit dem Formularentwurf zusammenzuführen, müssen Sie eine XML-Datenquelle referenzieren, die Daten enthält. Für jedes Formularfeld, das mit Daten gefüllt werden soll, muss ein XML-Element vorhanden sein. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Wenn alle XML-Elemente angegeben sind, muss die Reihenfolge, in der die XML-Elemente angezeigt werden, nicht übereinstimmen.
Beachten Sie das folgende Beispielformular für einen Kreditantrag.
Um Daten in diesem Formularentwurf zusammenzuführen, müssen Sie eine XML-Datenquelle erstellen, die dem Formular entspricht. Die folgende XML-Datei stellt eine XDP-XML-Datenquelle dar, die dem Beispielformular für einen Hypothekenantrag entspricht.
<?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>
Festlegen von PDF-Laufzeitoptionen
Legen Sie die Datei-URI-Option beim Erstellen eines PDF-Dokuments fest. Diese Option gibt den Namen und den Speicherort der PDF-Datei an, die der Output-Service generiert.
Festlegen von Rendering-Laufzeitoptionen
Beim Erstellen eines PDF-Dokuments können Sie Rendering-Laufzeitoptionen festlegen. Obwohl diese Optionen nicht erforderlich sind (im Gegensatz zu PDF-Laufzeitoptionen, die erforderlich sind), können Sie Aufgaben wie die Leistungsverbesserung des Output-Service ausführen. Beispielsweise können Sie den Formularentwurf zwischenspeichern, den der Output-Service verwendet, um dessen Leistung zu verbessern.
Wenn Sie ein getaggtes Acrobat-Formular als Eingabe verwenden, können Sie die Java- oder die Webservice-API des Output-Service nicht verwenden, um die getaggte Einstellung zu deaktivieren. Wenn Sie versuchen, diese Option programmgesteuert auf false
festzulegen, ist das PDF-Ergebnisdokument weiterhin getaggt.
RenderOptionsSpec
-Klassenreferenz. (Siehe AEM Forms-API-Referenz).Generieren eines PDF-Dokuments
Nachdem Sie eine gültige XML-Datenquelle referenziert haben, die Formulardaten enthält, und Laufzeitoptionen festgelegt haben, können Sie den Output-Service aufrufen. Dadurch wird ein PDF-Dokument generiert.
Beim Generieren eines PDF-Dokuments geben Sie URI-Werte an, die für den Output-Service zum Erstellen eines PDF-Dokuments erforderlich sind. Ein Formularentwurf kann in Speicherorten wie dem Serverdateisystem oder als Teil eines AEM Forms-Programms gespeichert werden. Ein Formularentwurf (oder andere Ressourcen wie eine Grafikdatei), der Teil eines Forms-Programms ist, kann mithilfe des Inhaltsstamm-URI-Werts repository:///
referenziert werden. Betrachten Sie beispielsweise den folgenden Formularentwurf mit dem Namen Loan.xdp, der in einer Forms-Anwendung mit dem Namen Applications/FormsApplication enthalten ist:
Um auf die in der vorherigen Abbildung dargestellte Datei „Loan.xdp“ zuzugreifen, übergeben Sie repository:///Applications/FormsApplication/1.0/FormsFolder/
als dritten Parameter der generatePDFOutput
-Methode des OutputClient
-Objekts. Übergeben Sie den Namen des Formulars (Loan.xdp) als zweiten Parameter der generatePDFOutput
-Methode des OutputClient
-Objekts.
Wenn die XDP-Datei Bilder (oder andere Ressourcen wie Fragmente) enthält, legen Sie die Ressourcen im gleichen Anwendungsordner wie die XDP-Datei ab. AEM Forms verwendet den Inhaltsstamm-URI als Basispfad, um Verweise auf Bilder aufzulösen. Wenn die Datei „Loan.xdp“ beispielsweise ein Bild enthält, stellen Sie sicher, dass Sie das Bild in Applications/FormsApplication/1.0/FormsFolder/
ablegen.
generatePDFOutput
oder generatePrintedOutput
des OutputClient
-Objekts auf den URI der Forms-Anwendung verweisen.Abrufen der Ergebnisse des Vorgangs
Nachdem der Output-Service einen Vorgang ausgeführt hat, gibt er verschiedene Datenelemente zurück, z. B. Status-XML-Daten, die angeben, ob der Vorgang erfolgreich war.
Siehe auch
Erstellen eines PDF-Dokuments mit der Java-API
Erstellen eines PDF-Dokuments mit der Web Service-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Erstellen eines PDF-Dokuments mit der Java-API create-a-pdf-document-using-the-java-api
Erstellen Sie ein PDF-Dokument mithilfe der Output-API (Java):
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle darstellt, die zum Ausfüllen des PDF-Dokuments verwendet wird, indem Sie seinem Konstruktor einen Zeichenfolgenwert übergeben, der den Speicherort der XML-Datei angibt. - Erstellen Sie ein Objekt
com.adobe.idp.Document
, indem Sie den Konstruktor verwenden. Übergeben Sie dasjava.io.FileInputStream
-Objekt.
- Erstellen Sie ein
-
Legen Sie PDF-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option „Datei-URI“ fest, indem Sie die
setFileURI
-Methode desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der vom Output-Service generierten PDF-Datei angibt. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Speichern Sie den Formularentwurf zwischen, um die Leistung des Output-Service zu verbessern, indem Sie die
setCacheEnabled
-Methode desRenderOptionsSpec
-Objekts aufrufen und ihrtrue
übergeben.
note note NOTE Sie können die PDF-Dokumentversion nicht mithilfe der setPdfVersion
-Methode desRenderOptionsSpec
-Objekts festlegen, wenn das Eingabedokument ein Acrobat-Formular (ein in Acrobat erstelltes Formular) oder XFA-Dokument ist, das signiert oder zertifiziert ist. Das PDF-Ausgabedokument behält die PDF-Originalversion bei. Ebenso können Sie die Option für Adobe PDF mit Tags nicht festlegen, indem Sie diesetTaggedPDF
*-Methode desRenderOptionsSpec
-Objekts aufrufen, wenn das Eingabedokument ein Acrobat-Formular oder ein signiertes oder zertifiziertes XFA-Dokument ist. *note note NOTE Sie können die Option „Linearized PDF“ nicht mithilfe der setLinearizedPDF
-Methode desRenderOptionsSpec
-Objekts festlegen, wenn das PDF-Eingabedokument zertifiziert oder digital signiert ist. (Weitere Informationen finden Sie unter PDF-Dokumente digital signieren.) - Erstellen Sie ein Objekt
-
Generieren Sie ein PDF-Dokument.
Erstellen Sie ein PDF-Dokument, indem Sie die
generatePDFOutput
-Methode desOutputClient
-Objekts aufrufen und ihr die folgenden Werte übergeben:- Einen
TransformationFormat
-Aufzählungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen.
Die
generatePDFOutput
-Methode gibt einOutputResult
-Objekt zurück, das das Ergebnis der Authentifizierung enthält.note note NOTE Beim Generieren eines PDF-Dokuments durch Aufrufen der generatePDFOutput
-Methode ist zu beachten, dass Sie keine Daten mit einem XFA-PDF-Formular zusammenführen können, das signiert oder zertifiziert ist. (Weitere Informationen finden Sie unter Digitales Signieren und Zertifizieren von Dokumenten.)note note NOTE Die getRecordLevelMetaDataList
-Methode desOutputResult
-Objekts gibtnull
zurück.note note NOTE Sie können auch ein PDF-Dokument erstellen, indem Sie die generatePDFOutput2
-Methode desOutputClient
-Objekts aufrufen. (Siehe Übergeben von Dokumenten in Content Services (veraltet) an den Ausgabe-Service.) - Einen
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Rufen Sie ein
com.adobe.idp.Document
-Objekt ab, das den Status desgeneratePDFOutput
-Vorgangs darstellt, indem Sie diegetStatusDoc
-Methode desOutputResult
-Objekts aufrufen. Diese Methode gibt Status-XML-Daten zurück, die angeben, ob der Vorgang erfolgreich war. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von dergetStatusDoc
-Methode zurückgegeben wurde).
Obwohl der Output-Service das PDF-Dokument an den Speicherort schreibt, der in dem an die
setFileURI
-Methode desPDFOutputOptionsSpec
-Objekts übergebenen Argument angegeben wird, können Sie das PDF/A-Dokument programmgesteuert abrufen, indem Sie diegetGeneratedDoc
-Methode desOutputResult
-Objekts aufrufen. - Rufen Sie ein
Siehe auch
Schnellstart (EJB-Modus): Erstellen eines PDF-Dokuments mit der Java-API
Schnellstart (SOAP-Modus): Erstellen eines PDF-Dokuments mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen eines PDF-Dokuments mit der Web Service-API create-a-pdf-document-using-the-web-service-api
Erstellen Sie ein PDF-Dokument mithilfe der Output API (Web Service):
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt dient zum Speichern von XML-Daten, die mit dem PDF-Dokument zusammengeführt werden. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und ihm einen Zeichenfolgenwert übergeben, der den Dateispeicherort der XML-Datei mit den Formulardaten darstellt. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Datenstromdaten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und ihr das Byte-Array, die Startposition und die zu lesende Datenstromlänge übergeben. - Füllen Sie das
BLOB
-Objekt, indem Sie seinemMTOM
-Feld den Inhalt des Byte-Arrays zuweisen.
- Erstellen Sie ein Objekt
-
Festlegen von PDF-Laufzeitoptionen
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option „Datei-URI“ fest, indem Sie einen Zeichenfolgenwert, der den Speicherort der vom Output-Service generierten PDF-Datei angibt, dem
fileURI
-Datenelement desPDFOutputOptionsSpec
-Objekts zuweisen. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Speichern Sie den Formularentwurf zwischen, um die Leistung des Output-Service zu verbessern, indem Sie dem
cacheEnabled
-Datenelement desRenderOptionsSpec
-Objekts den Werttrue
zuweisen.
note note NOTE Sie können die PDF-Dokumentversion nicht mithilfe der setPdfVersion
-Methode desRenderOptionsSpec
-Objekts festlegen, wenn das Eingabedokument ein Acrobat-Formular (ein in Acrobat erstelltes Formular) oder ein XFA-Dokument ist, das signiert oder zertifiziert ist. Das PDF-Ausgabedokument behält die PDF-Originalversion bei. Ebenso können Sie die Option für Adobe PDF mit Tags nicht festlegen, indem Sie diesetTaggedPDF
-Methode desRenderOptionsSpec
-Objekts aufrufen, wenn das Eingabedokument ein Acrobat-Formular oder ein signiertes oder zertifiziertes XFA-Dokument ist.note note NOTE Sie können die Option „Linearized PDF“ nicht mithilfe des linearizedPDF
-Elements desRenderOptionsSpec
-Objekts festlegen, wenn das PDF-Eingabedokument zertifiziert oder digital signiert ist. (Weitere Informationen finden Sie unter PDF-Dokumente digital signieren.) - Erstellen Sie ein Objekt
-
Generieren Sie ein PDF-Dokument.
Erstellen Sie ein PDF-Dokument, indem Sie die
generatePDFOutput
-Methode desOutputServiceService
-Objekts aufrufen und ihr die folgenden Werte übergeben:- Einen
TransformationFormat
-Aufzählungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit Ergebnisdaten. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
note note NOTE Beachten Sie beim Erzeugen eines PDF-Dokuments durch Aufrufen der Methode generatePDFOutput
, dass Sie keine Daten mit einem XFA-PDF-Formular zusammenführen können, das signiert oder zertifiziert ist. (Siehe Digitales Signieren und Zertifizieren von Dokumenten.)note note NOTE Sie können auch ein PDF-Dokument erstellen, indem Sie die Methode generatePDFOutput2
desOutputClient
-Objekts aufrufen. (Siehe Übergeben von Dokumenten in Content Services (veraltet) an den Ausgabe-Service.) - Einen
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der einen XML-Dateispeicherort darstellt, welcher Ergebnisdaten enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das durch die MethodegeneratePDFOutput
desOutputServiceService
-Objekts mit Ergebnisdaten aufgefüllt wurde (der achte Parameter). Füllen Sie das Byte-Array, indem Sie den Wert desfield
MTOM
desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in die XML-Datei, indem Sie die Methode
Write
desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
Siehe auch
- Erstellen Sie ein
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef
generateOutput
des OutputServiceService
-Objekts ist veraltet.Erstellen von PDF/A-Dokumenten creating-pdf-a-documents
Sie können den Ausgabe-Service verwenden, um ein PDF/A-Dokument zu erstellen. Da PDF/A ein Archivierungsformat für die langfristige Beibehaltung des Dokumentinhalts ist, werden alle Schriftarten eingebettet und die Datei nicht komprimiert. PDF/A-Dokumente sind daher in der Regel größer als normale PDF-Dokumente. Außerdem enthalten PDF/A-Dokumente keine Audio- und Videoinhalte. Wie auch bei anderen Ausgabe-Service-Aufgaben stellen Sie sowohl einen Formularentwurf als auch Daten bereit, die mit einem Formularentwurf zusammengeführt werden sollen, um ein PDF/A-Dokument zu erstellen.
Die PDF/A-1-Spezifikation besteht aus zwei Konformitätsstufen, nämlich a und b. Der wesentliche Unterschied zwischen den beiden besteht in der Unterstützung der logischen Struktur (Zugänglichkeit), die für die Konformitätsstufe b nicht erforderlich ist. Unabhängig von der Konformitätsstufe bestimmt PDF/A-1, dass alle Schriftarten in das generierte PDF/A-Dokument eingebettet sind.
Obwohl PDF/A der Standard für die Archivierung von PDF-Dokumenten ist, ist es nicht erforderlich, PDF/A für die Archivierung zu verwenden, wenn ein standardmäßiges PDF-Dokument den Anforderungen Ihrer Firma entspricht. Der PDF/A-Standard dient der Erstellung einer PDF-Datei, die über einen längeren Zeitraum gespeichert werden kann und die Anforderungen an die Dokumentenerhaltung erfüllt. Beispielsweise kann eine URL nicht in eine PDF/A eingebettet werden, da die URL im Laufe der Zeit ungültig werden kann.
Ihre Organisation muss ihre eigenen Bedürfnisse, die Dauer der Aufbewahrung des Dokuments und die Dateigröße berücksichtigen und ihre eigene Archivierungsstrategie festlegen. Mit dem DocConverter-Service können Sie programmgesteuert feststellen, ob ein PDF-Dokument PDF/A-konform ist. (Siehe Programmgesteuerte Ermittlung der PDF/A-Konformität.)
Ein PDF/A-Dokument muss die im Formularentwurf angegebene Schriftart verwenden, und Schriftarten können nicht ersetzt werden. Wenn daher eine Schriftart, die sich in einem PDF-Dokument befindet, auf dem Host-Betriebssystem nicht verfügbar ist, tritt eine Ausnahme auf.
Wenn ein PDF/A-Dokument in Acrobat geöffnet wird, wird eine Meldung angezeigt, die bestätigt, dass es sich um ein PDF/A-Dokument handelt, wie in der folgenden Abbildung dargestellt.
Zusammenfassung der Schritte summary_of_steps-1
Um ein PDF/A-Dokument zu erstellen, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Legen Sie PDF/A-Laufzeitoptionen fest.
- Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein PDF/A-Dokument.
- Rufen Sie die Ergebnisse des Vorgangs ab.
Einbinden von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein benutzerdefiniertes Programm mithilfe von Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver bereitgestellt wird, der nicht JBoss ist, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird.
Erstellen eines Output-Client-Objekts
Bevor Sie einen Output-Service-Vorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt für den Output-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Output-Webservice-API verwenden, erstellen Sie ein OutputServiceService
-Objekt.
Referenzieren einer XML-Datenquelle
Um Daten mit dem Formularentwurf zusammenzuführen, müssen Sie eine XML-Datenquelle referenzieren, die Daten enthält. Für jedes Formularfeld, das mit Daten gefüllt werden soll, muss ein XML-Element vorhanden sein. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Wenn alle XML-Elemente angegeben sind, muss die Reihenfolge, in der die XML-Elemente angezeigt werden, nicht übereinstimmen.
Festlegen von PDF/A-Laufzeitoptionen
Sie können die Option „Datei-URI“ beim Erstellen eines PDF/A-Dokuments festlegen. Der URI bezieht sich auf den J2EE-Programm-Server, der als Host für AEM Forms dient. Wenn Sie also C:\Adobe festlegen, wird die Datei in den Ordner auf dem Server geschrieben, nicht auf den Client-Computer. Der URI gibt den Namen und Speicherort der PDF/A-Datei an, die der Output-Service generiert.
Festlegen von Rendering-Laufzeitoptionen
Beim Erstellen von PDF/A-Dokumenten können Sie Laufzeitoptionen für das Rendern festlegen. Zwei PDF/A-Optionen, die Sie festlegen können, sind die Werte PDFAConformance
und PDFARevisionNumber
. Der Wert PDFAConformance
gibt an, inwieweit ein PDF-Dokument den Anforderungen bezüglich der Langzeitarchivierung elektronischer Dokumente entspricht. Gültige Werte für diese Option sind A
und B
. Informationen zu Konformitätsstufe a und b finden Sie in der ISO-Spezifikation PDF/A-1 mit dem Titel ISO 19005-1 Dokumentenmanagement.
Die PDFARevisionNumber
-Wert bezieht sich auf die Revisionsnummer eines PDF/A-Dokuments. Informationen zur Revisionsnummer eines PDF/A-Dokuments finden Sie in der ISO-Spezifikation PDF/A-1 mit dem Titel ISO 19005-1 Dokumentenmanagement.
false
festlegen. PDF/A 1A ist immer ein PDF-Dokument mit Tags. Außerdem können Sie die Option „Adobe PDF mit Tags“ beim Erstellen eines PDF/A 1B-Dokuments nicht auf true
festlegen. PDF/A 1B ist immer ein PDF-Dokument ohne Tags.Erstellen eines PDF/A-Dokuments
Nachdem Sie auf eine gültige XML-Datenquelle, die Formulardaten enthält, verwiesen und Laufzeitoptionen festgelegt haben, können Sie den Output-Service aufrufen, der daraufhin ein PDF/A-Dokument generiert.
Abrufen der Ergebnisse eines Vorgangs
Nachdem der Output-Service einen Vorgang ausgeführt hat, gibt er verschiedene Datenelemente wie XML-Daten zurück, die angeben, ob der Vorgang erfolgreich war.
Siehe auch
Erstellen eines PDF/A-Dokuments mit der Java-API
Erstellen eines PDF/A-Dokuments mithilfe der Web Service-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Erstellen eines PDF/A-Dokuments mit der Java-API create-a-pdf-a-document-using-the-java-api
Erstellen Sie ein PDF/A-Dokument mithilfe der Output-API (Java):
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle darstellt, die zum Ausfüllen des PDF/A-Dokuments verwendet wird, indem Sie seinen Konstruktor aufrufen und ihm einen Zeichenfolgenwert übergibt, der den Speicherort der XML-Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Festlegen von PDF/A-Laufzeitoptionen.
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option „Datei-URI“ fest, indem Sie die
setFileURI
-Methode desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der vom Output-Service generierten PDF-Datei angibt. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie den
PDFAConformance
-Wert fest, indem Sie diesetPDFAConformance
-Methode desRenderOptionsSpec
-Objekts aufrufen und ihr einenPDFAConformance
-Aufzählungswert übergeben, der die Konformitätsstufe angibt. Um beispielsweise Konformitätsstufe A anzugeben, übergeben SiePDFAConformance.A
. - Legen Sie den
PDFARevisionNumber
-Wert fest, indem Sie diesetPDFARevisionNumber
-Methode desRenderOptionsSpec
-Objekts aufrufen und ihrPDFARevisionNumber.Revision_1
übergeben.
note note NOTE Die PDF-Version eines PDF/A-Dokuments ist 1.4, unabhängig davon, welchen Wert Sie für die setPdfVersion
-Methode desRenderOptionsSpec
-Objekts angeben. - Erstellen Sie ein Objekt
-
Erstellen Sie ein PDF/A-Dokument.
Erstellen Sie ein PDF/A-Dokument, indem Sie die
generatePDFOutput
-Methode desOutputClient
-Objekts aufrufen und ihr folgende Werte übergeben:- Ein
TransformationFormat
-Aufzählungswert. Um ein PDF/A-Dokument zu generieren, geben SieTransformationFormat.PDFA
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen.
Die
generatePDFOutput
-Methode gibt einOutputResult
-Objekt zurück, das das Ergebnis der Authentifizierung enthält.note note NOTE Die OutputResult
-ObjektgetRecordLevelMetaDataList
Methodenzurückgabennull
*. *note note NOTE Sie können auch ein PDF/A-Dokument erstellen, indem Sie die generatePDFOutput
-Methode desOutputClient
-Objekts aufrufen. (Siehe Übergeben von Dokumenten in Content Services (nicht mehr unterstützt) an den Ausgabeservice.) - Ein
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
com.adobe.idp.Document
-Objekt, das den Status dergeneratePDFOutput
-Methode darstellt, indem Sie diegetStatusDoc
-Methode desOutputResult
-Objekts aufrufen. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von dergetStatusDoc
-Methode zurückgegeben wurde).
note note NOTE Obwohl der Output-Dienst das PDF/A-Dokument an den Speicherort schreibt, der durch das an das PDFOutputOptionsSpec
-ObjektsetFileURI
-Methode verwenden, können Sie das PDF/A-Dokument programmgesteuert abrufen, indem Sie dieOutputResult
-ObjektgetGeneratedDoc
* Methode.* - Erstellen Sie ein
Siehe auch
Kurzanleitung (SOAP-Modus): Erstellen eines PDF/A-Dokuments mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen.
Erstellen eines PDF/A-Dokuments mithilfe der Web Service-API create-a-pdf-a-document-using-the-web-service-api
So erstellen Sie ein PDF/A-Dokument mithilfe der Ausgabe-API (Webservice):
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt wird zum Speichern von Daten verwendet, die mit dem PDF/A-Dokument zusammengeführt werden. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des zu verschlüsselnden PDF-Dokuments und den Modus darstellt, in dem die Datei geöffnet werden soll. - Erstellen Sie ein Byte-Array, in dem der Inhalt des
System.IO.FileStream
-Objekts gespeichert wird. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Methode
Read
desSystem.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die Länge des zu lesenden Streams übergeben. - Füllen Sie das
BLOB
-Objekt, indem Sie seinem FeldMTOM
den Inhalt des Byte-Arrays zuweisen.
- Erstellen Sie ein Objekt
-
Legen Sie PDF/A-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option „Datei-URI“ fest, indem Sie dem Datenelement
fileURI
desPDFOutputOptionsSpec
-Objekts einen Zeichenfolgenwert zuweisen, der den Speicherort der PDF-Datei angibt, die vom Ausgabe-Service erzeugt wird. Die Option „Datei-URI“ bezieht sich auf den J2EE-Programm-Server, der als Host für AEM Forms dient, nicht auf den Client-Computer.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie den Wert von
PDFAConformance
fest, indem Sie dem DatenelementPDFAConformance
desRenderOptionsSpec
-Objekts einenPDFAConformance
-Auflistungswert zuweisen. Um beispielsweise Konformitätsstufe A anzugeben, weisen Sie diesem DatenelementPDFAConformance.A
zu. - Legen Sie den Wert
PDFARevisionNumber
fest, indem Sie dem DatenelementPDFARevisionNumber
desRenderOptionsSpec
-Objekts einenPDFARevisionNumber
-Auflistungswert zuweisen. Weisen Sie diesem DatenelementPDFARevisionNumber.Revision_1
zu.
note note NOTE Die PDF-Version eines PDF/A-Dokuments ist 1.4, unabhängig davon, welchen Wert Sie angeben. - Erstellen Sie ein Objekt
-
Erstellen Sie ein PDF/A-Dokument.
Erstellen Sie ein PDF-Dokument, indem Sie die Methode
generatePDFOutput
desOutputServiceService
-Objekts aufrufen und die folgenden Werte übergeben:- Ein TransformationFormat-Auflistungswert. Um ein PDF-Dokument zu erzeugen, geben Sie
TransformationFormat.PDFA
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. Die MethodegeneratePDFOutput
füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
BLOB
-Objekt, das von der MethodegeneratePDFOutput
aufgefüllt wird. Die MethodegeneratePDFOutput
füllt dieses Objekt mit Ergebnisdaten. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.)
note note NOTE Sie können auch ein PDF/A-Dokument erstellen, indem Sie die generatePDFOutput
-Methode desOutputClient
-Objekts aufrufen. (Siehe Übergeben von Dokumenten in Content Services (nicht mehr unterstützt) an den Ausgabeservice.) - Ein TransformationFormat-Auflistungswert. Um ein PDF-Dokument zu erzeugen, geben Sie
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der einen XML-Dateispeicherort darstellt, welcher Ergebnisdaten enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das von dergeneratePDFOutput
-Methode desOutputServiceService
-Objekts (der achte Parameter) gefüllt wurde. Füllen Sie das Byte-Array, indem Sie den Wert desMTOM
-Felds desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in die XML-Datei, indem Sie die
Write
-Methode desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef
Übergeben von Dokumenten in Content Services (nicht mehr unterstützt) an den Ausgabeservice passing-documents-located-in-content-services-deprecated-to-the-output-service
Der Ausgabe-Service rendert ein nicht interaktives PDF-Formular, das auf einem Formularentwurf basiert, der normalerweise als XDP-Datei gespeichert und in Designer erstellt wird. Sie können ein com.adobe.idp.Document
-Objekt übergeben, das den Formularentwurf für den Ausgabe-Service enthält. Der Ausgabe-Service rendert dann den Formularentwurf im com.adobe.idp.Document
-Objekt.
Ein Vorteil der Übergabe eines com.adobe.idp.Document
-Objekts an den Ausgabe-Service besteht darin, dass andere AEM Forms-Service-Vorgänge eine com.adobe.idp.Document
-Instanz zurückgeben. Das heißt, Sie können eine com.adobe.idp.Document
-Instanz aus einem anderen Service-Vorgang abrufen und rendern. Angenommen, eine XDP-Datei wird in einem Content Services-Knoten (veraltet) gespeichert, der /Company Home/Form Designs
heißt, wie in der folgenden Illustration dargestellt.
Sie können Loan.xdp programmgesteuert aus Content Services (veraltet) abrufen und die XDP-Datei innerhalb eines com.adobe.idp.Document
-Objekts an den Ausgabe-Service übergeben.
Zusammenfassung der Schritte summary_of_steps-2
Führen Sie die folgenden Aufgaben aus, um ein von Content Services (veraltet) gespeichertes Dokument an den Ausgabe-Service zu übergeben:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Ausgabe- und ein Document Management-Client-API-Objekt.
- Rufen Sie den Formularentwurf aus Content Services ab (veraltet).
- Rendern Sie das nicht interaktive PDF-Formular.
- Führen Sie eine Aktion mit dem Datenstrom aus.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, schließen Sie die Proxy-Dateien ein.
Erstellen eines Ausgabe- und eines Document Management Client API-Objekts
Bevor Sie einen Ausgabe-Service-API-Vorgang programmgesteuert ausführen können, erstellen Sie ein Ausgabe-Client-API-Objekt. Da mit diesem Workflow eine XDP-Datei aus Content Services (veraltet) abgerufen wird, erstellen Sie ein Document Management-API-Objekt.
Abrufen des Formularentwurfs aus Content Services (veraltet)
Rufen Sie die XDP-Datei aus Content Services (veraltet) ab, indem Sie die Java- oder Webservice-API verwenden. Die XDP-Datei wird innerhalb einer com.adobe.idp.Document
-Instanz (oder BLOB
-Instanz, wenn Sie Web-Services verwenden) zurückgegeben. Anschließend können Sie die com.adobe.idp.Document
-Instanz an den Ausgabe-Service übergeben.
Rendern des nicht interaktiven PDF-Formulars
Übergeben Sie zum Rendern eines nicht interaktiven Formulars die com.adobe.idp.Document
-Instanz, die von Content Services (veraltet) an den Ausgabe-Service zurückgegeben wurde.
generatePDFOutput2
und eneratePrintedOutput2
akzeptieren ein com.adobe.idp.Document
-Objekt, das einen Formularentwurf enthält. Sie können auch com.adobe.idp.Document
mit dem Formularentwurf beim Senden eines Printstreams an einen Netzwerkdrucker an den Ausgabe-Service übergeben.Ausführen einer Aktion mit dem Formulardaten-Stream
Sie können das nicht interaktive Formular als PDF-Datei speichern. Das Formular kann in Adobe Reader oder Acrobat angezeigt werden.
Siehe auch
Übergeben von Dokumenten an den Ausgabe-Service mithilfe der Java-API
Übergeben von Dokumenten an den Output-Service mithilfe der Webservice-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Erstellen von PDF-Dokumenten mithilfe von Fragmenten
Übergeben von Dokumenten an den Ausgabe-Service mithilfe der Java-API pass-documents-to-the-output-service-using-the-java-api
Übergeben Sie ein Dokument, das von Content Services (veraltet) abgerufen wurde, mithilfe der Ausgabe-Srvice- und Content Services-API (veraltet):
-
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ und „adobe-contentservices-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output- und ein Document Management-Client-API-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften.) - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben. - Erstellen Sie ein
DocumentManagementServiceClientImpl
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Rufen Sie den Formularentwurf aus Content Services ab (veraltet).
Rufen Sie die
retrieveContent
-Methode desDocumentManagementServiceClientImpl
-Objekts auf und übergeben Sie die folgenden Werte:- Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist
SpacesStore
. Dieser Wert ist ein obligatorischer Parameter. - Ein Zeichenfolgenwert, der den vollständig qualifizierten Pfad des abzurufenden Inhalts angibt (z. B.
/Company Home/Form Designs/Loan.xdp
). Dieser Wert ist ein obligatorischer Parameter. - Ein Zeichenfolgenwert, der die Version angibt. Dieser Wert ist ein optionaler Parameter, und Sie können auch eine leere Zeichenfolge übergeben. In diesem Fall wird die neueste Version abgerufen.
Die
retrieveContent
-Methode gibt einCRCResult
-Objekt zurück, das die XDP-Datei enthält. Rufen Sie einecom.adobe.idp.Document
-Instanz durch Aufrufen dergetDocument
-Methode desCRCResult
-Objekts ab. - Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist
-
Rendern Sie das nicht interaktive PDF-Formular.
Rufen Sie die Methode
generatePDFOutput2
desOutputClient
-Objekts auf und übergeben Sie die folgenden Werte:- Ein
TransformationFormat
-Auflistungswert. Um ein PDF-Dokument zu erzeugen, geben SieTransformationFormat.PDF
an. - Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich die zusätzlichen Ressourcen wie Bilder befinden.
- Ein
com.adobe.idp.Document
-Objekt, das den Formularentwurf darstellt (verwenden Sie die Instanz, die von der MethodegetDocument
desCRCResult
-Objekts zurückgegeben wird). - Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen.
Die Methode
generatePDFOutput2
gibt einOutputResult
-Objekt zurück, das die Ergebnisse des Vorgangs enthält. - Ein
-
Führen Sie eine Aktion mit dem Formulardaten-Stream aus.
- Rufen Sie ein
com.adobe.idp.Document
-Objekt ab, das das nicht-interaktive Formular darstellt, indem Sie die MethodegetGeneratedDoc
desOutputResult
-Objekts aufrufen. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .pdf lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von dergetGeneratedDoc
-Methode zurückgegeben wurde).
- Rufen Sie ein
Siehe auch
Schnellstart (EJB-Modus): Übergeben von Dokumenten an den Output-Service mithilfe der Java-API
Schnellstart (SOAP-Modus): Übergeben von Dokumenten an den Output-Service mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Übergeben von Dokumenten an den Output-Service mithilfe der Webservice-API pass-documents-to-the-output-service-using-the-web-service-api
Übergeben Sie ein Dokument, das von Content Services (nicht mehr unterstützt) abgerufen wurde, indem Sie den Output-Service und die Content Services-API (nicht mehr unterstützt) (Webservice) verwenden:
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Da dieses Client-Programm zwei AEM Forms-Services aufruft, erstellen Sie zwei Service-Verweise. Verwenden Sie die folgende WSDL-Definition für die Service-Referenz, die mit dem Output-Service verknüpft ist:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.Verwenden Sie die folgende WSDL-Definition für die Service-Referenz, die mit dem Document Management-Service verknüpft ist:
http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
.Da der
BLOB
-Datentyp für beide Service-Referenzen verwendet wird, müssen Sie denBLOB
-Datentyp vollständig qualifizieren, wenn Sie ihn verwenden. Im entsprechenden Webservice-Schnellstart sind alleBLOB
-Instanzen vollständig qualifiziert.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output- und ein Document Management-Client-API-Objekt.
-
Erstellen Sie ein
OutputServiceClient
-Objekt mithilfe des Standardkonstruktors. -
Erstellen Sie ein
OutputServiceClient.Endpoint.Address
-Objekt mithilfe desSystem.ServiceModel.EndpointAddress
-Konstruktors. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie einen Service-Verweis erstellen.) -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt durch Abrufen des Werts des FeldsOutputServiceClient.Endpoint.Binding
. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu.
- Weisen Sie dem Feld
-
Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
note note NOTE Wiederholen Sie diese Schritte für die DocumentManagementServiceClient
* Service-Client. * -
-
Rufen Sie den Formularentwurf aus Content Services ab (veraltet).
Rufen Sie Inhalte durch Aufrufen der
retrieveContent
-Methode desDocumentManagementServiceClient
-Objekts ab und übergeben Sie die folgenden Werte:- Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist
SpacesStore
. Dieser Wert ist ein obligatorischer Parameter. - Ein Zeichenfolgenwert, der den vollständig qualifizierten Pfad des abzurufenden Inhalts angibt (z. B.
/Company Home/Form Designs/Loan.xdp
). Dieser Wert ist ein obligatorischer Parameter. - Ein Zeichenfolgenwert, der die Version angibt. Dieser Wert ist ein optionaler Parameter, und Sie können auch eine leere Zeichenfolge übergeben. In diesem Fall wird die neueste Version abgerufen.
- Der Ausgabeparameter einer Kennzeichenfolge, der den Wert des Browse-Links speichert.
- Ein
BLOB
-Ausgabeparameter, der den Inhalt speichert. Sie können diesen Ausgabeparameter verwenden, um den Inhalt abzurufen. - Ein
ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
-Ausgabeparameter, der Inhaltsattribute speichert. - Ein
CRCResult
-Ausgabeparameter. Statt dieses Objekt zu verwenden, können Sie denBLOB
-Ausgabeparameter zum Abrufen des Inhalts verwenden.
- Ein Zeichenfolgewert, der den Speicher angibt, dem der Inhalt hinzugefügt wird. Der Standardspeicherort ist
-
Rendern Sie das nicht interaktive PDF-Formular.
Rufen Sie die Methode
generatePDFOutput2
desOutputServiceClient
-Objekts auf und übergeben Sie die folgenden Werte:- Ein
TransformationFormat
-Auflistungswert. Um ein PDF-Dokument zu erzeugen, geben SieTransformationFormat.PDF
an. - Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich die zusätzlichen Ressourcen wie Bilder befinden.
- Ein
BLOB
-Objekt, das den Formularentwurf darstellt (verwenden Sie dieBLOB
-Instanz, die von Content Services (nicht mehr unterstützt) zurückgegeben wird). - Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle enthält, die Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen. - Ein
BLOB
-Ausgabeobjekt, das von dergeneratePDFOutput2
-Methode gefüllt wird. DiegeneratePDFOutput2
-Methode füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein Ausgabe-
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
Die
generatePDFOutput2
-Methode gibt einBLOB
-Objekt zurück, das das nicht interaktive PDF-Formular enthält. - Ein
-
Führen Sie eine Aktion mit dem Formulardaten-Stream aus.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Kennzeichenfolgewert, der den Dateispeicherort des interaktiven PDF-Dokuments und den Modus angibt, in dem die Datei geöffnet werden soll. - Erstellen Sie ein Byte-Array, das den Inhalt des
BLOB
-Objekts speichert, das von der MethodegeneratePDFOutput2
abgerufen wurde. Füllen Sie das Byte-Array auf, indem Sie den Wert des DatenelementsMTOM
desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Methode
Write
desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Übergeben von Dokumenten im Repository an den Ausgabe-Service passing-documents-located-in-the-repository-to-the-output-service
Der Ausgabe-Service rendert ein nicht-interaktives PDF-Formular, das auf einem Formularentwurf basiert, der normalerweise in Designer erstellt und als XDP-Datei gespeichert wird. Sie können ein com.adobe.idp.Document
-Objekt übergeben, das den Formularentwurf für den Ausgabe-Service enthält. Der Ausgabe-Service rendert dann den Formularentwurf im com.adobe.idp.Document
-Objekt.
Ein Vorteil der Übergabe eines com.adobe.idp.Document
-Objekts an den Ausgabe-Service besteht darin, dass andere AEM Forms-Service-Vorgänge eine com.adobe.idp.Document
-Instanz zurückgeben. Das heißt, Sie können eine com.adobe.idp.Document
-Instanz von einem anderen Service-Vorgang erhalten und sie rendern. Angenommen, eine XDP-Datei wird im AEM Forms-Repository gespeichert, wie in der folgenden Abbildung dargestellt.
Der Ordner FormsFolder ist ein benutzerdefinierter Speicherort im AEM Forms-Repository (dieser Speicherort ist nur ein Beispiel und standardmäßig nicht vorhanden). In diesem Beispiel befindet sich in diesem Ordner ein Formularentwurf mit dem Namen „Loan.xdp“. Neben dem Formularentwurf können an dieser Stelle auch andere Formularkomponenten wie Bilder gespeichert werden. Der Pfad zu einer Ressource im AEM Forms-Repository lautet:
Applications/Application-name/Application-version/Folder.../Filename
Sie können „Loan.xdp“ programmgesteuert aus dem AEM Forms-Repository abrufen und es in einem com.adobe.idp.Document
-Objekt an den Ausgabe-Service übergeben.
Sie können eine PDF-Datei basierend auf einer XDP-Datei im Repository auf zwei Arten erstellen. Sie können den XDP-Speicherort als Referenz übergeben oder die XDP programmgesteuert aus dem Repository abrufen und innerhalb einer XDP-Datei an den Ausgabe-Service übergeben.
Kurzanleitung (EJB-Modus): Erstellen eines PDF-Dokuments auf der Grundlage einer XDP-Programmdatei mithilfe der Java-API (hier wird gezeigt, wie Sie den Speicherort der XDP-Datei per Referenz übergeben).
Kurzanleitung (EJB-Modus): Übergeben eines Dokuments aus dem AEM Forms-Repository an den Ausgabe-Service mithilfe der Java-API (hier wird gezeigt, wie Sie die XDP-Datei programmgesteuert aus dem AEM Forms-Repository abrufen und sie innerhalb einer com.adobe.idp.Document
-Instanz an den Ausgabe-Service übergeben). (In diesem Abschnitt wird beschrieben, wie Sie diese Aufgabe durchführen.)
Zusammenfassung der Schritte summary_of_steps-3
Führen Sie die folgenden Aufgaben aus, um ein vom AEM Forms-Repository abgerufenes Dokument an den Ausgabe-Service zu übergeben:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Ausgabe- und ein Document Management-Client-API-Objekt.
- Rufen Sie den Formularentwurf aus dem AEM Forms-Repository ab.
- Rendern Sie das nicht interaktive PDF-Formular.
- Führen Sie eine Aktion mit dem Datenstrom aus.
Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, schließen Sie die Proxy-Dateien ein.
Erstellen eines Ausgabe- und eines Document Management Client API-Objekts
Bevor Sie einen Ausgabe-Service-API-Vorgang programmgesteuert ausführen können, erstellen Sie ein Ausgabe-Client-API-Objekt. Da mit diesem Workflow eine XDP-Datei aus Content Services (veraltet) abgerufen wird, erstellen Sie ein Document Management-API-Objekt.
Abrufen des Formularentwurfs aus dem AEM Forms-Repository
Rufen Sie die XDP-Datei mithilfe der Repository-API aus dem AEM Forms-Repository ab. (Siehe Lesen von Ressourcen.)
Die XDP-Datei wird innerhalb einer com.adobe.idp.Document
-Instanz zurückgegeben (oder einer BLOB
-Instanz, wenn Sie Web-Services verwenden). Sie können dann die com.adobe.idp.Document
-Instanz an den Ausgabe-Service übergeben.
Rendern eines nicht-interaktiven PDF-Formulars
Um ein nicht-interaktives Formular zu rendern, übergeben Sie die com.adobe.idp.Document
-Instanz, die mithilfe der AEM Forms-Repository-API zurückgegeben wurde.
generatePDFOutput2
und generatePrintedOutput2
akzeptieren ein com.adobe.idp.Document
-Objekt, das einen Formularentwurf enthält. Sie können auch ein com.adobe.idp.Document
, das den Formularentwurf enthält, an den Ausgabe-Service übergeben, wenn Sie einen Druck-Stream an einen Netzwerkdrucker senden.Ausführen einer Aktion mit dem Formulardaten-Stream
Sie können das nicht interaktive Formular als PDF-Datei speichern. Das Formular kann in Adobe Reader oder Acrobat angezeigt werden.
Siehe auch
Übergeben von Dokumenten im Repository an den Ausgabe-Service mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
ResourceRepositoryClient
Übergeben von Dokumenten im Repository an den Ausgabe-Service mithilfe der Java-API pass-documents-located-in-the-repository-to-the-output-service-using-the-java-api
So übergeben Sie ein aus dem Repository abgerufenes Dokument mithilfe des Ausgabe-Services und der Repository-API (Java):
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ und „adobe-repository-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output- und ein Document Management-Client-API-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. (Siehe Einstellung von Verbindungseigenschaften.) - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben. - Erstellen Sie ein
DocumentManagementServiceClientImpl
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Rufen Sie den Formularentwurf aus dem AEM Forms-Repository ab.
Rufen Sie die Methode
readResourceContent
desResourceRepositoryClient
-Objekts auf und übergeben Sie einen Zeichenfolgenwert, der den URI-Speicherort der XDP-Datei angibt. Beispiel:/Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
. Dieser Wert ist erforderlich. Diese Methode gibt einecom.adobe.idp.Document
-Instanz zurück, die die XDP-Datei darstellt. -
Rendern Sie das nicht interaktive PDF-Formular.
Rufen Sie die Methode
generatePDFOutput2
desOutputClient
-Objekts auf und übergeben Sie die folgenden Werte:- Ein
TransformationFormat
-Auflistungswert. Um ein PDF-Dokument zu erzeugen, geben SieTransformationFormat.PDF
an. - Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich die zusätzlichen Ressourcen wie Bilder befinden. Beispiel:
repository:///Applications/FormsApplication/1.0/FormsFolder/
. - Ein
com.adobe.idp.Document
-Objekt, das den Formularentwurf darstellt (verwenden Sie die Instanz, die von der MethodereadResourceContent
desResourceRepositoryClient
-Objekts zurückgegeben wird). - Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen.
Die Methode
generatePDFOutput2
gibt einOutputResult
-Objekt zurück, das die Ergebnisse des Vorgangs enthält. - Ein
-
Führen Sie eine Aktion mit dem Formulardaten-Stream aus.
- Rufen Sie ein
com.adobe.idp.Document
-Objekt ab, das das nicht-interaktive Formular darstellt, indem Sie die MethodegetGeneratedDoc
desOutputResult
-Objekts aufrufen. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .pdf lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von dergetGeneratedDoc
-Methode zurückgegeben wurde).
- Rufen Sie ein
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen von PDF-Dokumenten mithilfe von Fragmenten creating-pdf-documents-using-fragments
Sie können die Ausgabe- und Assembler-Services verwenden, um einen Ausgabe-Stream, z. B. ein PDF-Dokument, zu erstellen, der auf Fragmenten basiert. Der Assembler-Service stellt ein XDP-Dokument zusammen, das auf Fragmenten basiert, die sich in mehreren XDP-Dateien befinden. Das zusammengestellte XDP-Dokument wird an den Ausgabe-Service übergeben, der ein PDF-Dokument erstellt. Obwohl dieser Workflow zeigt, dass ein PDF-Dokument erzeugt wird, kann der Ausgabe-Service für diesen Arbeitsablauf auch andere Ausgabetypen wie ZPL erzeugen. Ein PDF-Dokument wird hier nur zu Demonstrationszwecken verwendet.
Die folgende Abbildung zeigt diesen Workflow.
Bevor Sie Erstellen von PDF-Dokumenten mithilfe von Fragmenten lesen, sollten Sie sich mit der Verwendung des Assembler-Services zum Zusammenstellen mehrerer XDP-Dokumente vertraut machen. (Siehe Zusammenstellen mehrerer XDP-Fragmente.)
Zusammenfassung der Schritte summary_of_steps-4
Um ein auf Fragmenten basierendes PDF-Dokument zu erstellen, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output- und Assembler-Client-Objekt.
- Verwenden Sie den Assembler-Service, um das Design des Formulars zu generieren.
- Verwenden Sie den Output-Service, um das PDF-Dokument zu generieren.
- Speichern Sie das Formular als PDF-Datei.
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Erstellen eines Ausgabe- und Assembler-Client-Objekts
Bevor Sie einen Ablauf für die Ausgabe-Service-API programmgesteuert ausführen können, müssen Sie ein Ausgabe-Client-API-Objekt erstellen. Da dieser Workflow für die Erstellung des Formulardesigns den Assembler-Service aufruft, erstellen Sie außerdem ein Assembler-Client-API-Objekt.
Verwenden des Assembler-Service für die Erstellung des Formulardesigns
Verwenden Sie den Assembler-Service, um das Formulardesign mithilfe von Fragmenten zu generieren. Der Assembler-Serivce gibt eine com.adobe.idp.Document
-Instanz zurück, die das Formulardesign enthält.
Verwenden des Ausgabe-Service für die Erstellung des PDF-Dokuments
Sie können den Ausgabe-Service verwenden, um ein PDF-Dokument mit dem von Assembler-Service erstellten Formulardesign zu generieren. Übergeben Sie die com.adobe.idp.Document
-Instanz, die der Assembler-Service an den Ausgabe-Service zurückgegeben hat.
PDF-Dokument als PDF-Datei speichern
Nachdem der Ausgabe-Service ein PDF-Dokument generiert hat, können Sie es als PDF-Datei speichern.
Siehe auch
Erstellen eines PDF-Dokuments basierend auf Fragmenten mithilfe der Java-API
Erstellen eines PDF-Dokuments basierend auf Fragmenten mithilfe der Web Service-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Assemblieren mehrerer XDP-Fragmente
Erstellen eines PDF-Dokuments basierend auf Fragmenten mithilfe der Java-API create-a-pdf-document-based-on-fragments-using-the-java-api
Erstellen eines PDF-Dokuments basierend auf Fragmenten mithilfe der Output Service API und der Assembler Service API (Java):
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output- und Assembler-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben. - Erstellen Sie ein
AssemblerServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Verwenden Sie den Assembler-Service, um das Design des Formulars zu generieren.
Rufen Sie die
invokeDDX
-Methode desAssemblerServiceClient
-Objekts auf und übergeben Sie ihr die folgenden erforderlichen Werte:- Ein
com.adobe.idp.Document
-Objekt, das das zu verwendende DDX-Dokument darstellt. - Ein
java.util.Map
-Objekt, das die XDP-Eingabedateien enthält. - Ein
com.adobe.livecycle.assembler.client.AssemblerOptionSpec
-Objekt, das die Laufzeitoptionen angibt, einschließlich der Standardschrift und der Vorgangsprotokollebene.
Die
invokeDDX
-Methode gibt eincom.adobe.livecycle.assembler.client.AssemblerResult
-Objekt zurück, welches das assemblierte XDP-Dokument enthält. Um das assemblierte XDP-Dokument abzurufen, gehen Sie wie folgt vor:- Rufen Sie die
getDocuments
-Methode desAssemblerResult
-Objekts auf. Diese Methode gibt einjava.util.Map
-Objekt zurück. - Iterieren Sie durch das
java.util.Map
-Objekt, bis Sie das resultierendecom.adobe.idp.Document
-Objekt finden. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um das assemblierte XDP-Dokument zu extrahieren.
- Ein
-
Verwenden Sie den Output-Service, um das PDF-Dokument zu generieren.
Rufen Sie die
generatePDFOutput2
-Methode desOutputClient
-Objekts auf und übergeben Sie ihr folgende Werte:- Einen
TransformationFormat
-Aufzählungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an - Einen Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich die zusätzlichen Ressourcen (z. B. Bilder) befinden
- Ein
com.adobe.idp.Document
-Objekt, das den Formularentwurf darstellt (verwenden Sie die vom Assembler-Service zurückgegebene Instanz) - Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen
Die
generatePDFOutput2
-Methode gibt einOutputResult
-Objekt zurück, das das Ergebnis des Vorgangs enthält - Einen
-
Speichern Sie das Formular als PDF-Datei.
- Rufen Sie ein
com.adobe.idp.Document
-Objekt ab, das das PDF-Dokument darstellt, indem Sie diegetGeneratedDoc
-Methode desOutputResult
-Objekts aufrufen. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .PDF lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren. (Stellen Sie sicher, dass Sie das von dergetGeneratedDoc
-Methode zurückgegebenecom.adobe.idp.Document
-Objekt verwenden.)
- Rufen Sie ein
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen.
Erstellen eines PDF-Dokuments basierend auf Fragmenten mithilfe der Web Service-API create-a-pdf-document-based-on-fragments-using-the-web-service-api
Erstellen Sie ein PDF-Dokument basierend auf Fragmenten mithilfe der Output Service-API und der Assembler Service-API (Web Service):
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Verwenden Sie die folgende WSDL-Definition für den Service-Verweis, der mit dem Output-Service verknüpft ist:
code language-as3 http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.
Verwenden Sie die folgende WSDL-Definition für die Service-Referenz, die mit dem Assembler-Service verknüpft ist:
code language-as3 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.
Da der Datentyp
BLOB
für beide Service-Verweise verwendet wird, müssen Sie den DatentypBLOB
qualifizieren, wenn Sie ihn verwenden. Im entsprechenden Webservice-Schnellstart sind alleBLOB
-Instanzen vollständig qualifiziert.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output- und Assembler-Client-Objekt.
-
Erstellen Sie mithilfe seines Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu.
- Weisen Sie dem Feld
-
Weisen Sie den Wert der Konstante
BasicHttpSecurityMode.TransportCredentialOnly
dem FeldBasicHttpBindingSecurity.Security.Mode
zu.
note note NOTE Wiederholen Sie diese Schritte für die AssemblerServiceClient
* -Objekt. * -
-
Verwenden Sie den Assembler-Service, um das Design des Formulars zu generieren.
Rufen Sie die Methode
invokeDDX
des ObjektsAssemblerServiceClient
auf und übergeben Sie die folgenden Werte:- A
BLOB
-Objekt, das das DDX-Dokument darstellt - Das
MyMapOf_xsd_string_To_xsd_anyType
-Objekt, das die erforderlichen Dateien enthält - Ein
AssemblerOptionSpec
-Objekt, das Laufzeitoptionen angibt
Die Methode
invokeDDX
gibt einAssemblerResult
-Objekt zurück, das die Ergebnisse des Vorgangs sowie alle aufgetretenen Ausnahmen enthält. Um das neu erstellte XDP-Dokument abzurufen, führen Sie die folgenden Aktionen aus:- Greifen Sie auf das Feld
documents
des ObjektsAssemblerResult
zu, welches einMap
-Objekt mit den erstellten PDF-Dokumente ist. - Durchlaufen Sie das
Map
-Objekt, um den zusammengesetzten Formularentwurf abzurufen. Wandeln Sie denvalue
des Array-Elements in einenBLOB
um. Übergeben Sie die Instanz diesesBLOB
s an den Ausgabe-Service.
- A
-
Verwenden Sie den Output-Service, um das PDF-Dokument zu generieren.
Rufen Sie die
generatePDFOutput2
-Methode desOutputServiceClient
-Objekts auf und übergeben Sie ihr folgende Werte:- Ein
TransformationFormat
-Auflistungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Eine Zeichenfolge, die den Inhaltsstamm angibt, in dem sich die zusätzlichen Ressourcen (z. B. Bilder) befinden.
- Ein
BLOB
-Objekt, welches das Formulardesign darstellt (verwenden Sie dieBLOB
-Instanz, die vom Assembler-Service zurückgegeben wird). - Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formulardesign zusammengeführt werden sollen. - Ein Ausgabe
BLOB
-Objekt, das die MethodegeneratePDFOutput2
mit Werten füllt. Die MethodegeneratePDFOutput2
befüllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein Ausgabe-
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
Die Methode
generatePDFOutput2
gibt einBLOB
-Objekt zurück, das das nicht-interaktive PDF-Formular enthält. - Ein
-
Speichern Sie das Formular als PDF-Datei.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Kennzeichenfolgewert, der den Dateispeicherort des interaktiven PDF-Dokuments und den Modus angibt, in dem die Datei geöffnet werden soll. - Erstellen Sie ein Byte-Array, das den Inhalt des
BLOB
-Objekts speichert, das von der MethodegeneratePDFOutput2
abgerufen wurde. Füllen Sie das Byte-Array auf, indem Sie den Wert des DatenelementsMTOM
desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Methode
Write
desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Drucken in Dateien printing-to-files
Mit dem Ausgabe-Service können Sie Streams wie PostScript, Printer Control Language (PCL) oder die folgenden Etikettenformate in eine Datei drucken:
- Zebra (ZPL)
- Intermec (IPL)
- Datamax (DPL)
- TecToshiba (TPCL)
Mit dem Ausgabe-Service können Sie XML-Daten mit einem Formularentwurf zusammenführen und das Formular in eine Datei drucken. Die folgende Abbildung zeigt, wie der Ausgabe-Service Laser- und Etikettendateien erstellt.
Zusammenfassung der Schritte summary_of_steps-5
Führen Sie die folgenden Schritte aus, um in eine Datei zu drucken:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Legen Sie die zum Drucken in eine Datei erforderlichen Laufzeitoptionen für das Drucken fest.
- Drucken Sie den Druck-Stream in eine Datei.
- Rufen Sie die Ergebnisse des Vorgangs ab.
Einbinden von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Programm-Server bereitgestellt wird, bei dem es sich nicht um JBoss handelt, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Programm-Server sind, auf dem AEM Forms bereitgestellt wird. (Siehe Einbeziehung von AEM Forms Java-Bibliotheksdateien.)
Erstellen eines Client-Objekts für die Ausgabe
Bevor Sie einen Output-Service-Vorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt für den Output-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Output-Webservice-API verwenden, erstellen Sie ein OutputServiceService
-Objekt.
Referenzieren einer XML-Datenquelle
Zum Drucken eines Dokuments, das Daten enthält, müssen Sie eine XML-Datenquelle referenzieren, die XML-Elemente für jedes Formularfeld enthält, das mit Daten gefüllt werden soll. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Wenn alle XML-Elemente angegeben sind, muss die Reihenfolge, in der die XML-Elemente angezeigt werden, nicht übereinstimmen.
Festlegen der zum Drucken in eine Datei erforderlichen Laufzeitoptionen für das Drucken
Um in eine Datei zu drucken, müssen Sie die Laufzeitoption „Datei-URI“ festlegen, indem Sie den Speicherort und den Namen der Datei angeben, in die der Ausgabe-Service drucken soll. Um beispielsweise den Ausgabe-Service anzuweisen, eine PostScript-Datei mit dem Namen MortgageForm.ps auf C:\Adobe zu drucken, geben Sie C:\Adobe\MortgageForm.ps an.
PrintedOutputOptionsSpec
-Klassenreferenz als Teil der AEM Forms-API-Referenz.Drucken des Druck-Streams in eine Datei
Nachdem Sie eine gültige XML-Datenquelle referenziert haben, die Formulardaten enthält, und Laufzeitoptionen für das Drucken festgelegt haben, können Sie den Ausgabe-Service aufrufen, wodurch die Datei gedruckt wird.
Abrufen der Ergebnisse des Vorgangs
Nachdem der Ausgabe-Service einen Vorgang ausgeführt hat, gibt er verschiedene Datenelemente wie XML-Daten zurück, die angeben, ob der Vorgang erfolgreich war.
Siehe auch
Drucken in Dateien mithilfe der Java-API
Drucken in Dateien mithilfe der Webservice-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Drucken in Dateien mithilfe der Java-API print-to-files-using-the-java-api
So drucken Sie mit der Ausgabe-API (Java) in eine Datei:
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle darstellt, die zum Auffüllen des Dokuments verwendet wird, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort der XML-Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Legen Sie die zum Drucken in eine Datei erforderlichen Laufzeitoptionen für das Drucken fest.
- Erstellen Sie ein Objekt
PrintedOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Geben Sie die Datei an, indem Sie die Methode
setFileURI
des PrintedOutputOptionsSpec-Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Namen und den Speicherort der Datei angibt. Wenn Sie beispielsweise möchten, dass der Output-Dienst in eine PostScript-Datei mit dem Namen "MortgageForm.ps"unter C:\Adobe druckt, geben Sie C:\Adobe\MortgageForm.ps an. - Geben Sie die Anzahl der zu druckenden Kopien an, indem Sie die Methode
setCopies
desPrintedOutputOptionsSpec
-Objekts verwenden und einen ganzzahligen Wert für die Anzahl der Exemplare übergeben.
- Erstellen Sie ein Objekt
-
Drucken Sie den Druck-Stream in eine Datei.
Drucken Sie in eine Datei, indem Sie die Methode
generatePrintedOutput
desOutputClient
-Objekts verwenden und die folgenden Werte übergeben:- Ein
PrintFormat
-Enumerationswert, der das zu erstellende Druckstream-Format angibt. Um beispielsweise einen PostScript-Druckstream zu erstellen, übergeben SiePrintFormat.PostScript
. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Eine Zeichenfolge, die den Speicherort zugehöriger Begleitdateien wie Bilddateien angibt.
- Eine Zeichenfolge, die den Speicherort der zu verwendenden XDC-Datei angibt (Sie können
null
übergeben, wenn Sie die XDC-Datei mit Hilfe desPrintedOutputOptionsSpec
-Objekts festgelegt haben). - Das
PrintedOutputOptionsSpec
-Objekt, das die erforderlichen Laufzeitoptionen zum Drucken in eine Datei enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit Formulardaten enthält.
Die Methode
generatePrintedOutput
gibt einOutputResult
-Objekt zurück, das das Ergebnis der Authentifizierung enthält.note note NOTE Die OutputResult
-ObjektgetRecordLevelMetaDataList
Methodenzurückgabennull
*. * - Ein
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
com.adobe.idp.Document
-Objekt, das den Status der MethodegeneratePrintedOutput
angibt, indem Sie die MethodegetStatusDoc
desOutputResult
-Objekts aufrufen (dasOutputResult
-Objekt wurde von der MethodegeneratePrintedOutput
zurückgegeben). - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateierweiterung XML ist. - Rufen Sie die Methode
copyToFile
descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von der MethodegetStatusDoc
zurückgegeben wurde).
- Erstellen Sie ein
Siehe auch
Schnellstart (SOAP-Modus): Drucken in eine Datei mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen.
Drucken in Dateien mithilfe der Webservice-API print-to-files-using-the-web-service-api
Drucken Sie mit der Output API (Web-Service) in eine Datei:
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt wird zum Speichern von Formulardaten verwendet. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und eine Zeichenfolge übergeben, die den Speicherort der XML-Datei mit den Formulardaten angibt. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben. - Befüllen Sie das
BLOB
-Objekt mit dem Inhalt des Byte-Arrays durch Zuweisen der EigenschaftbinaryData
.
- Erstellen Sie ein Objekt
-
Legen Sie die zum Drucken in eine Datei erforderlichen Laufzeitoptionen für das Drucken fest.
- Erstellen Sie ein Objekt
PrintedOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Geben Sie die Datei an, indem Sie dem
PrintedOutputOptionsSpec
-Datenelement des ObjektsfileURI
eine Zeichenfolge zuweisen, die den Speicherort und den Namen der Datei darstellt. Wenn der Ausgabe-Service beispielsweise in eine PostScript-Datei mit dem Namen MortgageForm.ps im Ordner C:\Adobe drucken soll, geben Sie C:\Adobe\MortgageForm.ps an. - Geben Sie die Anzahl der zu druckenden Kopien an, indem Sie den
copies
-Datenelementen desPrintedOutputOptionsSpec
-Objekts einen ganzzahligen Wert zuweisen, der die Anzahl der Kopien darstellt.
- Erstellen Sie ein Objekt
-
Drucken Sie den Druck-Stream in eine Datei.
Drucken Sie in eine Datei, indem Sie die Methode
generatePrintedOutput
desOutputServiceService
-Objekts verwenden und die folgenden Werte übergeben:- Ein
PrintFormat
-Enumerationswert, der das zu erstellende Druckstream-Format angibt. Um beispielsweise einen PostScript-Druckstream zu erstellen, übergeben SiePrintFormat.PostScript
. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Eine Zeichenfolge, die den Speicherort zugehöriger Begleitdateien wie Bilddateien angibt.
- Ein Zeichenfolgenwert, der den Speicherort der zu verwendenden XDC-Datei angibt (Sie können
null
übergeben, wenn Sie die XDC-Datei angegeben haben, die mithilfe desPrintedOutputOptionsSpec
-Objekts verwendet werden soll). - Das
PrintedOutputOptionsSpec
-Objekt, das zum Drucken in eine Datei erforderliche Drucklaufzeitoptionen enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Formulardaten enthält. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. Die MethodegeneratePDFOutput
füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
BLOB
-Objekt, das von der MethodegeneratePDFOutput
aufgefüllt wird. Die MethodegeneratePDFOutput
füllt dieses Objekt mit Ergebnisdaten. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.)
- Ein
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der einen XML-Dateispeicherort mit den Ergebnisdaten darstellt. Stellen Sie sicher, dass die Dateierweiterung XML ist. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das mit den Ergebnisdaten von dergeneratePDFOutput
-Methode desOutputServiceService
-Objekts (der achte Parameter) gefüllt wurde. Füllen Sie das Byte-Array, indem Sie den Wert desMTOM
-Datenmembers desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in die XML-Datei, indem Sie die
Write
-Methode desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef
Senden von Druck-Streams an Drucker sending-print-streams-to-printers
Sie können den Ausgabe-Service verwenden, um Druck-Streams wie PostScript, Printer Control Language (PCL) oder die folgenden Etikettenformate an Netzwerkdrucker zu senden:
- Zebra (ZPL)
- Intermec (IPL)
- Datamax (DPL)
- TecToshiba (TPCL)
Mit dem Ausgabe-Service können Sie XML-Daten mit einem Formularentwurf zusammenführen und das Formular als Druck-Stream ausgeben. Sie können beispielsweise einen PostScript-Druck-Stream erstellen und an einen Netzwerkdrucker senden. Die folgende Abbildung zeigt, wie der Ausgabe-Service Druck-Streams an Netzwerkdrucker sendet.
Zusammenfassung der Schritte summary_of_steps-6
Um einen Druck-Stream an einen Netzwerkdrucker zu senden, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Festlegen von Laufzeitoptionen für das Drucken
- Rufen Sie ein zu druckendes Dokument ab.
- Senden Sie das Dokument an einen Netzwerkdrucker.
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver bereitgestellt wird, der nicht JBoss ist, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird.
Erstellen eines Client-Objekts für die Ausgabe
Bevor Sie einen Ausgabe-Service-Vorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt für den Ausgabe-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Output-Webservice-API verwenden, erstellen Sie ein OutputServiceClient
-Objekt.
Referenzieren einer XML-Datenquelle
Zum Drucken eines Dokuments, das Daten enthält, müssen Sie eine XML-Datenquelle referenzieren, die XML-Elemente für jedes Formularfeld enthält, das mit Daten gefüllt werden soll. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Wenn alle XML-Elemente angegeben sind, muss die Reihenfolge, in der die XML-Elemente angezeigt werden, nicht übereinstimmen.
Festlegen von Laufzeitoptionen für das Drucken
Sie können die Laufzeitoptionen beim Senden eines Druck-Streams an einen Drucker festlegen, einschließlich der folgenden Optionen:
- Kopien: Gibt die Anzahl der an den Drucker zu sendenden Kopien an. Der Standardwert ist 1.
- Heften: Eine XCI-Option wird festgelegt, wenn ein Hefter verwendet wird. Diese Option kann im Konfigurationsmodell durch das Heftelement angegeben werden und wird nur für PS- und PCL-Drucker verwendet.
- OutputJog: Eine XCI-Option wird festgelegt, wenn die Ausgabeseiten verschoben werden sollen (physische Verschiebung im Ausgabefach). Diese Option ist nur für PS- und PCL-Drucker verfügbar.
- OutputBin: XCI-Wert, der verwendet wird, um dem Druckertreiber die Auswahl des geeigneten Ausgabefachs zu ermöglichen.
PrintedOutputOptionsSpec
-Klassenreferenz.Abrufen eines zu druckenden Dokuments
Rufen Sie einen Druck-Streams ab, der an einen Drucker gesendet werden soll. Sie können beispielsweise eine PostScript-Datei abrufen und an einen Drucker senden.
Sie können eine PDF-Datei senden, wenn Ihr Drucker PDF unterstützt. Ein Problem beim Senden eines PDF-Dokuments an einen Drucker besteht jedoch darin, dass jeder Druckerhersteller über eine andere Implementierung des PDF-Interpreters verfügt. Das heißt, einige Druckerhersteller verwenden die Adobe PDF-Interpretation, aber dies hängt vom Drucker ab. Andere Drucker haben einen eigenen PDF-Interpreter. Daher können die Druckergebnisse variieren.
Eine weitere Einschränkung beim Senden eines PDF-Dokuments an einen Drucker besteht darin, dass es nur gedruckt wird. Dabei kann nicht auf Duplex, Papierfachauswahl und Heften zugegriffen werden, außer durch Einstellungen am Drucker.
Um ein zu druckendes Dokument abzurufen, verwenden Sie die Methode generatePrintedOutput
. In der folgenden Tabelle sind die Content-Typen aufgeführt, die für einen bestimmten Druck-Stream bei Verwendung der Methode generatePrintedOutput
festgelegt werden.
generatePrintedOutput2
-Methode an einen Drucker senden. Die Schnellstarts, die mit dem Abschnitt zum Senden von Druckstreams an Drucker verknüpft sind, verwenden jedoch die generatePrintedOutput
-Methode.Senden des Druckstroms an einen Netzwerkdrucker
Nachdem Sie ein zu druckendes Dokument abgerufen haben, können Sie den Ausgabeservice aufrufen, wodurch ein Druckstream an einen Netzwerkdrucker gesendet wird. Damit der Ausgabeservice den Drucker erfolgreich finden kann, müssen Sie sowohl den Druckserver als auch den Druckernamen angeben. Darüber hinaus müssen Sie auch das Druckprotokoll angeben.
Senden Sie mithilfe der Ausgabe API (Java) einen Druck-Stream an einen Netzwerkdrucker:
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen eines Client-Objekts für die Ausgabe
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren einer XML-Datenquelle
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle darstellt, die zum Auffüllen des Dokuments verwendet wird, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort der XML-Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Festlegen von Laufzeitoptionen für das Drucken
Erstellen Sie ein
PrintedOutputOptionsSpec
-Objekt, das Laufzeitoptionen für das Drucken darstellt. Sie können zum Beispiel die Anzahl der zu druckenden Kopien angeben, indem Sie die MethodesetCopies
desPrintedOutputOptionsSpec
-Objekts aufrufen.note note NOTE Sie können den Paginierungswert nicht mit der Methode setPagination
desPrintedOutputOptionsSpec
-Objekts festlegen, wenn Sie einen ZPL-Druck-Stream erzeugen. Ebenso können Sie die folgenden Optionen für einen ZPL-Druckstream nicht festlegen: OutputJog, PageOffset und Staple. DiesetPagination
* ist für die PostScript-Generierung nicht gültig. Sie gilt nur für die Erzeugung von PCL. * -
Abrufen eines zu druckenden Dokuments
-
Rufen Sie ein zu druckendes Dokument ab, indem Sie die Methode
generatePrintedOutput
desOutputClient
-Objekts aufrufen und die folgenden Werte übergeben:- Ein
PrintFormat
-Auflistungswert, der den Druck-Stream angibt. Um beispielsweise einen PostScript-Druck-Stream zu erstellen, übergeben SiePrintFormat.PostScript
. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Speicherort zugehöriger Begleitdateien (z. B. Grafikdateien) angibt.
- Ein Zeichenfolgenwert, der den Speicherort der zu verwendenden XDC-Datei angibt.
- Das
PrintedOutputOptionsSpec
-Objekt, das Laufzeitoptionen enthält, die zum Drucken in eine Datei erforderlich sind. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle darstellt, welche die mit dem Formularentwurf zusammenzuführenden Formulardaten enthält.
Diese Methode gibt ein
OutputResult
-Objekt zurück, das die Ergebnisse des Vorgangs enthält. - Ein
-
Erstellen Sie ein
com.adobe.idp.Document
-Objekt zum Senden an den Drucker, indem Sie die MethodegetGeneratedDoc
desOutputResult
-Objekts aufrufen. Diese Methode gibt eincom.adobe.idp.Document
-Objekt zurück.
-
-
Senden Sie den Druck-Stream an einen Netzwerkdrucker.
Senden Sie den Druck-Stream an einen Netzwerkdrucker, indem Sie die Methode
sendToPrinter
desOutputClient
-Objekts aufrufen und die folgenden Werte übergeben:- Ein
com.adobe.idp.Document
-Objekt, das den an den Drucker zu sendenden Druck-Stream darstellt. - Ein
PrinterProtocol
-Auflistungswert, der das zu verwendende Druckerprotokoll angibt. Um beispielsweise das SharedPrinter-Protokoll anzugeben, übergeben SiePrinterProtocol.SharedPrinter
. - Ein Zeichenfolgenwert, der den Namen des Druck-Servers angibt. Wenn beispielsweise der Name des Druck-Servers PrintSever1 lautet, übergeben Sie
\\\PrintSever1
. - Ein Zeichenfolgenwert, der den Namen des Druckers angibt. Wenn beispielsweise der Name des Druckers Printer1 lautet, übergeben Sie
\\\PrintSever1\Printer1
.
note note NOTE Die Methode sendToPrinter
wurde in Version 8.2.1 der AEM Forms-API hinzugefügt. - Ein
Senden eines Druck-Streams an einen Drucker mithilfe der Webservice-API send-a-print-stream-to-a-printer-using-the-web-service-api
So senden Sie einen Druck-Stream an einen Netzwerkdrucker, indem Sie die Ausgabe-API (Webservice) verwenden:
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen localhost
* mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird. * -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt wird zum Speichern von Formulardaten verwendet. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der XML-Datei angibt, die Formulardaten enthält. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Ermitteln Sie die Länge des Byte-Arrays, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die Methode
Read
desSystem.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die Länge des zu lesenden Streams übergeben. - Füllen Sie das
BLOB
-Objekt, indem Sie seinem FeldMTOM
den Inhalt des Byte-Arrays zuweisen.
- Erstellen Sie ein Objekt
-
Festlegen von Laufzeitoptionen für das Drucken.
Erstellen Sie ein Objekt
PrintedOutputOptionsSpec
, indem Sie den Konstruktor verwenden. Sie können zum Beispiel die Anzahl der zu druckenden Kopien angeben, indem Sie dem Datenelementcopies
desPrintedOutputOptionsSpec
-Objekts einen Ganzzahlwert zuweisen, der die Anzahl der Kopien darstellt.note note NOTE Sie können den Paginierungswert nicht mit der Methode pagination
desPrintedOutputOptionsSpec
-Objekts festlegen, wenn Sie einen ZPL-Druck-Stream erzeugen. Ebenso können Sie die folgenden Optionen für einen ZPL-Druck-Stream nicht festlegen: OutputJog, PageOffset und Staple. Diepagination
* -Datenelement ist für die PostScript-Generierung nicht gültig. Sie gilt nur für die Erzeugung von PCL. * -
Rufen Sie ein zu druckendes Dokument ab.
-
Rufen Sie ein zu druckendes Dokument ab, indem Sie die Methode
generatePrintedOutput
des ObjektsOutputServiceService
aufrufen und die folgenden Werte übergeben:- Ein
PrintFormat
-Auflistungswert, der den Druck-Stream angibt. Um beispielsweise einen PostScript-Druck-Stream zu erstellen, übergeben SiePrintFormat.PostScript
. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Speicherort zugehöriger Begleitdateien (z. B. Grafikdateien) angibt.
- Ein Zeichenfolgenwert, der den Speicherort der zu verwendenden XDC-Datei angibt.
- Das
PrintedOutputOptionsSpec
-Objekt, das Laufzeitoptionen für das Drucken enthält, die beim Senden eines Druck-Streams an einen Netzwerkdrucker verwendet werden. - Das
BLOB
-Objekt, das die XML-Datenquelle enthält, die Formulardaten enthält. - Ein
BLOB
-Objekt, das von dergeneratePrintedOutput
-Methode gefüllt wird. Die MethodegeneratePrintedOutput
füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
BLOB
-Objekt, das von der MethodegeneratePrintedOutput
aufgefüllt wird. Die MethodegeneratePrintedOutput
füllt dieses Objekt mit Ergebnisdaten. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.)
- Ein
-
Erstellen Sie ein
BLOB
-Objekt, das an den Drucker gesendet werden soll, indem Sie den Wert der MethodegeneratedDoc
desOutputResult
-Objekts abrufen. Diese Methode gibt einBLOB
-Objekt zurück, das PostScript-Daten enthält, die von der MethodegeneratePrintedOutput
zurückgegeben werden.
-
-
Senden Sie den Druck-Stream an einen Netzwerkdrucker.
Senden Sie den Druck-Stream an einen Netzwerkdrucker, indem Sie die Methode
sendToPrinter
desOutputClient
-Objekts aufrufen und die folgenden Werte übergeben:- Ein
BLOB
-Objekt, das den an den Drucker zu sendenden Druck-Stream darstellt. - Ein
PrinterProtocol
-Auflistungswert, der das zu verwendende Druckerprotokoll angibt. Um beispielsweise das SharedPrinter-Protokoll anzugeben, übergeben SiePrinterProtocol.SharedPrinter
. - Ein
bool
Wert, der angibt, ob der vorherige Parameterwert verwendet werden soll. Übergeben Sie den Werttrue
. (Dieser Parameterwert ist nur für den Aufruf des Webservices erforderlich.) - Ein Zeichenfolgenwert, der den Namen des Druck-Servers angibt. Wenn beispielsweise der Name des Druckservers PrintSever1 lautet, übergeben Sie
\\\PrintSever1
. - Ein Zeichenfolgenwert, der den Namen des Druckers angibt. Wenn beispielsweise der Name des Druckers Printer1 lautet, übergeben Sie
\\\PrintSever1\Printer1
.
note note NOTE Die Methode sendToPrinter
wurde in Version 8.2.1 der AEM Forms-API hinzugefügt. - Ein
Erstellen mehrerer Ausgabedateien creating-multiple-output-files
Der Ausgabe-Service kann für jeden Datensatz in einer XML-Datenquelle oder in einer Datei, die alle Datensätze enthält, separate Dokumente erstellen (diese Funktion ist die Standardfunktion). Angenommen, zehn Datensätze befinden sich in einer XML-Datenquelle und Sie weisen den Ausgabe-Service an, mithilfe der Ausgabe-Service-API für jeden Datensatz separate PDF-Dokumente (oder andere Ausgabetypen) zu erstellen. Dann erzeugt der Ausgabe-Service zehn PDF-Dokumente. (Anstatt Dokumente zu erstellen, können Sie auch mehrere Druck-Streams an einen Drucker senden.)
Die folgende Abbildung zeigt auch, wie der Ausgabe-Service eine XML-Datendatei verarbeitet, die mehrere Datensätze enthält. Nehmen wir jedoch an, dass Sie den Ausgabe-Service anweisen, ein einziges PDF-Dokument zu erstellen, das alle Datensätze enthält. In diesem Fall erzeugt der Ausgabe-Service ein Dokument, das alle Datensätze enthält.
Die folgende Abbildung zeigt, wie der Ausgabe-Service eine XML-Datendatei verarbeitet, die mehrere Datensätze enthält. Angenommen, Sie weisen den Ausgabe-Service an, für jeden Datensatz ein eigenes PDF-Dokument zu erstellen. In diesem Fall erzeugt der Ausgabe-Service für jeden Datensatz ein separates PDF-Dokument.
Die folgenden XML-Daten zeigen ein Beispiel einer Datendatei, die drei Datensätze enthält.
<?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>
Beachten Sie, dass das XML-Element, das jeden Datensatz startet und beendet, LoanRecord
ist. Dieses XML-Element wird durch die Anwendungslogik referenziert, die mehrere Dateien erzeugt.
Zusammenfassung der Schritte summary_of_steps-7
Um mehrere PDF-Dateien auf der Grundlage einer XML-Datenquelle zu erstellen, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Legen Sie PDF-Laufzeitoptionen fest.
- Legen Sie Rendering-Laufzeitoptionen fest.
- Generieren Sie mehrere PDF-Dateien.
- Rufen Sie die Ergebnisse des Vorgangs ab.
Einbinden von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver bereitgestellt wird, der nicht JBoss ist, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird.
Erstellen eines Output-Client-Objekts
Bevor Sie einen Output-Service-Vorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt für den Output-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Output-Webservice-API verwenden, erstellen Sie ein OutputServiceService
-Objekt.
Referenzieren einer XML-Datenquelle
Referenzieren Sie eine XML-Datenquelle, die mehrere Datensätze enthält. Ein XML-Element muss verwendet werden, um die Datensätze zu trennen. In der Beispiel-XML-Datenquelle, die oben in diesem Abschnitt gezeigt wird, heißt beispielsweise das XML-Element, das Datensätze trennt, LoanRecord
.
Für jedes Formularfeld, das mit Daten gefüllt werden soll, muss ein XML-Element vorhanden sein. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Wenn alle XML-Elemente angegeben sind, muss die Reihenfolge, in der die XML-Elemente angezeigt werden, nicht übereinstimmen.
Festlegen von PDF-Laufzeitoptionen
Sie müssen die folgenden Laufzeitoptionen festlegen, damit der Ausgabe-Service erfolgreich mehrere Dateien erstellen kann, die auf einer XML-Datenquelle basieren:
- Viele Dateien: Gibt an, ob der Ausgabe-Service ein einzelnes Dokument oder mehrere Dokumente erstellt. Sie können „true“ oder „false“ angeben. Um ein separates Dokument für jeden Datensatz in der XML-Datenquelle zu erstellen, geben Sie „true“ an.
- Datei-URI: Gibt den Speicherort der Dateien an, die der Ausgabe-Service erzeugt. Angenommen, Sie geben C:\Adobe\forms\Loan.pdf an. In diesem Fall erstellt der Ausgabe-Service eine Datei mit dem Namen „Loan.pdf“ und legt diese Datei im Ordner „C:\Adobe\forms folder“ ab. Wenn mehrere Dateien vorliegen, lauten die Dateinamen „Loan0001.pdf“, „Loan0002.pdf“, „Loan0003.pdf“ usw. Wenn Sie einen Dateispeicherort angeben, werden die Dateien auf dem Server und nicht auf dem Client-Computer abgelegt.
- Datensatzname: Gibt den Namen des XML-Elements in der Datenquelle an, das die Datensätze trennt. In der Beispiel-XML-Datenquelle, die oben in diesem Abschnitt gezeigt wird, hat beispielsweise das XML-Element, das Datensätze trennt, den Namen
LoanRecord
. (Anstatt als Laufzeitoption den Datensatznamen festzulegen, können Sie auch die Datensatzebene festlegen, indem Sie ihr einen numerischen Wert zuweisen, der die Elementebene angibt, welche Datensätze enthält. Sie können jedoch nur entweder den Datensatznamen oder die Datensatzebene festlegen. Sie können nicht beide Werte festlegen.)
Festlegen von Laufzeitoptionen für das Rendern
Sie können beim Erstellen mehrerer Dateien Laufzeitoptionen für das Rendern festlegen. Obwohl diese Optionen nicht erforderlich sind (im Gegensatz zu erforderlichen Laufzeitoptionen für die Ausgabe), können Sie damit Aufgaben wie die Verbesserung der Leistung des Ausgabe-Services ausführen. Beispielsweise können Sie die Leistung verbessern, indem Sie den Formularentwurf zwischenspeichern, den der Ausgabe-Service verwendet.
Wenn der Ausgabe-Service Batch-Datensätze verarbeitet, liest er inkrementell Daten, die mehrere Datensätze enthalten. Das heißt, der Ausgabe-Service liest die Daten in den Speicher ein und gibt sie im Laufe der Verarbeitung des Datensatz-Batches wieder frei. Der Ausgabe-Service lädt Daten inkrementell, wenn eine der zwei Laufzeitoptionen festgelegt ist. Wenn Sie für die Laufzeitoption den Datensatznamen festlegen, liest der Ausgabe-Service die Daten inkrementell. Wenn Sie für die Laufzeitoption die Datensatzebene auf 2 oder höher setzen, liest der Ausgabe-Service die Daten ebenfalls auf inkrementelle Weise.
Sie können steuern, ob der Ausgabe-Service das Laden inkrementell durchführen soll, indem Sie die Methode PDFOutputOptionsSpec
oder PrintedOutputOptionSpec
des setLazyLoading
-Objekts verwenden. Sie können den Wert false
an diese Methode übergeben, um das inkrementelle Laden zu deaktivieren.
Erzeugen mehrerer PDF-Dateien
Nachdem Sie eine gültige XML-Datenquelle referenziert haben, die mehrere Datensätze enthält, und Laufzeitoptionen festgelegt haben, können Sie den Ausgabe-Service aufrufen, wodurch mehrere Dateien erzeugt werden. Bei der Erzeugung mehrerer Datensätze gibt die Methode getGeneratedDoc
des OutputResult
-Objekts null
zurück.
Abrufen der Ergebnisse des Vorgangs
Nachdem der Ausgabe-Service einen Vorgang ausgeführt hat, werden XML-Daten zurückgegeben, die angeben, ob der Vorgang erfolgreich war. Die folgende XML-Datei wird vom Ausgabe-Service zurückgegeben. In diesem Fall generiert der Ausgabe-Service 42 Dokumente.
<?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>
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Erstellen mehrerer PDF-Dateien mit der Java-API create-multiple-pdf-files-using-the-java-api
Erstellen Sie mehrere PDF-Dateien mithilfe der Ausgabe-API (Java):
-
Projektdateien einschließen“
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein…
-
Erstellen eines Client-Objekts für die Ausgabe
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren einer XML-Datenquelle
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle mit mehreren Datensätzen darstellt, indem es seinen Konstruktor verwendet und eine Zeichenfolge mit dem Speicherort der XML-Datei übergibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Festlegen von PDF-Laufzeitoptionen
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option „Viele Dateien“ fest, indem Sie die Methode
setGenerateManyFiles
desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie beispielsweise den Werttrue
, um den Ausgabe-Service anzuweisen, für jeden Datensatz in der XML-Datenquelle eine separate PDF-Datei zu erstellen. (Wenn Siefalse
übergeben, generiert der Output-Dienst ein einzelnes PDF-Dokument, das alle Datensätze enthält). - Legen Sie die Option „Datei-URI“ fest, indem Sie die Methode
setFileUri
desPDFOutputOptionsSpec
-Objekts verwenden und eine Zeichenfolge übergeben, die den Speicherort der Dateien angibt, die der Ausgabe-Service generiert. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer. - Legen Sie die Option „Name des Datensatzes“ fest, indem Sie die Methode
setRecordName
desOutputOptionsSpec
-Objekts verwenden und eine Zeichenfolge übergeben, die den Namen des XML-Elements in der Datenquelle angibt, das die Datensätze trennt. (Ein Beispiel für eine XML-Datenquelle finden Sie weiter oben in diesem Abschnitt. Der Name des XML-Elements, das die Datensätze trennt, ist LoanRecord).
- Erstellen Sie ein Objekt
-
Einstellen der Laufzeitoptionen für das Rendern
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Führen Sie eine Zwischenspeicherung des Formulardesigns durch, um die Leistung des Ausgabe-Service zu verbessern, indem Sie
RenderOptionsSpec
für dassetCacheEnabled
-Objekt anwenden und einenBoolean
-Wert vontrue
übergeben.
- Erstellen Sie ein Objekt
-
Mehrere PDF-Dateien generieren
Erstellen Sie mehrere PDF-Dateien, indem Sie die Methode
generatePDFOutput
desOutputClient
-Objekts verwenden und die folgenden Werte übergeben:- Einen
TransformationFormat
Enum-Wert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
com.adobe.idp.Document
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen.
Die Methode
generatePDFOutput
gibt einOutputResult
-Objekt zurück, das die Ergebnisse des Vorgangs enthält. - Einen
-
Ergebnisse des Vorgangs abrufen
- Erstellen Sie ein
java.io.File
-Objekt, das eine XML-Datei mit den Ergebnisse dergeneratePDFOutput
-Methode darstellt. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Rufen Sie die Methode
copyToFile
descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von der MethodeapplyUsageRights
zurückgegeben wird).
- Erstellen Sie ein
Siehe auch
Schnellstart (EJB-Modus): Erstellen mehrerer PDF-Dateien mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen mehrerer PDF-Dateien mithilfe der Web-Service-API create-multiple-pdf-files-using-the-web-service-api
Erstellen mehrerer PDF-Dateien mithilfe der Output API (Web-Service):
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird. -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DieBLOB
-Objekt wird zum Speichern von Formulardaten verwendet, die mehrere Datensätze enthalten. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Dateispeicherort der XML-Datei darstellt, die mehrere Datensätze enthält. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Datenstromdaten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und ihr das Byte-Array, die Startposition und die zu lesende Datenstromlänge übergeben. - Füllen Sie das
BLOB
-Objekt durch Zuweisen seinesMTOM
-Felds mit dem Inhalt des Byte-Arrays.
- Erstellen Sie ein Objekt
-
Legen Sie PDF-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Legen Sie die Option für viele Dateien fest, indem Sie dem
generateManyFiles
-Datenelement desOutputOptionsSpec
-Objekts einen booleschen Wert zuweisen. Weisen Sie beispielsweise den Werttrue
diesem Datenelement zu, um den Ausgabeservice anzuweisen, eine separate PDF-Datei für jeden Datensatz in der XML-Datenquelle zu erstellen. (Wenn Siefalse
diesem Datenelement zuweisen, generiert der Ausgabeservice eine einzelne PDF-Datei, die alle Datensätze enthält.) - Legen Sie die Datei-URI-Option fest, indem Sie einen Zeichenfolgenwert zuweisen, der den Speicherort der Datei(en) angibt, die der Ausgabeservice im
fileURI
-Datenelement desOutputOptionsSpec
-Objekts generiert. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer. - Legen Sie die Option für den Datensatznamen fest, indem Sie einen Zeichenfolgenwert zuweisen, der den Namen des XML-Elements in der Datenquelle angibt, die die Datensätze im
recordName
-Datenelement desOutputOptionsSpec
-Objekts trennt. - Legen Sie die Kopienoption fest, indem Sie einen ganzzahligen Wert zuweisen, der die Anzahl der Kopien angibt, die vom Ausgabeservice im
copies
-Datenelement desOutputOptionsSpec
-Objekts generiert werden.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Speichern Sie den Formularentwurf zwischen, um die Leistung des Ausgabeservice zu verbessern, indem Sie den Wert
true
demcacheEnabled
-Datenelement desRenderOptionsSpec
-Objekts zuweisen.
- Erstellen Sie ein Objekt
-
Generieren Sie mehrere PDF-Dateien.
Erstellen Sie mehrere PDF-Dateien durch Aufrufen der
generatePDFOutput
-Methode desOutputServiceService
-Objekts und durch Übergeben der folgenden Werte:- Ein TransformationFormat-Enum-Wert. Um ein PDF-Dokument zu generieren, geben Sie
TransformationFormat.PDF
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit Ergebnisdaten. - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält.
- Ein TransformationFormat-Enum-Wert. Um ein PDF-Dokument zu generieren, geben Sie
-
Ergebnisse des Vorgangs abrufen
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie den Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der einen XML-Dateispeicherort darstellt, der Ergebnisdaten enthält. Stellen Sie sicher, dass die Dateinamenerweiterung .xml lautet. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das von dergeneratePDFOutput
-Methode desOutputServiceService
-Objekts (der achte Parameter) gefüllt wurde. Füllen Sie das Byte-Array, indem Sie den Wert desbinaryData
-Datenmembers desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in die XML-Datei, indem Sie die
Write
-Methode desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef
Erstellen von Suchregeln creating-search-rules
Sie können Suchregeln erstellen, die dazu führen, dass der Ausgabe-Service Eingabedaten prüft und verschiedene auf dem Dateninhalt basierende Formulardesigns verwendet, um die Ausgabe zu generieren. Wenn sich beispielsweise der Text Hypothek in den Eingabedaten befindet, kann der Ausgabe-Service einen Formularentwurf mit dem Namen Mortgage.xdp verwenden. Ähnlich kann der Ausgabe-Service, wenn sich der Text Automobile in den Eingabedaten befindet, einen Formularentwurf verwenden, der als AutomobileLoan.xdp gespeichert wird. Auch wenn der Ausgabe-Service unterschiedliche Ausgabetypen erzeugen kann, wird in diesem Abschnitt davon ausgegangen, dass der Ausgabe-Service eine PDF-Datei erzeugt. Das folgende Diagramm zeigt, wie der Ausgabe-Service eine PDF-Datei erzeugt, indem er eine XML-Datendatei verarbeitet und einen von vielen Formularentwürfen verwendet.
Darüber hinaus kann der Ausgabe-Service Dokumentenpakete generieren, bei denen mehrere Datensätze im Datensatz bereitgestellt werden, jeder Datensatz einem Formularentwurf zugeordnet wird und ein einziges Dokument erzeugt wird, das aus mehreren Formularentwürfen besteht.
Zusammenfassung der Schritte summary_of_steps-8
Um den Ausgabe-Service anzuweisen, beim Erzeugen eines Dokuments Suchregeln zu verwenden, führen Sie die folgenden Schritte aus:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Referenzieren Sie eine XML-Datenquelle.
- Definieren Sie Suchregeln.
- Legen Sie PDF-Laufzeitoptionen fest.
- Legen Sie Rendering-Laufzeitoptionen fest.
- Generieren Sie ein PDF-Dokument.
- Rufen Sie die Ergebnisse des Vorgangs ab.
Einbinden von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Programm-Server bereitgestellt wird, bei dem es sich nicht um JBoss handelt, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Programm-Server sind, auf dem AEM Forms bereitgestellt wird.
Erstellen eines Client-Objekts für die Ausgabe
Bevor Sie einen Ausgabe-Service-Vorgang programmgesteuert durchführen können, müssen Sie ein Client-Objekt für den Ausgabe-Service erstellen.
Referenzieren einer XML-Datenquelle
Für jedes Formularfeld, das mit Daten gefüllt werden soll, muss ein XML-Element vorhanden sein. Der Name des XML-Elements muss mit dem Feldnamen übereinstimmen. Ein XML-Element wird ignoriert, wenn es keinem Formularfeld entspricht oder wenn der XML-Elementname nicht mit dem Feldnamen übereinstimmt. Es ist nicht erforderlich, die Reihenfolge der Anzeige der XML-Elemente einzuhalten, solange alle XML-Elemente angegeben sind.
Definieren von Suchregeln
Um Suchregeln zu definieren, definieren Sie ein oder mehrere Textmuster, nach denen der Ausgabe-Service in den Eingabedaten suchen soll. Für jedes von Ihnen definierte Textmuster geben Sie einen entsprechenden Formularentwurf an, der verwendet wird, wenn das Textmuster gefunden wird. Wenn ein Textmuster gefunden wird, verwendet der Ausgabe-Service den entsprechenden Formularentwurf, um die Ausgabe zu erzeugen. Ein Beispiel für ein Textmuster ist Hypothek.
Festlegen von PDF-Laufzeitoptionen
Legen Sie die folgenden PDF-Laufzeitoptionen fest, damit der Ausgabe-Service erfolgreich ein PDF-Dokument erstellen kann, das auf mehreren Formularentwürfen basiert:
- Datei-URI: Gibt den Namen und Speicherort der PDF-Datei an, die der Ausgabe-Service erzeugt.
- Regeln: Gibt von Ihnen definierte Regeln an.
- LookAHead: Gibt die Anzahl der Bytes an, die ab dem Anfang der Eingabedatendatei verwendet werden sollen, um nach den definierten Textmustern zu suchen. Der Standardwert ist 500 Byte.
Festlegen von Laufzeitoptionen für das Rendern
Sie können beim Erstellen von PDF-Dateien Laufzeitoptionen für das Rendern festlegen. Obwohl diese Optionen nicht erforderlich sind (im Gegensatz zu PDF-Laufzeitoptionen), können Sie damit Aufgaben wie die Verbesserung der Leistung des Ausgabe-Services ausführen. Beispielsweise können Sie die Leistung verbessern, indem Sie den Formularentwurf zwischenspeichern, den der Ausgabe-Service verwendet.
Erzeugen eines PDF-Dokuments
Nachdem Sie eine gültige XML-Datenquelle referenziert und Laufzeitoptionen festgelegt haben, können Sie den Ausgabe-Service aufrufen, um ein PDF-Dokument zu erzeugen. Wenn der Ausgabe-Service ein bestimmtes Textmuster in den Eingabedaten findet, verwendet er den entsprechenden Formularentwurf. Wenn kein Textmuster verwendet wird, verwendet der Ausgabe-Service den Standardformularentwurf.
Abrufen der Ergebnisse des Vorgangs
Nachdem der Ausgabe-Service einen Vorgang ausgeführt hat, gibt er XML-Daten zurück, die angeben, ob der Vorgang erfolgreich war.
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Erstellen von Suchregeln mithilfe der Java-API create-search-rules-using-the-java-api
So erstellen Sie Suchregeln mithilfe der Ausgabe-API (Java):
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das die XML-Datenquelle darstellt, die zum Füllen des PDF-Dokuments verwendet wird, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort der XML-Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Definieren Sie Suchregeln.
- Erstellen Sie ein Objekt
Rule
, indem Sie den Konstruktor verwenden. - Definieren Sie ein Textmuster, indem Sie die
setPattern
-Methode desRule
-Objekts aufrufen und einen Zeichenfolgenwert übergeben, der ein Textmuster angibt. - Definieren Sie den entsprechenden Formularentwurf, indem Sie die
setForm
-Methode desRule
-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Formularentwurfs angibt.
note note NOTE Wiederholen Sie für jedes Textmuster, das Sie definieren möchten, die vorherigen drei Teilschritte. - Erstellen Sie ein
java.util.List
-Objekt mithilfe einesjava.util.ArrayList
-Konstruktors. - Rufen Sie für jedes
Rule
-Objekt, das Sie erstellt haben, dieadd
-Methode desjava.util.List
-Objekts auf und übergeben Sie dasRule
-Objekt.
- Erstellen Sie ein Objekt
-
Legen Sie PDF-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Geben Sie den Namen und den Speicherort der PDF-Datei an, die der Ausgabe-Sevice generiert, indem Sie die
setFileURI
-Methode desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort der PDF-Datei angibt. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer. - Legen Sie die von Ihnen definierten Regeln fest, indem Sie die
setRules
-Methode desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie dasjava.util.List
-Objekt, das dieRule
-Objekte enthält. - Legen Sie die Anzahl der Bytes fest, die nach den definierten Textmustern gescannt werden sollen, indem Sie die
setLookAhead
-Methode desPDFOutputOptionsSpec
-Objekts aufrufen. Übergeben Sie einen ganzzahligen Wert, der die Anzahl der Bytes darstellt.
- Erstellen Sie ein Objekt
-
Legen Sie Rendering-Laufzeitoptionen fest.
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Speichern Sie den Formularentwurf zwischen, um die Leistung des Ausgabe-Service zu verbessern, indem Sie
setCacheEnabled
desRenderOptionsSpec
-Objekts aufrufen undtrue
übergeben.
- Erstellen Sie ein Objekt
-
Generieren Sie ein PDF-Dokument.
Generieren Sie ein PDF-Dokument, das auf mehreren Formularentwürfen basiert, indem Sie die
generatePDFOutput
-Methode desOutputClient
-Objekts aufrufen und die folgenden Werte übergeben:- Ein
TransformationFormat
-Auflistungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein Zeichenfolgenwert, der den Namen des Standardformularentwurfs angibt. Das heißt, der Formularentwurf, der verwendet wird, wenn ein Textmuster nicht gefunden wird.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich die Formularentwürfe befinden.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Rendering-Laufzeitoptionen enthält. - Das
com.adobe.idp.Document
-Objekt, das die Formulardaten enthält, die vom Ausgabe-Service nach den definierten Textmustern durchsucht werden.
Die
generatePDFOutput
-Methode gibt einOutputResult
-Objekt zurück, das das Ergebnis der Authentifizierung enthält. - Ein
-
Rufen Sie die Ergebnisse des Vorgangs ab.
- Erstellen Sie ein
com.adobe.idp.Document
-Objekt, das den Status dergeneratePDFOutput
-Methode darstellt, indem Sie diegetStatusDoc
-Methode desOutputResult
-Objekts aufrufen. - Erstellen Sie ein
java.io.File
-Objekt, das die Ergebnisse des Vorgangs enthält. Stellen Sie sicher, dass die Dateierweiterung .xml lautet. - Rufen Sie die
copyToFile
-Methode descom.adobe.idp.Document
-Objekts auf, um den Inhalt descom.adobe.idp.Document
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dascom.adobe.idp.Document
-Objekt verwenden, das von dergetStatusDoc
-Methode zurückgegeben wurde).
- Erstellen Sie ein
Siehe auch
Schnellstart (EJB-Modus): Erstellen von Suchregeln mithilfe der Java-API
Schnellstart (SOAP-Modus): Erstellen von Suchregeln mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Erstellen von Suchregeln mithilfe der Web-Service-API create-search-rules-using-the-web-service-api
Erstellen Sie Suchregeln mithilfe der Ausgabe-API (Web-Service):
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird. -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Referenzieren Sie eine XML-Datenquelle.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt wird zum Speichern von Daten verwendet, die in das PDF-Dokument integriert werden sollen. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, in dem der Dateispeicherort des zu verschlüsselnden PDF-Dokuments und der Modus enthalten sind, in dem die Datei geöffnet werden soll. - Erstellen Sie ein Byte-Array, in dem der Inhalt des
System.IO.FileStream
-Objekts gespeichert wird. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Datenstromdaten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und ihr das Byte-Array, die Startposition und die zu lesende Datenstromlänge übergeben. - Füllen Sie das
BLOB
-Objekt mit den Inhalten des Byte-Arrays, indem Sie diese demMTOM
-Feld des Objekts zuweisen.
- Erstellen Sie ein Objekt
-
Definieren Sie Suchregeln.
- Erstellen Sie ein Objekt
Rule
, indem Sie den Konstruktor verwenden. - Definieren Sie ein Textmuster, indem Sie dem
pattern
-Datenelement desRule
-Objekts einen Zeichenfolgenwert zuweisen, der ein Textmuster festlegt. - Definieren Sie das dazugehörige Formular-Design, indem Sie dem
form
-Datenelement desRule
-Objekts einen Zeichenfolgenwert zuweisen, der das Formular-Design bestimmt.
note note NOTE Wiederholen Sie für jedes Textmuster, das Sie definieren möchten, die vorherigen drei Teilschritte. - Erstellen Sie ein
MyArrayOf_xsd_anyType
-Objekt zum Abspeichern der Regeln. - Weisen Sie jedes
Rule
-Objekt einem Element desMyArrayOf_xsd_anyType
-Arrays zu. Rufen Sie dieAdd
-Methode desMyArrayOf_xsd_anyType
-Objekts für jedesRule
-Objekt auf.
- Erstellen Sie ein Objekt
-
Festlegen von PDF-Laufzeitoptionen
- Erstellen Sie ein Objekt
PDFOutputOptionsSpec
, indem Sie den Konstruktor verwenden. - Definieren Sie die Option „URI“ der Datei, indem Sie dem
fileURI
-Datenelement desPDFOutputOptionsSpec
-Objekts einen Zeichenfolgenwert zuweisen, der den Speicherort der vom Ausgabe-Service generierten PDF-Datei angibt. Die Datei-URI-Option ist relativ zum J2EE-Anwendungsserver, der als Host für AEM Forms dient, nicht zum Clientcomputer. - Definieren Sie die Option „Kopien“, indem Sie dem
copies
-Datenelement desPDFOutputOptionsSpec
-Objekts einen ganzzahligen Wert zuweisen, der die Anzahl der vom Ausgabe-Service zu generierenden Kopien angibt. - Aktivieren Sie die von Ihnen definierten Regeln, indem Sie dem
rules
-Datenelement desPDFOutputOptionsSpec
-Objekts dasMyArrayOf_xsd_anyType
-Objekt zuweisen, das die Regeln enthält. - Legen Sie die Anzahl der Bytes fest, in denen nach den definierten Textmustern gescannt werden soll, indem Sie der
lookAhead
-Datenmethode desPDFOutputOptionsSpec
-Objekts einen ganzzahligen Wert zuweisen, der die Anzahl der zu scannenden Bytes bestimmt.
- Erstellen Sie ein Objekt
-
Einstellen der Laufzeitoptionen für das Rendern
- Erstellen Sie ein Objekt
RenderOptionsSpec
, indem Sie den Konstruktor verwenden. - Aktivieren Sie das Zwischenspeichern des Formular-Designs, um die Leistung des Ausgabe-Services zu verbessern, in dem Sie dem
cacheEnabled
-Datenelement desRenderOptionsSpec
-Objekts den Werttrue
zuweisen.
note note NOTE Falls das Eingabedokument ein Acrobat-Formular ist, können Sie die Version des PDF-Dokuments nicht anhand des pdfVersion
-Datenelements desRenderOptionsSpec
-Objekts festlegen. Für das PDF-Ausgabedokument wird dieselbe PDF-Version des Acrobat-Formulars verwendet. Ferner können Sie auch nicht die Option „PDF-Datei mit Tags“ anhand dertaggedPDF
-Methode desRenderOptionsSpec
-Objekt aktivieren, wenn das Eingabedokument ein Acrobat-Formular ist.note note NOTE Sie können die Option „Linearisiertes PDF“ nicht anhand des linearizedPDF
-Datenelements desRenderOptionsSpec
-Objekts aktivieren, wenn das Eingabe-PDF-Dokument zertifiziert oder digital signiert ist. Weitere Informationen finden Sie unter Digitales Signieren von PDF-Dokumenten. - Erstellen Sie ein Objekt
-
Ein PDF-Dokument generieren
Erstellen Sie ein PDF-Dokument, indem Sie die
generatePDFOutput
-Methode desOutputServiceService
-Objekts aufrufen und die folgenden Werte übergeben:- Einen
TransformationFormat
-Aufzählungswert. Um ein PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein string-Wert, der den Namen des Formularentwurfs angibt.
- Ein Zeichenfolgenwert, der den Inhaltsstamm angibt, in dem sich der Formularentwurf befindet.
- Ein
PDFOutputOptionsSpec
-Objekt, das PDF-Laufzeitoptionen enthält. - Ein
RenderOptionsSpec
-Objekt, das Laufzeitoptionen zum Rendern enthält. - Das
BLOB
-Objekt, das die XML-Datenquelle mit den Daten enthält, die mit dem Formularentwurf zusammengeführt werden sollen. - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit generierten Metadaten, die das Dokument beschreiben. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein
BLOB
-Objekt, das von dergeneratePDFOutput
-Methode gefüllt wird. DiegeneratePDFOutput
-Methode füllt dieses Objekt mit Ergebnisdaten. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich). - Ein
OutputResult
-Objekt, das die Ergebnisse des Vorgangs enthält. (Dieser Parameterwert ist nur für den Webservice-Aufruf erforderlich).
note note NOTE Beim Generieren eines PDF-Dokuments durch Aufrufen der generatePDFOutput
-Methode sollten Sie beachten, dass Sie keine Daten in ein XFA-PDF-Formular aufnehmen können, falls dieses signiert/zertifiziert wurde oder Verwendungsrechte enthält. Weitere Informationen zu Verwendungsrechten finden Sie unter Verwendungsrechte für PDF-Dokumente aktivieren. - Einen
-
Ergebnisse des Vorgangs abrufen
- Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Speicherort einer XML-Datei mit Ergebnisdaten darstellt. Stellen Sie sicher, dass die Dateierweiterung XML ist. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das mit den Ergebnisdaten von dergeneratePDFOutput
-Methode desOutputServiceService
-Objekts (der achte Parameter) gefüllt wurde. Füllen Sie das Byte-Array, indem Sie den Wert desMTOM
-Datenmembers desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in die XML-Datei, indem Sie die
Write
-Methode desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef
Reduzieren von PDF-Dokumenten flattening-pdf-documents
Sie können den Ausgabe-Service verwenden, um ein interaktives PDF-Dokument in ein nicht interaktives PDF-Dokument umzuwandeln. Interaktive PDF-Dokumente ermöglichen es dem Benutzer, Daten in die PDF-Dokumentfelder einzugeben bzw. darin zu ändern. Der Prozess der Umwandlung eines interaktiven PDF-Dokuments in ein nicht interaktives PDF-Dokument wird als Reduzieren bezeichnet. Wenn ein PDF-Dokument reduziert wird, kann ein Benutzer die in den Feldern des Dokuments enthaltenen Daten nicht ändern. Dies kann ein Grund dafür sein, PDF-Dokumente zu reduzieren.
Sie können die folgenden Arten von PDF-Dokumenten reduzieren:
- Interaktive XFA-PDF-Dokumente
- Acrobat Forms
Der Versuch, ein PDF-Dokument, bei dem es sich um ein nicht interaktives PDF-Dokument handelt, zu reduzieren, verursacht eine Ausnahme.
Zusammenfassung der Schritte summary_of_steps-9
Führen Sie die folgenden Schritte aus, um ein interaktives PDF-Dokument in ein nicht interaktives PDF-Dokument zu reduzieren:
- Schließen Sie Projektdateien ein.
- Erstellen Sie ein Output-Client-Objekt.
- Rufen Sie ein interaktives PDF-Dokument ab.
- Wandeln Sie das PDF-Dokument um.
- Speichern Sie das nicht interaktive PDF-Dokument als PDF-Datei.
Einschließen von Projektdateien
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Web-Services verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-output-client.jar
- adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
- jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss bereitgestellt wird)
Wenn AEM Forms auf einem unterstützten J2EE-Programm-Server bereitgestellt wird, bei dem es sich nicht um JBoss handelt, müssen Sie die Dateien „adobe-utilities.jar“ und „jbossall-client.jar“ durch JAR-Dateien ersetzen, die spezifisch für den J2EE-Programm-Server sind, auf dem AEM Forms bereitgestellt wird. Informationen zum Speicherort aller AEM Forms-JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.
Erstellen eines Ausgabe-Client-Objekts
Bevor Sie einen Output-Service-Vorgang programmgesteuert ausführen können, müssen Sie ein Client-Objekt für den Output-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein OutputClient
-Objekt. Wenn Sie die Ausgabe-Web-Service-API verwenden, erstellen Sie ein OutputServiceService
-Objekt.
Abrufen eines interaktiven PDF-Dokuments
Rufen Sie ein interaktives PDF-Dokument ab, das Sie in ein nicht interaktives PDF-Dokument umwandeln möchten. Der Versuch, ein nicht interaktives PDF-Dokument umzuwandeln, verursacht eine Ausnahme.
Umwandeln des PDF-Dokuments
Nachdem Sie ein interaktives PDF-Dokument abgerufen haben, können Sie es in ein nicht interaktives PDF-Dokument umwandeln. Der Ausgabe-Service gibt ein nicht interaktives PDF-Dokument zurück.
Speichern des nicht interaktiven PDF-Dokuments als PDF-Datei
Sie können das nicht interaktive PDF-Dokument als PDF-Datei speichern.
Siehe auch
Reduzieren eines PDF-Dokuments mithilfe der Java-API
Reduzieren eines PDF-Dokuments mithilfe der Web-Service-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Schnellstarts zur API für Output Service
Reduzieren eines PDF-Dokuments mithilfe der Java-API flatten-a-pdf-document-using-the-java-api
Reduzieren Sie ein interaktives PDF-Dokument mithilfe der Ausgabe-API (Java) auf ein nicht interaktives PDF-Dokument:
-
Schließen Sie Projektdateien ein.
Fügen Sie Client-JAR-Dateien wie „adobe-output-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.
-
Erstellen Sie ein Output-Client-Objekt.
- Erstellen Sie ein
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält. - Erstellen Sie ein
OutputClient
-Objekt, indem Sie seinen Konstruktor verwenden und dasServiceClientFactory
-Objekt übergeben.
- Erstellen Sie ein
-
Rufen Sie ein interaktives PDF-Dokument ab.
- Erstellen Sie ein
java.io.FileInputStream
-Objekt, das das umzuwandelnde interaktive PDF-Dokument darstellt, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort der interaktiven PDF-Datei angibt. - Erstellen Sie ein
com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und dasjava.io.FileInputStream
-Objekt übergeben.
- Erstellen Sie ein
-
Wandeln Sie das PDF-Dokument um.
Wandeln Sie das interaktive PDF-Dokument in ein nicht interaktives PDF-Dokument um, indem Sie die
transformPDF
-Methode desOutputServiceService
-Objekts aufrufen und die folgenden Werte übergeben:- Das
com.adobe.idp.Document
-Objekt, das das interaktive PDF-Dokument enthält. - Ein
TransformationFormat
-Aufzählungswert. Um ein nicht interaktives PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein
PDFARevisionNumber
-Aufzählungswert, der die Revisionsnummer angibt. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Sienull
angeben. - Ein Zeichenfolgenwert, der die Änderungsnummer und das Jahr darstellt, getrennt durch einen Doppelpunkt. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Sie
null
angeben. - Ein
PDFAConformance
-Aufzählungswert, der die PDF/A-Konformitätsstufe darstellt. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Sienull
angeben.
Die
transformPDF
-Methode gibt eincom.adobe.idp.Document
-Objekt zurück, das ein nicht interaktives PDF-Dokument enthält. - Das
-
Speichern Sie das nicht interaktive PDF-Dokument als PDF-Datei.
- Erstellen Sie ein
java.io.File
-Objekt und stellen Sie sicher, dass die Dateierweiterung .pdf lautet. - Rufen Sie die
copyToFile
-Methode desDocument
-Objekts auf, um den Inhalt desDocument
-Objekts in die Datei zu kopieren (stellen Sie sicher, dass Sie dasDocument
-Objekt verwenden, das von dertransformPDF
-Methode zurückgegeben wurde).
- Erstellen Sie ein
Siehe auch
Schnellstart (EJB-Modus): Umwandeln eines PDF-Dokuments mithilfe der Java-API
Schnellstart (SOAP-Modus): Umwandeln eines PDF-Dokuments mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Reduzieren eines PDF-Dokuments mithilfe der Web-Service-API flatten-a-pdf-document-using-the-web-service-api
Reduzieren Sie ein interaktives PDF-Dokument mithilfe der Ausgabe-API (Web-Service) auf ein nicht interaktives PDF-Dokument:
-
Schließen Sie Projektdateien ein.
Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie die folgende WSDL-Definition verwenden:
http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1
.note note NOTE Ersetzen Sie localhost
durch die IP-Adresse des Servers, auf dem AEM Forms gehostet wird. -
Erstellen Sie ein Output-Client-Objekt.
-
Erstellen Sie mithilfe des Standardkonstruktors ein
OutputServiceClient
-Objekt. -
Erstellen Sie mithilfe des
System.ServiceModel.EndpointAddress
-Konstruktors einOutputServiceClient.Endpoint.Address
-Objekt. Übergeben Sie einen Zeichenfolgenwert, der die WSDL für den AEM Forms-Service angibt (z. B.http://localhost:8080/soap/services/OutputService?blob=mtom
). Sie müssen daslc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie eine Servicereferenz erstellen. Geben Sie jedoch?blob=mtom
an, um MTOM zu verwenden. -
Erstellen Sie ein
System.ServiceModel.BasicHttpBinding
-Objekt, indem Sie den Wert desOutputServiceClient.Endpoint.Binding
-Felds abrufen. Wandeln Sie den Rückgabewert inBasicHttpBinding
um. -
Legen Sie das
MessageEncoding
-Feld desSystem.ServiceModel.BasicHttpBinding
-Objekts aufWSMessageEncoding.Mtom
fest. Dieser Wert stellt sicher, dass MTOM verwendet wird. -
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
- Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu. - Weisen Sie dem Feld
OutputServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten WertHttpClientCredentialType.Basic
zu. - Weisen Sie dem Feld
BasicHttpBindingSecurity.Security.Mode
den konstanten WertBasicHttpSecurityMode.TransportCredentialOnly
zu.
- Weisen Sie dem Feld
-
-
Rufen Sie ein interaktives PDF-Dokument ab.
- Erstellen Sie ein Objekt
BLOB
, indem Sie den Konstruktor verwenden. DasBLOB
-Objekt wird verwendet, um das interaktive PDF-Dokument zu speichern. - Erstellen Sie ein
System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen und einen Zeichenfolgenwert übergeben, der den Dateispeicherort des interaktiven PDF-Dokuments darstellt. - Erstellen Sie ein Byte-Array, das den Inhalt des
System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie dieLength
-Eigenschaft desSystem.IO.FileStream
-Objekts abrufen. - Füllen Sie das Byte-Array mit Stream-Daten, indem Sie die
Read
-Methode desSystem.IO.FileStream
-Objekts aufrufen und das Byte-Array, die Startposition und die zu lesende Stream-Länge übergeben. - Füllen Sie das
BLOB
-Objekt, indem Sie seinerMTOM
-Eigenschaft den Inhalt des Byte-Arrays zuweisen.
- Erstellen Sie ein Objekt
-
Wandeln Sie das PDF-Dokument um.
Wandeln Sie das interaktive PDF-Dokument in ein nicht interaktives PDF-Dokument um, indem Sie die
transformPDF
-Methode desOutputClient
-Objekts aufrufen und die folgenden Werte übergeben:- Ein
BLOB
-Objekt, das das interaktive PDF-Dokument enthält. - Ein
TransformationFormat
-Aufzählungswert. Um ein nicht interaktives PDF-Dokument zu generieren, geben SieTransformationFormat.PDF
an. - Ein
PDFARevisionNumber
-Aufzählungswert, der die Revisionsnummer angibt. - Ein boolescher Wert, der angibt, ob der
PDFARevisionNumber
-Aufzählungswert verwendet wird. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Siefalse
angeben. - Ein Zeichenfolgenwert, der die Änderungsnummer und das Jahr darstellt, getrennt durch einen Doppelpunkt. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Sie
null
angeben. - Ein
PDFAConformance
-Aufzählungswert, der die PDF/A-Konformitätsstufe darstellt. - Boolescher Wert, der angibt, ob der
PDFAConformance
-Aufzählungswert verwendet wird. Da dieser Parameter für ein PDF/A-Dokument vorgesehen ist, können Siefalse
angeben.
Die
transformPDF
-Methode gibt einBLOB
-Objekt zurück, das ein nicht interaktives PDF-Dokument enthält. - Ein
-
Speichern Sie das nicht interaktive PDF-Dokument als PDF-Datei.
- Erstellen Sie ein
System.IO.FileStream
-Objekt durch Aufrufen von dessen Konstruktor und Übergeben eines Zeichenfolgenwerts, der den Dateispeicherort des nicht interaktiven PDF-Dokuments darstellt. - Erstellen Sie ein Byte-Array, das den Dateninhalt des
BLOB
-Objekts speichert, das von dertransformPDF
-Methode zurückgegeben wurde. Füllen Sie das Byte-Array, indem Sie den Wert desMTOM
-Datenelements desBLOB
-Objekts abrufen. - Erstellen Sie ein
System.IO.BinaryWriter
-Objekt, indem Sie seinen Konstruktor aufrufen und dasSystem.IO.FileStream
-Objekt übergeben. - Schreiben Sie den Inhalt des Byte-Arrays in eine PDF-Datei, indem Sie die Methode
Write
desSystem.IO.BinaryWriter
-Objekts aufrufen und das Byte-Array übergeben.
- Erstellen Sie ein
Siehe auch
AEM Forms mithilfe von MTOM aufrufen
Aufrufen von AEM Forms mithilfe von SwaRef