Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.
Mithilfe der Bates-Nummerierung können Sie PDF-Dokumente zusammenstellen, die eindeutige Seitenkennungen enthalten. Bates-Nummerierung ist eine Methode zur Anwendung von eindeutigen Identifikatoren auf einen Stapel verwandter Dokumente. Jede Seite im Dokument (oder in einer Gruppe von Dokumenten) erhält eine Bates-Nummer, mit der die Seite eindeutig identifiziert wird. Beispielsweise können Fertigungsdokumente, die Materialaufstellungsinformationen enthalten und mit der Herstellung einer Baugruppe verbunden sind, einen Bezeichner enthalten. Eine Bates-Nummer enthält einen sequenziell inkrementierten numerischen Wert sowie ein optionales Präfix und Suffix. Das Präfix + numerisch + Suffix wird als Bates-Muster bezeichnet.
Die folgende Abbildung zeigt ein PDF-Dokument, das eine eindeutige Kennung in der Kopfzeile des Dokuments enthält.
Für diese Diskussion wird die eindeutige Seitenkennung in der Kopfzeile eines Dokuments platziert. Angenommen, das folgende DDX-Dokument wird verwendet.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="out.pdf">
<Header>
<Center>
<StyledText>
<p font-size="20pt"><BatesNumber/></p>
</StyledText>
</Center>
</Header>
<PDF source="map.pdf" />
<PDF source="directions.pdf" />
</PDF>
</DDX>
Dieses DDX-Dokument führt zwei PDF-Dokumente mit dem Namen map.pdf und instructions.pdf in einem einzigen PDF-Dokument zusammen. Das PDF-Zieldokument enthält eine Kopfzeile, die aus einer eindeutigen Seitenkennung besteht. Das Dokument in der obigen Abbildung zeigt beispielsweise 000016.
Bevor Sie diesen Abschnitt lesen, sollten Sie mit dem Zusammenstellen von PDF-Dokumenten mithilfe des Assembler-Dienstes vertraut sein. In diesem Abschnitt werden die Konzepte nicht erläutert, wie z. B. das Erstellen eines Sammlungsobjekts, das Eingabedokumente enthält, oder das Extrahieren der Ergebnisse aus dem zurückgegebenen Sammlungsobjekt. (Siehe Programmgesteuertes Zusammenstellen von PDF-Dokumenten.)
Weitere Informationen zum Assembler-Service finden Sie in der Service-Referenz für AEM Forms.
Weitere Informationen zu einem DDX-Dokument finden Sie in der Referenz für Assembler-Service und DDX.
Um ein PDF-Dokument mit einer eindeutigen Seitenkennung (Bates-Nummerierung) zusammenzustellen, führen Sie die folgenden Schritte aus:
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 Webdienste verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.
Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:
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 Einbeziehen von AEM Forms-Java-Bibliotheksdateien.
Erstellen eines PDF-Assembler-Clients
Bevor Sie einen Assembler-Vorgang programmgesteuert ausführen können, müssen Sie einen Assembler-Dienst-Client erstellen.
Referenzieren eines bestehenden DDX-Dokuments
Zum Zusammenführen eines PDF-Dokuments muss auf ein DDX-Dokument verwiesen werden. Betrachten Sie beispielsweise das DDX-Dokument, das in diesem Abschnitt eingeführt wurde. Um ein PDF-Dokument zusammenzustellen, das eindeutige Seitenkennungen enthält, muss das DDX-Dokument das Element BatesNumber
enthalten.
Referenzieren von PDF-Eingabedokumenten
PDF-Eingabedokumente müssen referenziert werden, um ein PDF-Dokument zusammenzustellen. Beispielsweise müssen die Dokumente „map.pdf“ und „directions.pdf“ referenziert werden, um diese PDF-Dokumente in einem einzigen PDF-Dokument zusammenzustellen.
Festlegen des anfänglichen Bates-Zahlenwerts
Sie können den Anfangswert der Bates-Nummer so festlegen, dass er Ihre Geschäftsanforderungen erfüllt. Angenommen, der Ausgangswert muss auf 000100 gesetzt werden. Wenn Sie den Anfangswert nicht festlegen, lautet der Wert der ersten Seite 000000.
Zusammenstellen der PDF-Eingabedokumente
Nachdem Sie den Assembler-Service-Client erstellt haben, das DDX-Dokument referenziert haben, das Informationen zum Element BatesNumber
enthält, ein PDF-Eingabedokument referenziert haben und Laufzeitoptionen festgelegt haben, können Sie den Vorgang invokeDDX
aufrufen, der dazu führt, dass der Assembler-Service ein PDF-Dokument zusammenstellt, welches eindeutige Seitenkennungen enthält.
Extrahieren der Ergebnisse
Der Assembler-Service gibt ein Sammlungsobjekt zurück, das die Auftragsergebnisse enthält. Sie können das PDF-Zieldokument und alle ausgelösten Ausnahmen extrahieren. In diesem Fall befindet sich ein verschlüsseltes PDF-Dokument im Sammlungsobjekt.
Ein Sammlungsobjekt wird zurückgegeben, wenn Sie den Vorgang invokeDDX
aufrufen. Dieser Vorgang wird verwendet, wenn zwei oder mehr PDF-Eingabedokumente an den Assembler-Service übergeben werden. Wenn Sie jedoch nur ein PDF-Eingabedokument an den Assembler-Service übergeben, sollten Sie den Vorgang invokeOneDocument
aufrufen. Weitere Informationen zur Verwendung dieses Vorgangs finden Sie unter Zusammenstellen verschlüsselter PDF-Dokumente.
Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Programmatisches Zusammenstellen von PDF-Dokumenten
So stellen Sie mithilfe der Assembler Service-API (Java) ein PDF-Dokument zusammen, das eindeutige Seitenkennungen (Bates-Nummerierung) verwendet:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie adobe-assembler-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie einen PDF Assembler-Client.
ServiceClientFactory
-Objekt, das Verbindungseigenschaften enthält.AssemblerServiceClient
-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Referenzieren Sie ein vorhandenes DDX-Dokument.
java.io.FileInputStream
-Objekt, das das DDX-Dokument darstellt, indem Sie seinen Konstruktor verwenden und einen Zeichenfolgenwert übergeben, der den Speicherort der DDX-Datei angibt.com.adobe.idp.Document
-Objekt, indem Sie seinen Konstruktor verwenden und das java.io.FileInputStream
-Objekt übergeben.Referenzieren Sie die PDF-Eingabedokumente.
Erstellen Sie mithilfe eines HashMap
-Konstruktors ein java.util.Map
-Objekt zum Speichern von Eingabe-PDF-Dokumenten.
Erstellen Sie für jedes PDF-Eingabedokument ein java.io.FileInputStream
-Objekt, indem Sie seinen Konstruktor verwenden und den Speicherort des PDF-Eingabedokuments übergeben. Übergeben Sie in diesem Fall den Speicherort eines ungesicherten PDF-Dokuments.
Erstellen Sie für jedes PDF-Eingabedokument ein com.adobe.idp.Document
-Objekt und übergeben Sie das java.io.FileInputStream
-Objekt, das das PDF-Dokument enthält.
Fügen Sie dem java.util.Map
-Objekt durch Aufrufen seiner put
-Methode und Übergeben der folgenden Argumente einen Eintrag hinzu:
com.adobe.idp.Document
-Objekt, das das ungesicherte PDF-Dokument enthält.Legen Sie den Anfangswert der Bates-Nummer fest.
AssemblerOptionSpec
-Objekt, das Laufzeitoptionen mithilfe seines Konstruktors speichert.AssemblerOptionSpec
-Objekt setFirstBatesNumber
und übergeben einen numerischen Wert, der den Anfangswert angibt.Stellen Sie die PDF-Eingabedokumente zusammen.
Rufen Sie die AssemblerServiceClient
-Objekt invokeDDX
-Methode verwenden und die folgenden erforderlichen Werte übergeben:
com.adobe.idp.Document
-Objekt, das das DDX-Dokument darstellt.java.util.Map
-Objekt, das die ungesicherte PDF-Eingabedatei enthält.com.adobe.livecycle.assembler.client.AssemblerOptionSpec
-Objekt, das die Laufzeitoptionen angibt, einschließlich der Standardschrift und der Vorgangslogebene.Die invokeDDX
-Methode gibt ein com.adobe.livecycle.assembler.client.AssemblerResult
-Objekt zurück, das ein kennwortverschlüsseltes PDF-Dokument enthält.
Extrahieren Sie die Ergebnisse.
Führen Sie die folgenden Schritte aus, um das neu erstellte PDF-Dokument abzurufen:
AssemblerResult
-Objekt getDocuments
-Methode. Diese Aktion gibt ein java.util.Map
-Objekt zurück.java.util.Map
-Objekt, bis Sie das com.adobe.idp.Document
-Objekt finden.com.adobe.idp.Document
-Objekt copyToFile
-Methode, um das PDF-Dokument zu extrahieren.Siehe auch
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Stellen Sie mithilfe der Assembler-Service-API (Web-Service) ein PDF-Dokument zusammen, das eindeutige Seitenkennungen (Bates-Nummerierung) verwendet:
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/AssemblerService?WSDL&lc_version=9.0.1
.
Ersetzen Sie localhost
mit der IP-Adresse des Servers, auf dem AEM Forms gehostet wird.
Erstellen Sie einen PDF Assembler-Client.
Erstellen Sie ein AssemblerServiceClient
-Objekt, indem Sie seinen standardmäßigen Konstruktor verwenden.
Erstellen Sie ein AssemblerServiceClient.Endpoint.Address
-Objekt mithilfe des System.ServiceModel.EndpointAddress
-Konstruktors. Übergeben Sie einen Zeichenfolgenwert mit der WSDL an den AEM Forms-Service (z. B. http://localhost:8080/soap/services/AssemblerService?blob=mtom
). Sie müssen das lc_version
-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie einen Service-Verweis erstellen.
Erstellen Sie ein System.ServiceModel.BasicHttpBinding
-Objekr, indem Sie den Wert des Felds AssemblerServiceClient.Endpoint.Binding
abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding
um.
Legen Sie die System.ServiceModel.BasicHttpBinding
-Objekt MessageEncoding
-Feld zu WSMessageEncoding.Mtom
. Dieser Wert stellt sicher, dass MTOM verwendet wird.
Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:
AssemblerServiceClient.ClientCredentials.UserName.UserName
den AEM Forms-Benutzernamen zu.AssemblerServiceClient.ClientCredentials.UserName.Password
den entsprechenden Passwortwert zu.BasicHttpBindingSecurity.Transport.ClientCredentialType
den konstanten Wert HttpClientCredentialType.Basic
zu.BasicHttpBindingSecurity.Security.Mode
den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly
zu.Referenzieren Sie ein vorhandenes DDX-Dokument.
BLOB
, indem Sie den Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern des DDX-Dokuments verwendet.System.IO.FileStream
, indem Sie den Konstruktor aufrufen und einen String-Wert übergeben, der den Dateispeicherort des DDX-Dokuments und den Modus, in dem die Datei geöffnet werden soll, repräsentiert.System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Objekt Length
-Eigenschaft.System.IO.FileStream
-Objekt Read
-Methode. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Datenstromlänge.BLOB
-Objekt, indem Sie dessen MTOM
-Feld den Inhalt des Byte-Arrays zuweisen.Referenzieren Sie die PDF-Eingabedokumente.
BLOB
-Objekt, indem Sie seinen Konstruktor verwenden. Das BLOB
-Objekt wird zum Speichern des PDF-Eingabedokuments verwendet.System.IO.FileStream
-Objekt, indem Sie seinen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Eingabedokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.System.IO.FileStream
-Objekts speichert. Sie können die Größe des Byte-Arrays bestimmen, indem Sie die System.IO.FileStream
-Objekt Length
-Eigenschaft.System.IO.FileStream
-Objekt Read
-Methode. Übergeben Sie das Byte-Array, die Startposition und die zu lesende Datenstromlänge.BLOB
-Objekt, indem Sie seiner MTOM
-Eigenschaft den Inhalt des Byte-Arrays zuweisen.MyMapOf_xsd_string_To_xsd_anyType
-Objekt. Dieses Sammlungsobjekt wird zum Speichern der PDF-Eingabedokumente verwendet.MyMapOf_xsd_string_To_xsd_anyType_Item
-Objekt. Wenn beispielsweise zwei PDF-Eingabedokumente verwendet werden, erstellen Sie zwei MyMapOf_xsd_string_To_xsd_anyType_Item
-Objekte.key
des MyMapOf_xsd_string_To_xsd_anyType_Item
-Objekts einen Zeichenfolgenwert zu, der den Schlüsselnamen darstellt. Dieser Wert muss mit dem Wert des im DDX-Dokument angegebenen PDF-Quellelements übereinstimmen. (Führen Sie diese Aufgabe für jedes PDF-Eingabedokument aus.)BLOB
-Objekt, das das PDF-Dokument speichert, dem Feld value
des MyMapOf_xsd_string_To_xsd_anyType_Item
-Objekts zu. (Führen Sie diese Aufgabe für jedes PDF-Eingabedokument aus.)MyMapOf_xsd_string_To_xsd_anyType_Item
-Objekt zum MyMapOf_xsd_string_To_xsd_anyType
-Objekt hinzu. Rufen Sie die Methode Add
des MyMapOf_xsd_string_To_xsd_anyType
-Objekts auf, und übergeben Sie das MyMapOf_xsd_string_To_xsd_anyType
-Objekt. (Führen Sie diese Aufgabe für jedes PDF-Eingabedokument aus.)Legen Sie den Anfangswert der Bates-Nummer fest.
AssemblerOptionSpec
-Objekt, das Laufzeitoptionen speichert, indem Sie seinen Konstruktor verwenden.firstBatesNumber
, das zum AssemblerOptionSpec
-Objekt gehört, einen numerischen Wert zuweisen.Stellen Sie die PDF-Eingabedokumente zusammen.
Rufen Sie die AssemblerServiceClient
-Objekt invoke
-Methode verwenden und die folgenden Werte übergeben:
BLOB
-Objekt, das das DDX-Dokument darstellt.MyMapOf_xsd_string_To_xsd_anyType
-Objekt, das die PDF-Eingabedokumente enthält. Seine Schlüssel müssen mit den Namen der PDF-Quelldateien übereinstimmen, und seine Werte müssen die BLOB
-Objekte sein, die diesen Dateien entsprechen.AssemblerOptionSpec
-Objekt, das Laufzeitoptionen angibt.Die Methode invoke
gibt ein AssemblerResult
-Objekt zurück, das die Ergebnisse des Auftrags und eventuell aufgetretene Ausnahmen enthält.
Extrahieren Sie die Ergebnisse.
Führen Sie die folgenden Schritte aus, um das neu erstellte PDF-Dokument abzurufen:
AssemblerResult
-Objekt documents
-Feld, das ein Map
-Objekt, das die PDF-Ergebnisdokumente enthält.Map
-Objekt, bis Sie den Schlüssel finden, der dem Namen des Ergebnisdokuments entspricht. Dann das Array-Element value
zu BLOB
.BLOB
-Objekt MTOM
-Eigenschaft. Dadurch wird ein Array von Bytes zurückgegeben, die Sie in eine PDF-Datei schreiben können.Siehe auch