Справочник вывода PDF для проектирования шаблонов

Создание документов с помощью драйвера PDF Rational Publishing Engine.

Назначение

Создание документа .pdf из шаблона.

Выбор драйвера PDF

Драйвер PDF по умолчанию создает файлы PDF версии 1.5. При необходимости можно выбрать драйвер Устаревший PDF, создающий файлы PDF версии 1.4.

Если спецификацию документа, созданную в Rational Publishing Engine 1.1.2.1 или более ранней версии, открыть в Rational Publishing Engine 1.1.2.2 или более поздней версии, то параметры PDF переносятся в обе версии драйвера PDF. Если спецификацию документа, созданную в Rational Publishing Engine 1.1.2.2 или более поздней версии, открыть в Rational Publishing Engine 1.1.2.1 или более ранней версии, то по умолчанию применяется драйвер Устаревший PDF. Если в версии 1.1.2.2 или более поздней настроены оба драйвера PDF, то будут созданы два экземпляра драйверов PDF с одинаковыми параметрами. В этом случае один из совпадающих драйверов можно удалить из спецификации документа.

Элементы шаблона

Табл. 1. Элементы шаблона, которые можно использовать для вывода в формате PDF
Элемент Описание Может содержать другие элементы Может содержать данные
Значок абзаца Абзац Используется для группировки раздела элементов. Добавляет символы возврата каретки вокруг своих дочерних элементов в выводе. Да Нет
Значок контейнера Контейнер Используется для группировки раздела элементов. К нему не может быть применен стиль, и он не влияет на форматирование вывода.
При использовании внутри других элементов дочерние элементы, доступные для использования в контейнере, могут быть ограничены. Например:
  • Внутри строк контейнеры могут содержать только ячейки
  • Внутри списков контейнеры могут содержать только элементы подробных сведений списка
Да Нет
Значок текста Текст Содержимое выводится с одинаковым заданным форматированием. Нет Да
Значок текст со стилем Текст со стилем Блок текста, который может иметь уникальное форматирование отдельных слов. Используйте жирный шрифт, курсив, подчеркивание, зачеркивание или форматирование цветом для выделенных слов в элементе. Текст статичен. Нет Да
Значок гиперссылки Гиперссылка Создает гиперссылку в выводе. Гиперссылка может указывать на расположение внутри документа или внешнее расположение. Нет Да
Значок изображения Изображение Отображает изображение .gif, .png, .jpg, emf или wmf в выводе. Разработчик отчета может указать путь к изображению в шаблоне, или создатель отчета может указать путь во время выполнения. Нет Да
Значок таблицы Таблица Создает таблицу в выводе. Таблица может содержать строки или элементы контейнера. Да Нет
Значок строки Строка Создает строку в текущей таблице. Да Нет
Значок ячейки Ячейка Создает ячейку в текущей строке текущей таблицы. Да Нет
Значок списка Список Создает маркированный или нумерованный список в выводе. Да Нет
Значок подробных сведений списка Подробные сведения списка Создает элемент списка в текущем списке в выводе. Да Нет
Значок конфигурации источника данных Конфигурация источника данных См. Добавление элемента конфигурации источника данных. Нет Нет
Значок включаемого файла Включаемый файл Включает в вывод указанный файл как поле INCLUDETEXT.
  • Включаемый файл может иметь расширение .doc, .docx, .txt или .rtf.
  • В случае вывода Microsoft Word включаемый файл отображается после обновления всех полей с помощью макроса.
  • Для вывода Legacy PDF, HTML и XSL-FO включаемый файл является гиперссылкой на документ.
Нет Да
Значок области Область Области являются статическими элементами, которые позволяют изменить поток вывода, перенаправив содержимое других элементов или групп элементов. Если для элемента задано свойство целевая область с именем элемента области, его содержимое выводится в указанной области, а не в его позиции в документе. Нет Нет
Значок закладки Закладка Определяет закладку в документе. Именем сгенерированной закладки является содержимое элемента закладки. При генерации документов Rational Publishing Engine генерирует уникальное имя для каждой закладки. Имя состоит из указанного во время проектирования имени и уникального идентификатора, сгенерированного во время выполнения. Нет Да
Значок разрыва страницы Разрыв страницы Добавляет разрыв страницы в вывод. Нет Нет
Значок разрыва раздела Разрыв раздела Добавляет разрыв раздела в вывод. Нет Нет
Значок оглавления Оглавление Добавляет оглавление в вывод. Нет Нет
Значок номера страницы Номер страницы Добавляет номер страницы в вывод. Поддерживается только в выводе Microsoft Word и PDF. Нет Нет
Значок общего числа страниц Общее число страниц Добавляет общее число страниц в вывод. Поддерживается только для Microsoft Word и PDF. Нет Нет

Если PDF создается слишком долго, добавьте в шаблон Значок элемента Разрыв раздела элементы Разрыв раздела, чтобы повысить производительность.

Свойства элемента

Информация о настройке свойств элементов в шаблонах для создания документов PDF.
Табл. 2. Свойства ячейки
Свойства ячейки Примечание
Ширина рамки Ширина рамки должна быть от 1 до 30 пикселей, чтобы рамка показывалась в выводе.
Выравнивание ячейки Это свойство задает положение текста в ячейке. Значение по обоим краям не поддерживается для этого формата вывода.
Ширина ячейки Введите значение в пунктах или пикселах. Если значение введено в пикселах, оно преобразуется в пункты, и предполагается, что дисплей имеет разрешение 96 dpi. Если значение введено в процентах, оно игнорируется. При объединении таблиц необходимо задать свойство ширина ячейки, чтобы ширина столбцов была одинаковая.
Число столбцов Все строки и столбцы должны содержать одинаковое число ячеек. Границы между ячейками удаляются, но только содержимое/свойства первой ячейки применяются к выводу. Следует избегать наложения объединений.
Число строк Все строки и столбцы должны содержать одинаковое число ячеек. Границы между ячейками удаляются, но только содержимое/свойства первой ячейки применяются к выводу. Следует избегать наложения объединений.
Табл. 3. Свойства подписи рисунка
Свойства подписи рисунка Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.
Код поля Арабские и римские цифры показываются последовательно для каждой подписи.
Табл. 4. Свойства изображения
Свойства изображения Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.
Табл. 5. Свойства списка
Свойства списка Примечание
Стиль нумерации Можно использовать следующие стили:
  • Символ элемента списка - ненумерованные списки
  • Арабские цифры - нумерованные списки
  • Прописные римские цифры - заглавные римские цифры
  • Строчные римские цифры - строчные римские цифры
  • Прописные буквы - заглавные буквы
  • Строчные буквы - строчные буквы
Отступ от символа нумерации Это свойство нельзя использовать для данного формата вывода.
Табл. 6. Свойства элемента списка
Свойства элемента списка Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.
Табл. 7. Свойства номера страницы
Свойства номера страницы Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.
Табл. 8. Свойства абзаца
Свойства абзаца Примечание
Ширина рамки Ширина рамки должна быть от 1 до 30 пикселей, чтобы рамка показывалась в выводе.
Выравнивание абзаца Расположение текста на странице с определенным выравниванием.

Выравнивание по левому краю, по правому краю и по центру создает неровные края абзаца. Абзац заполняется максимальным количеством слов. Выравнивание по обоим краям создает ровные края абзаца путем вставки дополнительных пробелов между словами на всех строках кроме последней.

Распределенное выравнивание для этого формата вывода использовать нельзя.

Управление повисшими строками и словами Когда это свойство равно да, межсимвольное пространство корректируется таким образом, чтобы предотвратить следующее:
  • Последнее слово абзаца на новой строке
  • Последняя строка абзаца на новой странице

Когда свойство равно нет, межсимвольное пространство не корректируется.

Табл. 9. Свойства строки
Свойства строки Примечание
Разбивать строку на страницы Когда это свойство равно да, последняя строка страницы разрывается при необходимости. Непоместившаяся часть строки переносится на новую страницу.

Когда свойство равно нет, последняя строка страницы не разрывается. Строка целиком переносится на новую страницу.

Табл. 10. Свойства таблицы
Свойства таблицы Примечание
Автоподбор размера по содержимому Размер таблицы определяется содержимым ячеек. При использовании этого свойства также следует присвоить свойству Изменять размер по содержимому значение да.
Автоподбор размера по ширине окна Ширина таблицы определяется по ширине страницы. Это свойство следует выключить, когда свойство Изменять размер по содержимому равно нет.
Ширина рамки Ширина рамки должна быть от 1 до 30 пикселей, чтобы рамка показывалась в выводе.
Расстояние между ячейками Это свойство нельзя использовать для данного формата вывода.
Фиксированная ширина ячеек в столбце Задает фиксированную ширину ячеек столбца (в пикселах).
Изменять размер по содержимому Когда это свойство равно да, а свойствам ширина и автоподбор размера по ширине окна не присвоены значения, ширина столбца определяется его содержимым. Если свойство автоподбор размера по содержимому задано, свойству изменять размер по содержимому должно быть присвоено значение да.

Когда это свойство равно нет, свойствам ширина и автоподбор размера по ширине окна таблицы присваивать значения не следует. Таблица создается с шириной столбца по умолчанию 2,54 см.

Автоподбор ширины таблицы Когда этому свойству присвоено значение Да, ширина таблицы определяется шириной страницы. Когда и свойство изменять размер по содержимому равно Да, ширина ячеек не учитывается и размер таблицы определяется содержимым ячеек.

Значение свойства фиксированная ширина столбца указывать нельзя. Следует использовать свойство фиксированная ширина ячейки.

Ширина Этому свойству должно быть присвоено значение, если свойство Изменять размер по содержимому не равно нет.
Табл. 11. Свойства названия таблицы
Свойства названия таблицы Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.
Код поля Арабские и римские цифры показываются последовательно для каждой подписи.
Табл. 12. Свойства текста
Свойства текста Примечание
Ширина рамки Ширина рамки должна быть от 1 до 30 пикселей, чтобы рамка показывалась в выводе.
Табл. 13. Свойства общего числа страниц
Свойства общего числа страниц Примечание
Ширина рамки Это свойство нельзя использовать для данного формата вывода.

Элемент Включаемый файл

Можно или связать файл или физически встроить файл в выходной документ. Однако, способ обработки элементов Включаемый файл зависит от формата вывода и расположения, из которого извлекается файл. Для вывода PDF включаемый файл импортируется с отображением полного содержимого документа.

Стили заголовков

Для применения предопределенных стилей заголовков Microsoft Word (Заголовок 1, Заголовок 2, ... , Заголовок 9) и HTML (H1, H2, ... , 9) используйте имя стиля 1,2, ... 9. В форматах PDF и XSL-FO нет стилей заголовков, однако Rational Publishing Engine использует внутренние стили заголовков.

Данные Unicode в выводе

Выводятся все данные Unicode, если для используемого шрифта поддерживается Unicode.

Комментарии