Canevas de document

Un canevas de document est un plan directeur pour la génération de documents. Le canevas définit les données à extraire de la source de données et la manière dont elles sont formatées.

Les canevas de document sont des fichiers archive autonomes avec l'extension .dta (archive de canevas de document). Vous pouvez partager, déplacer et copier un canevas. Les canevas de document créés avec des versions antérieures d'IBM® Rational Publishing Engine fonctionnent avec la dernière version. Toutefois, si votre fournisseur de données ne prend pas encore en charge la dernière version de la structure de canevas de Rational Publishing Engine, vous pouvez définir la version du canevas de sorte qu'elle utilise la structure de canevas des versions précédentes de Rational Publishing Engine.

Vous pouvez ajouter aussi bien un contenu statique que dynamique à un canevas de document. Le contenu statique inclut le texte et les images fournis à la conception du canevas. Le contenu dynamique est représenté par les données obtenues des sources de données lorsque le document est généré. Le canevas définit également les informations de formatage, bien que certaines données puissent conserver les informations de formatage qui y sont imbriquées à partir de la source de données.

Un canevas de document peut contenir :

Schéma de source de données dans les canevas

Lorsque vous définissez le canevas, vous utilisez la définition de votre structure de données, appelée schéma, au lieu de données statiques. Cela permet d'appliquer le canevas à toute source de données dont la structure correspond à la structure de la source de données de définition. Un canevas peut contenir n'importe quel nombre de schémas source de données.

Si une source de données ne correspond pas exactement au schéma de source de données, Rational Publishing Engine traite les éléments qui correspondent au schéma et ignore les erreurs non critiques. Par exemple, si un attribut Rational DOORS statut est utilisé dans le canevas et que la source de données réelle (module DOORS) ne comporte pas cet attribut, la génération de documents se poursuit par défaut.

Rational Publishing Engine fournit les mécanismes de création et d'obtention de schémas pour plusieurs types de source de données, tels que des sources de données IBM Rational DOORS, IBM Rational Tau, et Rational REST. Pour plus d'informations sur la définition de schéma standard, voir http://www.w3.org/XML/Schema. Vous pouvez utiliser une application tiers pour générer un schéma à partir des données XML.

Réutilisation des canevas

Vous pouvez réutiliser les structures de canevas des canevas stockés en local, à distance ou dans le composant Gestion centralisée. Une fois que vous avez créé un canevas, vous pouvez importer des canevas complets dans un canevas principal à condition que les canevas que vous importez ne fassent pas référence à d'autres canevas. Créez des fragments pour les sections de documents que vous réutilisez de manière régulière, telles que les en-têtes et les bas de page.

Lorsque vous importez des canevas, vous pouvez les référencer de manière dynamique ou les imbriquer physiquement. Lorsque vous référencez dynamiquement un canevas ou un fichier inclus, suivant le type de sortie dans lequel vous générez le canevas, vous ajoutez un lien vers ce canevas ou fichier ou chargez le contenu du canevas importé lorsque vous générez la sortie. Lorsque vous imbriquez physiquement un canevas ou un fichier, vous importez son contenu dans votre canevas principal immédiatement et non lors de la phase d'exécution.

En cas de conflits entre le canevas principal et le canevas que vous référencez ou imbriquez, vous êtes invité à les résoudre. Par exemple, les conflits peuvent inclure des schémas de source de données différents. Si les schémas de source de données sont différents, le schéma du canevas importé peut être ajouté au canevas principal pour résoudre le conflit.

Spécifications de document par défaut

Chaque canevas est associé à une spécification de document vide par défaut. Lorsque vous prévisualisez ou publiez un canevas à partir de l'application Document Studio, cette spécification de document vide peut être personnalisée ou utilisée sans personnalisation pour générer la sortie. Document Studio conserve le canevas synchronisé avec la spécification de document par défaut lorsque vous ouvrez ou sauvegardez le canevas.

Commentaires