Références aux sorties PDF pour la conception de canevas

Consultez ces informations pour en savoir plus sur la génération de documents PDF avec le pilote PDF de Rational Publishing Engine.

Objectif

Permet de générer le canevas dans un document .pdf.

visualiseurs de contenu pris en charge

Pour obtenir la liste des produis pris en charge pour l'affichage de ce type de sortie :
  1. Ouvrez Configuration requise pour Rational Publishing Engine .
  2. Dans la section By type, cliquez sur Software.
  3. Accédez à la section Content viewers. Les noms et versions de produit pris en charge pour l'affichage des sorties de Rational Publishing Engine sont répertoriés.

Choix entre les pilotes PDF

Le pilote PDF par défaut génère des fichiers PDF version 1.5. Vous pouvez tout de même choisir d'utiliser le pilote PDF existant, qui génère des fichiers PDF version 1.4.

Si vous créez une spécification de document dans Rational Publishing Engine 1.1.2.1 ou une version antérieure et que vous l'ouvrez à l'aide de Rational Publishing Engine 1.1.2.2 ou une version ultérieure, les paramètres PDF sont migrés vers les paramètres PDF et PDF existants de cette dernière version. Si vous créez une spécification de document dans Rational Publishing Engine 1.1.2.2 ou une version ultérieure et que vous l'ouvrez dans Rational Publishing Engine 1.1.2.1 ou une version antérieure, le pilote PDF existant est utilisé par défaut. Si les pilotes PDF et PDF existants ont tous les deux été configurés dans la spécification de document 1.1.2.2 ou une version ultérieure, les deux instances PDF sont créées et identiques. Si cette duplication a lieu, vous pouvez supprimer le pilote en double de la spécification de document.

Eléments de canevas

Tableau 1. Eléments de canevas pouvant être utilisés pour le format de sortie PDF
Elément Description Peut contenir d'autres éléments Peut contenir des valeurs de contenu et des expressions

Paragraphe icône Paragraphe

Permet de regrouper une section d'éléments. Ajoute un retour chariot autour de ses éléments enfant dans la sortie.

Oui

Non

Icône Conteneur Conteneur

Permet de regrouper une section d'éléments. Ne peut pas être mis en style et n'affecte pas le formatage de la sortie.

S'ils sont utilisés dans d'autres éléments, les éléments enfant pouvant être utilisés dans le conteneur peuvent être limités. Exemple :
  • A l'intérieur des lignes, les conteneurs ne peuvent héberger que des cellules
  • A l'intérieur des listes, les conteneurs ne peuvent héberger que des éléments de détails de liste

Oui

Non

Icône Texte Texte

Le contenu est affiché avec le même formatage spécifié.

Non

Oui

Texte mis en style icône Texte mis en style

Bloc de texte pouvant avoir un formatage unique sur des mots individuels. Utilisez le formatage gras, italique, souligné, barré ou couleur sur une sélection de mots dans l'élément. Le texte est statique.

Non

Oui

Icône Lien hypertexte Lien hypertexte

Crée un lien hypertexte dans la sortie. Le lien hypertexte peut pointer vers un emplacement à l'intérieur du document ou un emplacement externe.

Non

Oui

Icône Image Image

Affiche une image .gif, .png, .jpg, emf ou wmf dans la sortie. Le concepteur de rapport peut spécifier le chemin d'accès de l'image dans le canevas ou le générateur de rapports peut spécifier le chemin d'accès lors de la phase d'exécution.

Non

Oui

Icône Table Table

Crée une table dans la sortie. Une table peut contenir des lignes ou des éléments de conteneur.

Oui

Non

Icône Ligne Ligne

Crée une ligne dans la table actuelle.

Oui

Non

Icône Cellule Cellule

Crée une cellule dans la ligne actuelle de la table actuelle.

Oui

Non

Liste icône Liste

Crée une liste à puces ou une liste numérique dans la sortie.

Oui

Non

Détails de liste icône Détails de liste

Crée un élément de liste dans la liste actuelle de la sortie.

Oui

Non

Icône Configuration de la source de données Configuration de la source de données

Voir Ajout d'un élément de configuration de source de données.

Non

Non

Icône Fichier d'inclusion Fichier d'inclusion

Inclut le fichier spécifié dans la sortie sous forme de zone INCLUDETEXT.

  • Le fichier inclus peut avoir une extension .doc, .docx, .txt, ou .rtf.
  • Pour une sortie Microsoft Word, vous devez mettre à jour toutes les zones avec la macro pour voir le fichier inclus.
  • Pour une sortie PDF existant, HTML ou XSL-FO, le fichier inclus est un lien hypertexte au document.

Non

Oui

Icône Région Région

Les régions sont des éléments statiques qui vous permettent de modifier le flux de sortie en réacheminant le contenu des autres éléments ou groupes d'éléments. Si pour un élément, la propriété Région cible est spécifiée avec le nom d'un élément de région, son contenu est affiché dans la région spécifiée et non à sa position dans le document.

Non

Non

Icône Signet Signet

Définit un signet dans le document. Le nom du signet généré correspond au contenu du signet. Lors de la génération de documents, Rational Publishing Engine génère un nom unique pour chaque signet. Ce nom est basé sur le nom fourni lors de la phase de conception et sur un identificateur unique généré lors de la phase d'exécution.

Non

Oui

Icône de saut de page Saut de page

Ajoute un saut de page à la sortie.

Non

Non

Saut de section icône Saut de section

Ajoute un saut de section à la sortie.

Non

Non

Icône Table des matières Table des matières

Ajoute une table des matières à la sortie.

Non

Non

Numéro de page icône Numéro de page

Ajoute un numéro de page dans la sortie. Pris en charge dans les sorties Microsoft Word et PDF.

Non

Non

Nombre total de pages icône Nombre total de pages

Ajoute le nombre total de pages dans la sortie. Pris en charge pour les sorties Microsoft Word et PDF.

Non

Non

Si la génération du PDF est lente, ajoutez des éléments Saut de section icône d'élément Saut de section au canevas pour améliorer les performances.

Propriétés d'élément

Consultez ces remarques pour en savoir plus sur la spécification des propriétés d'élément dans les canevas conçus pour générer des documents PDF.
Tableau 2. Propriétés de cellule
Propriétés de cellule Remarques
Largeur de la bordure Vous devez spécifier une largeur de bordure comprise entre 1 et 30 pixels pour créer une bordure dans la sortie.
Alignement de cellule Cette propriété indique la position du texte dans la cellule. La valeur Justifié n'est pas prise en charge pour ce format de sortie.
Largeur de cellule Entrez une valeur en points ou en pixels. Si vous entrez une valeur en pixels, cette valeur est convertie en points et suppose que l'affichage est de 96 dpi. Si vous entrez une valeur comme pourcentage, cette valeur est ignorée. Lorsque vous combinez des tables, vous devez définir la propriété Largeur de cellule pour vous assurer que les tailles des colonnes sont identiques.
Etendue de colonne Toutes les lignes et les colonnes doivent contenir le même nombre de cellules. Les bordures entre les cellules sont supprimées, mais seul le contenu ou les propriétés indiqués pour la première cellule sont appliqués à la sortie. Evitez les étendues qui se chevauchent.
Etendue de ligne Toutes les lignes et les colonnes doivent contenir le même nombre de cellules. Les bordures entre les cellules sont supprimées, mais seul le contenu ou les propriétés indiqués pour la première cellule sont appliqués à la sortie. Evitez les étendues qui se chevauchent.
Tableau 3. Propriétés de commentaires
Propriétés de commentaires Remarques
Contenu Si vous incluez des liens hypertexte dans la propriété Contenu des éléments Commentaire, il n'est pas possible de cliquer sur ces liens dans la sortie PDF.
Tableau 4. Propriétés de légende de figure
Propriétés de légende de figure Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.
Code de zone Les chiffres arabes ou romains sont affichés de manière séquentielle sur chaque légende.
Tableau 5. Propriétés de note de bas de page
Propriétés de note de bas de page Remarques
Nom du style Si vous appliquez un style aux éléments en ligne, par exemple les notes de bas de page, le texte, le texte mis en style, ou les tables, ce style est appliqué à l'ensemble des éléments en ligne jusqu'à l'élément de bloc suivant, par exemple un paragraphe. Par exemple, si vous ajoutez un style à un élément de note de bas de page et que celui-ci est précédé d'un élément de texte mis en style, le style est également appliqué à cet élément de texte mise en style.
Tableau 6. Propriétés de l'image
Propriétés de l'image Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.
Contenu Formats d'image pris en charge : .bmp, .emf, .gif, .jpg, .png, .wmf

Les images .svg sont prises en charge par Rational Publishing Engine, mais pas par Microsoft Word. Le pilote PDF utilise une fonctionnalité de Microsoft Word. Pour générer correctement le document dans la sortie PDF, les images .svg sont converties en images .png. Le processus de conversion peut déformer l'affichage de l'image dans la sortie.

Tableau 7. Propriétés de la liste
Propriétés de la liste Remarques
Style de numérotation Vous pouvez utiliser les styles suivants :
  • Puce : listes non ordonnées
  • Arabe: listes numérotées
  • Romain majuscule : nombres romains en majuscules
  • Romain minuscule : nombres romains en minuscules
  • Alphanumérique majuscule : lettres en majuscules
  • Alphanumérique minuscule : lettres en minuscules
Espacement des caractères N'utilisez pas ce format de sortie.
Tableau 8. Propriétés des détails de liste
Propriétés des détails de liste Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.
Tableau 9. Propriétés de numéro de page
Propriétés de numéro de page Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.
Tableau 10. Propriétés de paragraphe
Propriétés de paragraphe Remarques
Largeur de la bordure Vous devez spécifier une largeur de bordure comprise entre 1 et 30 pixels pour créer une bordure dans la sortie.
Alignement de paragraphe Espace le texte dans la page avec un certain alignement.

Les alignements à gauche, à droite et au centre créent des bords de paragraphe irréguliers en essayant de placer autant de mots que possible dans un paragraphe. Justifié crée des bords de paragraphe réguliers en insérant un espace supplémentaire entre les mots sur toutes les lignes, exceptée la dernière ligne.

N'utilisez pas Distribué pour ce format de sortie.

Eviter veuves et orphelines Si la valeur est true, l'interligne est ajusté pour éviter les résultats de formatage suivants :
  • Un seul mot terminant un paragraphe sur une nouvelle ligne
  • Un seule ligne terminant un paragraphe sur une nouvelle page

Si la valeur est false, l'interligne n'est pas ajusté.

Tableau 11. Propriétés de ligne
Propriétés de ligne Remarques
Saut de ligne dans les pages Si la valeur est true, le contenu d'une ligne à la fin d'une page est fractionné, si nécessaire. Le contenu qui ne tient pas sur la page se reporte sur la page suivante sous la forme d'une nouvelle ligne.

Si la valeur est false, le contenu d'une ligne à la fin d'une page n'est pas fractionné. L'intégralité de la ligne passe à la page suivante.

Tableau 12. Propriétés des textes mis en style
Propriétés des textes mis en style Remarques
Nom du style Si vous appliquez un style aux éléments en ligne, par exemple les notes de bas de page, le texte, le texte mis en style, ou les tables, ce style est appliqué à l'ensemble des éléments en ligne jusqu'à l'élément de bloc suivant, par exemple un paragraphe. Par exemple, si vous ajoutez un style à un élément de note de bas de page et que celui-ci est précédé d'un élément de texte mis en style, le style est également appliqué à cet élément de texte mise en style.
Tableau 13. Propriétés de table
Propriétés de table Remarques
Ajuster au contenu Redimensionne la table en fonction du contenu de chaque cellule. Si vous utilisez cette propriété, affectez également à la propriété Redimensionner pour s'ajuster au contenu la valeur true.
Ajuster à la fenêtre Redimensionne la table en fonction de la largeur de la page. Désélectionnez cette propriété si Redimensionner pour s'ajuster au contenu possède la valeur false.
Largeur de la bordure Vous devez spécifier une largeur de bordure comprise entre 1 et 30 pixels pour créer une bordure dans la sortie.
Style de bordure Utilisez la valeur single au lieu de thick, hairline, inset ou outset. Le même formatage est appliqué pour toutes ces valeurs et ressemble pour la plupart à ce que vous obtiendrez pour single.
Espacement des cellules N'utilisez pas ce format de sortie.
Largeur de cellule fixe dans la colonne Indiquez une valeur en pixels pour vous assurer que toutes les cellules d'une colonne sont de même largeur.
Redimensionner pour s'ajuster au contenu Si la valeur est true et que Largeur et Ajuster à la fenêtre sont désélectionnés, la largeur de la colonne est ajustée en fonction du contenu. Si Ajuster au contenu est spécifié, vous devez affecter à Redimensionner automatiquement pour ajuster au contenu la valeur true.

Si la valeur est false, désélectionnez les propriétés Largeur et Ajuster à la fenêtre de la table. La table est générée avec la taille de colonne par défaut d'un pouce.

Nom du style Si vous appliquez un style aux éléments en ligne, par exemple les notes de bas de page, le texte, le texte mis en style, ou les tables, ce style est appliqué à l'ensemble des éléments en ligne jusqu'à l'élément de bloc suivant, par exemple un paragraphe. Par exemple, si vous ajoutez un style à un élément de note de bas de page et que celui-ci est précédé d'un élément de texte mis en style, le style est également appliqué à cet élément de texte mise en style.
Ajustement automatique de la table Si la valeur est true, la table est redimensionnée en fonction de la largeur de la page. Si Redimensionner pour s'ajuster au contenu possède également la valeur true, les largeurs des cellules sont ignorées et la table est redimensionnée en fonction du contenu.

Vous ne pouvez pas entrer Largeur de colonne fixe comme valeur. Utilisez la propriété Largeur de cellule fixe à la place.

Largeur Vous devez spécifier une valeur, sauf si la propriété Redimensionner pour s'ajuster au contenu a la valeur false.
Tableau 14. Propriétés des légendes de table
Propriétés des légendes de table Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.
Code de zone Les chiffres arabes ou romains sont affichés de manière séquentielle sur chaque légende.
Tableau 15. Propriétés du texte
Propriétés du texte Remarques
Largeur de la bordure Vous devez spécifier une largeur de bordure comprise entre 1 et 30 pixels pour créer une bordure dans la sortie.
Nom du style Si vous appliquez un style aux éléments en ligne, par exemple les notes de bas de page, le texte, le texte mis en style, ou les tables, ce style est appliqué à l'ensemble des éléments en ligne jusqu'à l'élément de bloc suivant, par exemple un paragraphe. Par exemple, si vous ajoutez un style à un élément de note de bas de page et que celui-ci est précédé d'un élément de texte mis en style, le style est également appliqué à cet élément de texte mise en style.
Tableau 16. Propriétés du nombre total de pages
Propriétés du nombre total de pages Remarques
Largeur de la bordure N'utilisez pas ce format de sortie.

Elément Fichier d'inclusion

Vous pouvez choisir d'associer le fichier ou de l'imbriquer physiquement dans votre document de sortie. Toutefois, la manière dont les éléments de fichier d'inclusion sont traités dépend du format de sortie et de l'emplacement à partir duquel vous extrayez le fichier. Pour une sortie PDF, le fichier inclus est importé et l'intégralité du contenu du document est affiché.

Styles d'en-tête

Les formats de sortie PDF n'ont pas de style d'en-tête ; toutefois, Rational Publishing Engine utilise des styles d'en-tête définis en interne.

Données Unicode dans la sortie

Toutes les données Unicode sont affichées si la police utilisée prend en charge le format Unicode. Pour une sortie PDF, une configuration supplémentaire est nécessaire. Pour plus de détails, voir Définition des propriétés de sortie des documents PDF. Si vous avez utilisé une police non Unicode, régénérez le document en utilisant les polices Unicode True Type et définissez les propriétés de sortie appropriées.

Objets OLE

Vous pouvez extraire des objets imbriqués, tels que des objets OLE (Object linking and embedding), des attributs d'une source de données. Les objets OLE sont cependant toujours affichés comme des images dans les sorties PDF, car ce format ne prend pas en charge les objets OLE.

Retour d'informations