Создание документов в формате HTML с помощью Rational Publishing Engine.
Назначение
Создание документа HTML из шаблона.
Элементы шаблона
Табл. 1. Элементы шаблона, которые можно использовать для вывода в формате HTMLЭлемент |
Описание |
Может содержать другие элементы |
Может содержать данные |
Абзац |
Используется для группировки раздела
элементов.
Добавляет символы возврата каретки вокруг своих
дочерних элементов в выводе. |
Да |
Нет |
Контейнер |
Используется для группировки раздела
элементов.
К нему не может быть применен стиль, и он не влияет на
форматирование вывода.При использовании внутри других элементов
дочерние элементы, доступные для использования в контейнере, могут
быть ограничены. Например: - Внутри строк контейнеры могут содержать только ячейки
- Внутри списков контейнеры могут содержать только элементы подробных сведений списка
|
Да |
Нет |
Текст |
Содержимое выводится с одинаковым
заданным форматированием. |
Нет |
Да |
Текст со стилем |
Блок текста, который может иметь
уникальное форматирование отдельных слов. Используйте жирный шрифт,
курсив, подчеркивание, зачеркивание или форматирование цветом для
выделенных слов в элементе. Текст статичен. |
Нет |
Да |
Гиперссылка |
Создает гиперссылку в выводе.
Гиперссылка может указывать на расположение внутри документа или
внешнее расположение. |
Нет |
Да |
Изображение |
Отображает изображение .gif,
.png, .jpg,
emf или wmf в выводе. Разработчик отчета может указать путь к изображению в
шаблоне, или создатель отчета может указать путь во время
выполнения. |
Нет |
Да |
Таблица |
Создает таблицу в выводе. Таблица
может содержать строки или элементы контейнера. |
Да |
Нет |
Строка |
Создает строку в текущей таблице. |
Да |
Нет |
Ячейка |
Создает ячейку в текущей строке текущей таблицы. |
Да |
Нет |
Список |
Создает маркированный или нумерованный
список в выводе. |
Да |
Нет |
Подробные сведения списка |
Создает элемент списка в
текущем списке в выводе. |
Да |
Нет |
Конфигурация источника данных |
См.
Добавление элемента конфигурации источника данных. |
Нет |
Нет |
Включаемый файл |
Включает в вывод указанный файл как
поле INCLUDETEXT. - Включаемый файл может иметь расширение
.doc, .docx,
.txt или .rtf.
- В случае вывода Microsoft
Word включаемый файл отображается после обновления
всех полей с помощью макроса.
- Для вывода Legacy PDF, HTML и XSL-FO включаемый файл является
гиперссылкой на документ.
|
Нет |
Да |
Закладка |
Определяет закладку в документе.
Именем сгенерированной закладки является содержимое элемента
закладки.
При генерации документов
Rational Publishing Engine
генерирует уникальное имя для каждой закладки. Имя состоит из
указанного во время проектирования имени и уникального
идентификатора, сгенерированного во время выполнения. |
Нет |
Да |
Разрыв страницы |
Добавляет разрыв страницы в вывод. |
Нет |
Нет |
Разрыв раздела |
Добавляет разрыв раздела в вывод. |
Нет |
Нет |
Оглавление |
Добавляет оглавление в вывод. |
Нет |
Нет |
Свойства элемента
Информация о настройке свойств элементов в шаблонах для создания документов HTML.
Табл. 2. Свойства ячейкиСвойства ячейки |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Выравнивание ячейки |
Это свойство задает положение текста в ячейке. |
Ширина ячейки |
Можно указать ширину ячеек в пикселах,
пунктах или процентах. |
Табл. 3. Свойства подписи рисункаСвойства подписи рисунка |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Код поля |
Это свойство нельзя использовать для данного формата вывода. |
Табл. 4. Свойства изображенияСвойства изображения |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Содержимое |
Поддерживаемые форматы изображений: - Internet Explorer: .bmp,
.emf, .gif,
.jpg, .png,
.svg (версия 9 или более поздняя),
.wmf
- Firefox: .bmp, .gif, .jpg, .png, .svg
|
Табл. 5. Свойства элемента спискаСвойства элемента списка |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Табл. 6. Свойства номера страницыСвойства номера страницы |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Табл. 7. Свойства абзацаСвойства абзаца |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Выравнивание абзаца |
Расположение текста на странице с определенным выравниванием. по левому краю, по правому краю и по центру создает неровные края абзаца. Абзац заполняется максимальным количеством слов. Выравнивание по обоим краям создает ровные края абзаца путем вставки дополнительных пробелов между словами на всех строках кроме последней. Значение распределенное похоже на по обоим краям. Разница лишь в том, что пробелы также вставляются между словами последней строки абзаца.
|
Управление повисшими строками и словами |
Это свойство нельзя использовать для данного формата вывода. |
Табл. 8. Свойства строкиСвойства строки |
Примечания |
Разбивать строку на страницы |
Это свойство нельзя использовать для данного формата вывода. |
Табл. 9. Свойства таблицыСвойства таблицы |
Примечания |
Автоподбор размера по содержимому |
Размер таблицы определяется содержимым ячеек. При использовании этого свойства также следует присвоить свойству Изменять размер по содержимому значение да. |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Расстояние между ячейками |
Это свойство нельзя использовать для данного формата вывода. |
Фиксированная ширина ячеек в столбце |
Задает фиксированную ширину ячеек столбца (в пикселах). |
Изменять размер по содержимому |
Когда этому свойству присвоено значение да, строки не разрываются, если нет пробела. Когда нет пробела, строки не разрываются, и ширина столбца увеличивается до ширины текста. Если свойство автоподбор размера по содержимому задано, свойству изменять размер по содержимому должно быть присвоено значение да. Когда это свойство равно нет, ширина столбца фиксированная и строки разрываются вне зависимости от длины текста и наличия пробелов. Кроме того, свойство автоподбор ширины таблицы не учитывается.
|
Автоподбор ширины таблицы |
Когда этому свойству присвоено значение Да, ширина таблицы определяется шириной страницы. Когда и свойство изменять размер по содержимому равно Да, ширина ячеек не учитывается и размер таблицы определяется содержимым ячеек. Значение свойства фиксированная ширина столбца указывать нельзя. Следует использовать свойство фиксированная ширина ячейки.
|
Табл. 10. Свойства названия таблицыСвойства названия таблицы |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Код поля |
Это свойство нельзя использовать для данного формата вывода. |
Табл. 11. Свойства текстаСвойства текста |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Табл. 12. Свойства общего числа страницСвойства общего числа страниц |
Примечания |
Ширина рамки |
Для создания рамки в данных вывода должна быть указана ширина рамки. |
Элемент Включаемый файл
Можно или связать файл или физически
встроить файл в выходной документ. Однако, способ обработки
элементов Включаемый файл зависит от формата вывода и расположения,
из которого извлекается файл. Для устаревших выходных данных PDF, HTML и
XSL-FO в качестве файла всегда добавляется гиперссылка.
Стили заголовков
Для применения предопределенных стилей заголовков
HTML (H1, H2, ... , 9) используйте имя стиля 1, 2 - 9.
Стили Rational Publishing Engine
или внешние стили?
По возможности рекомендуется использовать внешние стили, которые
определены
в таблице стилей. Такой подход позволяет быстро изменять
вид выходного документа и соблюдать единое оформление документов во
всей компании.
Данные Unicode в выводе
Выводятся все данные Unicode, если для
используемого шрифта поддерживается Unicode. Если
шрифт, отличный от Unicode, применяется для вывода HTML, то после
генерации документа измените семейство шрифтов в таблице стилей.
Объекты OLE
Из атрибутов источника данных можно извлечь встроенные объекты,
например объекты OLE. Объекты OLE всегда обрабатываются как изображения в выводе HTML,
поскольку этот формат не поддерживает объекты OLE.
Списки в абзацах
В случае разработки
шаблонов, предназначенных для создания вывода HTML, следует
избегать вложенных элементов списка в элементах абзацев.
Списки
наследуют набор свойств форматирования, который может
конфликтовать с отдельными свойствами абзаца. Например, свойства абзаца, такие как цвет фона и границы,
изменяются, если абзац содержит список. Разместите элементы
списков в шаблоне после элементов абзацев,
чтобы избежать таких неполадок.