Scénario : Création de mises en page et de mises en page de fragments

Une mise en page définit l’apparence graphique d’une courrier. La mise en page peut contenir des champs de formulaire types tels qu’« Adresse » et « Numéro de référence ». Elle contient également des sous-formulaires vides indiquant les zones cible.

Le concepteur de formulaires crée la mise en page et, une fois celle-ci réalisée, le spécialiste d’applications la télécharge vers la solution Correspondence Management. A partir de là, la mise en page peut être sélectionnée lorsqu’on crée un modèle de correspondance. Les spécialistes d’applications mappent du contenu (textes et images) vers les zones cible et ils lient des champs de formulaire à des sources de données.

Les spécialistes d’applications peuvent utiliser une même mise en page pour créer des modèles de correspondance différents. Par exemple, la mise en page ClaimSubrogation reproduite ci-dessous contient plusieurs zones cible, dont certaines peuvent être réutilisées dans d’autres modèles de courrier :

Afficher le graphique en taille réelle
Mise en page ClaimSubrogation

Présentation de l’implémentation

Procédez comme indiqué ci-après afin de créer des mises en page pour la solution Correspondence Management :

  1. Analysez la mise en page et déterminez le contenu qui se répétera sur toutes les pages. Il s’agit en général de l’en-tête et du pied de page. Ce contenu est placé sur les gabarits de la mise en page. Le contenu restant va dans le corps des pages de la mise en page. Dans un dossier de police, le logo et l’adresse de la société pourront être ajoutés à l’en-tête ou au pied de page du gabarit (voir Analyse de votre correspondance existante). Par exemple, dans le modèle de solution, l’avis de renouvellement et l’avis d’annulation utilisent la même mise en mise en page (voir Présentation de la solution Correspondence Management).

  2. Lors de la conception des pages courantes, divisez le contenu des pages en sections. Chaque section est conçue comme un sous-formulaire intégré dans la mise en page ou comme une mise en page de fragment. Choisissez la bonne approche en vous inspirant des règles suivantes :
    • Si la section contient un tableau, modélisez-la comme mise en page de fragment.

  3. Une mise en page peut être conçue comme suit :
    • Faites de chaque section un sous-formulaire distinct contenant tous les éléments de la section.

    • Faites de chaque section un enfant du même sous-formulaire parent. La mise en page du sous-formulaire parent est définie de manière à permettre à la disposition des sections de s’ajuster si les sections précédentes accueillent des données fusionnées en quantité importante.

    • La section Résidence principale peut être réutilisée dans d’autres mises en page. Créez-la comme une mise en page de fragment.

    • La section Détails d’intérêt supplémentaires ne contient que deux éléments placé l’un au-dessous de l’autre, elle peut contenir des données de grande taille et elle est conçue comme une disposition souple.

    • D’autres sections contiennent des éléments à des positions spécifiques ; elles sont donc conçues comme des mises en page positionnées.

    • Eclatez une section en plusieurs sous-formulaires si la section contient des éléments à des positions spécifiques et si ces éléments contiennent de grandes quantités de données. Organisez ensuite les sous-formulaires pour obtenir le comportement souhaité.

    • Pour la section Résidence principale, ajoutez une zone cible d’espace réservé. Cet espace réservé est lié au fragment Résidence principale au moment de la conception du courrier.

  4. Envoyez par téléchargement la mise en page et la mise en page des fragments à l’aide de l’interface de gestion des actifs.

Outils utilisés

  • LiveCycle Designer pour créer des mises en page et des mises en page de fragments.

  • l’interface utilisateur de gestion des actifs pour télécharger la mise en page et les mises en page de fragments vers le système Correspondence Management.

Membres de l’équipe

Le concepteur de formulaires effectue les tâches décrites dans le présent scénario. Il a une connaissance approfondie de LiveCycle Designer.

Création d’une mise en page pour Correspondence Management

Version cible

Utilisez LiveCycle Designer pour créer des mises en page ciblant XFA version 2.8 ou ultérieure. Pour vous assurer que votre mise en page utilise la bonne version cible :

  1. Dans LiveCycle Designer, cliquez sur Fichier > Propriétés du formulaire > Valeurs par défaut et définissez Acrobat/Reader 9.0 comme version cible.

  2. Accédez à la vue source XML et confirmez que la version du modèle est 2.8. Par exemple :

    <template xmlns="http://www.xfa.org/schema/xfa-template/2.8/">

  3. Dans le nœud du modèle, recherchez le nœud originalXFA et si vous le trouvez, supprimez-le. Par exemple :

    <?originalXFAVersion http://www.xfa.org/schema/xfa-template/2.6/?>

  4. Appliquez toutes les modifications apportées à la source XML en basculant sur une autre vue.

Création de sous-formulaires de zone cible

Par défaut, tous les sous-formulaires qui sont vides de contenu sont considérés comme des zones cible. Si votre mise en forme contient un sous-formulaire vide qui n’est pas considéré comme une zone cible, nommez-le avec un suffixe « _int » (interne), par exemple WithScript_int. Utilisez un sous-formulaire vide en tant que fragment contenant uniquement une série d’objets de script utilisés dans différents formulaires. Dans ce cas, le sous-formulaire apparaît vide mais n’est pas considéré comme une zone cible. Les nœuds considérés comme du contenu sont : area, draw, exclGroup, exObject, field, subform et subformSet.

Un sous-formulaire de zone cible nécessite les éléments suivants :

  • un nom ;

  • une largeur (non extensible) ;

  • une position (x, y) ;

  • disposition souple.

Un sous-formulaire de zone cible ne doit pas  :

  • avoir une liaison (liaison définie sur « aucune ») ;

  • inclure du contenu (des nœuds enfants de type area, draw, exclGroup, exObject, field, subform ou subformSet) ;

  • inclure un suffixe « _int » dans son nom ;

  • se trouver sur une page de gabarit.

Utilisation d’un schéma

Vous pouvez utiliser un schéma dans une mise en page ou dans une mise en page de fragment, mais ce n’est pas obligatoire. Si vous utilisez un schéma, vérifiez les éléments suivants :
  • La mise en page et toutes les mises en page de fragments utilisées dans une lettre utilisent le même schéma que la lettre.

  • Tous les champs obligatoires à remplir avec des données sont liés au schéma.

Création de champs associables

Par défaut, tous les champs sont considérés comme pouvant être associés à diverses sources de données. Si votre mise en page contient des champs qui ne sont pas associables à une source de données, nommez ces champs à l’aide d’un suffixe « _int » (interne), par exemple pageCount_int.

Un champ associable doit :

  • être un <champ> XFA ou <exclGroup> ;

  • disposer d’une référence de liaison XFA ;

  • s’il s’agit d’un champ <exclGroup>, il doit contenir au moins un champ de bouton radio enfant, faute de quoi son type de valeur ne pourra pas être déterminé.

Un champ associable doit :

  • avoir un nom.

Un champ associable ne doit pas :

  • inclure de suffixe « _int » dans son nom ;

  • avoir une liaison définie comme « aucune » ;

  • être l’enfant d’un élément <exclGroup> .

Dès lors qu’un champ associable répond aux critères décrits ci-dessus, il peut être situé à n’importe quel emplacement et dans n’importe quel niveau d’imbrication de la mise en page. Vous pouvez utiliser les champs associables dans les pages de gabarit.

La configuration de la mise en page des champs est plus flexible que celle des sous-formulaires de zone cible. Mais les champs sont liés à un seul type de valeur. Vous pouvez définir un champ pour qu’il soit grand ou définir le champ avec une hauteur ou une largeur fixes, etc. Le résultat du module ou de la règle est envoyé dans le champ.

Quand utiliser des sous-formulaires et des champs de texte

Utilisez un sous-formulaire si vous voulez capturer plusieurs contenus de module dans une mise en forme de haut en bas à flux vertical (plusieurs paragraphes ou images). Votre mise en page doit gérer le fait que le sous-formulaire se développe en hauteur afin d’accueillir son contenu. Si vous n’êtes pas sûr que la longueur du contenu associé au sous-formulaire/à la cible ne dépassera jamais l’espace réservé dans la mise en page pour le sous-formulaire, créez ce dernier en tant qu’enfant dans un conteneur de sous-formulaires à disposition souple. Cette procédure garantit que les objets de mise en page situés en dessous du sous-formulaire se déplaceront vers le bas au fur et à mesure que le sous-formulaire s’agrandira.

Utilisez un champ si vous souhaitez capturer dans votre schéma de mise en page des données de module ou d’élément du dictionnaire de données (car les champs sont liés à des données) ou pour afficher un contenu de module dans une page de gabarit. N’oubliez pas que le contenu d’une page de gabarit ne présente pas une disposition souple modulable en fonction du contenu de la page. Assurez-vous donc que le champ d’image est utilisé comme logo de l’en-tête. Par exemple, s’il est défini pour restreindre le contenu de l’image à sa zone de contenu, plutôt que pour afficher le contenu de l’image à sa taille d’origine. Dans le cas contraire, pour une image de grande taille, l’image est affichée sous un contenu de page courante.

Le tableau qui suit indique plusieurs critères permettant de décider quand utiliser un sous-formulaire ou un champ dans une mise en page.

Utilisez un sous-formulaire lorsque

Utilisez un champ de texte lorsque

Il contient une combinaison d’éléments, tels que Nom de famille et Prénom.

Il contient un seul élément, tel que Numéro de police.

Il comprend plusieurs paragraphes.

Le texte passe à la ligne suivante et est justifié.

Les groupes de données conditionnels, facultatifs et répétitifs sont liés à des sous-formulaires afin de réduire le risque d’erreurs de conception susceptibles de survenir lorsque des scripts sont utilisés pour obtenir les mêmes résultats.

Les éléments tels que le logo et l’adresse de votre organisation apparaissent sur toutes les pages d’une lettre. Dans ce cas, créez des champs de formulaire pour ces éléments et placez-les sur la page de gabarit. Si vous définissez la liaison du champ comme « Aucune liaison de données », le champ Aucun champ apparaît comme champ associable dans l’Editeur de lettre. Si vous souhaitez associer certains types de contenu à ces champs, ces derniers doivent contenir des liaisons.

Si l’adresse de votre société contient plusieurs lignes de données, utilisez deux champs de texte avec l’option « Autoriser plusieurs lignes » pour représenter l’adresse dans la mise en page.

Si le type de données d’un champ de texte est défini comme texte brut, la sortie du module se fait en version texte brut plutôt qu’en version texte enrichi (toutes les mises en forme sont ignorées). Pour conserver la mise en forme, définissez le type de données du champ de texte comme texte enrichi.

Le texte fait l’objet d’une disposition souple.

Les champs de texte et d’image sont utilisés dans les pages de gabarit. Les pages de gabarit ne peuvent pas utiliser de sous-formulaires comme zones cible.

Les objets sont groupés et organisés sans lier le sous-formulaire à un élément de données.

 

Le sous-formulaire contient un champ de texte. Le sous-formulaire peut s’agrandir sans écraser les autres objets situés plus bas dans la mise en page.

Vous avez besoin d’accéder facilement à ses données dans le post-traitement.

Configuration d’éléments répétitifs

Lorsque des éléments comme le logo et l’adresse de votre organisation figurent sur toutes les pages d’une lettre, créez des champs de formulaire pour ces éléments et placez-les sur la page de gabarit. Utilisez la liaison Nom (Nom du champ) pour ces champs.

Spécifiez le format de rendu du serveur.

Utilisez le format de rendu du serveur de la mise en page pour le formulaire XML dynamique, faute de quoi aucune lettre basée sur cette mise en page ne s’affichera correctement. Par défaut, le format de rendu du serveur dans LiveCycle Designer est défini comme formulaire XML dynamique. Pour vous assurer que vous utilisez le format correct :

 Dans LiveCycle Designer, cliquez sur Fichier > Propriétés de formulaire > Valeurs par défaut et assurez-vous que la configuration de Format/Rendu PDF est définie comme formulaire XML dynamique.

Meilleures pratiques/conseils et astuces

Définissez la liaison de sous-formulaire par défaut

Lorsque vous créez des zones cible dans LiveCycle Designer, il est utile de définir par défaut comme « Aucune » la liaison pour tous les nouveaux sous-formulaires. Pour définir la liaison par défaut :

  1. Dans LiveCycle Designer, cliquez sur Outils > Options > Liaisons de données > Liaison de sous-formulaire.

  2. Dans la liste Liaison par défaut pour nouveaux sous-formulaires, sélectionnez Aucune liaison de données.

    Cela garantit que les sous-formulaires insérés à l’aide de la commande Insérer > Sous-formulaire ou par glisser-déposer depuis la palette Objets ont par défaut une liaison de type « Aucune ». Cela signifie que, par défaut, tout nouveau sous-formulaire est une zone cible à moins que vous n’y ajoutiez du contenu, que vous ne modifiiez ses paramètres de liaison ou que vous ne le renommiez avec un suffixe « _int ».

Conformité à la section 508

Si la version définitive de la lettre créée dans l’interface utilisateur Create Correspondence est utilisée pour compléter un flux de travail ultérieur, lors de la création de la mise en page, appliquez les recommandations suivantes qui sont en rapport à la section 508. Dans les autres cas, le PDF de la lettre est utilisé à des fins d’affichage et vous pouvez ignorer les recommandations ci-dessous :

  • Tous les sous-formulaires de zone cible et tous les champs d’une mise en page ont un ordre de tabulation.

  • Les champs contenant des légendes sont par défaut conformes à la section 508. L’attribut de champ /field/assist/speak@priority est défini par défaut comme « personnalisé », ce qui signifie que le lecteur d’écran lit la légende du champ à moins que le texte de l’écran de lecture personnalisé ne soit fourni.

  • La définition de /field/assist/speak@priority="toolTip" et la spécification du texte de l’info-bulle dans /field/assist/toolTip font que les champs sans légende spécifient une info-bulle et indiquent aux lecteurs d’écran de lire l’info-bulle.

Formats des dates dans Designer et Asset Configuration Manager

Lors de la création d’une mise en forme dans LiveCycle Designer, assurez-vous que les formats des champs de dates sont conformes aux formats de dates définis dans Asset Configuration Manager. Pour plus d’informations, voir Formater des valeurs de champ et utiliser des modèles dans l’Aide de LiveCycle Designer.

Capture des plages de dates

Lorsque vous avez affaire à une combinaison de dates, telles que startDate-endDate, utilisez un sous-formulaire unique afin de garantir un alignement correct dans la lettre définitive et de minimiser le nombre de champs.

Définition de liaison au niveau du formulaire

Lorsqu’une mise en forme contient de nombreux champs et zones cible mappés à des éléments XML uniques, utilisez la liaison au niveau du formulaire et créez un nœud distinct pour chaque élément. Les champs liés au niveau du formulaire sont ignorés lors du mappage des données dans Correspondence Management.

N’utilisez pas de zones cible de sous-formulaire dans une page de gabarit

Les zones cible de sous-formulaire d’une page de gabarit ne sont pas visibles dans l’interface utilisateur de gestion des actifs et aucune donnée ne peut leur être mappée.

Choix des positions et des types appropriés pour les zones cible

Lors de la conception de la mise en forme, soyez attentifs au choix des sous-formulaires. Si la mise en page contient un seul sous-formulaire, il peut s’agir d’un type de disposition souple. Après avoir positionné les champs dans le sous-formulaire, vous pouvez les encapsuler dans un autre sous-formulaire afin que le sous-formulaire encapsulé soit également de disposition souple et que la mise en page ne soit pas perturbée.

Positionnement des champs sur les gabarits

Notez les points suivants lorsque vous placez un champ sur un gabarit :

  • Définissez la liaison de champs de page principale pour utiliser les données globales

  • Ne placez pas le champ directement sous l’objet pageArea racine du gabarit.

  • Placez le champ dans un sous-formulaire et vérifiez que la liaison du sous-formulaire nommé est définie sur Utiliser un nom.