Внутренние переменные

Внутренние переменные, поставляемые вместе с Rational Publishing Engine, можно использовать для отображения в выводе автоматически создаваемой информации о шаблоне или спецификации документа.
Табл. 1. Внутренние переменные Rational Publishing Engine
Переменная Описание
_cell_number Номер ячейки в текущей строке. Если элемент не является ячейкой, то значение равно 0. Можно использовать _cell_number со вкладки Выражение данных или Выражение сценария.
_element_id Номер элемента в шаблоне. Хранится внутри шаблона и используется для отладки. Можно использовать _element_id с вкладки Выражение данных или Выражение сценария.
_element_level Уровень рекурсии элемента. Если для элемента не задано значение в свойстве Уровень рекурсии на вкладке Данные, то значение равно 1. Можно использовать _element_level с вкладки Выражение данных или Выражение сценария.
_row_number Номер строки в текущей таблице. Если элемент не входит в состав элемента строки, то значение равно 0. Можно использовать _row_number с вкладки Выражение данных или Выражение сценария.
_sessionInfo Информация о свойстве из шаблона или спецификации документа. На вкладке Выражение сценария выберите переменную _sessionInfo и введите сценарий. Укажите пустые кавычки без значения для создания значения по умолчанию для свойства в выводе. Примеры сценариев:

_sessionInfo.getDocspecProperty("свойство", "");
_sessionInfo.getTemplateProperty("свойство", "");
_sessionInfo.getDatasourceProperty("источник-данных","свойство", "");
_sessionInfo.getOutputProperty("тип-вывода","свойство", "");
_sessionInfo.docspecVersion
_sessionInfo.templateVersion
_sessionInfo.engineVersion
_sessionInfo.buildNumber

Для getDocspecProperty можно использовать свойства существующей спецификации документа или создать свойства пользовательских метаданных.

_sessionLogger В целях отладки можно просмотреть настроенную информацию, сообщения об ошибках, предупреждения и сообщения отладки в файле TEMP\rpe\rpe.log, на панели Консоль или на панели Неполадки. Сообщения отображаются в расположении, которое указано в файле log4j.properties.

По умолчанию информационные сообщения отображаются на панели Консоль, но не заносятся в файл rpe.log.

На вкладке Выражение сценария выберите переменную _sessionLogger и введите сценарий. Записи протокола можно создавать с помощью одного из следующих методов:
  1. _sessionLogger.debug(сообщение)
  2. _sessionLogger.info(сообщение)
  3. _sessionLogger.error(сообщение)
  4. _sessionLogger.warn(сообщение)

При выборе значения переменной сообщение рекомендуется использовать визуальную выноску со своими инициалами или именем пользователя либо переменные из шаблона с целью создания понятных сообщений.

_sessionUtils На вкладке Выражение сценария с помощью этой переменной можно запустить функцию для сценария с именем tidyXHTML. Эта переменная позволяет устранить пустые блоки из вывода, которые создаются в результате ошибок кода XHTML. Если указана переменная _sessionUtils, то строковый аргумент обрабатывается и XHTML очищается с удалением лишних пробелов из вывода.

Пример: _sessionUtils.tidyXHTML(текст);

В случае применения переменной _sessionUtils выберите параметры Ввод XHTML и Вывод XHTML на вкладке Выражение сценария.
Прим.: Шаблоны, содержащие эту переменную, можно загрузить в предыдущие версии Rational Publishing Engine, однако возможны ошибки обработки сценариев.

Комментарии