Utiliser le Service Assembler using-assembler-service

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Le service Assembler vous permet de combiner, d’organiser et d’étendre vos documents aux formats PDF et XDP. Grâce à lui, vous pouvez également obtenir des informations sur les documents PDF. Chacun des travaux envoyés au service Assembler inclut un document DDX (Document Description XML), ainsi qu’un ensemble de documents source et de ressources externes (chaînes et graphiques). Pour plus d’informations sur le service Assembler, voir Présentation du service Assembler.

Vous pouvez utiliser le service d’assemblage pour les opérations suivantes :

Assembler des documents PDF assemble-pdf-documents

Vous pouvez utiliser le service Assembler pour assembler deux documents PDF ou plus en un seul document PDF ou portfolio PDF. Vous pouvez également appliquer différentes fonctions au document PDF, afin de faciliter la navigation ou d’optimiser la sécurité. Vous trouverez ci-dessous quelques façons d’assembler des documents PDF :

Assemblage d’un document de PDF simple assemble-a-simple-pdf-document

L’illustration suivante présente la fusion de trois documents source en un seul document cible.

Assemblage d’un document PDF unique à de documents PDF multiples
Figure : Assemblage d’un document de PDF simple à partir de plusieurs documents de PDF

L’exemple suivant représente un document DDX utilisé pour assembler ce document. Il spécifie les noms des documents source utilisés pour produire le document cible, ainsi que le nom du document cible :

<PDF result="Doc4">
<PDF source="Doc1"/>
<PDF source="Doc2"/>
<PDF source="Doc3"/>
</PDF>

L’assemblage de documents crée des documents finaux qui contiennent le contenu et
les caractéristiques suivants :

  • Tout ou partie de chaque document source
  • Tous ou une partie des signets de chaque document source, normalisés pour le document cible assemblé
  • Autres caractéristiques adoptées à partir du document de base (Doc1), notamment les métadonnées, les libellés de page et la taille de page
  • Le document généré peut éventuellement inclure une table des matières créée à partir des signets dans les documents source.

Créer un portfolio PDF create-a-pdf-portfolio

Le service Assembler peut créer des portfolios PDF qui contiennent une collection des documents et une interface d’utilisateur indépendante. Cette interface est appelée Interface de portfolio PDF ou Navigateur de portfolio PDF (navigateur). Les portfolios PDF élargissent les capacités des packages PDF en ajoutant un navigateur, des dossiers et des pages d’accueil. L’interface améliore l’expérience de l’utilisateur, qui peut profiter des chaînes de texte localisées, des schémas de couleurs et des ressources graphiques personnalisées. Le Portfolio du PDF peut également inclure des dossiers pour organiser les fichiers du portfolio.

Lorsque le service Assembler interprète le document DDX suivant, il regroupe un portfolio PDF qui inclut un navigateur de portfolio PDF et un package contenant deux fichiers. Le service récupère le navigateur à l’emplacement indiqué par la source myNavigator. Il remplace le modèle de couleurs par défaut du navigateur par le modèle de couleurs pinkScheme.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1">
<Portfolio>
<Navigator source="myNavigator"/>
<ColorScheme scheme="pinkScheme"/>
</Portfolio>
<PackageFiles>
<PDF source="sourcePDF1"/>
<PDF source="sourcePDF2"/>
</PackageFiles>
</PDF>
</DDX>

Assembler des documents chiffrés assemble-encrypted-documents

Lors de l’assemblage d’un document, vous pouvez également chiffrer le document PDF avec un mot de passe. Après le chiffrement d’un document PDF avec un mot de passe, l’utilisateur doit spécifier un mot de passe pour l’afficher dans Adobe Reader ou Acrobat. Pour chiffrer un document de PDF avec un mot de passe, le document DDX doit contenir les valeurs d’élément de chiffrement requises pour chiffrer un document de PDF.

Le service Encryption ne doit pas nécessairement faire partie de votre installation de LiveCycle pour chiffrer un document de PDF avec un mot de passe.

Si un ou plusieurs des documents d’entrée sont chiffrés, fournissez un mot de passe pour ouvrir le document dans le cadre du DDX.

Assembler des documents à l’aide de la numérotation Bates assemble-documents-using-bates-numbering

Lors de l’assemblage d’un document, vous pouvez utiliser la numérotation Bates pour affecter un identifiant de page unique à chaque page. Avec la numérotation Bates, à chaque page du document (ou de l’ensemble de documents) correspond un numéro qui identifie la page de manière unique. Par exemple, des documents d’entreprise contenant une nomenclature et liés à la production d’un assemblage peuvent contenir un identifiant. Un numéro Bates contient une valeur numérique incrémentée séquentiellement et optionnellement un préfixe et un suffixe. Le préfixe + valeur numérique + suffixe est appelé modèle Bates.

L’illustration suivante présente un document PDF contenant un identifiant unique, situé dans l’en-tête du document.

Un document PDF qui contient un identifiant unique qui se trouve dans l’en-tête du document
Figure : Un document PDF contenant un identifiant unique situé dans l’en-tête du document.

Aplatir et assembler des documents flatten-and-assemble-documents

Vous pouvez utiliser le service Assembler pour transformer un document PDF interactif (par exemple, un formulaire) en document PDF non interactif. Un document PDF interactif permet aux utilisateurs de saisir ou de modifier des données contenues dans les champs de ce document. Le processus de transformation d’un document PDF interactif à un document PDF non interactif est appelé aplatissement. Lors de l’aplatissement, les champs des formulaires gardent leur apparence graphique mais ne sont plus interactifs. S’assurer que les données ne peuvent être modifiées est l’une des raisons de l’aplatissement d’un document PDF. En outre, les scripts associés aux champs ne fonctionnent plus.

Lorsque vous créez un document de PDF assemblé à partir de documents de PDF interactifs, le service Assembler aplatit ces formulaires avant de les assembler dans le document généré.

NOTE
Le service Assembler utilise le service Output pour aplatir les formulaires XFA dynamiques. Si le service Assembler traite un DDX ayant besoin qu’il aplatisse un formulaire XFA dynamique et que le service Output n’est pas disponible, une exception est générée. Le service Assembler peut aplatir un formulaire Acrobat ou un formulaire XFA statique sans utiliser le service Output.

Assemblage de documents XDP assemble-xdp-documents

Vous pouvez utiliser le service Assembler pour assembler un ou plusieurs documents XDP en un document PDF ou XDP unique. Pour les fichiers XDP source contenant des points d’insertion, vous pouvez spécifier les fragments à insérer.

Voici quelques méthodes d’assemblage de documents XDP :

Assemblage d’un document XDP simple assemble-a-simple-xdp-document

L’illustration suivante présente la fusion de trois documents XDP source en un seul document XDP cible. Le document XDP produit contient les trois documents XDP source, ainsi que les données connexes. Le document cible récupère les attributs de base du document d’origine (premier document XDP source).

Assemblage d’un document XDP unique de plusieurs documents XDP
Figure : Assemblage d’un document XDP simple à partir de plusieurs documents XDP

Voici un document DDX qui produit le résultat illustré ci-dessus.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>

Résolution des références pendant l’assemblage resolving-references-during-assembly

Habituellement, les documents XDP peuvent contenir des images référencées par le biais de références absolues ou relatives. Par défaut, le service Assembler conserve les références aux images dans le document XDP généré.

Vous pouvez spécifier la manière dont le service Assembler gère les images référencées dans les documents XDP source, par le biais de références absolues ou relatives dans les fichiers XDP lors de l’assemblage. Vous pouvez choisir d’incorporer toutes les images dans la cible, de sorte qu’elle ne contienne aucune référence absolue ou relative. Ce paramètre est défini en spécifiant la valeur de la balise resolveAssets, qui peut correspondre à l’une des options suivantes. Par défaut, aucune référence n’est résolue dans le document de résultat.

Valeur
Description
aucune
Ne résout aucune référence.
toutes
Incorpore toutes les images référencées dans le document XDP source.
relative
Incorpore toutes les images référencées par le biais de références relatives dans le XDP source.
document.
absolu
Incorpore toutes les images référencées par le biais de références absolues dans le XDP source.
document.

Vous pouvez spécifier la valeur de l’attribut resolveAssets dans la balise XDP source ou dans la balise XDP cible parente. Si l’attribut est spécifié pour la balise XDP cible, il est hérité par tous les éléments XDP source qui sont des enfants de la cible XDP. Toutefois, la spécification explicite de l’attribut pour un élément source remplace le paramètre de l’élément de résultat pour ce seul document source.

Résolution de toutes les références source dans un document XDP resolve-all-source-references-in-an-xdp-document

Pour résoudre toutes les références dans les documents XDP sources, spécifiez l’attribut resolveAssets pour le
document généré à tous, comme dans l’exemple ci-dessous :

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="all">
<XDP source="input1.xdp" />
<XDP source="input2.xdp" />
<XDP source="input3.xdp" />
</XDP>
</DDX

Vous pouvez également spécifier l’attribut pour tous les documents XDP sources séparément afin d’obtenir le même
résultat.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp">
<XDP source="input1.xdp" resolveAssets="all"/>
<XDP source="input2.xdp" resolveAssets="all"/>
<XDP source="input3.xdp" resolveAssets="all"/>
</XDP>
</DDX>

Résolution de références source sélectionnées dans un document XDP resolve-selected-source-references-in-an-xdp-document

Vous pouvez spécifier de manière sélective les références source à résoudre en définissant leur attribut resolveAssets. Les attributs pour les différents documents source remplacent le paramètre du document XDP cible. Dans cet exemple, les fragments inclus sont également résolus.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="all">
<XDP source="input1.xdp" >
<XDPContent source="fragment.xdp" insertionPoint="MyInsertionPoint"
fragment="myFragment"/>
</XDP>
<XDP source="input2.xdp" />
</XDP>
</DDX>

Résolution sélective de références absolues ou relatives selectively-resolve-absolute-or-relative-references

Vous pouvez résoudre de manière sélective les références absolues ou relatives dans tous ou une partie des documents source, comme illustré dans l’exemple ci-dessous :

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="absolute">
<XDP source="input1.xdp" />
<XDP source="input2.xdp" />
</XDP>
</DDX

Insertion dynamique de fragments de formulaire dans un formulaire XFA dynamically-insert-form-fragments-into-an-xfa-form

Vous pouvez utiliser le service Assembler pour créer un formulaire XFA à partir d’un autre formulaire XFA, dans lequel des fragments ont été insérés. Cette fonctionnalité vous permet d’utiliser des fragments pour créer plusieurs formulaires.

L’insertion dynamique des fragments de formulaire étant prise en charge, le contrôle du code source unique est possible. Il vous suffit de disposer d’une source unique pour les composants les plus couramment utilisés. Par exemple, vous pouvez créer un fragment pour la bannière de votre entreprise. Si cette dernière change, vous n’aurez qu’à modifier le fragment. Les autres formulaires qui incluent le fragment sont inchangés.

Les concepteurs de formulaires utilisent LiveCycle Designer pour créer des fragments de formulaire. Ces fragments sont appelés sous-formulaires dans un formulaire XFA. Via Designer, les concepteurs de formulaires peuvent également créer des formulaires XFA présentant des points d’insertion dont le nom est unique. Vous (le programmeur) écrivez des documents DDX qui spécifient comment les fragments sont insérés dans le formulaire XFA.

L’illustration suivante représente deux formulaires XML (modèles XFA). Le formulaire placé à gauche contient un point d’insertion appelé myInsertionPoint. Le formulaire à droite contient un fragment nommé myFragment.

Insertion des fragments des formulaires à un formulaire XFA
Figure : Insérer des fragments de formulaire dans un formulaire XFA

Lorsque le service Assembler interprète le document DDX suivant, il crée un formulaire XML contenant un autre formulaire XML. Le sous-formulaire myFragment du document myFragmentSource est inséré au niveau de myInsertionPoint du document myFormSource.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="myFormResult">
<XDP source="myFormSource">
<XDPContent fragment="myFragment" insertionPoint="myInsertionPoint"
source="myFragmentSource"/>
</XDP>
</XDP>
</DDX

Regroupez un document XDP en tant que PDF package-an-xdp-document-as-pdf

Vous pouvez utiliser le service Assembler pour assembler un document XDP en tant que document de PDF, comme indiqué dans ce document DDX.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1" encryption="passEncProfile1">
<XDP>
<XDP source="sourceXDP3"/>
<XDP source="sourceXDP4"/>
</XDP>
</PDF>
</DDX>

Désassembler des documents PDF disassemble-pdf-documents

Vous pouvez utiliser le service Assembler pour désassembler un document PDF. Ce service peut extraire des pages du document source ou diviser un document source en fonction de signets. En règle générale, cette tâche est utile si le document du PDF a été créé à l’origine à partir de nombreux documents individuels, comme une collection d’instructions.

Extraction de pages d’un document source extract-pages-from-a-source-document

Dans l’illustration suivante, les pages 1 à 3 sont extraites du document source et insérées dans un nouveau document cible.

Extraction de pages spécifiques à partir d’un document source
Figure : Extraction de pages spécifiques d’un document source

L’exemple suivant est un document DDX utilisé pour désassembler le document.

<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>

Diviser un document source en fonction de signets divide-a-source-document-based-on-bookmarks

Sur l’illustration suivante, DocA est divisé en plusieurs documents générés. Le premier signet de niveau 1 d’une page identifie le début d’un nouveau document généré.

Division d’un document source en fonction de signets en plusieurs documents
Figure : Division d’un document source en fonction de signets en plusieurs documents

L’exemple suivant est un document DDX qui utilise des signets pour désassembler un document source.

<PDFsFromBookmarks prefix="A">
<PDF source="DocA"/>
</PDFsFromBookmarks>

Déterminer si les documents sont conformes au PDF/A determine-whether-documents-are-pdf-a-compliant

Vous pouvez utiliser le service Assembler pour déterminer si un document PDF est compatible PDF / A. PDF / A est un format d’archivage, prévu pour la conservation sur le long terme du contenu d’un document. Les polices sont incorporées dans le document et le fichier est décompressé. Par conséquent, un document PDF/A est généralement plus volumineux qu’un document PDF standard. De plus, un document PDF/A ne contient aucune donnée audio et vidéo.

Obtention d’informations sur un document de PDF obtain-information-about-a-pdf-document

Vous pouvez utiliser le service Assembler pour obtenir les informations suivantes concernant un document PDF :

  • Informations sur le texte.

    • Mots sur chaque page du document
    • Position de chaque mot sur chaque page du document
    • Phrases dans chaque paragraphe de chaque page du document
  • Nombre de signets (incluant le numéro de la page, le titre, la destination et l’apparence). Vous pouvez exporter ces données à partir d’un document PDF et les importer dans un document PDF.

  • Pièces jointes, y compris les informations sur les fichiers. Pour les pièces jointes au niveau de la page, l’emplacement de l’annotation du fichier joint est également inclus. Vous pouvez exporter ces données à partir d’un document de PDF et les importer dans un document de PDF.

  • Les fichiers de package, y compris les informations sur les fichiers, dossiers, packages, schémas et données de champ. Vous pouvez exporter ces données à partir d’un document de PDF et les importer dans un document de PDF.

Validation des documents DDX validate-ddx-documents

Vous pouvez utiliser le service Assembler pour déterminer si un document DDX est valide. Par exemple, si vous avez effectué une mise à niveau à partir d’une version de LiveCycle précédente, la validation garantit que votre document DDX est valide.

Appel d’autres services call-other-services

Vous pouvez utiliser les document DDX qui cause le service Assembler pour appeler aux services LiveCycle suivantes. Le service Assembler peut uniquement appeler les services installés avec LiveCycle.

Service Reader Extensions: Permet aux utilisateurs d’Adobe Reader de signer numériquement le document du PDF généré.

Service Forms: Fusionne un fichier XDP et un fichier de données XML pour produire un document de PDF contenant le formulaire interactif rempli.

Service de sortie : Convertit un formulaire XML dynamique à un document PDF contenant un formulaire non interactive (aplatissement du formulaire). Le service Assembler aplatit des formulaires XML statiques et des formulaires Acrobat sans appeler le service Output.

<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="outDoc">
<PDF source="doc1"/>
<PDF source="doc2"/>
<ReaderRights
credentialAlias="LCESCred"
digitalSignatures="true"/>
</PDF>
</DDX>

L’utilisation du DDX et du service Assembler pour appeler d’autres services LiveCycle peut simplifier le diagramme de procédure. Il peut également réduire l’effort de personnalisation de vos flux de travail. (Voir également, Utiliser Document Services d’AEM par programmation)

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da