Определение и присваивание переменных

При разработке шаблона может потребоваться вычислить значения или сделать атрибуты данных доступными в контекстах, в которых они обычно недоступны. Для таких случаев можно определить переменные и присвоить им значения. Значения могут быть как статичными данными, так и данными, доступными в текущем контексте.

Об этой задаче

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

Процедура

  1. В представлении Схема выберите Переменные > Вставить > Создать переменную. Откроется окно Создать переменную.
  2. Введите сведения о переменной в следующих полях:
    1. Имя: введите имя переменной. Имя переменной должно быть допустимым идентификатором Java™ или JavaScript, так как он применяется в сценариях.
    2. Описание: введите описание переменной.
    3. Значение по умолчанию: введите значение переменной.
    4. Доступ: выберите (в списке), должна переменная быть внутренней или внешней.
      • Внутренние переменные не отображаются в спецификации документа, поэтому им нельзя присваивать значения.
      • Внешние переменные отображаются в спецификации документа и им можно присваивать значения.
  3. Для присваивания переменной элементу выполните следующие действия:
    Совет: Присвойте переменные элементам контейнера, если возможно. Переменная будет применена к элементам в элементе контейнера. Например может потребоваться использовать переменную в таблице для создания новой строки для каждой переменной. Если присвоить переменную элементу таблицы, то для каждой переменной может быть создана таблица. Иногда эти последовательные таблицы объединены, а иногда они отображаются как отдельные таблицы. При добавлении элемента контейнера в таблицу и перетаскивании строки в элемент контейнера выполняется присваивание переменной элементу контейнера, при этом создается одна таблица со строками для каждой переменной.
    Элемент таблицы с элементом контейнера. В элементе контейнера находится элемент строки с тремя элементами ячеек.
    1. Щелкните правой кнопкой мыши на элементе и выберите Данные > Изменить присваивания. Откроется окно Редактор присваиваний.
    2. Выберите Добавить. Откроется окно Выбрать переменную.
    3. Введите имя переменной и нажмите кнопку OK.
    4. Нажмите кнопку OK в окне Редактор присваиваний.

Результаты

Выбранная переменная будет определена и присвоена текущему элементу.

При присваивании переменной элементу он отображает значок Значок Присваивание переменной в редакторе материалов шаблона.

Элемент Абзац с запросом и присваиванием переменной

Дальнейшие действия

Совет: Для поиска списка присваиваний переменных, используемых в элементе, щелкните правой кнопкой мыши на элементе переменной и выберите Поиск > Указатели на переменные в элементе. Откроется представление Поиск и будет показан список присваиваний переменных. Для изменения присваивания переменной дважды щелкните на нем в результатах.

Для поиска списка присваиваний переменных, атрибутов и запросов, используемых в элементе щелкните правой кнопкой мыши на этом элементе и выберите Поиск > Все указатели в элементе. Откроется представление Поиск и будет показан список. Для изменения элемента дважды щелкните на нем в результатах.


Комментарии