Documentuitvoerstromen maken

Een PDF-document maken met de Java API

Een PDF-document maken met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron.
- Maak een java.io.FileInputStream-object dat de XML-gegevensbron vertegenwoordigt die wordt gebruikt om het PDF-document te vullen met de constructor ervan en geef een tekenreekswaarde door die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object met de constructor ervan. Geef het object java.io.FileInputStream door.
Stel PDF-runtime-opties in.
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie File URI in door de methode setFileURI van het object PDFOutputOptionsSpec aan te roepen. Geef een tekenreekswaarde door die de locatie aangeeft van het PDF-bestand dat door de uitvoerservice wordt gegenereerd. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de uitvoerservice te verbeteren door het RenderOptionsSpec-object op te roepen en true door te geven.setCacheEnabled
OPMERKING

U kunt de versie van het PDF-document niet instellen met de methode RenderOptionsSpec van het object als het invoerdocument een Acrobat-formulier (een formulier dat in Acrobat is gemaakt) of een XFA-document is dat is ondertekend of gecertificeerd. setPdfVersion Het PDF-uitvoerdocument behoudt de oorspronkelijke PDF-versie. Evenzo kunt u de optie gelabelde Adobe PDF niet instellen door de methode RenderOptionsSpec van het object setTaggedPDF* aan te roepen als het invoerdocument een Acrobat-formulier of een ondertekend of gecertificeerd XFA-document is. *

OPMERKING

U kunt de optie Gelineariseerde PDF niet instellen met de methode setLinearizedPDF van het object RenderOptionsSpec als het invoer-PDF-document is gecertificeerd of digitaal is ondertekend. (Zie PDF-documenten digitaal ondertekenen .)
Genereer een PDF-document.

Maak een PDF-document door de methode generatePDFOutput van het object OutputClient aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
De methode generatePDFOutput retourneert een OutputResult-object dat de resultaten van de bewerking bevat.

OPMERKING

Wanneer u een PDF-document genereert door de methode generatePDFOutput aan te roepen, moet u er rekening mee houden dat u geen gegevens kunt samenvoegen met een ondertekend of gecertificeerd XFA PDF-formulier. (Zie Documenten digitaal ondertekenen en certificeren .)

OPMERKING

De methode OutputResult van het object getRecordLevelMetaDataList retourneert null.

OPMERKING

U kunt ook een PDF-document maken door de methode generatePDFOutput2 van het object OutputClient aan te roepen. (Zie Documenten in Content Services (afgekeurd) doorgeven aan de Output Service .)
Haal de resultaten van de bewerking op.
- Haal een com.adobe.idp.Document-object op dat de status van de bewerking generatePDFOutput vertegenwoordigt door de methode getStatusDoc van het object OutputResult aan te roepen. Deze methode retourneert XML-gegevens met de status die aangeven of de bewerking is geslaagd.
- Maak een java.io.File-object dat de resultaten van de bewerking bevat. Controleer of de bestandsnaamextensie .xml is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getStatusDoc is geretourneerd).
Hoewel de service Uitvoer het PDF-document schrijft naar de locatie die is opgegeven door het argument dat wordt doorgegeven aan de methode setFileURI van het object PDFOutputOptionsSpec, kunt u het PDF/A-document programmatisch ophalen door de methode getGeneratedDoc van het object OutputResult aan te roepen.

Zie ook

Snel starten (EJB-modus): Een PDF-document maken met de Java API

Snel starten (SOAP-modus): Een PDF-document maken met de Java API

Een PDF-document maken met de webservice-API

Een PDF-document maken met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. In het object BLOB worden XML-gegevens opgeslagen die met het PDF-document worden samengevoegd.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het XML-bestand dat formuliergegevens bevat.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.
Opties voor PDF-runtime instellen
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie File URI in door een tekenreekswaarde toe te wijzen die de locatie aangeeft van het PDF-bestand dat de uitvoerservice genereert voor het PDFOutputOptionsSpec-gegevenslid van het fileURI-object. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de Output-service te verbeteren door de waarde true toe te wijzen aan het RenderOptionsSpec-gegevenslid van het cacheEnabled-object.
OPMERKING

U kunt de versie van het PDF-document niet instellen met de methode RenderOptionsSpec van het object als het invoerdocument een Acrobat-formulier (een formulier dat in Acrobat is gemaakt) of een XFA-document is dat is ondertekend of gecertificeerd. setPdfVersion Het PDF-uitvoerdocument behoudt de oorspronkelijke PDF-versie. Evenzo kunt u de optie gelabelde Adobe PDF niet instellen door de methode RenderOptionsSpec van het object setTaggedPDF* aan te roepen als het invoerdocument een Acrobat-formulier of een ondertekend of gecertificeerd XFA-document is.*

OPMERKING

U kunt de optie Gelineariseerde PDF niet instellen met het RenderOptionsSpec-lid van het object als het invoer-PDF-document is gecertificeerd of digitaal is ondertekend. linearizedPDF (Zie PDF-documenten digitaal ondertekenen .)
Genereer een PDF-document.

Maak een PDF-document door de methode OutputServiceService van het object generatePDFOutputaan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. Met de methode generatePDFOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een object BLOB dat is gevuld met de methode generatePDFOutput. De methode generatePDFOutput vult dit object met resultaatgegevens. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een OutputResult-object dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
OPMERKING

Wanneer u een PDF-document genereert door de methode generatePDFOutput aan te roepen, moet u er rekening mee houden dat u geen gegevens kunt samenvoegen met een ondertekend of gecertificeerd XFA PDF-formulier. (Zie Documenten digitaal ondertekenen en certificeren .)

OPMERKING

U kunt ook een PDF-document maken door de methode generatePDFOutput2 van het object OutputClient aan te roepen. (Zie Documenten in Content Services (afgekeurd) doorgeven aan de Output Service .)
Haal de resultaten van de bewerking op.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die een XML-bestandslocatie vertegenwoordigt die resultaatgegevens bevat. Controleer of de bestandsnaamextensie .xml is.
- Maak een bytearray met de gegevensinhoud van het BLOB-object dat met resultaatgegevens is gevuld door de methode generatePDFOutput van het OutputServiceService-object (de achtste parameter). Vul de bytearray met de waarde van BLOB MTOM field van het object.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar het XML-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.
Zie ook

Een PDF/A-document maken met de Java API

OPMERKING

De methode OutputServiceService van het object generateOutput is afgekeurd.

PDF/A-documenten maken

Met de service Uitvoer kunt u een PDF/A-document maken. Omdat PDF/A een archiefindeling is voor langdurige bewaring van de inhoud van het document, worden alle fonts ingesloten en wordt het bestand niet gecomprimeerd. Een PDF/A-document is daarom doorgaans groter dan een standaard PDF-document. Bovendien bevat een PDF/A-document geen audio- en video-inhoud. Net als bij andere uitvoerservicetaken kunt u zowel een formulierontwerp als gegevens opgeven die met een formulierontwerp moeten worden samengevoegd om een PDF/A-document te maken.

De PDF/A-1-specificatie bestaat uit twee conformiteitsniveaus, namelijk a en b. Het grootste verschil tussen beide is de logische structuur (toegankelijkheid) die niet vereist is voor niveau b. PDF/A-1 schrijft voor dat alle lettertypen in het gegenereerde PDF/A-document worden ingesloten, ongeacht het compatibiliteitsniveau.

Hoewel PDF/A de standaard is voor het archiveren van PDF-documenten, is het niet verplicht dat PDF/A wordt gebruikt voor archivering als een standaard PDF-document voldoet aan de behoeften van uw bedrijf. Het doel van de PDF/A-standaard is het maken van een PDF-bestand dat lange tijd kan worden opgeslagen en dat voldoet aan de vereisten voor documentbehoud. Een URL kan bijvoorbeeld niet worden ingesloten in een PDF/A omdat de URL na verloop van tijd ongeldig kan worden.

Uw organisatie moet haar eigen behoeften, de tijdsduur beoordelen u van plan bent om het document te houden, dossiergrootte overwegingen, en uw eigen archiveringsstrategie te bepalen. Met de DocConverter-service kunt u programmatisch bepalen of een PDF-document compatibel is met PDF/A. (Zie Programmaticaal PDF/A-compatibiliteit bepalen.)

Een PDF/A-document moet het font gebruiken dat is opgegeven in het formulierontwerp en fonts kunnen niet worden vervangen. Als een lettertype dat zich in een PDF-document bevindt niet beschikbaar is in het besturingssysteem van de host (OS), treedt daarom een uitzondering op.

Wanneer een PDF/A-document in Acrobat wordt geopend, wordt een bericht weergegeven waarin wordt bevestigd dat het document een PDF/A-document is, zoals in de volgende afbeelding wordt getoond.

cp_cp_pdfamessage

OPMERKING

De AIR-website heeft een sectie met veelgestelde vragen over PDF/A die u kunt openen op https://www.loc.gov/preservation/digital/formats/fdd/fdd000125.shtml.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om een PDF/A-document te maken:

Inclusief projectbestanden.
Maak een Output Client-object.
Verwijzen naar een XML-gegevensbron.
Stel PDF/A-runtime-opties in.
Stel renderingopties in.
Genereer een PDF/A-document.
Haal de resultaten van de bewerking op.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een aangepaste toepassing maakt met behulp van Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Een uitvoerclient-object maken

Verwijzen naar een XML-gegevensbron

Als u gegevens wilt samenvoegen met het formulierontwerp, moet u verwijzen naar een XML-gegevensbron die gegevens bevat. Een XML-element moet bestaan voor elk formulierveld dat u wilt vullen met gegevens. De naam van het XML-element moet overeenkomen met de veldnaam. Een XML-element wordt genegeerd als het niet overeenkomt met een formulierveld of als de naam van het XML-element niet overeenkomt met de veldnaam. Het is niet nodig de volgorde aan te passen waarin de XML-elementen worden weergegeven als alle XML-elementen zijn opgegeven.

Opties voor PDF/A-runtime instellen

U kunt de optie File URI instellen wanneer u een PDF/A-document maakt. De URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms. Dit betekent dat als u C:\Adobe instelt, het bestand naar de map op de server wordt geschreven, niet naar de clientcomputer. De URI geeft de naam en locatie op van het PDF/A-bestand dat de uitvoerservice genereert.

Renderopties tijdens runtime instellen

Bij het maken van PDF/A-documenten kunt u runtime-renderopties instellen. Twee PDF/A-gerelateerde opties die u kunt instellen, zijn de waarden PDFAConformance en PDFARevisionNumber. De waarde PDFAConformance verwijst naar de manier waarop een PDF-document voldoet aan vereisten die opgeven hoe elektronische documenten op lange termijn moeten worden behouden. Geldige waarden voor deze optie zijn A en B. Zie de PDF/A-1 ISO-specificatie met de naam ISO 19005-1 Document management voor informatie over niveau a- en b-conformiteit.

De waarde PDFARevisionNumber verwijst naar het revisienummer van een PDF/A-document. Zie de PDF/A-1 ISO-specificatie met de naam ISO 19005-1 Document management voor informatie over het revisienummer van een PDF/A-document.

OPMERKING

U kunt de optie voor gecodeerde Adobe PDF niet instellen op false wanneer u een PDF/A 1A-document maakt. PDF/A 1A wordt altijd een gecodeerd PDF-document. U kunt de optie voor gecodeerde Adobe PDF ook niet instellen op true wanneer u een PDF/A 1B-document maakt. PDF/A 1B wordt altijd een niet-gecodeerd PDF-document.

Een PDF/A-document genereren

Nadat u naar een geldige XML-gegevensbron met formuliergegevens hebt verwezen en u runtime-opties hebt ingesteld, kunt u de uitvoerservice aanroepen, zodat er een PDF/A-document wordt gegenereerd.

De resultaten van de bewerking ophalen

Nadat de dienst van de Output een verrichting uitvoert, keert het diverse gegevenspunten zoals de gegevens van XML terug die specificeren of de verrichting succesvol was.

Zie ook

Een PDF/A-document maken met de webservice-API

Een PDF/A-document maken met de Java API

Een PDF/A-document maken met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron.
- Maak een java.io.FileInputStream-object dat de XML-gegevensbron vertegenwoordigt die wordt gebruikt om het PDF/A-document te vullen met de constructor ervan en geef een tekenreekswaarde door die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Stel PDF/A-runtime-opties in.
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie File URI in door de methode setFileURI van het object PDFOutputOptionsSpec aan te roepen. Geef een tekenreekswaarde door die de locatie aangeeft van het PDF-bestand dat door de uitvoerservice wordt gegenereerd. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Stel de waarde PDFAConformance in door de methode setPDFAConformance van het object RenderOptionsSpec aan te roepen en een opsommingswaarde PDFAConformance door te geven die het compatibiliteitsniveau opgeeft. Als u bijvoorbeeld compatibiliteitsniveau A wilt opgeven, geeft u PDFAConformance.A door.
- Stel de waarde PDFARevisionNumber in door de methode setPDFARevisionNumber van het object RenderOptionsSpec aan te roepen en PDFARevisionNumber.Revision_1 door te geven.
OPMERKING

De PDF-versie van een PDF/A-document is 1.4, ongeacht de waarde die u opgeeft voor de methode RenderOptionsSpec van het object.setPdfVersion
Genereer een PDF/A-document.

Maak een PDF/A-document door de methode OutputClient van het object generatePDFOutput aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde TransformationFormat. Als u een PDF/A-document wilt genereren, geeft u TransformationFormat.PDFA op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
De methode generatePDFOutput retourneert een OutputResult-object dat de resultaten van de bewerking bevat.

OPMERKING

De methode OutputResult van het object getRecordLevelMetaDataList retourneert null*. *

OPMERKING

U kunt ook een PDF/A-document maken door de methode OutputClient van het object generatePDFOutput2 aan te roepen. (Zie Documenten die zich bevinden in Inhoudsservices (afgekeurd) doorgeven aan de Uitvoerservice.)
Haal de resultaten van de bewerking op.
- Maak een com.adobe.idp.Document-object dat de status van de methode generatePDFOutput vertegenwoordigt door de methode getStatusDoc van het object OutputResult aan te roepen.
- Maak een java.io.File-object dat de resultaten van de bewerking zal bevatten. Controleer of de bestandsnaamextensie .xml is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getStatusDoc is geretourneerd).
OPMERKING

Hoewel de Output-service het PDF/A-document schrijft naar de locatie die is opgegeven door het argument dat wordt doorgegeven aan de methode setFileURI van het object PDFOutputOptionsSpec, kunt u het PDF/A-document programmatisch ophalen door de methode getGeneratedDoc* van het object OutputResult* aan te roepen.*

Zie ook

Snel starten (SOAP-modus): Een PDF/A-document maken met de Java API

Verbindingseigenschappen instellen.

Een PDF/A-document maken met de webservice-API

Een PDF/A-document maken met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. In het object BLOB worden gegevens opgeslagen die met het PDF/A-document worden samengevoegd.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het te versleutelen PDF-document en de modus waarin het bestand moet worden geopend.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.
Stel PDF/A-runtime-opties in.
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie File URI in door een tekenreekswaarde toe te wijzen die de locatie aangeeft van het PDF-bestand dat de uitvoerservice genereert voor het PDFOutputOptionsSpec-gegevenslid van het fileURI-object. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Stel de waarde PDFAConformance in door een PDFAConformance-opsommingswaarde toe te wijzen aan het RenderOptionsSpec-gegevenslid van het PDFAConformance-object. Als u bijvoorbeeld compatibiliteitsniveau A wilt opgeven, wijst u PDFAConformance.A toe aan dit gegevenslid.
- Stel de waarde PDFARevisionNumber in door een PDFARevisionNumber-opsommingswaarde toe te wijzen aan het RenderOptionsSpec-gegevenslid van het PDFARevisionNumber-object. Wijs PDFARevisionNumber.Revision_1 aan dit gegevenslid toe.
OPMERKING

De PDF-versie van een PDF/A-document is 1.4, ongeacht de waarde die u opgeeft.
Genereer een PDF/A-document.

Maak een PDF-document door de methode OutputServiceService van het object generatePDFOutputaan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde van TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDFA op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. Met de methode generatePDFOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Een object BLOB dat is gevuld met de methode generatePDFOutput. De methode generatePDFOutput vult dit object met resultaatgegevens. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Een OutputResult-object dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
OPMERKING

U kunt ook een PDF/A-document maken door de methode OutputClient van het object generatePDFOutput2 aan te roepen. (Zie Documenten die zich bevinden in Inhoudsservices (afgekeurd) doorgeven aan de Uitvoerservice.)
Haal de resultaten van de bewerking op.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die een XML-bestandslocatie vertegenwoordigt die resultaatgegevens bevat. Controleer of de bestandsnaamextensie .xml is.
- Maak een bytearray met de gegevensinhoud van het BLOB-object dat met resultaatgegevens is gevuld door de methode generatePDFOutput van het OutputServiceService-object (de achtste parameter). Vul de bytearray met de waarde van het veld BLOB van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar het XML-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Documenten doorgeven aan de uitvoerservice met de Java API

Het overgaan van Documenten die in de (verlaten) Inhoudsdiensten worden gevestigd aan de Dienst van de Output

De service Uitvoer genereert een niet-interactief PDF-formulier dat is gebaseerd op een formulierontwerp dat gewoonlijk als een XDP-bestand wordt opgeslagen en in Designer wordt gemaakt. U kunt een com.adobe.idp.Document-object met het formulierontwerp doorgeven aan de uitvoerservice. De uitvoerservice geeft vervolgens het formulierontwerp weer dat zich in het object com.adobe.idp.Document bevindt.

Een voordeel van het doorgeven van een com.adobe.idp.Document-object aan de Output-service is dat andere AEM Forms-servicebewerkingen een com.adobe.idp.Document-instantie retourneren. Dat wil zeggen dat u een com.adobe.idp.Document instantie kunt ophalen van een andere servicebewerking en deze kunt renderen. Stel dat een XDP-bestand wordt opgeslagen in een knooppunt Content Services (afgekeurd) met de naam /Company Home/Form Designs, zoals in de volgende afbeelding wordt getoond.

U kunt Loan.xdp programmatically terugwinnen van de Diensten van de Inhoud (afgekeurd) en het XDP dossier tot de dienst van de Output binnen een com.adobe.idp.Document voorwerp overgaan.

OPMERKING

Zie Referentiehandleiding voor services voor AEM Forms voor meer informatie over de Forms-service.

Overzicht van de stappen

Als u een document dat is verkregen van Content Services (afgekeurd) wilt doorgeven aan de service Uitvoer, voert u de volgende taken uit:

Inclusief projectbestanden.
Maak een Output- en een Document Management Client API-object.
Haal het formulierontwerp op bij Inhoudsservices (afgekeurd).
Het niet-interactieve PDF-formulier weergeven.
Voer een handeling uit met de gegevensstroom.

Projectbestanden opnemen

Neem de benodigde bestanden op voor uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.

Een Output en een Document Management Client API-object maken

Voordat u programmatisch een uitvoerservice-API-bewerking kunt uitvoeren, maakt u een Output Client-API-object. Omdat met deze workflow een XDP-bestand wordt opgehaald van Content Services (afgekeurd), maakt u ook een Document Management API-object.

Het formulierontwerp ophalen van Content Services (afgekeurd)

Haal het XDP-bestand op van Content Services (afgekeurd) met behulp van de Java- of webservice-API. Het XDP-bestand wordt geretourneerd binnen een com.adobe.idp.Document-instantie (of een BLOB-instantie als u webservices gebruikt). Vervolgens kunt u de instantie com.adobe.idp.Document doorgeven aan de uitvoerservice.

Het niet-interactieve PDF-formulier renderen

Als u een niet-interactief formulier wilt renderen, geeft u het exemplaar com.adobe.idp.Document dat is geretourneerd van Content Services (afgekeurd) door aan de Output-service.

OPMERKING

Twee nieuwe methoden met de naam generatePDFOutput2en g eneratePrintedOutput2accepteren een com.adobe.idp.Document-object dat een formulierontwerp bevat. U kunt ook een com.adobe.idp.Documentdocument met het formulierontwerp aan de Output-service doorgeven wanneer u een afdrukstroom naar een netwerkprinter verzendt.

Een handeling uitvoeren met de gegevensstroom van het formulier

U kunt het niet-interactieve formulier opslaan als een PDF-bestand. Het formulier kan worden weergegeven in Adobe Reader of Acrobat.

Zie ook

Documenten doorgeven aan de uitvoerservice met behulp van de webservice-API

PDF-documenten maken met behulp van fragmenten

Documenten doorgeven aan de uitvoerservice met de Java API

Geef een document door dat is opgehaald uit Content Services (afgekeurd) met de Output-service en Content Services (afgekeurd) API (Java):

Inclusief projectbestanden.

Neem JAR-bestanden voor clients, zoals adobe-output-client.jar en adobe-contentservices-client.jar, op in het klassenpad van uw Java-project.
Maak een Output- en een Document Management Client API-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
- Maak een DocumentManagementServiceClientImpl-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Haal het formulierontwerp op bij Inhoudsservices (afgekeurd).

Roep de methode retrieveContent van het object DocumentManagementServiceClientImpl aan en geef de volgende waarden door:
- Een tekenreekswaarde die de opslaglocatie opgeeft waar de inhoud wordt toegevoegd. De standaardopslag is SpacesStore. Deze waarde is een verplichte parameter.
- Een tekenreekswaarde die het volledig gekwalificeerde pad opgeeft van de inhoud die moet worden opgehaald (bijvoorbeeld /Company Home/Form Designs/Loan.xdp). Deze waarde is een verplichte parameter.
- Een tekenreekswaarde die de versie opgeeft. Deze waarde is een optionele parameter en u kunt een lege tekenreeks doorgeven. In dit geval wordt de laatste versie opgehaald.
De methode retrieveContent retourneert een CRCResult-object dat het XDP-bestand bevat. Haal een com.adobe.idp.Document-instantie op door de methode getDocument van het object CRCResult aan te roepen.
Het niet-interactieve PDF-formulier weergeven.

Roep de methode generatePDFOutput2 van het object OutputClient aan en geef de volgende waarden door:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de extra bronnen, zoals afbeeldingen, zich bevinden.
- Een object com.adobe.idp.Document dat het formulierontwerp vertegenwoordigt (gebruik de instantie die wordt geretourneerd door de methode getDocument van het object CRCResult).
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
De methode generatePDFOutput2 retourneert een OutputResult-object dat de resultaten van de bewerking bevat.
Voer een handeling uit met de gegevensstroom van het formulier.
- Haal een com.adobe.idp.Document-object op dat het niet-interactieve formulier vertegenwoordigt door de methode OutputResult van het object getGeneratedDoc aan te roepen.
- Maak een java.io.File-object dat de resultaten van de bewerking bevat. Controleer of de bestandsnaamextensie .pdf is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getGeneratedDoc is geretourneerd).

Zie ook

Snel starten (EJB-modus): Documenten doorgeven aan de uitvoerservice met de Java API

Snel starten (SOAP-modus): Documenten doorgeven aan de uitvoerservice met de Java API

Documenten doorgeven aan de uitvoerservice met behulp van de webservice-API

Geef een document door dat is opgehaald uit Content Services (afgekeurd) met de Output-service en Content Services (afgekeurd) API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Omdat deze cliënttoepassing de twee diensten van AEM Forms aanhaalt, creeer twee de dienstverwijzingen. Gebruik de volgende definitie WSDL voor de de dienstverwijzing verbonden aan de dienst van de Output: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

Gebruik de volgende definitie WSDL voor de de dienstverwijzing verbonden aan de dienst van het Beheer van het Document: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Omdat het gegevenstype BLOB gemeenschappelijk is voor beide serviceverwijzingen, moet u het gegevenstype BLOB volledig kwalificeren wanneer u het gebruikt. In de overeenkomstige webservice quick start zijn alle BLOB-instanties volledig gekwalificeerd.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output- en een Document Management Client API-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.)
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
- Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
OPMERKING

Herhaal deze stappen voor de DocumentManagementServiceClient* de dienstcliënt. *
Haal het formulierontwerp op bij Inhoudsservices (afgekeurd).

Haal inhoud op door de methode DocumentManagementServiceClient van het object retrieveContent aan te roepen en de volgende waarden door te geven:
- Een tekenreekswaarde die de opslaglocatie opgeeft waar de inhoud wordt toegevoegd. De standaardopslag is SpacesStore. Deze waarde is een verplichte parameter.
- Een tekenreekswaarde die het volledig gekwalificeerde pad opgeeft van de inhoud die moet worden opgehaald (bijvoorbeeld /Company Home/Form Designs/Loan.xdp). Deze waarde is een verplichte parameter.
- Een tekenreekswaarde die de versie opgeeft. Deze waarde is een optionele parameter en u kunt een lege tekenreeks doorgeven. In dit geval wordt de laatste versie opgehaald.
- Een parameter van de koordoutput die doorbladert verbindingswaarde opslaat.
- Een BLOB uitvoerparameter die de inhoud opslaat. U kunt deze uitvoerparameter gebruiken om de inhoud op te halen.
- Een ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType-uitvoerparameter die inhoudskenmerken opslaat.
- A CRCResult outputparameter. In plaats van dit object te gebruiken, kunt u de uitvoerparameter BLOB gebruiken om de inhoud op te halen.
Het niet-interactieve PDF-formulier weergeven.

Roep de methode generatePDFOutput2 van het object OutputServiceClient aan en geef de volgende waarden door:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de extra bronnen, zoals afbeeldingen, zich bevinden.
- Een object BLOB dat het formulierontwerp vertegenwoordigt (gebruik de instantie BLOB die door Content Services is geretourneerd (afgekeurd)).
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een uitvoerobject BLOB dat wordt gevuld door de methode generatePDFOutput2. Met de methode generatePDFOutput2 wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een uitvoerobject OutputResult dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
De methode generatePDFOutput2 retourneert een object BLOB dat het niet-interactieve PDF-formulier bevat.
Voer een handeling uit met de gegevensstroom van het formulier.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het interactieve PDF-document en de modus waarin het bestand moet worden geopend.
- Maak een bytearray waarin de inhoud wordt opgeslagen van het BLOB-object dat is opgehaald van de methode generatePDFOutput2. Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Documenten in de opslagplaats doorgeven aan de uitvoerservice met behulp van de Java API

Documenten in de opslagplaats doorgeven aan de uitvoerservice

Een voordeel van het doorgeven van een com.adobe.idp.Document-object aan de Output-service is dat andere AEM Forms-servicebewerkingen een com.adobe.idp.Document-instantie retourneren. Dat wil zeggen dat u een com.adobe.idp.Document instantie kunt ophalen van een andere servicebewerking en deze kunt renderen. Stel dat een XDP-bestand wordt opgeslagen in de AEM Forms-opslagplaats, zoals in de volgende afbeelding wordt getoond.

pd_pd_formrepository

De map FormsFolder is een door de gebruiker gedefinieerde locatie in de AEM Forms-opslagplaats (deze locatie is een voorbeeld en bestaat niet standaard). In dit voorbeeld bevindt zich een formulierontwerp met de naam Loan.xdp in deze map. Naast het formulierontwerp kunnen ook andere formulierelementen, zoals afbeeldingen, op deze locatie worden opgeslagen. Het pad naar een bron in de AEM Forms-opslagplaats is:

Applications/Application-name/Application-version/Folder.../Filename

U kunt Loan.xdp programmatically terugwinnen van de bewaarplaats van AEM Forms en het tot de dienst van de Output binnen een com.adobe.idp.Document voorwerp overgaan.

U kunt op twee manieren een PDF maken op basis van een XDP-bestand in de opslagplaats. U kunt de XDP-locatie doorgeven via verwijzing of u kunt de XDP-locatie via programmacode ophalen uit de opslagplaats en deze doorgeven aan de Output-service in een XDP-bestand.

Snel starten (EJB-modus): Een PDF-document maken op basis van een XDP-bestand van een toepassing met behulp van de Java API (toont hoe u de locatie van het XDP-bestand door verwijzing doorgeeft).

Snel starten (EJB-modus): Als u een document in de AEM Forms Repository doorgeeft aan de Output-service met behulp van de Java API (geeft u aan hoe u het XDP-bestand programmatisch kunt ophalen uit de AEM Forms Repository en doorgeeft aan de Output-service in een com.adobe.idp.Document instantie). (In deze sectie wordt besproken hoe deze taak moet worden uitgevoerd)

OPMERKING

Zie Referentiehandleiding voor services voor AEM Forms voor meer informatie over de Forms-service.

Overzicht van de stappen

Voer de volgende taken uit om een document dat is verkregen van de AEM Forms-opslagplaats door te geven aan de Output-service:

Inclusief projectbestanden.
Maak een Output- en een Document Management Client API-object.
Haal het formulierontwerp op uit de AEM Forms-opslagplaats.
Het niet-interactieve PDF-formulier weergeven.
Voer een handeling uit met de gegevensstroom.

Projectbestanden opnemen

Een Output en een Document Management Client API-object maken

Het formulierontwerp ophalen uit de AEM Forms Repository

Haal het XDP-bestand op uit de AEM Forms Repository met behulp van de Repository API. (Zie Bronnen lezen.)

Het XDP-bestand wordt geretourneerd binnen een com.adobe.idp.Document-instantie (of een BLOB-instantie als u webservices gebruikt). Vervolgens kunt u de instantie com.adobe.idp.Document aan de uitvoerservice doorgeven.

Het niet-interactieve PDF-formulier renderen

Als u een niet-interactief formulier wilt weergeven, geeft u het com.adobe.idp.Document-exemplaar door dat is geretourneerd met de AEM Forms Repository API.

OPMERKING

Twee nieuwe methoden met de naam generatePDFOutput2en generatePrintedOutput2accepteren een com.adobe.idp.Documentobject dat een formulierontwerp bevat. U kunt ook een com.adobe.idp.Document met het formulierontwerp aan de Output-service doorgeven wanneer u een afdrukstroom naar een netwerkprinter verzendt.

Een handeling uitvoeren met de gegevensstroom van het formulier

U kunt het niet-interactieve formulier opslaan als een PDF-bestand. Het formulier kan worden weergegeven in Adobe Reader of Acrobat.

Zie ook

ResourceRepositoryClient

Documenten in de opslagplaats doorgeven aan de uitvoerservice met behulp van de Java API

Geef een document dat is opgehaald uit de opslagplaats door gebruik te maken van de Output-service en de Repository-API (Java):

Inclusief projectbestanden.

Neem JAR-bestanden voor clients, zoals adobe-output-client.jar en adobe-repository-client.jar, op in het klassenpad van uw Java-project.
Maak een Output- en een Document Management Client API-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
- Maak een DocumentManagementServiceClientImpl-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Haal het formulierontwerp op uit de AEM Forms Repository.

Roep de methode ResourceRepositoryClient van het object readResourceContent aan en geef een tekenreekswaarde door die de URI-locatie aan het XDP-bestand opgeeft. Bijvoorbeeld, /Applications/FormsApplication/1.0/FormsFolder/Loan.xdp. Deze waarde is verplicht. Deze methode retourneert een com.adobe.idp.Document-instantie die het XDP-bestand vertegenwoordigt.
Het niet-interactieve PDF-formulier weergeven.

Roep de methode generatePDFOutput2 van het object OutputClient aan en geef de volgende waarden door:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de extra bronnen, zoals afbeeldingen, zich bevinden. Bijvoorbeeld, repository:///Applications/FormsApplication/1.0/FormsFolder/.
- Een object com.adobe.idp.Document dat het formulierontwerp vertegenwoordigt (gebruik de instantie die wordt geretourneerd door de methode readResourceContent van het object ResourceRepositoryClient).
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
De methode generatePDFOutput2 retourneert een OutputResult-object dat de resultaten van de bewerking bevat.
Voer een handeling uit met de gegevensstroom van het formulier.
- Haal een com.adobe.idp.Document-object op dat het niet-interactieve formulier vertegenwoordigt door de methode OutputResult van het object getGeneratedDoc aan te roepen.
- Maak een java.io.File-object dat de resultaten van de bewerking bevat. Controleer of de bestandsnaamextensie .pdf is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getGeneratedDoc is geretourneerd).

Zie ook

Snel starten (EJB-modus): Een document in de AEM Forms Repository doorgeven aan de Output-service met behulp van de Java API

Een PDF-document maken op basis van fragmenten met de Java API

PDF-documenten maken met behulp van fragmenten

Met de services Uitvoer en Assembler kunt u een uitvoerstream maken, zoals een PDF-document, die is gebaseerd op fragmenten. De Assembler-service brengt een XDP-document samen dat is gebaseerd op fragmenten die zich in meerdere XDP-bestanden bevinden. Het samengevoegde XDP-document wordt doorgegeven aan de Output-service, die een PDF-document maakt. Hoewel in deze workflow een PDF-document wordt gegenereerd, kan de uitvoerservice voor deze workflow andere uitvoertypen genereren, zoals ZPL. Een PDF-document wordt alleen gebruikt voor discussie.

Deze workflow wordt in de volgende afbeelding getoond.

cp_cp_outputassemblefragmenten

Voordat u PDF-documenten maakt met behulp van Fragments, is het raadzaam bekend te raken met het gebruik van de Assembler-service voor het samenstellen van meerdere XDP-documenten. (Zie Meerdere XDP-fragmenten samenvoegen.)

OPMERKING

U kunt ook een formulierontwerp dat door de Assembler-service is samengesteld, aan de Forms-service doorgeven in plaats van aan de Output-service. Het belangrijkste verschil tussen de Output-service en de Forms-service is dat de Forms-service interactieve PDF-documenten genereert en dat de Output-service niet-interactieve PDF-documenten produceert. Ook kan de Forms-service geen op printers gebaseerde uitvoerstreams zoals ZPL genereren.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om een PDF-document te maken op basis van fragmenten:

Inclusief projectbestanden.
Maak een Output- en Assembler Client-object.
Gebruik de Assembler-service om het formulierontwerp te genereren.
Gebruik de uitvoerservice om het PDF-document te genereren.
Sla het PDF-document op als een PDF-bestand.

Projectbestanden opnemen

Een Output- en Assembler Client-object maken

Voordat u programmatisch een uitvoerservice-API-bewerking kunt uitvoeren, maakt u een Output Client API-object. Bovendien maakt u een Assembler Client API-object omdat deze workflow de Assembler-service oproept om het formulierontwerp te maken.

Met de Assembler-service kunt u het formulierontwerp genereren

Met de Assembler-service kunt u het formulierontwerp genereren met behulp van fragmenten. De Assembler-service retourneert een com.adobe.idp.Document-exemplaar dat het formulierontwerp bevat.

De service Uitvoer gebruiken om het PDF-document te genereren

U kunt de service Uitvoer gebruiken om een PDF-document te genereren met behulp van het formulierontwerp dat de Assembler-service heeft gemaakt. Geef de instantie com.adobe.idp.Document door die de Assembler-service aan de Output-service heeft geretourneerd.

Het PDF-document opslaan als een PDF-bestand

Nadat de service Uitvoer een PDF-document heeft gegenereerd, kunt u het opslaan als een PDF-bestand.

Zie ook

Een PDF-document maken op basis van fragmenten met de webservice-API

Meerdere XDP-fragmenten samenstellen

PDF-documenten maken

Een PDF-document maken op basis van fragmenten met de Java API

Maak een PDF-document op basis van fragmenten met de API voor uitvoerservice en de API voor vergaderingsservice (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output- en Assembler Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
- Maak een AssemblerServiceClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Gebruik de Assembler-service om het formulierontwerp te genereren.

Roep de methode invokeDDX van het object AssemblerServiceClient aan en geef de volgende vereiste waarden door:
- Een com.adobe.idp.Document-object dat het te gebruiken DDX-document vertegenwoordigt.
- Een object java.util.Map dat de invoer-XDP-bestanden bevat.
- Een com.adobe.livecycle.assembler.client.AssemblerOptionSpec-object dat de runtime-opties opgeeft, inclusief het standaardlettertype en het taaklogniveau.
De methode invokeDDX retourneert een com.adobe.livecycle.assembler.client.AssemblerResult-object dat het geassembleerde XDP-document bevat. Voer de volgende handelingen uit om het samengevoegde XDP-document op te halen:
- Roep de methode AssemblerResult van het object getDocuments aan. Deze methode retourneert een java.util.Map-object.
- Doorloop het object java.util.Map totdat u het resulterende object com.adobe.idp.Document hebt gevonden.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om het samengevoegde XDP-document te extraheren.
Gebruik de uitvoerservice om het PDF-document te genereren.

Roep de methode generatePDFOutput2 van het object OutputClient aan en geef de volgende waarden door:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de extra bronnen, zoals afbeeldingen, zich bevinden
- Een com.adobe.idp.Document-object dat het formulierontwerp vertegenwoordigt (gebruik de instantie die door de Assembler-service is geretourneerd)
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat
- Een RenderOptionsSpec-object dat renderingopties bevat
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd
De methode generatePDFOutput2 retourneert een OutputResult-object dat de resultaten van de bewerking bevat
Sla het PDF-document op als een PDF-bestand.
- Haal een com.adobe.idp.Document-object op dat het PDF-document vertegenwoordigt door de methode getGeneratedDoc van het object OutputResult aan te roepen.
- Maak een java.io.File-object dat de resultaten van de bewerking bevat. Zorg ervoor dat de bestandsnaamextensie .pdf is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren. (Zorg ervoor dat u het object com.adobe.idp.Document gebruikt dat de methode getGeneratedDoc heeft geretourneerd.)

Zie ook

Snel starten (EJB-modus): Een PDF-document maken op basis van fragmenten met de Java API

Snel starten (SOAP-modus): Een PDF-document maken op basis van fragmenten met de Java API

Verbindingseigenschappen instellen.

Een PDF-document maken op basis van fragmenten met de webservice-API

Maak een PDF-document op basis van fragmenten met de API voor uitvoerservice en de API voor vergaderingsservice (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Gebruik de volgende definitie WSDL voor de de dienstverwijzing verbonden aan de dienst van de Output:
```
 http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.
```
Gebruik de volgende definitie WSDL voor de de dienstverwijzing verbonden aan de dienst van de Assembler:
```
 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.
```
Omdat het gegevenstype BLOB gemeenschappelijk is voor beide serviceverwijzingen, moet u het gegevenstype BLOB volledig kwalificeren wanneer u het gebruikt. In de overeenkomstige webservice quick start zijn alle BLOB-instanties volledig gekwalificeerd.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output- en Assembler Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserNametoe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het OutputServiceClient.ClientCredentials.UserName.Passwordgebied toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan BasicHttpBindingSecurity.Transport.ClientCredentialTypegebied toe.
- Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het BasicHttpBindingSecurity.Security.Modeveld.
OPMERKING

Herhaal deze stappen voor het object AssemblerServiceClient*. *
Gebruik de Assembler-service om het formulierontwerp te genereren.

Roep de methode invokeDDX van het object AssemblerServiceClient aan en geef de volgende waarden door:
- Een BLOB-object dat het DDX-document vertegenwoordigt
- Het MyMapOf_xsd_string_To_xsd_anyType-object dat de vereiste bestanden bevat
- Een AssemblerOptionSpec-object dat uitvoeringsopties opgeeft
De methode invokeDDX retourneert een AssemblerResult-object dat de resultaten van de taak en eventuele uitzonderingen bevat die zich hebben voorgedaan. Voer de volgende handelingen uit om het nieuwe XDP-document te verkrijgen:
- Open het veld AssemblerResult van het object documents. Dit is een Map-object dat de resulterende PDF-documenten bevat.
- Doorloop het object Map om het samengevoegde formulierontwerp op te halen. Cast value van dat serielid aan BLOB. Geef deze BLOB-instantie door aan de Output-service.
Gebruik de uitvoerservice om het PDF-document te genereren.

Roep de methode generatePDFOutput2 van het object OutputServiceClient aan en geef de volgende waarden door:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de extra bronnen, zoals afbeeldingen, zich bevinden.
- Een BLOB-object dat het formulierontwerp vertegenwoordigt (gebruik de BLOB-instantie die door de Assembler-service is geretourneerd).
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een uitvoerobject BLOB dat door de methode generatePDFOutput2 wordt gevuld. Met de methode generatePDFOutput2 wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een uitvoerobject OutputResult dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
De methode generatePDFOutput2 retourneert een object BLOB dat het niet-interactieve PDF-formulier bevat.
Sla het PDF-document op als een PDF-bestand.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het interactieve PDF-document en de modus waarin het bestand moet worden geopend.
- Maak een bytearray waarin de inhoud wordt opgeslagen van het BLOB-object dat is opgehaald van de methode generatePDFOutput2. Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Afdrukken naar bestanden met de Java API

Afdrukken naar bestanden

U kunt de uitvoerservice gebruiken om streams zoals PostScript, Printer Control Language (PCL) of de volgende labelindelingen naar een bestand af te drukken:

Zebra - ZPL
Intermec, IPL
Datamax - DPL
TecToshiba - TPCL

Met de service Uitvoer kunt u XML-gegevens samenvoegen met een formulierontwerp en het formulier afdrukken naar een bestand. In de volgende afbeelding ziet u hoe de uitvoerservice laser- en labelbestanden maakt.

OPMERKING

Zie Afdrukstromen verzenden naar printers voor informatie over het verzenden van afdrukstromen naar printers.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om naar een bestand af te drukken:

Inclusief projectbestanden.
Maak een Output Client-object.
Verwijzen naar een XML-gegevensbron.
Stel de runtime-opties voor afdrukken in die nodig zijn om af te drukken naar een bestand.
Druk de afdrukstroom naar een bestand af.
Haal de resultaten van de bewerking op.

Projectbestanden opnemen

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Een uitvoerclient-object maken

Verwijzen naar een XML-gegevensbron

Als u een document wilt afdrukken dat gegevens bevat, moet u verwijzen naar een XML-gegevensbron die XML-elementen bevat voor elk formulierveld dat u wilt vullen met gegevens. De naam van het XML-element moet overeenkomen met de veldnaam. Een XML-element wordt genegeerd als het niet overeenkomt met een formulierveld of als de naam van het XML-element niet overeenkomt met de veldnaam. Het is niet nodig de volgorde aan te passen waarin de XML-elementen worden weergegeven als alle XML-elementen zijn opgegeven.

Stel runtime-opties voor afdrukken in die nodig zijn om af te drukken naar een bestand

Als u naar een bestand wilt afdrukken, moet u de runtime-optie voor de bestands-URI instellen door de locatie en de naam op te geven van het bestand dat door de uitvoerservice wordt afgedrukt. Als u bijvoorbeeld de uitvoerservice de instructie wilt geven een PostScript-bestand met de naam MortgaugeForm.ps af te drukken naar C:\Adobe, geeft u C:\Adobe\MortgageForm.ps op.

OPMERKING

Er zijn optionele uitvoeringsopties die u kunt definiëren. Zie de PrintedOutputOptionsSpec-klasseverwijzing in AEM Forms API Reference voor informatie over alle opties die u kunt instellen.

De afdrukstroom naar een bestand afdrukken

Nadat u naar een geldige XML-gegevensbron met formuliergegevens hebt verwezen en u afdrukopties hebt ingesteld, kunt u de uitvoerservice aanroepen, waardoor een bestand wordt afgedrukt.

De resultaten van de bewerking ophalen

Nadat de dienst van de Output een verrichting uitvoert, keert het diverse gegevenspunten, zoals de gegevens van XML terug, die specificeren of de verrichting succesvol was.

Zie ook

Afdrukken naar bestanden met de webservice-API

Afdrukken naar bestanden met de Java API

Afdrukken naar een bestand met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron.
- Maak een object java.io.FileInputStream dat de XML-gegevensbron vertegenwoordigt die wordt gebruikt om het document te vullen met de constructor ervan en geef een tekenreekswaarde door die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Stel de runtime-opties voor afdrukken in die nodig zijn om af te drukken naar een bestand.
- Maak een PrintedOutputOptionsSpec-object met de constructor ervan.
- Geef het bestand op door de methode setFileURI van het PrintOutputOptionsSpec-object aan te roepen en een tekenreekswaarde door te geven die de naam en locatie van het bestand vertegenwoordigt. Als u bijvoorbeeld wilt dat de uitvoerservice wordt afgedrukt naar een PostScript-bestand met de naam* MortgaugeForm.ps* in C:\Adobe, geeft u C:\Adobe\MortgageForm.ps op.
- Geef het aantal exemplaren op dat moet worden afgedrukt door de methode setCopies van het object PrintedOutputOptionsSpec aan te roepen en een geheel-getalwaarde door te geven die het aantal kopieën vertegenwoordigt.
Druk de afdrukstroom naar een bestand af.

Druk af naar een bestand door de methode generatePrintedOutput van het object OutputClient aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde PrintFormat die de indeling van de afdrukstroom opgeeft die moet worden gemaakt. Als u bijvoorbeeld een PostScript-afdrukstroom wilt maken, geeft u PrintFormat.PostScript door.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de locatie van verwante secundaire bestanden, zoals afbeeldingsbestanden, opgeeft.
- Een tekenreekswaarde die de locatie aangeeft van het XDC-bestand dat moet worden gebruikt (u kunt null doorgeven als u het XDC-bestand hebt opgegeven dat moet worden gebruikt met het object PrintedOutputOptionsSpec).
- Het PrintedOutputOptionsSpec-object dat runtime-opties bevat die vereist zijn om af te drukken naar een bestand.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die formuliergegevens bevat.
De methode generatePrintedOutput retourneert een OutputResult-object dat de resultaten van de bewerking bevat.

OPMERKING

De methode OutputResult van het object getRecordLevelMetaDataList retourneert null*. *
Haal de resultaten van de bewerking op.
- Maak een com.adobe.idp.Document-object dat de status van de methode generatePrintedOutput vertegenwoordigt door de methode getStatusDoc van het object OutputResult aan te roepen (het object OutputResult is geretourneerd door de methode generatePrintedOutput).
- Maak een java.io.File-object dat de resultaten van de bewerking zal bevatten. Zorg ervoor dat de bestandsextensie XML is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getStatusDoc is geretourneerd).

Zie ook

Snel starten (SOAP-modus): Afdrukken naar een bestand met de Java API

Verbindingseigenschappen instellen.

Afdrukken naar bestanden met de webservice-API

Afdrukken naar een bestand met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. Het object BLOB wordt gebruikt om formuliergegevens op te slaan.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de locatie aangeeft van het XML-bestand dat formuliergegevens bevat.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het object BLOB door de eigenschap binaryData ervan toe te wijzen met de inhoud van de bytearray.
Stel de runtime-opties voor afdrukken in die nodig zijn om af te drukken naar een bestand.
- Maak een PrintedOutputOptionsSpec-object met de constructor ervan.
- Geef het bestand op door een tekenreekswaarde toe te wijzen die de locatie en naam van het bestand vertegenwoordigt aan het PrintedOutputOptionsSpec-gegevenslid van het fileURI-object. Als u bijvoorbeeld wilt dat de uitvoerservice wordt afgedrukt naar een PostScript-bestand met de naam MortgaugeForm.ps in C:\Adobe, geeft u C:\Adobe\MortgageForm.ps op.
- Geef het aantal exemplaren op dat moet worden afgedrukt door een geheel-getalwaarde toe te wijzen die het aantal exemplaren aangeeft voor de PrintedOutputOptionsSpec-gegevensleden van het copies-object.
Druk de afdrukstroom naar een bestand af.

Druk af naar een bestand door de methode generatePrintedOutput van het object OutputServiceService aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde PrintFormat die de indeling van de afdrukstroom opgeeft die moet worden gemaakt. Als u bijvoorbeeld een PostScript-afdrukstroom wilt maken, geeft u PrintFormat.PostScript door.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de locatie van verwante secundaire bestanden, zoals afbeeldingsbestanden, opgeeft.
- Een tekenreekswaarde die de locatie aangeeft van het XDC-bestand dat moet worden gebruikt (u kunt null doorgeven als u het XDC-bestand hebt opgegeven dat moet worden gebruikt met het object PrintedOutputOptionsSpec).
- Het PrintedOutputOptionsSpec-object dat afdrukopties bij uitvoering bevat die vereist zijn om naar een bestand af te drukken.
- Het object BLOB dat de XML-gegevensbron bevat die formuliergegevens bevat.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. Met de methode generatePDFOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Een object BLOB dat is gevuld met de methode generatePDFOutput. De methode generatePDFOutput vult dit object met resultaatgegevens. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Een OutputResult-object dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
Haal de resultaten van de bewerking op.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die een XML-bestandslocatie vertegenwoordigt die resultaatgegevens bevat. Zorg ervoor dat de bestandsextensie XML is.
- Maak een bytearray met de gegevensinhoud van het BLOB-object dat met resultaatgegevens is gevuld door de methode generatePDFOutput van het OutputServiceService-object (de achtste parameter). Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar het XML-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Afdrukstromen naar printers verzenden

Met de service Uitvoer kunt u afdrukstreams zoals PostScript, Printer Control Language (PCL) of de volgende labelindelingen naar netwerkprinters verzenden:

Zebra - ZPL
Intermec, IPL
Datamax - DPL
TecToshiba - TPCL

Met de Output-service kunt u XML-gegevens samenvoegen met een formulierontwerp en het formulier uitvoeren als een afdrukstroom. U kunt bijvoorbeeld een PostScript-afdrukstroom maken en deze naar een netwerkprinter verzenden. In de volgende afbeelding ziet u hoe de uitvoerservice afdrukstreams naar netwerkprinters verzendt.

OPMERKING

In deze sectie wordt een PostScript-afdrukstroom naar een netwerkprinter verzonden met behulp van het SharedPrinter-printerprotocol om te tonen hoe u een afdrukstream naar een netwerkprinter verzendt.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om een afdrukstroom naar een netwerkprinter te verzenden:

Inclusief projectbestanden.
Maak een Output Client-object.
Verwijzen naar een XML-gegevensbron.
Uitvoeropties voor afdrukken instellen
Een af te drukken document ophalen.
Verzend het document naar een netwerkprinter.

Projectbestanden opnemen

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Een uitvoerclient-object maken

Voordat u programmatisch een uitvoerservicebewerking kunt uitvoeren, maakt u een uitvoerservice-clientobject. Als u de Java API gebruikt, maakt u een OutputClient-object. Als u de uitvoerwebservice-API gebruikt, maakt u een OutputServiceClient-object.

Verwijzen naar een XML-gegevensbron

Uitvoeropties voor afdrukken instellen

U kunt de runtime-opties instellen wanneer u een afdrukstroom naar een printer verzendt, inclusief de volgende opties:

Exemplaren: Hier geeft u het aantal exemplaren op dat u naar de printer wilt verzenden. De standaardwaarde is 1.
Stapel: Een optie XCI wordt geplaatst wanneer een nietmachine wordt gebruikt. Deze optie kan in het configuratiemodel door het belangrijkste element worden gespecificeerd en wordt gebruikt voor printers PS en PCL slechts.
OutputJog: Er wordt een XCI-optie ingesteld wanneer uitvoerpagina's moeten worden samengevoegd (fysiek verschoven in de uitvoerlade). Deze optie geldt alleen voor PS- en PCL-printers.
OutputBin: XCI-waarde die wordt gebruikt om het afdrukstuurprogramma in staat te stellen de juiste uitvoerbak te selecteren.

OPMERKING

Zie de klasseverwijzing PrintedOutputOptionsSpec voor informatie over alle runtime-opties die u kunt instellen.

Een af te drukken document ophalen

Haal een afdrukstroom op die u naar een printer wilt verzenden. U kunt bijvoorbeeld een PostScript-bestand ophalen en naar een printer verzenden.

U kunt een PDF-bestand verzenden als uw printer PDF-bestanden ondersteunt. Een probleem bij het verzenden van een PDF-document naar een printer is echter dat elke printerfabrikant een andere implementatie van de PDF-interpreter heeft. Dat wil zeggen dat sommige afdrukfabrikanten Adobe PDF-interpretatie gebruiken, maar dat hangt van de printer af. Andere printers hebben een eigen PDF-interpreter. Hierdoor kunnen de afdrukresultaten afwijken.

Een andere beperking bij het verzenden van een PDF-document naar een printer is dat het alleen wordt afgedrukt. de printer heeft alleen toegang tot duplex, selectie van papierlade en nieten, via de printerinstellingen.

Als u een document wilt ophalen om af te drukken, gebruikt u de methode generatePrintedOutput. In de volgende tabel worden inhoudstypen aangegeven die voor een bepaalde afdrukstroom zijn ingesteld wanneer de methode generatePrintedOutput wordt gebruikt.

Afdrukindeling	Beschrijving
DPL	Maakt standaard een dpl203.xdc of aangepaste xdc-uitvoerstream.
DPL300DPI	Maakt een DPL 300 DPI-uitvoerstream.
DPL406DPI	Maakt een DPL 400 DPI-uitvoerstream.
DPL600DPI	Maakt een DPL 600 DPI-uitvoerstream.
GenericColorPCL	Hiermee wordt een algemene PCL-uitvoerstream (5c) van kleur gemaakt.
GenericPSLevel3	Hiermee wordt een generieke uitvoerstream van PostScript Level 3 gemaakt.
IPL	Maakt een aangepaste IPL-uitvoerstream.
IPL300DPI	Maakt een IPL 300 DPI-uitvoerstream.
IPL400DPI	Maakt een IPL 400 DPI-uitvoerstream.
PCL	Hiermee wordt een generieke monochrome PCL-uitvoerstream (5e) gemaakt.
PostScript	Hiermee wordt een generieke uitvoerstream van PostScript Level 2 gemaakt.
TPCL	Maakt een aangepaste TPCL-uitvoerstream.
TPCL305DPI	Maakt een TPCL 305 DPI-uitvoerstream.
TPCL600DPI	Maakt een TPCL 600 DPI-uitvoerstream.
ZPL	Maakt een ZPL 203 DPI-uitvoerstream.
ZPL300DPI	Maakt een ZPL 300 DPI-uitvoerstroom.

OPMERKING

U kunt ook een afdrukstroom naar een printer verzenden met de methode generatePrintedOutput2. De snelle start die echter wordt gekoppeld aan de sectie Afdrukstromen naar printers verzenden, gebruikt de methode generatePrintedOutput.

De afdrukstroom naar een netwerkprinter verzenden

Nadat u een document hebt opgehaald om af te drukken, kunt u de service Uitvoer inschakelen, waardoor een afdrukstroom naar een netwerkprinter wordt verzonden. Als u de printer wilt vinden in de uitvoerservice, moet u zowel de afdrukserver als de printernaam opgeven. Daarnaast moet u ook het afdrukprotocol opgeven.

OPMERKING

Als PDFG op de vormenserver en de serverlooppas op de Server 2008 van Vensters wordt geïnstalleerd, kunt u niet het bezit SharedPrinter gebruiken. In deze situatie, gebruik een verschillend printerprotocol.

OPMERKING

Als u een netwerkprinter gebruikt en het toegangsmechanisme SharedPrinter is, moet u het volledige netwerkpad van de printer opgeven.Een afdrukstroom naar een netwerkprinter verzenden met de Java API

Een afdrukstream naar een netwerkprinter verzenden met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Een uitvoerclient-object maken
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron
- Maak een object java.io.FileInputStream dat de XML-gegevensbron vertegenwoordigt die wordt gebruikt om het document te vullen met de constructor ervan en geef een tekenreekswaarde door die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Uitvoeropties voor afdrukken instellen

Maak een PrintedOutputOptionsSpec-object dat afdrukomloopopties vertegenwoordigt. U kunt bijvoorbeeld het aantal exemplaren opgeven dat moet worden afgedrukt door de methode setCopies van het object PrintedOutputOptionsSpec aan te roepen.

OPMERKING

U kunt de pagineringswaarde niet instellen met de methode setPagination van het object PrintedOutputOptionsSpec als u een ZPL-afdrukstroom genereert. Evenzo kunt u de volgende opties niet instellen voor een ZPL-afdrukstroom: OutputJog, PageOffset en Stapel. De methode setPagination* is niet geldig voor het genereren van PostScript. Het is alleen geldig voor PCL-generatie. *
Een af te drukken document ophalen
- Haal een document op dat u wilt afdrukken door de methode OutputClient van het object generatePrintedOutput aan te roepen en de volgende waarden door te geven:
  - Een opsommingswaarde PrintFormat die de afdrukstroom opgeeft. Als u bijvoorbeeld een PostScript-afdrukstroom wilt maken, geeft u PrintFormat.PostScript door.
  - Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
  - Een tekenreekswaarde die de locatie van verwante secundaire bestanden opgeeft, zoals afbeeldingsbestanden.
  - Een tekenreekswaarde die de locatie aangeeft van het XDC-bestand dat moet worden gebruikt.
  - Het PrintedOutputOptionsSpec-object dat uitvoeringsopties bevat die vereist zijn om af te drukken naar een bestand.
  - Het object com.adobe.idp.Document dat de XML-gegevensbron vertegenwoordigt die formuliergegevens bevat die met het formulierontwerp moeten worden samengevoegd.
  Deze methode retourneert een OutputResult-object dat de resultaten van de bewerking bevat.
- Maak een com.adobe.idp.Document-object om naar de printer te verzenden door de methode OutputResult van het object getGeneratedDoc aan te roepen. Deze methode retourneert een com.adobe.idp.Document-object.
De afdrukstroom naar een netwerkprinter verzenden

Verzend de afdrukstroom naar een netwerkprinter door de methode OutputClient van het object sendToPrinter aan te roepen en de volgende waarden door te geven:
- Een com.adobe.idp.Document-object dat de afdrukstream vertegenwoordigt die naar de printer moet worden verzonden.
- Een PrinterProtocol opsommingswaarde die het te gebruiken printerprotocol specificeert. Als u bijvoorbeeld het SharedPrinter-protocol wilt opgeven, geeft u PrinterProtocol.SharedPrinter door.
- Een tekenreekswaarde die de naam van de afdrukserver opgeeft. Als de naam van de afdrukserver bijvoorbeeld PrintServer1 is, geeft u \\\PrintSever1 door.
- Een tekenreekswaarde die de naam van de printer opgeeft. Als bijvoorbeeld de naam van de printer Printer1 is, geeft u \\\PrintSever1\Printer1 door.
OPMERKING

De methode sendToPrinter is toegevoegd aan de AEM Forms API in versie 8.2.1.

Een afdrukstream naar een printer verzenden met de webservice-API

Een afdrukstroom naar een netwerkprinter verzenden met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost* door het IP-adres van de server die als host fungeert voor AEM Forms. *
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. Het object BLOB wordt gebruikt om formuliergegevens op te slaan.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de locatie aangeeft van het XML-bestand dat formuliergegevens bevat.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. Bepaal de lengte van de bytearray door de eigenschap Length van het System.IO.FileStream-object op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.
Stel opties voor het uitvoeren van de afdruk in.

Maak een PrintedOutputOptionsSpec-object met de constructor ervan. U kunt bijvoorbeeld het aantal exemplaren opgeven dat moet worden afgedrukt door een geheel-getalwaarde toe te wijzen die het aantal exemplaren aan het PrintedOutputOptionsSpec gegevenslid van het copies-object vertegenwoordigt.

OPMERKING

U kunt de pagineringswaarde niet instellen met het PrintedOutputOptionsSpec-gegevenslid van het object als u een ZPL-afdrukstroom genereert. pagination Evenzo kunt u de volgende opties niet instellen voor een ZPL-afdrukstroom: OutputJog, PageOffset en Stapel. Het gegevenslid pagination* is niet geldig voor het genereren van PostScript. Het is alleen geldig voor PCL-generatie. *
Een af te drukken document ophalen.
- Haal een document op dat u wilt afdrukken door de methode OutputServiceService van het object generatePrintedOutput aan te roepen en de volgende waarden door te geven:
  - Een opsommingswaarde PrintFormat die de afdrukstroom opgeeft. Als u bijvoorbeeld een PostScript-afdrukstroom wilt maken, geeft u PrintFormat.PostScript door.
  - Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
  - Een tekenreekswaarde die de locatie van verwante secundaire bestanden opgeeft, zoals afbeeldingsbestanden.
  - Een tekenreekswaarde die de locatie aangeeft van het XDC-bestand dat moet worden gebruikt.
  - Het PrintedOutputOptionsSpec-object dat afdrukomloopopties bevat die worden gebruikt bij het verzenden van een afdrukstroom naar een netwerkprinter.
  - Het object BLOB dat de XML-gegevensbron bevat die formuliergegevens bevat.
  - Een object BLOB dat is gevuld met de methode generatePrintedOutput. Met de methode generatePrintedOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
  - Een object BLOB dat is gevuld met de methode generatePrintedOutput. De methode generatePrintedOutput vult dit object met resultaatgegevens. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
  - Een OutputResult-object dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Maak een BLOB-object om naar de printer te verzenden door de waarde op te halen van de methode OutputResult van het object. generatedDoc Deze methode retourneert een BLOB-object dat PostScript-gegevens bevat die door de methode generatePrintedOutput zijn geretourneerd.
Verzend de afdrukstroom naar een netwerkprinter.

Verzend de afdrukstroom naar een netwerkprinter door de methode OutputClient van het object sendToPrinter aan te roepen en de volgende waarden door te geven:
- Een BLOB-object dat de afdrukstream vertegenwoordigt die naar de printer moet worden verzonden.
- Een PrinterProtocol opsommingswaarde die het te gebruiken printerprotocol specificeert. Als u bijvoorbeeld het SharedPrinter-protocol wilt opgeven, geeft u PrinterProtocol.SharedPrinter door.
- Een waarde bool die opgeeft of de vorige parameterwaarde moet worden gebruikt. Geef de waarde true door. (Deze parameterwaarde is alleen vereist voor aanroepen van webservices.)
- Een tekenreekswaarde die de naam van de afdrukserver opgeeft. Als bijvoorbeeld de naam van de afdrukserver PrintServer1 is, geeft u \\\PrintSever1 door.
- Een tekenreekswaarde die de naam van de printer opgeeft. Als bijvoorbeeld de naam van de printer Printer1 is, geeft u \\\PrintSever1\Printer1 door.
OPMERKING

De methode sendToPrinter is toegevoegd aan de AEM Forms API in versie 8.2.1.

Meerdere uitvoerbestanden maken

Met de service Uitvoer kunt u aparte documenten maken voor elke record in een XML-gegevensbron of één bestand dat alle records bevat (deze functionaliteit is de standaardinstelling). Stel bijvoorbeeld dat tien records zich in een XML-gegevensbron bevinden en dat u de Output-service opgeeft om voor elke record afzonderlijke PDF-documenten (of andere uitvoertypen) te maken met de Output Service API. Als gevolg hiervan genereert de uitvoerservice tien PDF-documenten. (In plaats van documenten te maken, kunt u meerdere afdrukstromen naar een printer verzenden.)

In de volgende afbeelding ziet u ook hoe de uitvoerservice een XML-gegevensbestand verwerkt dat meerdere records bevat. Stel echter dat u de uitvoerservice opgeeft één PDF-document te maken dat alle gegevensrecords bevat. In deze situatie genereert de uitvoerservice één document dat alle records bevat.

In de volgende afbeelding ziet u hoe de uitvoerservice een XML-gegevensbestand verwerkt dat meerdere records bevat. Stel dat u de uitvoerservice opgeeft een afzonderlijk PDF-document te maken voor elke gegevensrecord. In dit geval genereert de uitvoerservice een afzonderlijk PDF-document voor elke gegevensrecord.

cm_outputbatchmany

De volgende XML-gegevens laten een voorbeeld zien van een gegevensbestand dat drie gegevensrecords bevat.

 <?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>

Het XML-element dat elk gegevensrecord start en beëindigt, is LoanRecord. Naar dit XML-element wordt verwezen door de toepassingslogica die meerdere bestanden genereert.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om meerdere PDF-bestanden te maken op basis van een XML-gegevensbron:

Inclusief projectbestanden.
Maak een Output Client-object.
Verwijzen naar een XML-gegevensbron.
Stel PDF-runtime-opties in.
Stel renderingopties in.
Genereer meerdere PDF-bestanden.
Haal de resultaten van de bewerking op.

Projectbestanden opnemen

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Een uitvoerclient-object maken

Verwijzen naar een XML-gegevensbron

Verwijs naar een gegevensbron van XML die veelvoudige verslagen bevat. Een XML-element moet worden gebruikt om de gegevensrecords van elkaar te scheiden. In het voorbeeld-XML-gegevensbron dat eerder in deze sectie wordt weergegeven, krijgt het XML-element dat gegevensrecords scheidt de naam LoanRecord.

Een XML-element moet bestaan voor elk formulierveld dat u wilt vullen met gegevens. De naam van het XML-element moet overeenkomen met de veldnaam. Een XML-element wordt genegeerd als het niet overeenkomt met een formulierveld of als de naam van het XML-element niet overeenkomt met de veldnaam. Het is niet nodig de volgorde aan te passen waarin de XML-elementen worden weergegeven als alle XML-elementen zijn opgegeven.

Opties voor PDF-runtime instellen

U moet de volgende runtime opties voor de dienst van de Output plaatsen om veelvoudige dossiers tot stand te brengen die op een gegevensbron van XML worden gebaseerd:

Veel bestanden: Hiermee wordt opgegeven of de service Uitvoer één document of meerdere documenten maakt. U kunt waar of onwaar opgeven. Geef true op als u een afzonderlijk document wilt maken voor elke gegevensrecord in de XML-gegevensbron.
Bestands-URI: Hier geeft u de locatie op van de bestanden die de uitvoerservice genereert. Stel bijvoorbeeld dat u C:\Adobe\forms\Loan.pdf opgeeft. In dit geval maakt de service Uitvoer een bestand met de naam Loan.pdf en wordt het bestand in de map C:\Adobe\forms folder geplaatst. Als er meerdere bestanden zijn, zijn de bestandsnamen Loan0001.pdf, Loan0002.pdf, Loan0003.pdf enzovoort. Als u een bestandslocatie opgeeft, worden de bestanden op de server geplaatst, niet op de clientcomputer.
Recordnaam: Hiermee wordt de naam van het XML-element opgegeven in de gegevensbron die de gegevensrecords scheidt. In het voorbeeld-XML-gegevensbron dat eerder in deze sectie wordt weergegeven, wordt het XML-element dat gegevensrecords scheidt, LoanRecord genoemd. (In plaats van de runtime voor opnamen in te stellen, kunt u het niveau opnemen instellen door er een numerieke waarde aan toe te wijzen die het elementniveau aangeeft dat gegevensrecords bevat. U kunt echter alleen de recordnaam of het recordniveau instellen. U kunt niet beide waarden instellen.)

Renderopties tijdens runtime instellen

Tijdens het maken van meerdere bestanden kunt u opties voor het renderen tijdens runtime instellen. Hoewel deze opties niet vereist zijn (in tegenstelling tot uitvoeropties, die vereist zijn), kunt u taken uitvoeren zoals het verbeteren van de prestaties van de uitvoerservice. U kunt bijvoorbeeld het formulierontwerp dat de Output-service gebruikt in cache plaatsen om de prestaties te verbeteren.

Wanneer de dienst van de Output partijverslagen verwerkt, leest het gegevens die veelvoudige verslagen op een stijgende manier bevatten. Dat wil zeggen dat de Output-service de gegevens in het geheugen leest en de gegevens vrijgeeft terwijl de batch met records wordt verwerkt. De uitvoerservice laadt gegevens incrementeel wanneer een van de twee uitvoeringsopties is ingesteld. Als u de runtime van de Naam van het Verslag optie plaatst, leest de dienst van de Output gegevens op een stijgende manier. Op dezelfde manier, als u de runtime van het Niveau van het Verslag optie aan 2 of groter plaatst, leest de dienst van de Output gegevens op een stijgende manier.

Met de methode PDFOutputOptionsSpec of PrintedOutputOptionSpec van het object setLazyLoading kunt u bepalen of de uitvoerservice incrementele belasting uitvoert. U kunt de waarde false aan deze methode overgaan die stijgende lading uitzet.

Meerdere PDF-bestanden genereren

Nadat u naar een geldige XML-gegevensbron verwijst die meerdere gegevensrecords bevat en runtime-opties instelt, kunt u de uitvoerservice aanroepen, waardoor er meerdere bestanden worden gegenereerd. Bij het genereren van meerdere records retourneert de methode OutputResult van het object getGeneratedDoc null.

De resultaten van de bewerking ophalen

Nadat de dienst van de Output een verrichting uitvoert, keert het de gegevens van XML terug die specificeren of de verrichting succesvol was. De volgende XML wordt geretourneerd door de service Uitvoer. In deze situatie genereerde de uitvoerservice 42 documenten.

 <?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>

Zie ook

Meerdere PDF-bestanden maken met de Java API

Meerdere PDF-bestanden maken met de Output API (Java):

Inclusief projectbestanden"

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project. .
Een uitvoerclient-object maken
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron
- Maak een java.io.FileInputStream-object dat de XML-gegevensbron vertegenwoordigt die meerdere records bevat door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Opties voor PDF-runtime instellen
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie Veel bestanden in door de methode setGenerateManyFiles van het object PDFOutputOptionsSpec aan te roepen. Geef bijvoorbeeld de waarde true door om de uitvoerservice op te dragen een afzonderlijk PDF-bestand te maken voor elke record in de XML-gegevensbron. (Als u false doorgeeft, genereert de uitvoerservice één PDF-document dat alle records bevat.)
- Stel de optie File URI in door de methode setFileUri van het object PDFOutputOptionsSpec aan te roepen en een tekenreekswaarde door te geven die de locatie aangeeft van de bestanden die de uitvoerservice genereert. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
- Stel de optie Naam record in door de methode setRecordName van het object OutputOptionsSpec aan te roepen en een tekenreekswaarde door te geven die de naam van het XML-element opgeeft in de gegevensbron die de gegevensrecords scheidt. (Neem bijvoorbeeld de XML-gegevensbron die eerder in deze sectie wordt weergegeven. De naam van het XML-element dat gegevensrecords scheidt, is LoanRecord.)
Renderopties tijdens runtime instellen
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de uitvoerservice te verbeteren door het RenderOptionsSpec-object setCacheEnabled aan te roepen en de waarde Boolean van true door te geven.
Meerdere PDF-bestanden genereren

Genereer meerdere PDF-bestanden door de methode OutputClient van het object generatePDFOutput aan te roepen en de volgende waarden door te geven:
- A TransformationFormat enum value. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object com.adobe.idp.Document dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
De methode generatePDFOutput retourneert een OutputResult-object dat de resultaten van de bewerking bevat.
De resultaten van de bewerking ophalen
- Maak een object java.io.File dat een XML-bestand vertegenwoordigt dat de resultaten van de methode generatePDFOutput zal bevatten. Controleer of de bestandsnaamextensie .xml is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode applyUsageRights is geretourneerd).

Zie ook

Snel starten (EJB-modus): Meerdere PDF-bestanden maken met de Java API

Meerdere PDF-bestanden maken met de webservice-API

Meerdere PDF-bestanden maken met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. Het object BLOB wordt gebruikt om formuliergegevens op te slaan die meerdere records bevatten.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de bestandslocatie vertegenwoordigt van het XML-bestand dat meerdere records bevat.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.
Stel PDF-runtime-opties in.
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de optie Veel bestanden in door een Booleaanse waarde toe te wijzen aan het OutputOptionsSpec-gegevenslid van het object. generateManyFiles Wijs bijvoorbeeld de waarde true toe aan dit gegevenslid om de Output-service op te dragen een afzonderlijk PDF-bestand te maken voor elke record in de XML-gegevensbron. (Als u false toewijst aan dit gegevenslid, genereert de Output-service één PDF die alle records bevat).
- Stel de bestands-URI-optie in door een tekenreekswaarde toe te wijzen die de locatie aangeeft van de bestanden die de uitvoerservice genereert voor het OutputOptionsSpec-gegevenslid van het fileURI-object. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
- Stel de recordnaamoptie in door een tekenreekswaarde toe te wijzen die de naam van het XML-element in de gegevensbron opgeeft die de gegevensrecords scheidt van het OutputOptionsSpec-gegevenslid van het recordName-object.
- Stel de optie Kopiëren in door een geheel-getalwaarde toe te wijzen die het aantal exemplaren opgeeft dat de uitvoerservice genereert voor het OutputOptionsSpec-gegevenslid van het copies-object.
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de Output-service te verbeteren door de waarde true toe te wijzen aan het RenderOptionsSpec-gegevenslid van het cacheEnabled-object.
Genereer meerdere PDF-bestanden.

Maak meerdere PDF-bestanden door de methode generatePDFOutputvan het object OutputServiceService aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde van TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. Met de methode generatePDFOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. De methode generatePDFOutput vult dit object met resultaatgegevens.
- Een OutputResult-object dat de resultaten van de bewerking bevat.
De resultaten van de bewerking ophalen
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die een XML-bestandslocatie vertegenwoordigt die resultaatgegevens bevat. Controleer of de bestandsnaamextensie .xml is.
- Maak een bytearray met de gegevensinhoud van het BLOB-object dat met resultaatgegevens is gevuld door de methode generatePDFOutput van het OutputServiceService-object (de achtste parameter). Vul de bytearray met de waarde van het BLOB-gegevenslid van het object binaryData.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar het XML-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Zoekregels maken

U kunt zoekregels maken die ertoe leiden dat de uitvoerservice invoergegevens controleert en verschillende formulierontwerpen gebruikt op basis van de gegevensinhoud om uitvoer te genereren. Als de tekst hypotheek zich bijvoorbeeld binnen de invoergegevens bevindt, kan de Output-service een formulierontwerp gebruiken met de naam Mortgauge.xdp. Op dezelfde manier geldt dat als de tekst automobile zich in de invoergegevens bevindt, de uitvoerservice een formulierontwerp kan gebruiken dat is opgeslagen als AutomobileLoan.xdp. Hoewel de service Uitvoer verschillende uitvoertypen kan genereren, wordt er in deze sectie van uitgegaan dat de service Uitvoer een PDF-bestand genereert. In het volgende diagram ziet u de service Uitvoer die een PDF-bestand genereert door een XML-gegevensbestand te verwerken en een van de vele formulierontwerpen te gebruiken.

Daarnaast kan de Output-service documentpakketten genereren, waarbij de gegevensset meerdere records bevat en elke record overeenkomt met een formulierontwerp en er één document wordt gegenereerd dat uit meerdere formulierontwerpen bestaat.

cs_outputbatchmanyformdesigns2

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om de uitvoerservice op te dragen de zoekregels te gebruiken tijdens het genereren van een document:

Inclusief projectbestanden.
Maak een Output Client-object.
Verwijzen naar een XML-gegevensbron.
Definieer zoekregels.
Stel PDF-runtime-opties in.
Stel renderingopties in.
Genereer een PDF-document.
Haal de resultaten van de bewerking op.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Als AEM Forms wordt geïmplementeerd op een ondersteunde J2EE-toepassingsserver die geen JBoss is, moet u adobe-utilities.jar en jbossall-client.jar vervangen door JAR-bestanden die specifiek zijn voor de J2EE-toepassingsserver waarop AEM Forms wordt geïmplementeerd.

Een uitvoerclient-object maken

Voordat u programmatisch een uitvoerservicebewerking kunt uitvoeren, moet u een uitvoerservice-clientobject maken.

Verwijzen naar een XML-gegevensbron

Zoekregels definiëren

Als u zoekregels wilt definiëren, definieert u een of meer tekstpatronen waarnaar de uitvoerservices zoeken in de invoergegevens. Voor elk tekstpatroon dat u definieert, geeft u een overeenkomstig formulierontwerp op dat wordt gebruikt als het tekstpatroon zich bevindt. Als een tekstpatroon wordt gevonden, gebruikt de uitvoerservice het bijbehorende formulierontwerp om de uitvoer te genereren. Een voorbeeld van een tekstpatroon is hypotheek.

OPMERKING

Als tekstpatronen niet worden gevonden, wordt het standaardformulier gebruikt. Zorg ervoor dat alle formulierontwerpen die u gebruikt zich in de basisinhoud bevinden.

Opties voor PDF-runtime instellen

Stel de volgende PDF-runtime-opties in zodat de uitvoerservice een PDF-document kan maken op basis van meerdere formulierontwerpen:

Bestands-URI: Hier geeft u de naam en locatie op van het PDF-bestand dat de uitvoerservice genereert.
Regels: Hier geeft u de regels op die u hebt gedefinieerd.
LookAHead: Geeft het aantal bytes op dat vanaf het begin van het invoergegevensbestand moet worden gebruikt om te scannen naar de gedefinieerde tekstpatronen. De standaardwaarde is 500 bytes.

Renderopties tijdens runtime instellen

Tijdens het maken van PDF-bestanden kunt u renderingopties instellen. Hoewel deze opties niet vereist zijn (in tegenstelling tot PDF-runtime-opties), kunt u taken uitvoeren zoals het verbeteren van de prestaties van de uitvoerservice. U kunt bijvoorbeeld het formulierontwerp dat de Output-service gebruikt in cache plaatsen om de prestaties te verbeteren.

Een PDF-document genereren

Nadat u naar een geldige XML-gegevensbron hebt verwezen en runtime-opties hebt ingesteld, kunt u de uitvoerservice aanroepen, waardoor een PDF-document wordt gegenereerd. Als de uitvoerservice een opgegeven tekstpatroon opzoekt in de invoergegevens, wordt het bijbehorende formulierontwerp gebruikt. Als geen tekstpatroon wordt gebruikt, gebruikt de Output-service het standaardformulierontwerp.

De resultaten van de bewerking ophalen

Nadat de dienst van de Output een verrichting uitvoert, keert het de gegevens van XML terug die specificeren of de verrichting succesvol was.

Zie ook

Zoekregels maken met de Java API

Maak zoekregels met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Verwijzen naar een XML-gegevensbron.
- Maak een java.io.FileInputStream-object dat de XML-gegevensbron vertegenwoordigt die wordt gebruikt om het PDF-document te vullen met de constructor ervan en geef een tekenreekswaarde door die de locatie van het XML-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Definieer zoekregels.
- Maak een Rule-object met de constructor ervan.
- Definieer een tekstpatroon door de methode setPattern van het object Rule aan te roepen en een tekenreekswaarde door te geven die een tekstpatroon opgeeft.
- Definieer het bijbehorende formulierontwerp door de methode setForm van het object Rule aan te roepen. Geef een tekenreekswaarde door die de naam van het formulierontwerp aangeeft.
OPMERKING

Herhaal de vorige drie substappen voor elk tekstpatroon dat u wilt definiëren.
- Maak een java.util.List-object met behulp van een java.util.ArrayList-constructor.
- Roep voor elk Rule-object dat u hebt gemaakt de methode add van het java.util.List-object aan en geef het Rule-object door.
Stel PDF-runtime-opties in.
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Geef de naam en locatie op van het PDF-bestand dat de uitvoerservice genereert door de methode setFileURI van het object PDFOutputOptionsSpec aan te roepen. Geef een tekenreekswaarde door die de locatie van het PDF-bestand aangeeft. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
- Stel de regels in die u hebt gedefinieerd door de methode setRules van het object PDFOutputOptionsSpec aan te roepen. Geef het object java.util.List dat de objecten Rule bevat door.
- Stel het aantal bytes in dat moet worden gescand op de gedefinieerde tekstpatronen door de methode setLookAhead van het object PDFOutputOptionsSpec aan te roepen. Geef een geheel getal door dat het aantal bytes vertegenwoordigt.
Stel renderingopties in.
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de uitvoerservice te verbeteren door het RenderOptionsSpec-object op te roepen en setCacheEnabled door te geven.true
Genereer een PDF-document.

Genereer een PDF-document dat is gebaseerd op meerdere formulierontwerpen door de methode generatePDFOutput van het object OutputClient aan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde die de naam van het standaardformulierontwerp aangeeft. Dit is het formulierontwerp dat wordt gebruikt als een tekstpatroon niet wordt gevonden.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar de formulierontwerpen zich bevinden.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het com.adobe.idp.Document-object dat de formuliergegevens bevat die door de uitvoerservice worden doorzocht op de gedefinieerde tekstpatronen.
De methode generatePDFOutput retourneert een OutputResult-object dat de resultaten van de bewerking bevat.
Haal de resultaten van de bewerking op.
- Maak een com.adobe.idp.Document-object dat de status van de methode generatePDFOutput vertegenwoordigt door de methode getStatusDoc van het object OutputResult aan te roepen.
- Maak een java.io.File-object dat de resultaten van de bewerking zal bevatten. Controleer of de bestandsextensie .xml is.
- Roep de methode com.adobe.idp.Document van het object copyToFile aan om de inhoud van het object com.adobe.idp.Document naar het bestand te kopiëren (zorg dat u het object com.adobe.idp.Document gebruikt dat door de methode getStatusDoc is geretourneerd).

Zie ook

Snel starten (EJB-modus): Zoekregels maken met de Java API

Snel starten (SOAP-modus): Zoekregels maken met de Java API

Zoekregels maken met de webservice-API

Maak zoekregels met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Verwijzen naar een XML-gegevensbron.
- Maak een BLOB-object met de constructor ervan. In het object BLOB worden gegevens opgeslagen die met het PDF-document worden samengevoegd.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het te versleutelen PDF-document en de modus waarin het bestand moet worden geopend.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het BLOB-object door het MTOM-veld toe te wijzen met de inhoud van de bytearray.
Definieer zoekregels.
- Maak een Rule-object met de constructor ervan.
- Definieer een tekstpatroon door een tekenreekswaarde toe te wijzen die een tekstpatroon opgeeft voor het Rule-gegevenslid van het pattern-object.
- Definieer het corresponderende formulierontwerp door een tekenreekswaarde toe te wijzen die het formulierontwerp opgeeft aan het Rule-gegevenslid van het form-object.
OPMERKING

Herhaal de vorige drie substappen voor elk tekstpatroon dat u wilt definiëren.
- Maak een MyArrayOf_xsd_anyType-object waarin de regels zijn opgeslagen.
- Wijs elk Rule-object toe aan een element van de MyArrayOf_xsd_anyType-array. Roep de methode MyArrayOf_xsd_anyType van het object Add aan voor elk Rule-object.
Opties voor PDF-runtime instellen
- Maak een PDFOutputOptionsSpec-object met de constructor ervan.
- Stel de bestands-URI-optie in door een tekenreekswaarde toe te wijzen die de locatie aangeeft van het PDF-bestand dat de uitvoerservice genereert voor het PDFOutputOptionsSpec-gegevenslid van het fileURI-object. De optie File URI is relatief ten opzichte van de J2EE-toepassingsserver die als host fungeert voor AEM Forms, niet ten opzichte van de clientcomputer.
- Stel de optie Kopiëren in door een geheel-getalwaarde toe te wijzen die het aantal exemplaren opgeeft dat de uitvoerservice genereert voor het PDFOutputOptionsSpec-gegevenslid van het copies-object.
- Stel de regels in die u hebt gedefinieerd door het MyArrayOf_xsd_anyType-object toe te wijzen dat de regels opslaat in het PDFOutputOptionsSpec-gegevenslid van het rules-object.
- Stel het aantal bytes in dat moet worden gescand op de gedefinieerde tekstpatronen door een geheel-getalwaarde toe te wijzen die het aantal bytes vertegenwoordigt dat moet worden gescand op de gegevensmethode PDFOutputOptionsSpec van het lookAhead-object.
Renderopties tijdens runtime instellen
- Maak een RenderOptionsSpec-object met de constructor ervan.
- Plaats het formulierontwerp in de cache om de prestaties van de Output-service te verbeteren door de waarde true toe te wijzen aan het RenderOptionsSpec-gegevenslid van het cacheEnabled-object.
OPMERKING

U kunt de versie van het PDF-document niet instellen met het RenderOptionsSpec-lid van het object als het invoerdocument een Acrobat-formulier is. pdfVersion In het PDF-uitvoerdocument blijft de PDF-versie van het Acrobat-formulier behouden. U kunt de optie voor gecodeerde PDF ook niet instellen met de methode taggedPDF van het object RenderOptionsSpec als het invoerdocument een Acrobat-formulier is.

OPMERKING

U kunt de optie Gelineariseerde PDF niet instellen met het RenderOptionsSpec-lid van het object als het invoer-PDF-document is gecertificeerd of digitaal is ondertekend. linearizedPDF Zie PDF-documenten digitaal ondertekenen voor meer informatie.
Een PDF-document genereren

Maak een PDF-document door de methode OutputServiceService van het object generatePDFOutputaan te roepen en de volgende waarden door te geven:
- Een opsommingswaarde TransformationFormat. Als u een PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een tekenreekswaarde waarmee de naam van het formulierontwerp wordt opgegeven.
- Een tekenreekswaarde die de hoofdmap van de inhoud opgeeft waar het formulierontwerp zich bevindt.
- Een PDFOutputOptionsSpec-object dat PDF-runtime-opties bevat.
- Een RenderOptionsSpec-object dat renderingopties bevat.
- Het object BLOB dat de XML-gegevensbron bevat die gegevens bevat die met het formulierontwerp moeten worden samengevoegd.
- Een object BLOB dat is gevuld met de methode generatePDFOutput. Met de methode generatePDFOutput wordt dit object gevuld met gegenereerde metagegevens die het document beschrijven. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een object BLOB dat is gevuld met de methode generatePDFOutput. De methode generatePDFOutput vult dit object met resultaatgegevens. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
- Een OutputResult-object dat de resultaten van de bewerking bevat. (Deze parameterwaarde is alleen vereist voor aanroepen van een webservice.)
OPMERKING

Wanneer u een PDF-document genereert door de methode generatePDFOutput aan te roepen, moet u er rekening mee houden dat u geen gegevens kunt samenvoegen met een XFA PDF-formulier dat is ondertekend, gecertificeerd of gebruiksrechten bevat. Zie Gebruiksrechten toepassen op PDF-documenten voor informatie over gebruiksrechten.
De resultaten van de bewerking ophalen
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die een XML-bestandslocatie vertegenwoordigt die resultaatgegevens bevat. Zorg ervoor dat de bestandsextensie XML is.
- Maak een bytearray met de gegevensinhoud van het BLOB-object dat met resultaatgegevens is gevuld door de methode generatePDFOutput van het OutputServiceService-object (de achtste parameter). Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar het XML-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook

Een PDF-document samenvoegen met de Java API

PDF-documenten afvlakken

Met de service Uitvoer kunt u een interactief PDF-document transformeren naar een niet-interactieve PDF. Met een interactief PDF-document kunnen gebruikers gegevens in de PDF-documentvelden invoeren of wijzigen. Het transformeren van een interactief PDF-document naar een niet-interactief PDF-document wordt afvlakking genoemd. Wanneer een PDF-document wordt samengevoegd, kan een gebruiker de gegevens in de documentvelden niet wijzigen. Een reden om een PDF-document af te vlakken is ervoor te zorgen dat gegevens niet kunnen worden gewijzigd.

U kunt de volgende typen PDF-documenten samenvoegen:

Interactieve XFA PDF-documenten
Acrobat Forms

Als u probeert een PDF af te vlakken die een niet-interactief PDF-document is, ontstaat er een uitzondering.

OPMERKING

Voor meer informatie over de dienst van de Output, zie de Verwijzing van de Diensten voor AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om een interactief PDF-document af te vlakken naar een niet-interactief PDF-document:

Inclusief projectbestanden.
Maak een Output Client-object.
Een interactief PDF-document ophalen.
Transformeer het PDF-document.
Sla het niet-interactieve PDF-document op als een PDF-bestand.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u werkt met webservices, moet u de proxybestanden opnemen.

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-output-client.jar
adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Een uitvoerclient-object maken

Een interactief PDF-document ophalen

Haal een interactief PDF-document op dat u wilt transformeren naar een niet-interactief PDF-document. Er is een uitzondering opgetreden bij het transformeren van een niet-interactief PDF-document.

Het PDF-document transformeren

Nadat u een interactief PDF-document hebt opgehaald, kunt u het omzetten in een niet-interactief PDF-document. De service Uitvoer retourneert een niet-interactief PDF-document.

Het niet-interactieve PDF-document opslaan als een PDF-bestand

U kunt het niet-interactieve PDF-document opslaan als een PDF-bestand.

Zie ook

Een PDF-document samenvoegen met de webservice-API

Een PDF-document samenvoegen met de Java API

Een interactief PDF-document afvlakken naar een niet-interactief PDF-document met de Output API (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-output-client.jar, op in het klassenpad van uw Java-project.
Maak een Output Client-object.
- Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
- Maak een OutputClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
Een interactief PDF-document ophalen.
- Maak een java.io.FileInputStream-object dat het interactieve PDF-document vertegenwoordigt dat moet worden getransformeerd met de constructor ervan en geef een tekenreekswaarde door die de locatie van het interactieve PDF-bestand aangeeft.
- Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.
Transformeer het PDF-document.

Transformeer het interactieve PDF-document naar een niet-interactief PDF-document door de methode transformPDF van het object OutputServiceService aan te roepen en de volgende waarden door te geven:
- Het com.adobe.idp.Document-object dat het interactieve PDF-document bevat.
- A TransformationFormat enum value. Als u een niet-interactief PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een opsommingswaarde PDFARevisionNumber die het revisienummer opgeeft. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u null opgeven.
- Een tekenreekswaarde die staat voor het wijzigingsnummer en -jaar, gescheiden door een dubbele punt. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u null opgeven.
- Een opsommingswaarde PDFAConformance die het PDF/A-compatibiliteitsniveau vertegenwoordigt. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u null opgeven.
De methode transformPDF retourneert een com.adobe.idp.Document-object dat een niet-interactief PDF-document bevat.
Sla het niet-interactieve PDF-document op als een PDF-bestand.
- Maak een java.io.File-object en zorg dat de bestandsnaamextensie .pdf is.
- Roep de methode Document van het object copyToFile aan om de inhoud van het object Document naar het bestand te kopiëren (zorg dat u het object Document gebruikt dat door de methode transformPDF is geretourneerd).

Zie ook

Snel starten (EJB-modus): Een PDF-document transformeren met de Java API

Snel starten (SOAP-modus): Een PDF-document transformeren met de Java API

Een PDF-document samenvoegen met de webservice-API

Een interactief PDF-document afvlakken naar een niet-interactief PDF-document met de Output API (webservice):

Inclusief projectbestanden.

Creeer een project van Microsoft .NET dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/OutputService?WSDL&lc_version=9.0.1.

OPMERKING

Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.
Maak een Output Client-object.
- Maak een OutputServiceClient-object met de standaardconstructor.
- Maak een OutputServiceClient.Endpoint.Address-object met de constructor System.ServiceModel.EndpointAddress. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/OutputService?blob=mtom). U hoeft het lc_version-kenmerk niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Geef ?blob=mtom echter op om MTOM te gebruiken.
- Maak een System.ServiceModel.BasicHttpBinding-object door de waarde van het veld OutputServiceClient.Endpoint.Binding op te halen. Cast de terugkeerwaarde aan BasicHttpBinding.
- Stel het veld System.ServiceModel.BasicHttpBinding van het object MessageEncoding in op WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam voor het AEM aan het veld OutputServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de overeenkomstige wachtwoordwaarde aan het gebied OutputServiceClient.ClientCredentials.UserName.Password toe.
  - Wijs de constante waarde HttpClientCredentialType.Basic aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType toe.
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly aan het veld BasicHttpBindingSecurity.Security.Mode toe.
Een interactief PDF-document ophalen.
- Maak een BLOB-object met de constructor ervan. Met het object BLOB wordt het interactieve PDF-document opgeslagen.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het interactieve PDF-document vertegenwoordigt.
- Maak een bytearray waarin de inhoud van het object System.IO.FileStream wordt opgeslagen. U kunt de grootte van de bytearray bepalen door de eigenschap System.IO.FileStream van het object Length op te halen.
- Vul de bytearray met streamgegevens door de methode Read van het object System.IO.FileStream aan te roepen en de bytearray, de startpositie en de lengte van de stream door te geven om te lezen.
- Vul het object BLOB door de eigenschap MTOM ervan toe te wijzen met de inhoud van de bytearray.
Transformeer het PDF-document.

Transformeer het interactieve PDF-document naar een niet-interactief PDF-document door de methode transformPDF van het object OutputClient aan te roepen en de volgende waarden door te geven:
- Een BLOB-object dat het interactieve PDF-document bevat.
- Een opsommingswaarde TransformationFormat. Als u een niet-interactief PDF-document wilt genereren, geeft u TransformationFormat.PDF op.
- Een opsommingswaarde PDFARevisionNumber die het revisienummer opgeeft.
- Een Booleaanse waarde die opgeeft of de opsommingswaarde PDFARevisionNumber wordt gebruikt. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u false opgeven.
- Een tekenreekswaarde die staat voor het wijzigingsnummer en -jaar, gescheiden door een dubbele punt. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u null opgeven.
- Een opsommingswaarde PDFAConformance die het PDF/A-compatibiliteitsniveau vertegenwoordigt.
- Booleaanse waarde die opgeeft of de opsommingswaarde PDFAConformance wordt gebruikt. Omdat deze parameter voor een PDF/A-document is bedoeld, kunt u false opgeven.
De methode transformPDF retourneert een BLOB-object dat een niet-interactief PDF-document bevat.
Sla het niet-interactieve PDF-document op als een PDF-bestand.
- Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie van het niet-interactieve PDF-document vertegenwoordigt.
- Maak een bytearray met de gegevensinhoud van het object BLOB dat door de methode transformPDF is geretourneerd. Vul de bytearray met de waarde van het BLOB-gegevenslid van het object MTOM.
- Maak een System.IO.BinaryWriter-object door de constructor ervan aan te roepen en het object System.IO.FileStream door te geven.
- Schrijf de inhoud van de bytearray naar een PDF-bestand door de methode Write van het object System.IO.BinaryWriter aan te roepen en de bytearray door te geven.

Zie ook