Konverterar PostScript till PDF-dokument converting-postscript-to-pdf-documents

Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.

Om Distiller-tjänsten about-the-distiller-service

Distiller®-tjänsten konverterar filer från PostScript®, Encapsulated PostScript (EPS) och PRN till kompakta, tillförlitliga och säkrare PDF över ett nätverk. Distiller-tjänsten används ofta för att konvertera stora volymer tryckta dokument till elektroniska dokument, som fakturor och kontoutdrag. När man konverterar dokument till PDF kan man också skicka en pappersversion och en elektronisk version av ett dokument till sina kunder.

NOTE
Mer information om tjänsten Distiller finns i Tjänstreferens för AEM Forms.

Konvertera PostScript till PDF-dokument converting-postscript-to-pdf-documents-inner

I det här avsnittet beskrivs hur du kan använda Distiller Service API (Java och webbtjänst) för att programmässigt konvertera PostScript- (PS), Encapsulated PostScript- (EPS) och PRN-filer till PDF-dokument.

NOTE
Mer information om tjänsten Distiller finns i Tjänstreferens för AEM Forms.
NOTE
Om du vill konvertera PostScript-filer till PDF-dokument måste något av följande vara installerat på den server som är värd för AEM Forms: Acrobat 9 eller Microsoft Visual C++ 2005 återdistribuerbart paket.

Sammanfattning av steg summary-of-steps

Gör så här om du vill konvertera någon av de typer som stöds till ett PDF-dokument:

  1. Inkludera projektfiler.
  2. Skapa en Distiller-tjänstklient.
  3. Hämta filen som ska konverteras.
  4. Anropa åtgärden att skapa PDF.
  5. Spara dokumentet PDF.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du ta med proxyfilerna.

Skapa en Distiller-tjänstklient

Innan du programmässigt kan utföra en Distiller-tjänståtgärd måste du skapa en Distiller-tjänstklient. Om du använder Java API skapar du ett DistillerServiceClient-objekt. Om du använder webbtjänstens API skapar du ett DistillerServiceService-objekt.

Hämta filen som ska konverteras

Hämta filen som du vill konvertera. Om du till exempel vill konvertera en PS-fil till ett PDF-dokument måste du hämta PS-filen.

Anropa skapandeåtgärden för PDF

När du har skapat tjänstklienten kan du sedan starta åtgärden Skapa PDF. Den här åtgärden kräver information om dokumentet som ska konverteras, inklusive sökvägen till måldokumentet.

Spara PDF-dokumentet

Du kan spara PDF-dokumentet som en PDF-fil.

Se även

Konvertera en PostScript-fil till PDF med Java API

Konvertera en PostScript-fil till PDF med hjälp av webbtjänstens API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Snabbstart för Output Service API

Konvertera en PostScript-fil till PDF med Java API convert-a-postscript-file-to-pdf-using-the-java-api

Konvertera en PostScript-fil till PDF-dokument med hjälp av Distiller Service API (Java):

  1. Inkludera projektfiler.

    Inkludera JAR-klientfiler, som adobe-distiller-client.jar, i Java-projektets klassökväg.

  2. Skapa en Distiller-tjänstklient.

    • Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
    • Skapa ett DistillerServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
  3. Hämta filen som ska konverteras.

    • Skapa ett java.io.FileInputStream-objekt som representerar filen som ska konverteras med hjälp av dess konstruktor och skicka ett strängvärde som anger filens plats.
    • Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
  4. Anropa åtgärden att skapa PDF.

    Anropa DistillerServiceClient-objektets createPDF-metod och skicka följande värden:

    • Objektet com.adobe.idp.Document som representerar PS-, EPS- eller PRN-filen som ska konverteras
    • Ett java.lang.String-objekt som innehåller namnet på filen som ska konverteras
    • Ett java.lang.String-objekt som innehåller namnet på de Adobe PDF-inställningar som ska användas
    • Ett java.lang.String-objekt som innehåller namnet på säkerhetsinställningarna som ska användas
    • Ett valfritt com.adobe.idp.Document-objekt som innehåller inställningar som ska användas när PDF-dokumentet genereras
    • Ett valfritt com.adobe.idp.Document-objekt som innehåller metadatainformation som ska användas i PDF-dokumentet

    Metoden createPDF returnerar ett CreatePDFResult-objekt som innehåller det nya PDF-dokumentet och en loggfil som kan genereras. Loggfilen innehåller vanligen fel- eller varningsmeddelanden som genereras av konverteringsbegäran.

  5. Spara dokumentet PDF.

    Utför följande åtgärder för att hämta det nya PDF-dokumentet:

    • Anropa metoden getCreatedDocument för objektet CreatePDFResult. Detta returnerar ett com.adobe.idp.Document-objekt.
    • Anropa com.adobe.idp.Document-objektets copyToFile-metod för att extrahera PDF-dokumentet.

    Utför på samma sätt följande åtgärder för att hämta loggdokumentet.

    • Anropa metoden getLogDocument för objektet CreatePDFResult. Detta returnerar ett com.adobe.idp.Document-objekt.
    • Anropa com.adobe.idp.Document-objektets copyToFile-metod för att extrahera loggdokumentet.

Se även

Sammanfattning av steg

Snabbstart (SOAP): Konvertera en PostScript-fil till ett PDF-dokument med Java API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Konvertera en PostScript-fil till PDF med hjälp av webbtjänstens API converting-a-postscript-file-to-pdf-using-the-web-service-api

Konvertera en PostScript-fil till PDF-dokument med Distiller Service API (webbtjänst):

  1. Inkludera projektfiler.

    Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    Ersätt localhost med IP-adressen för servern som är värd för AEM Forms.
  2. Skapa en Distiller-tjänstklient.

    • Skapa ett DistillerServiceClient-objekt med hjälp av dess standardkonstruktor.

    • Skapa ett DistillerServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/DistillerService?blob=mtom). Du behöver inte använda attributet lc_version. Det här attributet används när du skapar en tjänstreferens. Ange ?blob=mtom om du vill använda MTOM.

    • Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet DistillerServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.

    • Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.

    • Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:

      • Tilldela användarnamnet för AEM formulär till fältet DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Tilldela motsvarande lösenordsvärde till fältet DistillerServiceClient.ClientCredentials.UserName.Password.
      • Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
  3. Hämta filen som ska konverteras.

    • Skapa ett BLOB-objekt med hjälp av dess konstruktor. Det här BLOB-objektet används för att lagra filen som ska konverteras till ett PDF-dokument.
    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
    • Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
    • Fyll objektet BLOB genom att tilldela dess MTOM-egenskap med innehållet i bytearrayen.
  4. Anropa åtgärden att skapa PDF.

    Anropa DistillerServiceService-objektets CreatePDF2-metod och skicka följande obligatoriska värden:

    • Objektet BLOB som representerar PS-filen som ska konverteras
    • En sträng som innehåller sökvägen till filen som ska konverteras
    • Ett strängobjekt som innehåller de Adobe PDF-inställningar som ska användas (till exempel Standard)
    • Ett strängobjekt som innehåller de skyddsinställningar som ska användas (till exempel No Security)
    • Ett valfritt BLOB-objekt som innehåller inställningar som ska användas när PDF-dokumentet genereras
    • Ett valfritt BLOB-objekt som innehåller metadatainformation som ska användas i PDF-dokumentet
    • En BLOB-utdataparameter som används för att lagra PDF-dokumentet
    • En BLOB-utdataparameter som används för att lagra loggen
  5. Spara dokumentet PDF.

    • Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för det signerade PDF-dokumentet och läget som filen ska öppnas i.
    • Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden CreatePDF2 (parametern output). Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
    • Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
    • Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Sammanfattning av steg

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2