При разработке шаблона может потребоваться вычислить значения или сделать атрибуты данных доступными в контекстах, в которых они обычно недоступны. Для таких случаев можно определить переменные и присвоить им значения. Значения могут быть как статичными данными, так и данными, доступными в текущем контексте.
Об этой задаче
Переменные можно использовать как заменители для данных, вычисленных во время выполнения (присваивания переменных), либо можно указывать в спецификации документа. В отличие от атрибутов данных переменные можно также использовать в шаблонах.
Существует два типа переменных:
- Пользовательские переменные: определенные разработчиком шаблона. Пользовательские переменные могут быть внутренними или внешними.
- Внутренние пользовательские переменные: применяются для вычислений или для временного хранения информации, например, переменные, используемые для переноса данных в шаблоны. Внутренние переменные не отображаются в спецификации документа, поэтому им нельзя присваивать значения.
- Внешние пользовательские переменные: применяются при присваивании им значений. Внешние переменные отображаются в спецификации документа. См. Создание спецификации документа.
- Переменные Rational Publishing Engine: переменные Rational Publishing Engine - это внутренние переменные, доступные для использования в шаблоне документа.
Табл. 1. Внутренние переменныеПеременная |
Описание |
_element_id |
Хранится внутри шаблона и используется для отладки. |
_element_level |
Уровень рекурсии элемента. |
_row_number |
Номер строки в текущей таблице.
Если элемент не является строкой, то значение равно 0. |
_cell_number |
Номер ячейки в текущей строке. Если элемент не является ячейкой, то значение равно 0. |
Процедура
- В представлении Схема выберите . Откроется окно Создать переменную.
- Введите сведения о переменной в следующих полях:
- Имя: введите имя переменной. Имя переменной должно быть допустимым идентификатором
Java™ или JavaScript, так как он
применяется в сценариях.
- Описание: введите описание переменной.
- Значение по умолчанию: введите значение переменной.
- Доступ: выберите (в списке), должна переменная быть внутренней или внешней.
- Внутренние переменные не отображаются в спецификации документа, поэтому им нельзя присваивать значения.
- Внешние переменные отображаются в спецификации документа и им можно присваивать значения.
- Для присваивания переменной элементу выполните следующие действия:
Совет: Присвойте переменные элементам контейнера, если возможно.
Переменная будет применена к элементам в элементе контейнера.
Например может потребоваться использовать переменную в таблице для создания новой строки для каждой переменной. Если присвоить переменную элементу таблицы, то для каждой переменной может быть создана таблица. Иногда эти последовательные таблицы объединены, а иногда они отображаются как отдельные таблицы. При добавлении элемента контейнера в таблицу и перетаскивании строки в элемент контейнера выполняется присваивание переменной элементу контейнера, при этом создается одна таблица со строками для каждой переменной.
- Щелкните правой кнопкой мыши на элементе и выберите . Откроется окно Редактор присваиваний.
- Выберите Добавить. Откроется окно Выбрать переменную.
- Введите имя переменной и нажмите кнопку OK.
- Нажмите кнопку OK в окне Редактор присваиваний.
Результаты
Выбранная переменная будет определена и присвоена текущему элементу.
При присваивании переменной элементу он отображает значок
в редакторе материалов шаблона.
Дальнейшие действия
Совет: Для поиска списка присваиваний переменных, используемых в элементе, щелкните правой кнопкой мыши на элементе переменной и выберите . Откроется представление Поиск и будет показан список присваиваний переменных. Для изменения присваивания переменной дважды щелкните на нем в результатах.
Для поиска списка присваиваний переменных, атрибутов и запросов, используемых в элементе щелкните правой кнопкой мыши на этом элементе и выберите . Откроется представление Поиск и будет показан список. Для изменения элемента дважды щелкните на нем в результатах.