Installation et configuration des services de document

AEM Forms fournit un ensemble de services OSGi pour exécuter différentes opérations au niveau du document, par exemple, des services pour créer, assembler, publier et archiver des documents PDF, pour ajouter des signatures numériques afin de limiter l’accès aux documents et de décoder les formulaires à code-barres. Ces services sont inclus dans le package du module complémentaire AEM Forms. Ces services sont collectivement désignés par Services de document. Les services de document disponibles et leurs fonctionnalités principales sont les suivants :

• Service Assembler : vous permet de combiner, de réorganiser et d’agrémenter des documents PDF et XDP et d’obtenir des informations sur les documents PDF. Ce service permet également de convertir et de valider des documents PDF au format PDF/A standard, il convertit les formulaires PDF et XML aux formats PDF/A-1b, PDF/A-2b et PDFA/A-3b. Pour plus d’informations, voir Service Assembler.

• Service ConvertPDF : permet de convertir des documents PDF en fichiers PostScript ou image (JPEG, JPEG 2000, PNG et TIFF). Pour plus d’informations, voir Service ConvertPDF.

• Service Barcoded Forms : permet d’extraire des données à partir d’images électroniques de codes à barres. Il accepte en entrée des fichiers PDF et TIFF qui contiennent un ou plusieurs codes à barres et extrait les données de code à barres. Pour plus d’informations, voir Service Forms à code-barres.

• Service DocAssurance : vous permet de chiffrer et de déchiffrer des documents, d’étendre les fonctionnalités d’Adobe Reader avec des droits d’utilisation supplémentaires et d’ajouter des signatures numériques à vos documents. Le service Doc Assurance se compose en fait de trois services : Signature, Encryption et Reader Extensions. Pour plus d’informations, voir Service DocAssurance.

• Service Encryption : permet de chiffrer et de déchiffrer des documents. Lorsqu’un document est chiffré, son contenu devient illisible. Un utilisateur autorisé peut déchiffrer le document pour pouvoir accéder à son contenu. Pour plus d’informations, voir Service de chiffrement.

• Service Forms : permet de créer des applications clientes interactives de capture de données qui valident, traitent, transforment et diffusent des formulaires généralement créés dans Forms Designer. Le service Forms effectue le rendu de toute conception de formulaire que vous développez dans des documents PDF. Pour plus d’informations, voir Service Forms.

• Service Output : permet de créer des documents dans différents formats, y compris PDF, les formats d’imprimante laser et les formats d’imprimantes d’étiquettes. Les formats d’imprimantes laser sont les suivants : PostScript et PCL (Printer Control Language). Pour plus d’informations, voir Service Output.

• Service PDF Generator : le service PDF Generator fournit des API pour convertir les formats de fichiers natifs en PDF. Il convertit également des fichiers PDF en d’autres formats et optimise la taille des documents PDF. Pour plus d’informations, voir Service PDF Generator.

• Service d’extension Reader : permet à votre entreprise de partager facilement des documents PDF interactifs en étendant la fonctionnalité d’Adobe Reader avec des droits d’utilisation supplémentaires. Ce service active des fonctionnalités indisponibles à l’ouverture d’un document PDF dans Adobe Reader, comme l’ajout de commentaires dans un document, le remplissage de formulaires et l’enregistrement du document. Pour plus d’informations, voir Service d’extension de Reader.

• Service Signature : vous permet d’utiliser des signatures et des documents numériques sur le serveur AEM. Par exemple, le service Signature est généralement utilisé dans les situations suivantes :

  • Le serveur AEM certifie un formulaire avant que ce dernier ne soit envoyé à un utilisateur et ouvert avec Acrobat ou Adobe Reader.
  • Le serveur AEM valide la signature apposée sur un formulaire via Acrobat ou Adobe Reader.
  • Le serveur AEM signe un formulaire au nom d’un notaire.

  Le service Signature accède aux certificats et aux informations d’identification stockées dans le Trust Store. Pour plus d’informations, voir Service de signature.

AEM Forms est une puissante plateforme de classe entreprise et les services de document ne sont que l’une des fonctionnalités d’AEM Forms. Pour obtenir la liste complète des fonctionnalités, voir Présentation d’AEM Forms.

Topologie de déploiement

Le package du module complémentaire AEM Forms est une application déployée sur AEM. En général, une seule instance AEM (de création ou de publication) suffit pour exécuter les services de document AEM Forms. La topologie suivante est recommandée pour exécuter les services de document d’AEM Forms. Pour plus d’informations sur les topologies, voir Topologies d’architecture et de déploiement pour AEM Forms.

Configuration requise

Avant de commencer à installer et configurer les services de document AEM Forms, assurez-vous que :

• Le matériel et l’infrastructure logicielle sont en place. Pour obtenir une liste détaillée des matériels et logiciels pris en charge, voir Conditions techniques applicables.

• Le chemin d’installation de l’instance AEM ne contient aucun espace blanc.

• Une instance AEM est en cours d’utilisation. Dans la terminologie AEM, une « instance » est une copie d’AEM s’exécutant sur un serveur en mode de création ou de publication. En général, une seule instance AEM (création ou publication) suffit pour exécuter les services de document AEM Forms :

  • Création : instance AEM utilisée pour créer, télécharger et modifier du contenu et assurer l’administration du site Web. Une fois que le contenu est publié, il est répliqué sur l’instance de publication.
  • Publication : instance AEM qui diffuse le contenu publié au public sur Internet ou sur un réseau interne.

• Les besoins en mémoire sont satisfaits. Le module complémentaire AEM Forms nécessite :

  • 15 Go d’espace temporaire pour les installations Microsoft Windows.
  • 6 Go d’espace temporaire pour les installations Unix.

• Les logiciels client requis par PDF Generator pour effectuer une conversion sous Microsoft Windows et Linux sont installés :

  • Microsoft Windows : Installer Microsoft Office ou Apache OpenOffice
  • Linux : Installer Apache OpenOffice

Configuration requise supplémentaire pour les systèmes d’exploitation UNIX

Si vous utilisez un système d’exploitation UNIX, installez les packages suivants des supports d’installation du système d’exploitation correspondant :

• (PDF Generator uniquement) Installez la version 32 bits des bibliothèques libcurl, libcrypto et libssl et créez les liens symboliques ci-dessous. Les liens symboliques pointent vers la dernière version des bibliothèques respectives :

  • /usr/lib/libcurl.so
  • /usr/lib/libcrypto.so
  • /usr/lib/libssl.so

• (PDF Generator uniquement) Le service PDF Generator prend en charge les itinéraires WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF. Pour activer la conversion pour l’itinéraire PhantomJS, installez les bibliothèques 64 bits répertoriées ci-dessous. Ces bibliothèques sont généralement déjà installées. Si une bibliothèque est manquante, installez-la manuellement :

  • linux-gate.so.1
  • libz.so.1
  • libfontconfig.so.1
  • libfreetype.so.6
  • libdl.so.2
  • librt.so.1
  • libpthread.so.0
  • libstdc++.so.6
  • libm.so.6
  • libgcc_s.so.1
  • libc.so.6
  • ld-linux.so.2
  • libexpat.so.1

Configurations de pré-installation

Les configurations répertoriées dans la section Configurations de pré-installation s’appliquent uniquement au service PDF Generator. Si vous ne configurez pas le service PDF Generator, vous pouvez ignorer la section Configurations de pré-installation.

Installation d’Adobe Acrobat et d’applications tierces

Si vous utilisez le service PDF Generator pour convertir des formats de fichiers natifs tels que Microsoft Word, Microsoft Excel, Microsoft PowerPoint, OpenOffice, WordPerfect X7 et Adobe Acrobat en documents PDF, assurez-vous que ces applications sont installées sur le serveur AEM Forms.

Après l’installation d’Acrobat, ouvrez Microsoft Word. Sur l’onglet Acrobat, cliquez sur Créer un fichier PDF et convertissez un fichier .doc ou.docx disponible sur votre ordinateur en document PDF. Si la conversion fonctionne, AEM Forms est prêt à utiliser Acrobat avec le service PDF Generator.

Définition des variables d’environnement

Définissez des variables d’environnement pour Java Development Kit 32 bits et 64 bits, des applications tierces et Adobe Acrobat. Les variables d’environnement doivent contenir le chemin d’accès absolu du fichier exécutable utilisé pour démarrer l’application correspondante, par exemple, le tableau ci-dessous répertorie les variables d’environnement pour quelques applications :

(Uniquement pour IBM WebSphere) Configuration du fournisseur de socket SSL IBM

Effectuez les étapes suivantes pour configurer le fournisseur de socket SSL IBM :

1. Créez une copie du fichier java.security. L’emplacement par défaut du fichier est [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

2. Ouvrez le fichier java.security copié pour le modifier.

3. Modifiez les fabriques de socket SSL par défaut pour utiliser les fabriques JSSE2 au lieu des fabriques IBM WebSphere par défaut :

   Contenu par défaut:

   #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
   #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
   #WebSphere socket factories (in cryptosf.jar)
   ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
   ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
   

   Contenu modifié :

   ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
   ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
   
   #WebSphere socket factories (in cryptosf.jar)
   #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
   #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
   

4. Pour activer le serveur AEM Forms pour utiliser le fichier java.security mis à jour, lors du démarrage du serveur AEM Forms, ajoutez l’argument java suivant :

   -Djava.security.properties= [path of newly created Java.security file].

(Windows uniquement) Configuration du service d’installation d’encre et de reconnaissance de l’écriture manuscrite

Si vous exécutez Microsoft Windows Server, configurez le service d’encre et de reconnaissance de l’écriture manuscrite. Ce service est nécessaire pour ouvrir des fichiers Microsoft PowerPoint qui utilisent des fonctions d’encre de Microsoft Office :

1. Ouvrez le gestionnaire de serveur. Cliquez sur l’icône du gestionnaire de serveur sur la barre de lancement rapide.
2. Cliquez sur Ajouter des fonctionnalités dans le menu Fonctionnalités . Cochez la case Services d’encre et de reconnaissance de l’écriture manuscrite.
3. Boîte de dialogue Sélectionner des fonctionnalités avec l’option Services d’encre et de reconnaissance de l’écriture manuscrite cochée. Cliquez sur Installer pour installer le service.

(Windows uniquement) Configuration des paramètres de blocage des fichiers pour Microsoft Office

Modifiez les paramètres du Centre de gestion de la confidentialité Microsoft Office pour permettre au service PDF Generator de convertir des fichiers créés avec des versions précédentes de Microsoft Office.

1. Ouvrez une application Microsoft Office. Par exemple, Microsoft Word. Accédez à Fichier >Options. La boîte de dialogue Options s’affiche.

2. Cliquez sur Centre de gestion de la confidentialité, puis sur Paramètres du Centre de gestion de la confidentialité.

3. Dans les Paramètres du Centre de gestion de la confidentialité, cliquez sur Paramètres de blocage des fichiers.

4. Dans la liste Type de fichier, désélectionnez l’option Ouvrir pour le type de fichier que le service PDF Generator devrait être autorisé à convertir en documents PDF.

(Windows uniquement) Octroi du droit Remplacer un jeton de niveau processus

Le compte utilisateur utilisé pour démarrer le serveur d’applications doit avoir le droit de Remplacer un jeton de niveau processus. Le compte système local possède le droit de Remplacer un jeton de niveau processus par défaut. Pour les serveurs s’exécutant avec un utilisateur du groupe des administrateurs locaux, le droit doit être accordé explicitement. Effectuez les étapes suivantes pour accorder le droit :

1. Ouvrez l’éditeur de stratégie de groupe de Microsoft Windows. Pour ouvrir l’éditeur de stratégie de groupe, cliquez sur Démarrer, saisissez gpedit.msc dans la zone Lancer la recherche, puis cliquez sur Éditeur de stratégie de groupe.
2. Accédez à Stratégie d’ordinateur local > Configuration d’ordinateur > Paramètres Windows > Paramètres de sécurité > Stratégies locales > Attribution des droits utilisateur et modifiez la stratégie Remplacer un jeton de niveau processus pour y inclure le groupe Administrateurs.
3. Ajoutez l’utilisateur à l’entrée Remplacer un jeton de niveau processus.

(Windows uniquement) Activation du service PDF Generator pour les utilisateurs non administrateurs

Vous pouvez permettre à un utilisateur non-administrateur d’utiliser le service PDF Generator. Normalement, seuls les utilisateurs disposant de droits d’administrateur peuvent utiliser le service :

1. Créez une variable d’environnement, PDFG_NON_ADMIN_ENABLED.
2. Définissez la valeur de la variable d’environnement sur TRUE.
3. Redémarrez l’instance AEM Forms.

(Windows uniquement) Désactivation du contrôle de compte d’utilisateur

1. Pour accéder à l’utilitaire de configuration système, sélectionnez Démarrer > Exécuter et saisissez MSCONFIG.

2. Cliquez sur l’onglet Outils, faites défiler l’écran vers le bas, puis sélectionnez Modifier les paramètres de contrôle de compte d’utilisateur. Cliquez sur Démarrer pour lancer la commande dans une nouvelle fenêtre.

3. Déplacez le curseur sur le niveau Ne jamais m’avertir. Cela fait, fermez la fenêtre de commande, puis celle de la configuration du système.

4. Vérifiez que le paramètre de registre pour l’UAC est défini sur 0 (zéro). Effectuez les étapes suivantes pour vérifier :

   1. Microsoft recommande de sauvegarder le registre avant de le modifier. Pour obtenir la procédure détaillée, voir Comment sauvegarder et restaurer le registre dans Windows.
   2. Ouvrez l’éditeur de registre Microsoft Windows. Pour ouvrir l’éditeur de registre, accédez à Démarrer > Exécuter, saisissez regedit, puis cliquez sur OK.
   3. Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Assurez-vous que la valeur de EnableLUA est définie sur 0 (zéro).
   4. Assurez-vous que la valeur de EnableLUA est définie sur 0 (zéro). Si la valeur n’est pas 0, remplacez-la par 0. Fermez l’éditeur du registre.

5. Redémarrez l’ordinateur.

(Windows uniquement) Désactiver le service de création de rapports d’erreurs

Lors de la conversion d’un document au format PDF à l’aide du service PDF Generator sous Windows Server, Windows Server signale parfois que le fichier exécutable a rencontré un problème et doit se fermer. La conversion au format PDF n’est toutefois pas affectée et se poursuit en arrière-plan.

Pour éviter de recevoir cette erreur, vous pouvez désactiver le rapport d’erreurs Windows. Pour plus d’informations sur la désactivation des rapports d’erreur, voir https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Windows uniquement) Configuration de la conversion HTML vers PDF

Le service PDF Generator fournit des méthodes ou itinéraires WebKit, WebCapture et PhantomJS pour convertir des fichiers HTML en documents PDF. Sous Windows, pour activer la conversion des itinéraires WebKit et Acrobat WebCapture, copiez la police Unicode vers le répertoire %windir%\fonts.

(plateformes UNIX uniquement) Configurations supplémentaires pour la conversion HTML vers PDF

Sur les plates-formes UNIX, le service PDF Generator prend en charge les itinéraires WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF. Pour activer la conversion de fichiers HTML en PDF, effectuez les configurations suivantes, applicables à l’itinéraire de conversion de votre choix :

(Plateformes UNIX uniquement) Activation de la prise en charge des polices Unicode (WebKit uniquement)

Copiez la police Unicode vers l’un des répertoires suivants, en fonction de votre système d’exploitation :

• /usr/lib/X11/fonts/TrueType
• /usr/share/fonts/default/TrueType
• /usr/X11R6/lib/X11/fonts/ttf
• /usr/X11R6/lib/X11/fonts/truetype
• /usr/X11R6/lib/X11/fonts/TrueType
• /usr/X11R6/lib/X11/fonts/TTF
• /usr/openwin/lib/X11/fonts/TrueType (Solaris)

Installation du module complémentaire AEM Forms

Le package du module complémentaire AEM Forms est une application déployée sur AEM. Le package contient des services de document AEM Forms et d’autres fonctionnalités AEM Forms. Pour installer le package, procédez comme suit :

1. Ouvrez la Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

2. Appuyez sur Adobe Experience Manager disponible dans le menu d’en-tête.

3. Dans la section Filtres :

   1. Sélectionnez Formulaires dans la liste déroulante Solution.
   2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option Téléchargements de recherche pour filtrer les résultats.

4. Appuyez sur le nom du module approprié à votre système d’exploitation, sélectionnez Accepter les termes du contrat de licence de l’utilisateur (EULA), puis appuyez sur Télécharger.

5. Ouvrez Package Manager et cliquez sur Télécharger le package pour télécharger le package.

6. Sélectionnez le package et cliquez sur Installer.

   Vous pouvez également télécharger le package via le lien direct répertorié dans l’article Versions d’AEM Forms.

7. Une fois le package installé, vous êtes invité à redémarrer l’instance AEM. N'arrêtez pas le serveur immédiatement. Avant d’arrêter le serveur AEM Forms, attendez que les messages ServiceEvent REGISTERED et ServiceEvent UNREGISTERED cessent d’apparaître dans le fichier [AEM-Installation-Directory]/crx-quickstart/logs/error.log et que le journal soit stable.

Configurations post-installation

Configuration de Boot Delegation pour les bibliothèques RSA/BouncyCastle

1. Désactivez l’instance AEM. Accédez au [répertoire d’installation AEM]\crx-quickstart\conf\ folder. Ouvrez le fichier sling.properties en mode d’édition.

   Si vous utilisez [AEM installation directory]\crx-quickstart\bin\start.bat pour démarrer une instance AEM, modifiez le fichier sling.properties situé à l’emplacement suivant :[AEM_root]\crx-quickstart\.

2. Ajoutez les propriétés suivantes au fichier sling.properties :

   sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
   sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
   

3. (AIX uniquement) Ajoutez les propriétés suivantes au fichier sling.properties :

   sling.bootdelegation.xerces=org.apache.xerces.*
   

4. Enregistrez et fermez le fichier.

Configuration du service de gestion de polices

1. Connectez-vous à AEM Configuration Manager en tant qu’administrateur.

2. Recherchez et ouvrez le service CQ-DAM-Handler-Gibson Font Manager . Spécifiez le chemin d’accès aux répertoires des polices système, des polices Adobe et des polices du client. Cliquez sur Enregistrer.

   REMARQUE

   les droits d’utilisation relatifs aux polices fournies par des sociétés autres qu’Adobe sont régis par les contrats de licence accompagnant ces polices. Ils ne sont pas couverts par la licence d’utilisation du logiciel Adobe qui vous est concédée. Adobe vous recommande de vous assurer que vous agissez en conformité avec tous les contrats de licence de sociétés tierces applicables avant d’utiliser des polices non-Adobe avec des logiciels Adobe, notamment en ce qui concerne l’utilisation de polices dans des environnements de serveurs.
   Lorsque vous installez de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

Configuration d’un compte d’utilisateur local pour exécuter le service PDF Generator

Un compte d’utilisateur local est requis pour exécuter le service PDF Generator. Pour connaître les étapes de création d’un utilisateur local, voir Création d’un compte d’utilisateur sous Windows ou création d’un compte d’utilisateur sur des plateformes UNIX.

1. Ouvrez la page Configuration de PDF Generator dans AEM Forms.

2. Dans l’onglet Comptes utilisateur, saisissez les informations d’identification d’un compte utilisateur local, puis cliquez sur Envoyer. Si Microsoft Windows vous y invite, autorisez l’accès à l’utilisateur. Une fois l’ajout réussi, l’utilisateur configuré s’affiche sous la section Vos comptes d’utilisateurs dans l’onglet Comptes d’utilisateurs.

Configuration des paramètres de délai d’expiration

1. Dans AEM Configuration Manager, recherchez et ouvrez le service Fournisseur ORB Jacorb.

   Ajoutez l’élément suivant au champ Properties.name personnalisé et cliquez sur Enregistrer. Il définit le délai d’attente de réponse en attente (également appelé délai d’attente du client CORBA) sur 600 secondes.

   jacorb.connection.client.pending_reply_timeout=600000

2. Connectez-vous à l’instance d’auteur AEM et accédez à Adobe Experience Manager > Outils > Forms > Configurer PDF Generator. L’URL par défaut est http://localhost:4502/libs/fd/pdfg/config/ui.html.

   Ouvrez l’onglet Configuration générale et modifiez la valeur des champs suivants pour votre environnement :

(Windows uniquement) Configuration d’Acrobat pour le service PDF Generator

Sous Microsoft Windows, le service PDF Generator utilise Adobe Acrobat pour convertir les formats de fichiers pris en charge en document PDF. Effectuez les étapes suivantes pour configurer Adobe Acrobat pour le service PDF Generator :

1. Ouvrez Acrobat et sélectionnez Modifier> Préférences> Mises à jour. Dans Rechercher les mises à jour, désélectionnez Installer automatiquement les mises à jour, puis cliquez sur OK. Fermez Acrobat.

2. Double-cliquez sur un document PDF sur votre système. Lors du premier démarrage d’Acrobat, les boîtes de dialogue de connexion, l’écran de bienvenue et le CLUF s’affichent. Fermez ces boîtes de dialogue pour tous les utilisateurs configurés pour utiliser PDF Generator.

3. Exécutez le fichier de commandes de l’utilitaire PDF Generator pour configurer Acrobat pour le service PDF Generator :

   1. Ouvrez AEM Package Manager et téléchargez le fichier adobe-aemfd-pdfg-common-pkg-[version].zip depuis le gestionnaire de modules.

   2. Décompressez le fichier .zip téléchargé. Ouvrez l’invite de commande avec des droits d’administrateurs.

   3. Accédez au répertoire [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts . Exécutez le fichier de commandes suivant :

      Acrobat_for_PDFG_Configuration.bat

      Acrobat est configuré pour s’exécuter avec le service PDF Generator.

4. Exécutez l’outil de préparation du système pour valider l’installation d’Acrobat. L’outil vérifie que l’ordinateur est correctement configuré pour exécuter les conversions PDF Generator et génère un rapport au chemin indiqué:

   1. Ouvrez l’invite de commande. Accédez au dossier [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt . Exécutez la commande suivante à partir de l’invite de commande :

      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en

      REMARQUE

      Si l’outil System Readiness signale que le fichier pdfgen.api n’est pas disponible dans le dossier des modules externes Acrobat, copiez le fichier pdfgen.api du répertoire [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 vers le répertoire [Acrobat_root]\Acrobat\plug_ins.

   2. Accédez à [Path_of_reports_folder]. Ouvrez le fichier SystemReadinessTool.html . Vérifiez le rapport et résolvez les problèmes mentionnés.

(Windows uniquement) Configuration d’un itinéraire Principal pour la conversion HTML vers PDF

Le service PDF Generator fournit plusieurs itinéraires pour convertir des fichiers HTML en documents PDF : WebKit, Acrobat WebCapture (Windows uniquement) et PhantomJS. Adobe recommande d’utiliser l’itinéraire PhantomJS, car il permet de gérer du contenu dynamique et ne dépend pas des bibliothèques 32 bits, du JDK 32 bits ou de l’absence de polices supplémentaires. En outre, l’itinéraire PhantomJS ne requiert pas d’accès sudo ou root pour exécuter la conversion.

L’itinéraire principal par défaut pour les conversions HTML en PDF est WebKit. Pour modifier l’itinéraire de conversion :

1. Sur l’instance de création AEM, accédez à Outils > Forms > Configuration de PDF Generator.

2. Dans l’onglet Configuration générale, sélectionnez l’itinéraire de conversion préféré dans la liste déroulante Itinéraire Principal pour les conversions HTML en PDF.

Initialisation de la Trust Store globale

Trust Store Management vous permet d’importer, de modifier et de supprimer des certificats de confiance sur le serveur pour valider des signatures numériques et l’authentification de certificats. Vous pouvez en importer et en exporter autant que vous le souhaitez. Une fois qu’un certificat a été importé, vous pouvez modifier les paramètres d’approbation et le type de Trust Store. Pour initialiser un Trust Store, procédez comme suit :

1. Connectez-vous à une instance AEM Forms en tant qu’administrateur.
2. Accédez à Outils > Sécurité > Trust Store.
3. Cliquez sur Créer TrustStore. Définissez le mot de passe et appuyez sur Enregistrer.

Configuration des certificats pour le service Encryption et l’extension Reader

Le service DocAssurance peut appliquer des droits d’utilisation aux documents PDF. Pour appliquer des droits d’utilisation aux documents PDF, configurez les certificats.

Avant de configurer des certificats, assurez -vous que vous disposez des éléments suivants :

• Fichier de certificat (.pfx).

• Mot de passe de la clé privée, fourni avec le certificat.

• Alias de la clé privée. Vous pouvez exécuter la commande Java keytool pour afficher l’alias de la clé privée :
  keytool -list -v -keystore [keystore-file] -storetype pkcs12

• Mot de passe du fichier KeyStore. Si vous utilisez le certificat Reader Extensions d’Adobe, le mot de passe du fichier Key Store est toujours identique au mot de passe de la clé privée.

Effectuez les étapes suivantes pour configurer les certificats :

1. Connectez-vous à l’instance Auteur AEM en tant qu’administrateur. Accédez à Outils> Sécurité> Utilisateurs.

2. Cliquez sur le champ nom du compte d’utilisateur. La page Modifier les paramètres utilisateur s’affiche. Sur l’instance d’auteur AEM, les certificats résident dans un KeyStore. Si vous n’avez pas créé de KeyStore précédemment, cliquez sur Créer KeyStore et définissez un nouveau mot de passe pour le KeyStore. Si le serveur contient déjà un KeyStore, ignorez cette étape. Si vous utilisez le certificat Reader Extensions d’Adobe, le mot de passe du fichier Key Store est toujours identique au mot de passe de la clé privée.

3. Sur la page Modifier les paramètres utilisateur , sélectionnez l’onglet KeyStore . Développez l’option Ajouter la clé privée à partir du fichier Key Store et fournissez un alias. L’alias est utilisé pour effectuer l’opération Reader Extensions.

4. Pour télécharger le fichier de certificat, cliquez sur Sélectionner le fichier du magasin de clés, puis téléchargez un fichier <filename>.pfx.

   Ajoutez les mot de passe du magasin de clés, mot de passe de la clé privée et alias de la clé privée associés au certificat dans les champs respectifs. Cliquez sur Envoyer.

   REMARQUE

   Dans l’environnement de production, remplacez les informations d’identification d’évaluation par celles de production. Veillez à supprimer vos anciennes informations d’identification Reader Extensions avant de mettre à jour des informations d’identification expirées ou d’évaluation.

5. Cliquez sur Enregistrer et fermer sur la page Modifier les paramètres utilisateur.

Activation du chiffrement AES-256

Pour utiliser le chiffrement AES 256 pour les fichiers PDF, récupérez et installez les fichiers Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy. Remplacez les fichiers local_policy.jar et US_export_policy.jar dans le dossier jre/lib/security. Par exemple, si vous utilisez Sun JDK, copiez les fichiers téléchargés dans le dossier [JAVA_HOME]/jre/lib/security.

Le service Assembler dépend des services Reader Extensions, Signatures, Forms et Output. Pour vérifier que les services requis sont opérationnels, procédez comme suit :

1. Connectez-vous à l’URL https://'[server]:[port]'/system/console/bundles en tant qu’administrateur.
2. Recherchez les services suivants et vérifiez qu’ils sont en cours d’exécution :

Problèmes connus et dépannage

• La conversion de fichiers HTML au format PDF échoue si un fichier d’entrée compressé comprend des fichiers HTML dont le nom contient des caractères à deux octets. Pour éviter ce problème, n’utilisez aucun caractère à deux octets dans le nom des fichiers HTML.

• Sur les systèmes d’exploitation UNIX, effectuez les opérations suivantes pour rechercher les bibliothèques manquantes :

1. Accéder à [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

2. Exécutez la commande suivante pour répertorier toutes les bibliothèques requises par PhantomJS pour convertir un fichier HTML en PDF.

   ldd phantomjs

   Exécutez la commande suivante pour répertorier les bibliothèques manquantes.

   ldd phantomjs | grep not

3. Installez manuellement les bibliothèques manquantes.

Étapes suivantes

Vous disposez d’un environnement de documents de services AEM Forms fonctionnel. Vous pouvez utiliser les services de document via :

• Processus basés sur l’utilisation de Forms on OSGi
• Dossiers de contrôle
• API de services de document