Références aux sorties Microsoft Word pour la conception de canevas

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

Objectif

Générer le canevas dans les documents suivants :
Extension Format du document généré
.doc Microsoft Word 2003.
.docx Microsoft Word 2007, sans la possibilité d'exécuter des macros.
.docm Microsoft Word 2007, avec la possibilité d'exécuter des macros.

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.

Eléments de canevas

Tableau 1. Eléments de canevas pouvant être utilisés pour le format de sortie Microsoft Word
Elément Description Peut contenir d'autres éléments Peut contenir des données
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
Note de bas de page icône Note de bas de page Crée une note de bas de page dans la page de sortie actuelle. Le texte de la note de bas de page correspond au contenu de l'élément de note de bas de page. Pris en charge uniquement pour les sorties Microsoft Word. 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 Commentaire Commentaire Ajoute un commentaire à la sortie. Le format et la forme du commentaire de la sortie est spécifique au format de sortie.

Pris en charge pour Microsoft Word et PDF.

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
Icône Table des tables Table des tables Ajoute une table des tables à la sortie. Vous devez ajouter des légendes de table dans votre canevas de document pour générer une table des tables dans la sortie.

Pris en charge uniquement pour les sorties Microsoft Word.

Vous devez mettre à jour toutes les zones du document Microsoft Word pour afficher la valeur de la zone et pouvoir la mettre à jour.

Non Non
Icône Table des tables Table des tables Ajoute une table des tables à la sortie. Vous devez ajouter des légendes de table dans votre canevas de document pour générer une table des tables dans la sortie.

Pris en charge uniquement pour les sorties Microsoft Word.

Vous devez mettre à jour toutes les zones du document Microsoft Word pour afficher la valeur de la zone et pouvoir la mettre à jour.

Non Non
Zone icône Zone Ajoute un élément de zone Microsoft Word générique. Vous pouvez saisir tout code Microsoft Word valide dans la propriété du code de zone.

Pris en charge uniquement pour les sorties Microsoft Word.

Vous devez mettre à jour toutes les zones du document Microsoft Word pour afficher la valeur de la zone et pouvoir la mettre à jour.

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
Légende de table icône Légende de table Ajoute une légende de table. Vous ne pouvez pas spécifier de contenu dynamique dans une légende de table, mais tout texte ultérieur y est concaténé.

Pris en charge pour les sorties Microsoft Word et PDF.

Vous devez mettre à jour toutes les zones du document Microsoft Word pour afficher la valeur de la zone et pouvoir la mettre à jour.

Non Non
Légende de figure icône Légende de figure Ajoute une légende de figure. Vous ne pouvez pas spécifier de contenu dynamique dans une légende de figure, mais tout texte ultérieur y est concaténé.

Pris en charge pour les sorties Microsoft Word et PDF.

Vous devez mettre à jour toutes les zones du document Microsoft Word pour afficher la valeur de la zone et pouvoir la mettre à jour.

Non Non

Propriétés d'élément

Consultez ces remarques pour en savoir plus sur la spécification des propriétés d'élément des canevas conçus pour générer des documents Microsoft Word.
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.
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 Microsoft Word.
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. Pour générer correctement le document dans la sortie Microsoft Word, 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 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 8. 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 9. 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.

à 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. Distribué est similaire à Justifié, mais cet espace est également inséré entre les mots de la dernière ligne du paragraphe.

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 10. 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 11. 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 12. 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.
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.
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 automatiquement pour ajuster au contenu Si la valeur est true, les lignes ne sont pas scindées, sauf si un espace est présent. En l'absence d'espace, les lignes ne sont pas scindées et la largeur de la colonne s'aligne sur celle du texte. Si Ajuster au contenu est spécifié, vous devez affecter à Redimensionner automatiquement pour ajuster au contenu la valeur true.

Si la valeur est false, la largeur de colonne est fixe et les lignes sont scindées quels que soient les espaces utilisés ou la longueur du texte. En outre, la propriété Ajustement automatique de la table est ignorée.

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 indiquez une valeur.
Tableau 13. 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 14. 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 15. 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.

Longueur de table

Lorsque des canevas sont conçus pour être générés dans des documents Microsoft Word, la longueur de table doit être prise en compte.

Des tables longues peuvent s'étendre sur plusieurs pages. Lorsque cela se produit, sélectionnez un élément Ligne dans la table, puis définissez la propriété Saut de ligne dans les pages sur true dans la vue Propriétés. Une fois cette propriété définie, vos tables peuvent s'étendre sur plusieurs pages.

Tables des matières, figures et tables dans les documents Microsoft Word

Pour ajouter une table des matières à votre sortie, définissez-la dans votre canevas ou feuille de style. Si vous définissez la table des matières dans le canevas, elle n'est pas affichée dans le document Microsoft Word tant que vous n'avez pas mis à jour les zones du document. Pour mettre à jour les zones, utilisez la fonction Mettre à jour les champs ou Mettre à jour la table de Microsoft Word ou les macros de la feuille de style rpe.dot. La feuille de style rpe.dot se trouve dans l'installation de Rational Publishing Engine : %RPE_HOME%\utils\word\rpe.dot. La même procédure s'applique aux tables des figures et aux tables des tables.

Légendes dans les documents Microsoft Word

Les légendes des figures et des tables ne sont pas mises à jour automatiquement. Pour mettre à jour les zones, utilisez la fonction Mettre à jour les champs de Microsoft Word ou les macros de la feuille de style rpe.dot. La feuille de style rpe.dot se trouve dans l'installation de Rational Publishing Engine : %RPE_HOME%\utils\word\rpe.dot.

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 la sortie Microsoft Word, les Rational Publishing Engine met automatiquement à jour les zones Microsoft Word lors de la génération de documents. Si une zone INCLUDE TEXT est générée, la macro ne s'est pas exécutée et la tâche d'importation du fichier est déléguée à Microsoft Word. Un fichier d'inclusion n'est pas visible dans le document de sortie tant que toutes les zones n'ont pas été mises à jour. Pour mettre à jour les zones, utilisez la fonction Mettre à jour les champs de Microsoft Word ou les macros de la feuille de style %RPE_HOME%\utils\word\rpe.dot.
Conseil : Un document Microsoft Word lié à d'autres fichiers n'est pas autonome. Le déplacement du document sur d'autres ordinateurs vous empêche de visualiser le contenu des documents liés. Si une visualisation est requise, utilisez la fonction Rompre les liaisons (Alt+E+K dans Microsoft Office 2007) de Microsoft Word pour inclure le contenu d'un fichier lié.

Styles d'en-tête

Pour utiliser des styles d'en-tête prédéfinis pour les documents Microsoft Word (Heading 1, Heading 2, ... , Heading 9), utilisez le nom de style 1, 2, à 9.

Styles Rational Publishing Engine et styles externes

Utilisez autant que possible des styles externes, qui sont définis dans une feuille de style. Cette approche permet de modifier rapidement l'aspect du document de sortie et d'homogénéiser l'aspect des documents dans toute l'entreprise.

En-têtes de numérotation pour Microsoft Word

Utilisez une feuille de style avec des en-têtes numérotés pour obtenir des en-têtes numérotés comme liste hiérarchique.

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 Microsoft Word, si vous avez utilisé une police non Unicode, modifiez la police dans le document de sortie après la génération du document.

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. Pour une sortie Microsoft Word, vous devez définir la propriété OLEs as static images dans la section des métadonnées de la spécification de document.
Le dossier ref contient les fichiers .rtf des objets OLE. Pour chaque objet OLE exporté, la sortie Microsoft Word comporte une zone incluse pointant vers un fichier .rtf. IBM® Rational Publishing Engine ne pouvant pas mettre à jour les zones Microsoft Word, les zones incluses ne sont pas visibles lorsque le document Microsoft Word est ouvert. Pour les rendre visibles, effectuez l'une des actions suivantes :
Tableau 16. Actions
Action Résultat
Sélectionnez l'intégralité du contenu du document et utilisez la fonction Mettre à jour les champs de Microsoft Word. Les objets OLE sont affichés dans le document. Ce document n'est pas autonome.
Utilisez la macro updateFields fournie par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document n'est pas autonome.
Utilisez la macro insertOLEs fournie par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document est autonome.
Utilisez les macros rpe ou insertOLEs fournies par Rational Publishing Engine. Les objets OLE sont affichés dans le document. Ce document est autonome.
Remarque : Si vous déplacez un document qui n'est pas autonome vers un autre ordinateur, vous ne pouvez pas modifier les objets OLE. Pour éviter ce problème, exécutez la macro insertOLEs.

Retour d'informations