Installation et configuration des services de document

AEM Forms fournit un ensemble de services OSGi permettant d’effectuer différentes opérations au niveau du document, par exemple des services pour créer, assembler, distribuer et archiver des documents de PDF, ajouter des signatures numériques pour limiter l’accès aux documents et décoder Barcoded Forms. 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 : permet de combiner, d’organiser et d’étendre vos documents aux formats 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, consultez la section Service Assembler.

  • Service ConvertPDF : permet de convertir des documents PDF en fichiers PostScript ou en images (aux formats JPEG, JPEG 2000, PNG et TIFF). Pour plus d’informations, consultez la section Service ConvertPDF.

  • Service Barcoded Forms : permet d’extraire des données depuis des images électroniques de code-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, consultez la section Service Barcoded Forms.

  • Service DocAssurance : permet de chiffrer et de déchiffrer des documents, d’ajouter des droits d’utilisation aux fonctionnalités d’Adobe Reader ou encore 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, consultez la section 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, consultez la section Service Encryption.

  • Service Forms : permet de créer des applications clientes interactives de capture de données assurant la validation, le traitement, la transformation et la transmission de formulaires généralement créés dans Forms Designer. Le service Forms restitue sous forme de documents PDF tout type de formulaire que vous créez. Pour plus d’informations, consultez la section Service Forms.

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

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

  • Service Reader Extension : permet à votre organisation de partager facilement des documents PDF interactifs en ajoutant des droits dʼutilisation aux fonctionnalités dʼAdobe Reader. 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, consultez la section Service Reader Extensions.

  • Service Signature : permet d’utiliser des documents et des signatures 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, consultez la section Service Signature.

AEM Forms est une plateforme d’entreprise performante et les services de documents ne sont quʼune des fonctionnalités proposées. 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.

Topologies d’architecture et de déploiement pour AEM Forms

REMARQUE

Bien qu’AEM Forms vous permette de configurer et d’exécuter toutes les fonctionnalités à partir d’un seul serveur, vous devez planifier la capacité, équilibrer la charge et configurer des serveurs dédiés pour des fonctionnalités spécifiques dans un environnement de production. Par exemple, pour un environnement utilisant le service PDF Generator pour convertir des milliers de pages par jour et plusieurs formulaires adaptatifs pour capturer des données, configurez des serveurs AEM Forms distincts pour le service PDF Generator et les fonctionnalités de formulaires adaptatifs. Cela permet de fournir des performances optimales et de dimensionner les serveurs indépendamment les uns des autres.

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 pour que le générateur de PDF effectue une conversion sur Microsoft® Windows et Linux® sont installés :

REMARQUE
  • Sous Microsoft® Windows, PDF Generator prend en charge les itinéraires de conversion WebKit, Acrobat WebCapture et PhantomJS pour convertir des fichiers HTML en documents PDF.
  • Sur les systèmes dʼexploitation UNIX, PDF Generator prend en charge les itinéraires de conversion WebKit et PhantomJS pour convertir des fichiers HTML en documents PDF.

Exigences supplémentaires 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 :

  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (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.

REMARQUE
  • Si votre serveur AEM Forms se trouve dans un environnement hors ligne ou sécurisé et qu’Internet n’est pas disponible pour activer Adobe Acrobat, reportez-vous à la section Activation hors ligne pour obtenir des instructions sur l’activation de telles instances d’Adobe Acrobat.
  • Adobe Acrobat, Microsoft® Word, Excel et PowerPoint sont disponibles uniquement pour Microsoft® Windows. Si vous utilisez un système d’exploitation UNIX, installez OpenOffice pour convertir des fichiers texte enrichi et des fichiers Microsoft® Office pris en charge en documents PDF.
  • Fermez toutes les boîtes de dialogue qui s’affichent après l’installation d’Adobe Acrobat et d’un logiciel tiers pour tous les utilisateurs configurés pour utiliser le service PDF Generator.
  • Démarrez tous les logiciels installés au moins une fois. Fermez toutes les boîtes de dialogue pour tous les utilisateurs configurés pour utiliser le service PDF Generator.
  • Vérifier la date d’expiration de vos numéros de série Adobe Acrobat et définir une date pour mettre à jour la licence ou migrer votre numéro de série selon la date d’expiration.

Après avoir installé 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 de l’exécutable utilisé pour démarrer l’application correspondante, par exemple, le tableau ci-dessous répertorie les variables d’environnement pour quelques applications :

Application

Variable d’environnement

Exemple

JDK (64 bits)

JAVA_HOME

C:\Program Files\Java\jdk1.8.0_74

Adobe Acrobat

Acrobat_PATH

C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe

Bloc-notes

Notepad_PATH

C:\WINDOWS\notepad.exe

OpenOffice 

OpenOffice_PATH

C:\Program Files (x86)\OpenOffice.org 4

REMARQUE
  • Toutes les variables d’environnement et leurs chemins respectifs sont sensibles à la casse.
  • JAVA_HOME, JAVA_HOME_32 et Acrobat_PATH (Windows uniquement) sont des variables d’environnement obligatoires.
  • La variable d’environnement OpenOffice_PATH est définie sur le dossier d’installation et non pas sur le chemin d’accès au fichier exécutable.
  • Ne configurez pas de variables d’environnement pour les applications Microsoft® Office telles que Word, PowerPoint, Excel et Project, ni pour AutoCAD. Si ces applications sont installées sur le serveur, le service Generate PDF les démarre automatiquement.
  • Sur les plates-formes UNIX, installez OpenOffice en tant que /root. Si OpenOffice n’est pas installé en tant qu’utilisateur root, le service PDF Generator ne parvient pas à convertir les documents OpenOffice en documents PDF. Si vous devez installer et exécuter OpenOffice en tant qu’utilisateur non root, indiquez les droits sudo pour l’utilisateur non-root.
  • Si vous utilisez OpenOffice sur une plateforme UNIX, exécutez la commande suivante pour définir la variable de chemin :

export OpenOffice_PATH=/opt/openoffice.org4

(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 usines de socket SSL par défaut pour utiliser les usines JSSE2 au lieu des usines 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 permettre au serveur AEM Forms d'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) Configurer et installer le service 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. Le 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 fonctions dans le menu Fonctions. 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 les fichiers créés avec des versions plus anciennes 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) Accorder le 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 pour 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) Activer le 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ésactiver le contrôle de compte d’utilisateur (UAC)

  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). Pour vérifier, procédez comme suit :

    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 Microsoft® Éditeur du registre 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 rapport d’erreur

Lors de la conversion d’un document en 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 en savoir plus sur la désactivation des rapports d’erreur, consultez la section https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Windows uniquement) Configurer la conversion de fichiers HTML en PDF

Le service PDF Generator fournit des méthodes ou des 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.

REMARQUE

À chaque installation de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

(Plateformes UNIX uniquement) Configurations supplémentaires pour la conversion de fichiers HTML en 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) Activer 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™)
REMARQUE
  • Sous Red Hat® Enterprise Linux® 6.x et versions ultérieures, les polices Courier ne sont pas disponibles. Pour installer les polices Courier, téléchargez l’archive font-ibm-type1-1.0.3.zip. Extrayez le fichier d’archive vers /usr/share/fonts. Créez un lien symbolique de /usr/share/X11/fonts vers /usr/share/fonts.
  • Supprimez tous les fichiers de mémoire cache des polices .lst dans les répertoires Html2PdfSvc/bin et /usr/share/fonts.
  • Vérifiez que les répertoires /usr/lib/X11/fonts et /usr/share/fonts existent. Si les répertoires n’existent pas, utilisez la commande ln pour créer un lien symbolique à partir de /usr/share/X11/fonts vers /usr/lib/X11/fonts et un autre lien symbolique à partir de /usr/share/fonts vers /usr/share/X11/fonts. Vérifiez également que les polices Courier sont disponibles à l’emplacement /usr/lib/X11/fonts.
  • Vérifiez que toutes les polices (Unicode et non Unicode) sont disponibles dans le répertoire /usr/share/fonts ou /usr/share/X11/fonts.
  • Lorsque vous exécutez le service PDF Generator en tant qu’utilisateur non root, donnez à l’utilisateur non root un accès en lecture et en écriture à tous les répertoires de polices.
  • À chaque installation de nouvelles polices dans le dossier de polices, redémarrez l’instance AEM Forms.

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 Rechercher des téléchargements pour filtrer les résultats.
  4. Appuyez sur le nom applicable à votre système d’exploitation, sélectionnez Accepter les conditions du CLUF, 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 Version 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 la variable [AEM-Installation-Directory]/crx-quickstart/logs/error.log et le journal est stable.

Configurations post-installation

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

  1. Désactivez l’instance AEM. Accédez au dossier [Répertoire d’installation AEM]\crx-quickstart\conf. Ouvrez le fichier sling.properties pour modification.

    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.*
    
  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 Managers. Indiquez le chemin d’accès des répertoires des polices système, Adobe Server et 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 vérifier et de vous assurer que vous êtes conforme à tous les contrats de licence non-Adobe applicables avant d’utiliser des polices non-Adobe avec un logiciel Adobe, en particulier concernant l’utilisation de polices dans un environnement serveur.
    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 les étapes de création d’un utilisateur local, voir Créer un compte d’utilisateur dans Windows ou créer un compte d’utilisateur sur des plateformes UNIX.

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

  2. Dans l’onglet Comptes d’utilisateurs, saisissez les informations d’identification d’un compte d’utilisateur local, puis cliquez sur Envoyer. Si Microsoft® Windows vous invite, autorisez l’accès à l’utilisateur. Une fois ajouté, l’utilisateur configuré est affiché 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 Jacorb ORB Provider.

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

    jacorb.connection.client.pending_reply_timeout=600000

  2. Connectez-vous à l’instance de création AEM et accédez à Adobe Experience Manager > Outils > Forms > Configuration de 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 :

Champ Description Valeur par défaut
Expiration de conversion sur le serveur Une conversion PDFG reste active pendant le nombre de secondes définies dans le délai de conversion du serveur. 270 secondes
Secondes d’analyse de nettoyage PDFG Nombre de secondes requises pour exécuter des opérations après la conversion.
3600 secondes
Secondes avant expiration de la tâche Durée pendant laquelle le service PDF Generator peut exécuter une conversion. Assurez-vous que la valeur de Secondes avant expiration de la tâche est supérieure à celle de Secondes d’analyse de nettoyage PDFG. 7200 secondes

(Windows uniquement) Configurer 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 de PDF. Pour configurer Adobe Acrobat pour le service PDF Generator, procédez comme suit :

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

  2. Cliquez deux fois 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. Ouvrir AEM Gestionnaire de modules et téléchargez le fichier adobe-aemfd-pdfg-common-pkg-[version].zip à partir du 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 [extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\adobe-aemfd-pdfg-common-pkg-[version]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version] répertoire . 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écuter Outil System Readiness (SRT) pour valider l’installation d’Acrobat.

(Windows uniquement) Configurer l’itinéraire principal pour la conversion de fichiers HTML en 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 peut gérer le contenu dynamique, ne dépend pas des bibliothèques 32 bits, JDK 32 bits et ne nécessite aucune police supplémentaire. 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 votre choix dans le menu déroulant Itinéraire principal pour les conversions HTML en PDF.

Initialisez Global Trust Store

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 un Trust Store. Définissez le mot de passe, puis cliquez 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.

Pour configurer les certificats, procédez comme suit :

  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 de magasin de clés, puis 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ʼadresse 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 :
Nom du service Nom du lot
Service Signatures adobe-aemfd-signatures
Service Reader Extensions com.adobe.aemfd.adobe-aemfd-readerextensions
Service Forms com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Service Output com.adobe.livecycle.adobe-lc-forms-bedrock-connector

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.

Outil System Readiness (SRT)

L’outil System Readiness vérifie si l’ordinateur est correctement configuré pour exécuter les conversions de PDF Generator. L’outil génère un rapport à l’emplacement spécifié. Pour exécuter l’outil :

  1. Ouvrez une invite de commandes et accédez au dossier [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools.

  2. Exécutez la commande suivante à partir de l’invite de commande :

    java -jar forms-srt-[version].jar [Path_of_reports_folder] en

    La commande génère un rapport et crée également le fichier srt_config.yaml .

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

    • Vous pouvez utiliser le fichier srt_config.yaml pour configurer différents paramètres de . Le format du fichier est le suivant :

       # =================================================================
       # SRT Configuration
       # =================================================================
       #Note - follow correct format to avoid parsing failures
       #e.g. <param name>:<space><param value>
       #locale: (mandatory field)Locale to be used for SRT. Supported locales [en/fr/de/ja].
       locale: en
    
       #aemTempDir: AEM Temp direcotry
       aemTempDir:
    
       #users: provide PDFG converting users list
       #users:
       # - user1
       # - user2
       users:
    
       #profile: select profile to run specific checks. Choose from [LCM], more will be added soon
       profile:
    
       #outputDir: directory where output files will be saved
       outputDir:
    
  3. Accédez à [Path_of_reports_folder]. Ouvrez le fichier SystemReadinessTool.html. Vérifiez le rapport et résolvez les problèmes mentionnés.

Résolution des problèmes

Si vous rencontrez des problèmes même après avoir corrigé tous les problèmes signalés par l’outil SRT, effectuez les vérifications suivantes :

Avant d’effectuer les vérifications suivantes, assurez-vous que Outil System Readiness ne signale aucune erreur.

 Adobe Acrobat
  • Assurez-vous uniquement que version prise en charge de Microsoft® Office (32 bits) et Adobe Acrobat est installé et les boîtes de dialogue d’ouverture sont annulées.
  • Assurez-vous que le service de mise à jour Adobe Acrobat est désactivé.
  • Assurez-vous que la variable Acrobat_for_PDFG_Configuration.bat Le fichier batch a été exécuté avec les privilèges d’administrateur.
  • Assurez-vous qu’un utilisateur de PDF Generator est ajouté à l’interface utilisateur de configuration du PDF.
  • Assurez-vous que la variable Remplacer un jeton de niveau processus La permission est ajoutée pour l’utilisateur de PDF Generator.
  • Assurez-vous que l’ajout COM d’Acrobat PDFMaker Office est activé pour les applications Microsoft Office.
 Open Office

Microsoft® Windows

  • Assurez-vous que version prise en charge de Microsoft Office est installé et les boîtes de dialogue d’ouverture sont annulées pour toutes les applications.
  • Assurez-vous qu’un utilisateur de PDF Generator est ajouté à l’interface utilisateur de configuration du PDF.
  • Assurez-vous que l’utilisateur de PDF Generator est membre du groupe administrateurs et que la variable Remplacer un jeton de niveau processus est défini pour l’utilisateur.
  • Assurez-vous que l’utilisateur est configuré dans l’interface utilisateur de PDF Generator et effectuez les actions suivantes :
    1. Connectez-vous à Microsoft® Windows avec l’utilisateur PDF Generator.
    2. Ouvrez les applications Microsoft® Office ou Open Office et annulez toutes les boîtes de dialogue.
    3. Définissez Adobe PDF comme imprimante par défaut.
    4. Définissez Acrobat comme programme par défaut pour les fichiers du PDF.
    5. Effectuez une conversion manuelle à l’aide des options Fichier > Imprimer et ruban Acrobat dans les applications Microsoft Office et annulez toutes les boîtes de dialogue.
    6. Arrêtez tous les processus liés à la conversion tels que winword.exe, powerpoint.exe et excel.exe.
    7. Redémarrez le serveur AEM Forms.

Linux®

  • Assurez-vous que version prise en charge Une fois Open Office installé, les boîtes de dialogue d’ouverture sont annulées pour toutes les applications et les applications Office sont lancées avec succès.
  • Création d’une variable d’environnement OpenOffice_PATH et la définir pour qu’elle pointe vers l’installation OpenOffice est définie dans la variable console ou le profil dt (arborescence de l’appareil).
  • En cas de problèmes lors de l’installation d’OpenOffice, assurez-vous que Bibliothèques 32 bits La configuration requise pour l’installation d’OpenOffice est disponible.

Problèmes de conversion +++ HTML vers PDF

  • Assurez-vous que les répertoires de polices sont ajoutés dans l’interface utilisateur de configuration de PDF Generator.

Linux et Solaris (itinéraire de conversion PhantomJS)

  • Assurez-vous que la bibliothèque 32 bits est disponible (libicudata.so.42) pour la conversion HTMLToPDF basée sur Webkit et que les bibliothèques 64 bits (libicudata.so.42) sont disponibles pour la conversion HTMLToPDF basée sur PhantomJS.

  • Exécutez la commande suivante pour répertorier les bibliothèques manquantes pour phantomjs :

    ldd phantomjs | grep not
    
  • Assurez-vous que la variable d’environnement JAVA_HOME_32 pointe vers l’emplacement approprié.

Linux® et Solaris™ (itinéraire de conversion WebKit)

  • Assurez-vous que les répertoires /usr/lib/X11/fonts et /usr/share/fonts existent. Si les répertoires n’existent pas, créez un lien symbolique à partir de /usr/share/X11/fonts to /usr/lib/X11/fonts et un autre lien symbolique de /usr/share/fonts to /usr/share/X11/fonts.

    ln -s /usr/share/fonts /usr/share/X11/fonts
    
    ln -s /usr/share/X11/fonts /usr/lib/X11/fonts
    
  • Assurez-vous que les polices IBM sont copiées sous usr/share/fonts.

  • Assurez-vous que le correctif de vulnérabilité fantôme glibc est disponible sur l’ordinateur. Utilisez votre gestionnaire de packages par défaut pour effectuer la mise à jour vers la dernière version de glibc. Cela inclut la correction de la vulnérabilité des fantômes.

  • Assurez-vous que les dernières versions des bibliothèques libcrypto, libcrypto et libssl 32 bits sont installées sur le système. Créer également des liens symboliques /usr/lib/libcurl.so (ou libcurl.a pour AIX®), /usr/lib/libcrypto.so (ou libcrypto.a pour AIX®) et /usr/lib/libssl.so (ou libssl.a pour AIX®) pointant vers les dernières versions (32 bits) des bibliothèques respectives.

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

    1. Copiez le fichier java.security de <WAS_Installed_JAVA>\jre\lib\security à n’importe quel emplacement de votre serveur AEM Forms. L’emplacement par défaut est Default Location = <WAS_Installed>\Appserver\java_[version]\jre\lib\security.

    2. Modifiez le fichier java.security à l’emplacement copié et modifiez les usines de socket SSL par défaut avec les usines JSSE2 (utilisez les usines JSSE2 au lieu de WebSphere®).

      Modifiez les usines de socket JSSE par défaut suivantes :

      #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
      

      par

      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
      

+++

 Impossible d’ajouter un utilisateur PDF Generator (PDFG)
  • Assurez-vous que Microsoft® Visual C++ 2012 x86 et Microsoft® Visual C++ 2013 x86 (32 bits) redistribuables sont installés sous Windows.
 Échec des tests d’automatisation
  • Pour Microsoft® Office et OpenOffice, effectuez au moins une conversion manuellement (chaque utilisateur) afin de garantir qu’aucune boîte de dialogue ne s’affiche pendant la conversion. S'il y a un dialogue, il le rejette. Aucune boîte de dialogue de ce type ne doit apparaître lors de la conversion automatisée.

  • Avant d’exécuter l’automatisation sur un environnement AEM Forms on OSGi, assurez-vous que le package de test est installé et principal.

 Échecs de conversion de plusieurs utilisateurs
  • Vérifiez les journaux du serveur pour vérifier si la conversion échoue pour un utilisateur particulier.(l’Explorateur de processus peut vous aider à vérifier l’exécution du processus pour différents utilisateurs)

  • Assurez-vous que l’utilisateur configuré pour PDF Generator dispose des droits d’administrateur locaux.

  • Assurez-vous que l’utilisateur de PDF Generator dispose des autorisations de lecture, d’écriture et d’exécution sur les utilisateurs temporaires LC temp et PDFG.

  • Pour Microsoft® Office et OpenOffice, effectuez au moins une conversion manuellement (chaque utilisateur) afin de garantir qu’aucune boîte de dialogue ne s’affiche pendant la conversion. S'il y a un dialogue, il le rejette. Aucune boîte de dialogue de ce type ne doit apparaître lors de la conversion automatisée.

  • Effectuez un exemple de conversion.

 Expiration de la licence d’Adobe Acrobat installée sur AEM Forms Server
  • Si vous disposez d’une licence Adobe Acrobat existante qui a expiré, Télécharger la dernière version de Adobe Application Manageret migration de votre numéro de série. Avant migration de votre numéro de série.

    • Utilisez les commandes ci-dessous pour générer le fichier ar.xml et resérialiser l’installation existante à l’aide du fichier xml au lieu des commandes fournies dans migration de votre numéro de série article numéro.

       &quot;
      
       adobe_prtk —tool=VolumeSerialize —generate —serial=&lt;serialnum> [—leid=&lt;leid>] [—regsuppress=ss] [—eulasuppress] [—locales=liste limitée de paramètres régionaux au format xx_XX ou ALL>] [—procurfile=&lt;absolute path=&quot;&quot; to=&quot;&quot; prov.xml=&quot;&quot;>]
      
       &quot;
      
    • Sérialisez en volume le package (resérialisez l’installation existante à l’aide du fichier de confirmation.xml et de la nouvelle série) : Exécutez la commande suivante à partir du dossier d’installation PRTK en tant qu’administrateur pour sérialiser et activer les packages déployés sur les ordinateurs clients :

       &quot;
       adobe_prtk —tool=VolumeSerialize —provider=C:\prov.xml -stream
      
       &quot;
      
  • Pour les installations à grande échelle, utilisez la méthode Acrobat Customization Wizard pour supprimer les versions précédentes de Reader et Acrobat. Personnalisez le programme d’installation et déployez-le sur tous les ordinateurs de votre entreprise.

 AEM Forms Server se trouve dans un environnement hors ligne ou sécurisé et Internet n’est pas disponible pour activer Acrobat.
  • Vous pouvez vous connecter dans les 7 jours suivant le premier lancement de votre produit Adobe pour terminer une activation et une inscription en ligne ou utiliser un appareil compatible avec Internet et le numéro de série de votre produit pour terminer ce processus. Pour obtenir des instructions détaillées, voir Activation hors ligne.

Étapes suivantes

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

Sur cette page