Variables internes

Vous pouvez utiliser les variables internes fournies avec Rational Publishing Engine pour afficher automatiquement les informations générées sur la spécification de canevas ou document dans votre sortie.
Tableau 1. Variables internes de Rational Publishing Engine
Variable Description
_numéro_cellule Numéro de cellule dans une ligne actuelle. Si l'élément ne correspond pas à une cellule, la valeur est 0. Vous pouvez utiliser _cell_number depuis l'onglet Expression de données ou Expression de script.
_id_élément Numéro d'élément au sein du canevas. Conservée en interne dans le canevas et utilisée pour le débogage. Vous pouvez utiliser _id_élément depuis l'onglet Expression de données ou Expression de script.
_niveau_élément Niveau récursif d'un élément. Si aucune valeur n'est définie pour l'élément dans la propriété Niveau récursif de l'onglet Données, la valeur est 1. Vous pouvez utiliser _niveau_élément depuis l'onglet Expression de données ou Expression de script.
_numéro_ligne Numéro de ligne dans une table actuelle. Si l'élément ne figure pas dans un élément de ligne, la valeur est 0. Vous pouvez utiliser _numéro_ligne depuis l'onglet Expression de données ou Expression de script.
_sessionInfo Information de propriété d'exécution de la spécification de canevas ou de document. Sous l'onglet Expression de script, sélectionnez la variable _sessionInfo et entrez le script. Utilisez des guillemets vides sans valeur à l'intérieur afin de générer la valeur par défaut pour la propriété dans la sortie. Exemples de script :

_sessionInfo.getDocspecProperty("property", "");
_sessionInfo.getTemplateProperty("property", "");
_sessionInfo.getDatasourceProperty("data_source_name","property", "");
_sessionInfo.getOutputProperty("output_type","property", "");
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

Pour la variable getDocspecProperty, vous pouvez utiliser des propriétés de spécification de document existantes ou des propriétés de création de métadonnées personnalisées.

_sessionLogger A des fins de débogage, vous pouvez afficher des messages d'information, d'avertissement, ou de débogage personnalisés dans le fichier %TEMP%\rpe\rpe.log, la vue Console ou la vue Problèmes. Les messages s'affichent à l'emplacement qui est défini dans le fichier log4j.properties.

Le paramètre par défaut consiste à afficher les messages d'information dans la vue Console et non dans le fichier rpe.log.

Sous l'onglet Expression de script, sélectionnez la variable _sessionLogger et entrez le script. Vous pouvez générer des entrées de journal de l'une des manières suivantes :
  1. _sessionLogger.debug(message)
  2. _sessionLogger.info(message)
  3. _sessionLogger.error(message)
  4. _sessionLogger.warn(message)

Lorsque vous décidez ce que vous allez entrer comme message dans votre script, pensez à utiliser un paramètre callout visuel, par exemple vos initiales ou votre nom d'utilisateur, ainsi que des variables de votre canevas, afin de créer des messages significatifs.

_sessionUtils Sous l'onglet Expression de script, vous pouvez utiliser cette variable afin d'exécuter une fonction sur le script appelé tidyXHTML. Cette variable est utile si vous remarquez des blocs d'espace blanc dans la sortie qui est créée par un codage XHTML incorrect. Grâce à la variable _sessionUtils, un argument de chaîne est traité et le code XHTML est nettoyé de sorte que l'espace en trop ne s'affiche pas dans la sortie.

Exemple : _sessionUtils.tidyXHTML(text);

Lors de l'utilisation de la variable _sessionUtils, sélectionnez également les options Entrée XHTMLt et Sortie XHTML sous l'onglet Expression de script.
Remarque : Les canevas qui incluent cette variable peuvent être chargés dans de plus anciennes versions de Rational Publishing Engine, mais les scripts ne peuvent pas être correctement évalués.

Retour d'informations