Création d'une expression de script pour mettre en style les en-têtes

Vous pouvez créer des styles d'en-tête ou des variables avec certaines propriétés de formatage.

Pourquoi et quand exécuter cette tâche

Dans les sorties Microsoft Word, PDF et HTML, vous pouvez créer des titres de section et affecter des styles d'en-tête à ces titres, pour créer une hiérarchie informationnelle dans votre document. Rational Publishing Engine requiert une affectation numérique pour ces titres, qui commence par 1, à laquelle seront associés les numéros de style d'en-tête. Certaines données que vous souhaitez affecter aux styles d'en-tête ne commencent pas par 1 ou utilisent des valeurs de chaîne au lieu de valeurs numériques. Enfin, pour compliquer encore plus la normalisation de ces styles entre tous les formats de sortie, chaque format de sortie utilise des noms différents pour ces styles d'en-tête. Par exemple, dans Microsoft Word, le style d'en-tête le plus grand est appelé Titre 1. En HTML, le même style d'en-tête s'intitule H1.

Vous pouvez utiliser l'expression JavaScript parseInt(nom_attribut_ou_variable) pour associer les valeurs d'attribut ou de variable avec des valeurs numériques commençant par 1. Ensuite, pour créer des sous-entêtes sur les données enfant, ajoutez un à l'expression : parseInt(nom_attribut_ou_variable) + 1. Cette expression de script permet aux valeurs de correspondre de manière incrémentielle aux styles d'en-tête de toutes les sorties Microsoft Word, PDF et HTML.

Procédure

  1. Faites glisser un élément Texte icône Texte dans l'éditeur de contenu de canevas.
  2. Sélectionnez l'élément de texte.
  3. Dans la vue Propriétés, sélectionnez l'onglet Général.
  4. Dans la zone Nom du Style, cliquez sur l'icône de configuration icône de configuration.
  5. Sélectionnez l'onglet Expression de script.
  6. Sélectionnez une variable ou un attribut.
  7. Entrez l'expression JavaScript : parseInt(nom_attribut_ou_variable) + 1
  8. Cliquez sur OK.

Exemple

Cet exemple utilise le schéma XML générique RequisitePro.xsd, qui inclut l'attribut Niveau dans la requête PRRequirement.

Le document de sortie final créé par le canevas dans cet exemple :
  • Affiche les valeurs FullTag comme titres de section.
  • Affiche une hiérarchie visible des exigences :
    • Les exigences sont les en-têtes les plus importants et utilisent le style Titre 1.
    • Les exigences enfant sont les sous-entêtes et utilisent le style Titre 2.
  • Crée la hiérarchie des valeurs de l'attribut Niveau.
Pour créer un rapport avec les styles d'en-tête appliqués à FullTag :
  1. Dans Launcher, créez une spécification de document et configurez la source de données.
  2. Dans Document Studio, ouvrez un nouveau canevas.
  3. Ajoutez l'exemple de schéma de source de données :
    1. Dans la vue Schémas de source de données, cliquez sur l'icône Ajouter un schéma de source de données. L'assistant Schéma de source de données s'ouvre et vous pouvez cliquer sur Suivant.
    2. Dans la zone Type de schéma, sélectionnez XML générique.
    3. Cliquez sur Parcourir et sélectionnez l'exemple de fichier de données RequisitePro.xsd installé avec le produit. Emplacement par défaut : %RPE_HOME%\source\XML\examples\RequisitePro.xsd. Cliquez sur Ouvrir.
    4. Entrez un nom personnalisé pour l'ID source de données.
    5. Cliquez sur Suivant. Vérifiez vos sélections et cliquez sur Terminer.
  4. Ajoutez des éléments à votre canevas.
    1. Ajoutez un élément Conteneur icône Conteneur.
    2. Insérez un élément Paragraphe icône Paragraphe dans l'élément de conteneur.
    3. Insérez un élément Texte icône Texte dans l'élément de paragraphe.
      Exemple de canevas avec éléments
  5. Ajoutez des requêtes à vos éléments.
    1. Dans la vue Schémas de source de données, développez le projet et les exigences.
    2. Faites glisser PRRequirement dans l'élément de conteneur.
    3. Faites glisser FullTag (chaîne) dans l'élément de texte.
    4. Dans la fenêtre Sélection d'un contexte, sélectionnez Utiliser comme valeur.
    5. Sélectionnez le conteneur PRRequirement et cliquez sur OK.
      Exemple de canevas avec les requêtes dans les éléments
  6. Créez une expression de script de style pour l'élément de paragraphe.
    1. Sélectionnez l'élément de paragraphe.
    2. Dans la vue Propriétés, sélectionnez l'onglet Général.
    3. Dans la zone Nom du Style, cliquez sur l'icône de configuration icône de configuration.
    4. Dans la fenêtre Set style name value, sélectionnez l'onglet Expression de script.
    5. Développez Attributs et la source de données.
    6. Sélectionnez Niveau.
    7. Entrez parseInt(Level) + 1.
  7. Cliquez sur Publier > Générer le document pour générer la sortie.

    A mesure que les valeurs Niveau augmentent d'un, les styles d'en-tête augmentent également d'un. Le style Titre 1 est défini sur les valeurs FullTag pour les exigences qui possèdent 0 comme valeur Niveau. Le style Titre 2 est défini sur les valeurs FullTag pour les exigences qui possèdent 1 comme valeur Niveau.

Que faire ensuite

Un style d'en-tête est le style le plus courant à appliquer à l'aide d'expressions de script. Toutefois, vous pouvez également essayer d'appliquer des expressions de script à des tailles de police, des tailles de bordure ou des tailles de marge.

Commentaires