Utilisation du service Assembler

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

Afficher le graphique en taille réelle

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

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

L’assemblage de documents génère un document cible présentant certaines caractéristiques et contenant les éléments suivants :

• totalité ou partie de chacun des documents source ;

• totalité ou partie des signets de chacun des documents source, normalisés pour le document cible assemblé ;

• autres caractéristiques adoptées à partir du document de base (Doc1), telles que les métadonnées, les intitulés de page et la taille des pages ;

• le document produit peut inclure une table des matières générée à partir des signets présents dans les documents source (facultatif).

Le service Assembler peut créer des portfolios PDF contenant un ensemble de documents et une interface utilisateur autonome. 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 PDF peut également contenir des dossiers pour organiser les fichiers du portfolio.

Lorsque le service Assembler interprète le document DDX suivant, il assemble 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 change le schéma de couleur par défaut du navigateur, le remplaçant par pinkScheme.

<DDX xmlns="http://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>

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 PDF avec un mot de passe, le document DDX doit contenir les valeurs d’élément de chiffrement requises.

Il n’est pas nécessaire que le service Encryption fasse partie de votre installation LiveCycle pour chiffrer un document PDF avec un mot de passe.

Si un ou plusieurs des documents d’entrée sont chiffrés, vous devez fournir un mot de passe pour ouvrir ce ou ces documents dans le DDX.

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. L’ensemble 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.

Afficher le graphique en taille réelle

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 en 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. De plus, les scripts associés aux champs ne fonctionnent plus.

Lorsque vous créez un document PDF assemblé à partir de documents PDF interactifs, le service Assembler aplatit les formulaires avant de les assembler en un même 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).

Afficher le graphique en taille réelle

Voici le document DDX produisant la sortie illustrée ci-dessus.

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

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

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, le fait de spécifier de façon explicite l’attribut pour un élément source remplace le paramètre de l’élément cible pour ce document source uniquement.

<DDX xmlns="http://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>

<DDX xmlns="http://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>

<DDX xmlns="http://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>

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

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 fonction 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 incluant ce fragment ne seront pas altérés.

Les concepteurs de formulaires utilisent 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. En tant que programmeur, vous pouvez rédiger des documents DDX définissant le mode d’insertion des fragments 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. Celui de droite inclut un fragment appelé myFragment.

Afficher le graphique en taille réelle

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

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

Vous pouvez utiliser le service Assembler pour convertir un document XDP en document PDF, comme le montre ce document DDX.

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