Postscript converteren naar PDF-documenten

Informatie over de Distiller-service

De Distiller® service converteert PostScript®-, Encapsulated PostScript- (EPS) en PRN-bestanden naar compacte, betrouwbare en veiligere PDF-bestanden via een netwerk. De Distiller-service wordt vaak gebruikt om grote hoeveelheden gedrukte documenten om te zetten in elektronische documenten, zoals facturen en verklaringen. Door documenten naar PDF te converteren, kunnen bedrijven hun klanten ook een papieren versie en een elektronische versie van een document sturen.

OPMERKING

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

PostScript converteren naar PDF-documenten

In dit onderwerp wordt beschreven hoe u de Distiller Service API (Java en webservice) kunt gebruiken voor het programmatisch converteren van PostScript (PS)-, Encapsulated PostScript- (EPS) en PRN-bestanden naar PDF-documenten.

OPMERKING

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

OPMERKING

Als u PostScript-bestanden naar PDF-documenten wilt converteren, moet u een van de volgende opties installeren op de server die als host fungeert voor AEM Forms: Acrobat 9 of Microsoft Visual C++ 2005 redistributable pakket.

Overzicht van stappen

Voer de volgende stappen uit als u een van de ondersteunde typen wilt converteren naar een PDF-document:

  1. Inclusief projectbestanden.
  2. Maak een Distiller-serviceclient.
  3. Haal het te converteren bestand op.
  4. De PDF-ontwerpbewerking aanroepen.
  5. Sla het PDF-document 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 Distiller-serviceclient maken

Voordat u een Distiller-servicebewerking programmatisch kunt uitvoeren, moet u een Distiller-serviceclient maken. Als u de Java API gebruikt, maakt u een DistillerServiceClient-object. Als u de webservice-API gebruikt, maakt u een DistillerServiceService-object.

Het te converteren bestand ophalen

U moet het bestand ophalen dat u wilt converteren. Als u bijvoorbeeld een PS-bestand naar een PDF-document wilt converteren, moet u het PS-bestand ophalen.

De PDF-ontwerpbewerking aanroepen

Nadat u de serviceclient hebt gemaakt, kunt u het maken van de PDF vervolgens activeren. Voor deze bewerking is informatie nodig over het document dat moet worden geconverteerd, inclusief het pad naar het doeldocument.

Het PDF-document opslaan

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

Zie ook

Een PostScript-bestand converteren naar PDF met de Java API

Een PostScript-bestand converteren naar PDF met de webservice-API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Uitvoerservice-API - Snel starten

Een PostScript-bestand converteren naar PDF met de Java API

Een PostScript-bestand converteren naar PDF-document met de Distiller Service API (Java):

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-distiller-client.jar, op in het klassenpad van uw Java-project.

  2. Maak een Distiller-serviceclient.

    • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
    • Maak een DistillerServiceClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.

  3. Haal het te converteren bestand op.

    • Maak een java.io.FileInputStream-object dat het te converteren bestand vertegenwoordigt met de constructor ervan en geef een tekenreekswaarde door die de locatie van het bestand aangeeft.
    • Maak een com.adobe.idp.Document-object door de constructor ervan te gebruiken en het object java.io.FileInputStream door te geven.

  4. De PDF-ontwerpbewerking aanroepen.

    Roep de methode createPDF van het object DistillerServiceClient aan en geef de volgende waarden door:

    • Het com.adobe.idp.Document-object dat staat voor het PS-, EPS- of PRN-bestand dat moet worden omgezet
    • Een java.lang.String-object dat de naam bevat van het bestand dat moet worden omgezet
    • Een java.lang.String-object dat de naam bevat van de Adobe PDF-instellingen die moeten worden gebruikt
    • Een java.lang.String-object dat de naam bevat van de beveiligingsinstellingen die moeten worden gebruikt
    • Een optioneel com.adobe.idp.Document-object dat instellingen bevat die moeten worden toegepast tijdens het genereren van het PDF-document
    • Een optioneel com.adobe.idp.Document-object dat metagegevens bevat die op het PDF-document moeten worden toegepast

    De methode createPDF retourneert een CreatePDFResult-object dat het nieuwe PDF-document en een logbestand bevat dat kan worden gegenereerd. Het logbestand bevat doorgaans fout- of waarschuwingsberichten die worden gegenereerd door de conversieaanvraag.

  5. Sla het PDF-document op.

    Voer de volgende handelingen uit om het nieuwe PDF-document te verkrijgen:

    • Roep de methode CreatePDFResult van het object getCreatedDocument aan. Dit retourneert een com.adobe.idp.Document-object.
    • Roep de methode com.adobe.idp.Document van het object copyToFile aan om het PDF-document uit te pakken.

    Op dezelfde manier om het logboekdocument te verkrijgen, voer de volgende acties uit.

    • Roep de methode CreatePDFResult van het object getLogDocument aan. Dit retourneert een com.adobe.idp.Document-object.
    • Roep de methode com.adobe.idp.Document van het object copyToFile aan om het logdocument te extraheren.

Zie ook

Overzicht van de stappen

Snel starten (SOAP-modus): Een PostScript-bestand converteren naar een PDF-document met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een PostScript-bestand converteren naar PDF met de webservice-API

Een PostScript-bestand converteren naar PDF-document met de Distiller Service API (webservice):

  1. 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/DistillerService?WSDL&lc_version=9.0.1.

    OPMERKING

    Vervang localhost door het IP-adres van de server die als host fungeert voor AEM Forms.

  2. Maak een Distiller-serviceclient.

    • Maak een DistillerServiceClient-object met de standaardconstructor.

    • Maak een DistillerServiceClient.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/DistillerService?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 DistillerServiceClient.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 DistillerServiceClient.ClientCredentials.UserName.UserName toe.
      • Wijs de overeenkomstige wachtwoordwaarde aan het gebied DistillerServiceClient.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.

  3. Haal het te converteren bestand op.

    • Maak een BLOB-object met de constructor ervan. Met dit BLOB-object wordt het bestand opgeslagen dat naar een PDF-document moet worden geconverteerd.
    • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen en een tekenreekswaarde door te geven die de bestandslocatie en de modus vertegenwoordigt 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 object BLOB door de eigenschap MTOM ervan toe te wijzen met de inhoud van de bytearray.

  4. De PDF-ontwerpbewerking aanroepen.

    Roep de methode CreatePDF2 van het object DistillerServiceService aan en geef de volgende vereiste waarden door:

    • Het BLOB-object dat het te converteren PS-bestand vertegenwoordigt
    • Een tekenreeks die de padnaam bevat van het bestand dat moet worden omgezet
    • Een tekenreeksobject dat de Adobe PDF-instellingen bevat die moeten worden gebruikt (bijvoorbeeld Standard)
    • Een tekenreeksobject dat de beveiligingsinstellingen bevat die moeten worden gebruikt (bijvoorbeeld No Security)
    • Een optioneel BLOB-object dat instellingen bevat die moeten worden toegepast tijdens het genereren van het PDF-document
    • Een optioneel BLOB-object dat metagegevens bevat die op het PDF-document moeten worden toegepast
    • Een BLOB-uitvoerparameter die wordt gebruikt om het PDF-document op te slaan
    • Een BLOB outputparameter die wordt gebruikt om het logboek op te slaan

  5. Sla het PDF-document op.

    • Maak een System.IO.FileStream-object door de constructor ervan aan te roepen. Geef een tekenreekswaarde door die staat voor de bestandslocatie van het ondertekende PDF-document en de modus waarin het bestand moet worden geopend.
    • Maak een bytearray die de inhoud opslaat van het BLOB-object dat door de methode CreatePDF2 (de uitvoerparameter) 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

Overzicht van de stappen

AEM Forms aanroepen met MTOM

AEM Forms aanroepen met SwaRef

Op deze pagina