PDF omzetten in PostScript- en afbeeldingsbestanden converting-pdf-to-postscript-andimage-files
Over de Convert PDF Service
Met de service PDF converteren worden PDF-documenten geconverteerd naar PostScript en naar een aantal afbeeldingsindelingen (JPEG, JPEG 2000, PNG en TIFF). Het converteren van een PDF-document naar PostScript is handig voor afdrukken op basis van een server zonder toezicht op elke PostScript-printer. Het omzetten van een PDF-document in een TIFF-bestand met meerdere pagina's is handig bij het archiveren van documenten in systemen voor inhoudsbeheer die geen ondersteuning bieden voor PDF-documenten.
U kunt deze taken uitvoeren met de service PDF converteren:
-
PDF-documenten converteren naar PostScript.
-
Zet PDF-documenten om in afbeeldingsindelingen.
note note NOTE Voor meer informatie over de dienst van de PDF van de Bekeerling, zie Services Reference for AEM Forms.
PDF-documenten converteren naar PostScript converting-pdf-documents-to-postscript
In dit onderwerp wordt beschreven hoe u de API voor PDF-service converteren (Java en webservice) kunt gebruiken om PDF-documenten programmatisch om te zetten in PostScript-bestanden. Het PDF-document dat wordt geconverteerd naar een PostScript-bestand, moet een niet-interactief PDF-document zijn. Dit betekent dat als u probeert een interactief PDF-document om te zetten in een PostScript-bestand, een uitzondering wordt gegenereerd.
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om een PDF-document om te zetten in een PostScript-bestand:
- Inclusief projectbestanden.
- Maak een Convert PDF service-client.
- Verwijs naar het PDF-document dat u wilt converteren naar een PostScript-bestand.
- Stel opties voor de uitvoering van de conversie in.
- Zet het PDF-document om in een PostScript-bestand.
- Sla het PostScript-bestand 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 de proxybestanden opnemen.
Een Convert PDF-client maken
Voordat u programmatically een Convert PDF de dienstverrichting kunt uitvoeren, moet u een Convert de dienstcliënt van de PDF tot stand brengen. Als u de Java API gebruikt, maakt u een ConvertPdfServiceClient
object. Als u de webservice-API gebruikt, maakt u een ConvertPDFServiceService
object.
Deze sectie gebruikt webservicefunctionaliteit die in AEM Forms is geïntroduceerd. Als u toegang wilt tot nieuwe functionaliteit, moet u het proxyobject maken met de lc_version
kenmerk. (Zie "Toegang tot nieuwe functionaliteit met behulp van webservices" in AEM Forms aanroepen met webservices.)
Verwijs naar het PDF-document dat u wilt converteren naar een PostScript-bestand
Verwijs naar het PDF-document dat u naar een PostScript-bestand wilt converteren. Zoals eerder in dit onderwerp is vermeld, moet het PDF-document een niet-interactief PDF-document zijn. Als u probeert een interactief PDF-document om te zetten in een PostScript-bestand, wordt een uitzondering gegenereerd.
Uitvoeringsopties voor conversie instellen
Wanneer u een PDF-document naar een PostScript-bestand converteert, kunt u runtime-opties definiëren waarmee het PostScript-type wordt opgegeven dat wordt gemaakt. U kunt bijvoorbeeld een PostScript-bestand van niveau 3 definiëren.
Doorgaans geeft het gegenereerde PostScript-bestand de grootte van het invoer-PDF-document aan. Als u ShrinkToFit
(waardoor de uitvoer van het PostScript-bestand wordt verkleind zodat het op de pagina past), ziet u geen verschil tussen het invoerdocument en het gegenereerde PostScript-PDF-bestand. De ShrinkToFit
Deze optie is alleen van kracht als u ervoor kiest om af te drukken op een kleiner paginaformaat dan het invoerdocument PDF. Als u een kleiner paginaformaat wilt selecteren, definieert u de optie PageSize
optie. Daarnaast wordt u aangeraden het RotateAndCenter
optie voor true
om de juiste PostScript-uitvoer te verkrijgen.
En als u de optie ExpandToFit
(waarmee de uitvoer van het PostScript-bestand wordt uitgebreid zodat het op de pagina past), heeft deze optie alleen effect als u ervoor kiest om af te drukken op een grotere pagina dan het invoerdocument PDF. Als u een groter paginaformaat wilt selecteren, definieert u de optie PageSize
optie. Daarnaast wordt u aangeraden het RotateAndCenter
optie voor true
om de juiste PostScript-uitvoer te verkrijgen.
ToPSOptionsSpec
klasseverwijzing in AEM Forms API-naslag.Het PDF-document converteren naar een PostScript-bestand
Nadat u de de dienstcliënt creeert en runtime opties plaatst, kunt u de de omzettingsverrichting van PostScript aanhalen. Voor deze bewerking is informatie nodig over het document dat moet worden geconverteerd, inclusief het PostScript-niveau dat bij voorkeur voor het doeldocument wordt gebruikt.
Het PostScript-bestand opslaan
Nadat u het PDF-document hebt omgezet in PostScript, kunt u de uitvoer opslaan als een PostScript-bestand.
Zie ook
Een PDF-document naar PS converteren met de Java API
Een PDF-document naar PS converteren met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Snel aan de slag met de PDF Service API
Een PDF-document naar PS converteren met de Java API convert-a-pdf-document-to-ps-using-the-java-api
Converteer een PDF-document naar PostScript met de Java-API (Convert PDF Service):
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-convertpdf-client.jar, op in het klassenpad van uw Java-project.
-
Maak een Convert PDF-client.
- Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
ConvertPdfServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
Verwijs naar het PDF-document dat u wilt converteren naar een PostScript-bestand.
- Een
java.io.FileInputStream
-object door de constructor ervan te gebruiken en een tekenreekswaarde door te geven die de locatie aangeeft van het PDF-document dat moet worden omgezet. - Een
com.adobe.idp.Document
object dat het PDF-document opslaat met het gereedschapcom.adobe.idp.Document
constructor. Geef dejava.io.FileInputStream
object dat het PDF-document bevat.
- Een
-
Stel opties voor de uitvoering van de conversie in.
- Een
ToPSOptionsSpec
object door de constructor ervan aan te roepen. - Stel runtime-opties in door een geschikte methode aan te roepen die tot de
ToPSOptionsSpec
object. Als u bijvoorbeeld het PostScript-niveau wilt definiëren dat wordt gemaakt, roept u hetToPSOptionsSpec
objectsetPsLevel
methode en eenPSLevel
opsommingswaarde die het PostScript-niveau opgeeft. Voor informatie over alle runtime waarden die u kunt instellen, raadpleegt u deToPSOptionsSpec
klasseverwijzing in AEM Forms API-naslag.
- Een
-
Zet het PDF-document om in een PostScript-bestand.
De
ConvertPdfServiceClient
objecttoPS2
en geeft de volgende waarden door:- A
com.adobe.idp.Document
object dat staat voor het PDF-document dat naar een PostScript-bestand moet worden geconverteerd. - A
ToPSOptionsSpec
object dat opties voor PostScript-runtime opgeeft.
De
toPS2
methode retourneert eenDocument
-object dat het nieuwe PostScript-document bevat. - A
-
Sla het PostScript-bestand op.
- Een
java.io.File
-object en zorg ervoor dat de bestandsnaamextensie .ps is. - De
Document
objectcopyToFile
methode om de inhoud van deDocument
object naar het bestand (gebruik deDocument
object dat is geretourneerd door detoPS2
methode).
- Een
Zie ook
Snel starten (SOAP-modus): Een PDF-document converteren naar PostScript met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een PDF-document naar PS converteren met de webservice-API convert-a-pdf-document-to-ps-using-the-web-service-api
Converteer een PDF-document naar PostScript met de Convert PDF Service API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.note note NOTE Vervangen localhost
met het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een Convert PDF-client.
-
Een
ConvertPdfServiceClient
object met de standaardconstructor. -
Een
ConvertPdfServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/ConvertPDFService?blob=mtom
.) U hoeft delc_version
kenmerk. Geef echter?blob=mtom
. -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenConvertPdfServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld naarWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld toe
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Verwijs naar het PDF-document dat u wilt converteren naar een PostScript-bestand.
- Een
BLOB
object met behulp van de constructor. DeBLOB
-object wordt gebruikt om een PDF-document op te slaan dat naar een PostScript-bestand wordt geconverteerd. - Een
System.IO.FileStream
-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie vertegenwoordigt van het PDF-document dat moet worden omgezet en de modus waarin het bestand moet worden geopend. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. U kunt de grootte van de bytearray bepalen door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
en het doorgeven van de bytearray, de startpositie en de streamlengte om te lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
veld met de inhoud van de bytearray.
- Een
-
Stel opties voor de uitvoering van de conversie in.
- Een
ToPSOptionsSpec
object door de constructor ervan aan te roepen. - Stel runtime-opties in door een waarde toe te wijzen aan de
ToPSOptionsSpec
gegevenslid van object. Als u bijvoorbeeld het PostScript-niveau wilt definiëren dat wordt gemaakt, wijst u eenPSLevel
opsommingswaarde voor deToPSOptionsSpec
objectpsLevel
lid.
- Een
-
Zet het PDF-document om in een PostScript-bestand.
De
GeneratePDFServiceService
objecttoPS2
en geeft de volgende waarden door:- A
BLOB
object dat staat voor het PDF-document dat naar een PostScript-bestand moet worden geconverteerd - A
ToPSOptionsSpec
object dat uitvoeringsopties opgeeft
Nadat de conversie is voltooid, extraheert u de binaire gegevens die het PostScript-document vertegenwoordigen door het document te openen
BLOB
objectMTOM
eigenschap. Hiermee wordt een bytearray geretourneerd die u naar een PostScript-bestand kunt schrijven. - A
-
Sla het PostScript-bestand op.
- Een
System.IO.FileStream
object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de bestandslocatie van het PS-bestand vertegenwoordigt. - Maak een bytearray waarin de gegevensinhoud van de
BLOB
object dat is geretourneerd door deencryptPDFUsingPassword
methode. Vul de bytearray met de waarde van deBLOB
objectMTOM
veld. - Een
System.IO.BinaryWriter
object door de constructor aan te roepen en deSystem.IO.FileStream
object. - Schrijf de inhoud van de bytearray naar het PostScript-bestand door het
System.IO.BinaryWriter
objectWrite
en geeft u de bytearray door.
- Een
Zie ook
AEM Forms aanroepen met SwaRef
PDF-documenten omzetten in afbeeldingsindelingen converting-pdf-documents-to-image-formats
Met de service PDF converteren kunt u PDF-documenten programmatisch converteren naar afbeeldingsindelingen, zoals JPEG, JPEG 2000, TIFF en PNG. Door een PDF-document om te zetten in een afbeeldingsbestand, kunt u het PDF-document gebruiken als een afbeeldingsbestand. U kunt het image bijvoorbeeld in een inhoudbeheersysteem voor bedrijven plaatsen voor opslag.
Wanneer u een PDF-document omzet in een afbeelding, maakt de service PDF omzetten een aparte afbeelding voor elke pagina in het document. Met andere woorden, als het document uit 20 pagina's bestaat, maakt de service PDF converteren 20 afbeeldingsbestanden. Wanneer u een PDF-document omzet in een afbeeldingsindeling, kunt u afzonderlijke afbeeldingen maken voor elke pagina in het PDF-document of één afbeeldingsbestand voor het gehele PDF-document.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om een PDF-document te converteren naar een van de ondersteunde typen:
- Inclusief projectbestanden.
- Maak een Convert PDF service-client.
- Haal het PDF-document op dat u wilt converteren.
- Stel runtime-opties in.
- Zet de PDF om in een afbeelding.
- Haal de afbeeldingsbestanden op uit een verzameling.
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 de proxybestanden opnemen.
Een Convert PDF-client maken
Voordat u programmatically een Convert PDF de dienstverrichting kunt uitvoeren, moet u een Convert de dienstcliënt van de PDF tot stand brengen. Als u de Java API gebruikt, maakt u een ConvertPdfServiceClient
object. Als u de webservice-API gebruikt, maakt u een ConvertPDFServiceService
object.
Het te converteren PDF-document ophalen
U moet het PDF-document opvragen om het naar een afbeelding om te zetten. U kunt een interactief PDF-document niet omzetten in een afbeelding. Wanneer u dit probeert, wordt een uitzondering gegenereerd. Als u een interactief PDF-document wilt converteren naar een afbeeldingsbestand, moet u het PDF-document samenvoegen voordat u het converteert. (Zie PDF-documenten afvlakken.)
Uitvoeringsopties instellen
U moet runtime opties instellen, zoals de afbeeldingsindeling en de resolutiewaarden. Voor informatie over de runtime waarden, zie ToImageOptionsSpec
klasseverwijzing in AEM Forms API-naslag.
De PDF omzetten in een afbeelding
Nadat u de de dienstcliënt creeert en runtime opties plaatst, kunt u het document van de PDF in een beeld omzetten. Een verzamelingsobject dat de afbeeldingen bevat, wordt geretourneerd.
De afbeeldingsbestanden ophalen uit een verzameling
U kunt afbeeldingsbestanden ophalen uit een verzamelingsobject dat wordt geretourneerd door de service PDF converteren. Elk element in de verzameling is een com.adobe.idp.Document
instantie (of een BLOB
-instantie als u webservices gebruikt) die u kunt opslaan als afbeeldingsbestand, zoals een JPG-bestand.
De indeling van het afbeeldingsbestand is afhankelijk van de ImageConvertFormat
uitvoeringsoptie. Dat wil zeggen, als u de ImageConvertFormat
runtime-optie voor ImageConvertFormat.JPEG
kunt u afbeeldingsbestanden opslaan als JPG-bestanden.
Zie ook
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Snel aan de slag met de PDF Service API
Een PDF-document converteren naar afbeeldingsbestanden met de Java API convert-a-pdf-document-to-image-files-using-the-java-api
Een PDF-document converteren naar een afbeeldingsindeling met de API (Java) voor de convertservice PDF:
-
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-convertpdf-client.jar, op in het klassenpad van uw Java-project.
-
Maak een Convert PDF-client.
- Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
ConvertPdfServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
Haal het PDF-document op dat u wilt converteren.
- Een
java.io.FileInputStream
object dat staat voor het PDF-document dat moet worden geconverteerd met de constructor ervan en dat een tekenreekswaarde doorgeeft die de locatie van het PDF-document aangeeft. - Een
com.adobe.idp.Document
object door de constructor ervan te gebruiken en door te gevenjava.io.FileInputStream
object.
- Een
-
Stel runtime-opties in.
- Een
ToImageOptionsSpec
object met behulp van de constructor. - Roep de vereiste methoden aan die bij dit object horen. Stel bijvoorbeeld het afbeeldingstype in door het
setImageConvertFormat
methode en eenImageConvertFormat
enum-waarde die het indelingstype aangeeft.
note note NOTE De instelling ImageConvertFormat
opsommingswaarde is verplicht. - Een
-
Zet de PDF om in een afbeelding.
De
ConvertPdfServiceClient
objecttoImage2
en geeft de volgende waarden door:- A
com.adobe.idp.Document
object dat staat voor het PDF-bestand dat moet worden omgezet. - A
com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec
-object dat de verschillende voorkeuren voor de indeling van de doelafbeelding bevat.
De
toImage2
methode retourneert eenjava.util.List
object dat afbeeldingen bevat. Elk element in de verzameling is eencom.adobe.idp.Document
-instantie. - A
-
Haal de afbeeldingsbestanden op uit een verzameling.
Doorlopen
java.util.List
om te bepalen of er afbeeldingen aanwezig zijn. Elk element is eencom.adobe.idp.Document
-instantie. Sla de afbeelding op door decom.adobe.idp.Document
objectcopyToFile
methode en eenjava.io.File
object.
Zie ook
Snel starten (SOAP-modus): Een PDF-document converteren naar JPEG-bestanden met de Java API
Een PDF-document converteren naar afbeeldingsbestanden met de webservice-API convert-a-pdf-document-to-image-files-using-the-web-service-api
Een PDF-document converteren naar een afbeeldingsindeling met de Convert PDF Service API (webservice):
-
Inclusief projectbestanden.
Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt:
http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1
.note note NOTE Vervangen localhost
met het IP-adres van de server die als host fungeert voor AEM Forms. -
Maak een PDF-client voor omzetten.
-
Een
ConvertPdfServiceClient
object met de standaardconstructor. -
Een
ConvertPdfServiceClient.Endpoint.Address
object gebruikenSystem.ServiceModel.EndpointAddress
constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeldhttp://localhost:8080/soap/services/ConvertPDFService?blob=mtom
.) U hoeft delc_version
kenmerk. Geef echter?blob=mtom
. -
Een
System.ServiceModel.BasicHttpBinding
object door de waarde van het object op te halenConvertPdfServiceClient.Endpoint.Binding
veld. De geretourneerde waarde omzetten inBasicHttpBinding
. -
Stel de
System.ServiceModel.BasicHttpBinding
objectMessageEncoding
veld naarWSMessageEncoding.Mtom
. Deze waarde zorgt ervoor dat MTOM wordt gebruikt. -
Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
- Wijs de gebruikersnaam van het AEM aan het veld toe
ConvertPdfServiceClient.ClientCredentials.UserName.UserName
. - De bijbehorende wachtwoordwaarde aan het veld toewijzen
ConvertPdfServiceClient.ClientCredentials.UserName.Password
. - De constante waarde toewijzen
HttpClientCredentialType.Basic
naar het veldBasicHttpBindingSecurity.Transport.ClientCredentialType
. - De constante waarde toewijzen
BasicHttpSecurityMode.TransportCredentialOnly
naar het veldBasicHttpBindingSecurity.Security.Mode
.
- Wijs de gebruikersnaam van het AEM aan het veld toe
-
-
Haal het PDF-document op dat u wilt converteren.
- Een
BLOB
object met behulp van de constructor. DitBLOB
wordt gebruikt om het PDF-formulier op te slaan. - Een
System.IO.FileStream
object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die de locatie aangeeft van het PDF-formulier en de modus waarin het bestand moet worden geopend. - Maak een bytearray waarin de inhoud van de
System.IO.FileStream
object. Bepaal de grootte van de bytearray door deSystem.IO.FileStream
objectLength
eigenschap. - De bytearray vullen met streamgegevens door de
System.IO.FileStream
objectRead
methode. Geef de bytearray, de startpositie en de streamlengte door om te lezen. - Vul de
BLOB
object door het toe te wijzenMTOM
veld met de inhoud van de bytearray.
- Een
-
Stel runtime-opties in.
- Een
ToImageOptionsSpec
object met behulp van de constructor. - Roep de vereiste methoden aan die bij dit object horen. Stel bijvoorbeeld het afbeeldingstype in door het
setImageConvertFormat
methode en eenImageConvertFormat
opsommingswaarde die het opmaaktype aangeeft.
note note NOTE De instelling ImageConvertFormat
opsommingswaarde is verplicht. - Een
-
Zet de PDF om in een afbeelding.
De
ConvertPDFServiceService
objecttoImage2
en geeft de volgende waarden door:- A
BLOB
object dat staat voor het bestand dat moet worden omgezet - A
ToImageOptionsSpec
object dat de verschillende voorkeuren voor de indeling van de doelafbeelding bevat
De
toImage2
methode retourneert eenMyArrayOfBLOB
-object dat de nieuwe afbeeldingsbestanden bevat. - A
-
Haal de afbeeldingsbestanden op uit een verzameling.
- Het aantal elementen in het dialoogvenster
MyArrayOfBLOB
object door de waarde van het object op te halenCount
veld. Elk element is eenBLOB
object dat de afbeelding bevat. - Doorlopen
MyArrayOfBLOB
objecten maken en elk afbeeldingsbestand opslaan.
- Het aantal elementen in het dialoogvenster
Zie ook
AEM Forms aanroepen met SwaRef