Conversion de PostScript en Documents PDF

À propos du service Distiller

Le service Distiller® convertit les fichiers PostScript®, Encapsulated PostScript (EPS) et PRN en fichiers PDF compacts, fiables et plus sécurisés sur un réseau. Ce service est généralement utilisé pour convertir en documents électroniques d’importants volumes de documents papier, tels que des factures et des déclarations. La conversion de documents en PDF permet également aux entreprises d’envoyer à leurs clients un document à la fois dans sa version papier et dans sa version électronique.

Remarque

For more information about the Distiller service, see Services Reference for AEM Forms.

Conversion de PostScript en documents PDF

Cette rubrique décrit comment utiliser l’API Distiller Service (Java et service Web) pour convertir par programmation des fichiers PostScript (PS), Encapsulated PostScript (EPS) et PRN en documents PDF.

Remarque

For more information about the Distiller service, see Services Reference for AEM Forms.

Remarque

Pour convertir des fichiers PostScript en documents PDF, l’un des éléments suivants doit être installé sur le serveur hébergeant AEM Forms : Module redistribuable Acrobat 9 ou Microsoft Visual C++ 2005.

Résumé des étapes

Pour convertir l’un des types pris en charge en document PDF, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un client de service Distiller.
  3. Récupérez le fichier à convertir.
  4. Appelez l’opération de création de PDF.
  5. Enregistrez le document PDF.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un client de service Distiller

Avant de pouvoir exécuter une opération de service Distiller par programmation, vous devez créer un client de service Distiller. Si vous utilisez l’API Java, créez un DistillerServiceClient objet. Si vous utilisez l’API du service Web, créez un DistillerServiceService objet.

Récupérer le fichier à convertir

Vous devez récupérer le fichier à convertir. Par exemple, pour convertir un fichier PS en document PDF, vous devez récupérer le fichier PS.

Appeler l’opération de création de PDF

Après avoir créé le client de service, vous pouvez appeler l’opération de création de PDF. Cette opération nécessite des informations sur le document à convertir, y compris le chemin d'accès au document de cible.

Enregistrer le document PDF

Vous pouvez enregistrer le document PDF au format PDF.

Voir également

Conversion d’un fichier PostScript au format PDF à l’aide de l’API Java

Conversion d’un fichier PostScript en fichier PDF à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Débuts rapides de l’API Output Service

Conversion d’un fichier PostScript au format PDF à l’aide de l’API Java

Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (Java) :

  1. Incluez des fichiers de projet.

    Incluez des fichiers JAR client, tels que adobe-distiller-client.jar, dans le chemin de classe de votre projet Java.

  2. Créez un client de service Distiller.

    • Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
    • Create an DistillerServiceClient object by using its constructor and passing the ServiceClientFactory object.
  3. Récupérez le fichier à convertir.

    • Créez un java.io.FileInputStream objet représentant le fichier à convertir en utilisant son constructeur et en transmettant une valeur de chaîne spécifiant l’emplacement du fichier.
    • Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.
  4. Appelez l’opération de création de PDF.

    Appelez la méthode DistillerServiceClient de l’ createPDF objet et transmettez les valeurs suivantes :

    • Objet com.adobe.idp.Document représentant le fichier PS, EPS ou PRN à convertir
    • Objet java.lang.String contenant le nom du fichier à convertir
    • Objet java.lang.String contenant le nom des paramètres Adobe PDF à utiliser
    • Objet java.lang.String contenant le nom des paramètres de protection à utiliser
    • Objet facultatif com.adobe.idp.Document contenant les paramètres à appliquer lors de la génération du document PDF
    • Objet facultatif com.adobe.idp.Document contenant des informations de métadonnées à appliquer au document PDF

    La createPDF méthode renvoie un CreatePDFResult objet qui contient le nouveau document PDF et un fichier journal qui peut être généré. Le fichier journal contient généralement des messages d’erreur ou d’avertissement générés par la demande de conversion.

  5. Enregistrez le document PDF.

    Pour obtenir le document PDF nouvellement créé, effectuez les opérations suivantes :

    • Appelle la méthode CreatePDFResult de l’ getCreatedDocument objet. Cette méthode renvoie un com.adobe.idp.Document objet.
    • Appelez la méthode com.adobe.idp.Document de l’objet copyToFile pour extraire le document PDF.

    De même, pour obtenir le document du journal, effectuez les actions suivantes.

    • Appelle la méthode CreatePDFResult de l’ getLogDocument objet. Cette méthode renvoie un com.adobe.idp.Document objet.
    • Appelez la méthode com.adobe.idp.Document de l’objet copyToFile pour extraire le document de journal.

Voir également

Résumé des étapes

Début rapide (mode SOAP) : Conversion d’un fichier PostScript en document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Conversion d’un fichier PostScript en fichier PDF à l’aide de l’API du service Web

Convertissez un fichier PostScript en document PDF à l’aide de l’API Distiller Service (service Web) :

  1. Incluez des fichiers de projet.

    Créez un projet Microsoft .NET qui utilise MTOM. Assurez-vous d’utiliser la définition WSDL suivante : http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1.

    Remarque

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un client de service Distiller.

    • Create a DistillerServiceClient object by using its default constructor.

    • Create a DistillerServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Transférez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple, http://localhost:8080/soap/services/DistillerService?blob=mtom). Vous n’avez pas besoin d’utiliser l’ lc_version attribut. Cet attribut est utilisé lorsque vous créez une référence de service. Spécifiez toutefois ?blob=mtom l’utilisation de MTOM.

    • Créez un System.ServiceModel.BasicHttpBinding objet en obtenant la valeur du DistillerServiceClient.Endpoint.Binding champ. Convertissez la valeur de retour en BasicHttpBinding.

    • Définissez le System.ServiceModel.BasicHttpBinding champ de l’ MessageEncoding objet sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

    • Activez l’authentification HTTP de base en exécutant les tâches suivantes :

      • Attribuez le nom d’utilisateur AEM forms au champ DistillerServiceClient.ClientCredentials.UserName.UserName.
      • Attribuez la valeur de mot de passe correspondante au champ DistillerServiceClient.ClientCredentials.UserName.Password.
      • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.
  3. Récupérez le fichier à convertir.

    • Créez un objet BLOB en utilisant son constructeur. Cet BLOB objet est utilisé pour stocker le fichier à convertir en document PDF.
    • Créez un System.IO.FileStream objet en appelant son constructeur et en transmettant une valeur de chaîne qui représente l'emplacement du fichier et le mode d'ouverture du fichier.
    • Créez un tableau d’octets qui stocke le contenu de l’ System.IO.FileStream objet. Vous pouvez déterminer la taille du tableau d’octets en obtenant la System.IO.FileStream Length propriété de l’objet.
    • Renseignez le tableau d’octets avec les données de flux en appelant la System.IO.FileStream Read méthode de l’objet et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
    • Renseignez l’ BLOB objet en attribuant sa MTOM propriété au contenu du tableau d’octets.
  4. Appelez l’opération de création de PDF.

    Appelez la méthode DistillerServiceService de l’ CreatePDF2 objet et transmettez les valeurs requises suivantes :

    • Objet BLOB représentant le fichier PS à convertir
    • Chaîne contenant le nom du chemin d’accès du fichier à convertir
    • Objet de chaîne contenant les paramètres Adobe PDF à utiliser (par exemple, Standard)
    • Objet de chaîne contenant les paramètres de sécurité à utiliser (par exemple, No Security)
    • Objet facultatif BLOB contenant les paramètres à appliquer lors de la génération du document PDF
    • Objet facultatif BLOB contenant des informations de métadonnées à appliquer au document PDF
    • Paramètre BLOB de sortie utilisé pour stocker le document PDF
    • Paramètre BLOB de sortie utilisé pour stocker le journal
  5. Enregistrez le document PDF.

    • Create a System.IO.FileStream object by invoking its constructor. Transmettez une valeur de chaîne qui représente l’emplacement du fichier du document PDF signé et le mode d’ouverture du fichier.
    • Créez un tableau d’octets qui stocke le contenu de l’ BLOB objet renvoyé par la CreatePDF2 méthode (le paramètre output). Renseignez le tableau d’octets en obtenant la valeur du membre BLOB de données de l’ MTOM objet.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter Write de l’objet et en transmettant le tableau d’octets.

Voir également

Résumé des étapes

Appel de AEM Forms à l’aide de MTOM

Appel de AEM Forms à l’aide de SwaRef

Sur cette page