Справочник по свойствам вывода Microsoft Word для проектирования шаблонов

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

Назначение

Для создания из шаблона следующих документов:
Расширение Формат создаваемого документа
.doc Microsoft Word 2003.
.docx Microsoft Word 2007 (без макросов).
.docm Microsoft Word 2007 (с макросами).

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

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

Поддерживается для Microsoft Word и PDF.

Нет Да
Значок разрыва страницы Разрыв страницы Добавляет разрыв страницы в вывод. Нет Нет
Значок разрыва раздела Разрыв раздела Добавляет разрыв раздела в вывод. Нет Нет
Значок оглавления Оглавление Добавляет оглавление в вывод. Нет Нет
Значок таблицы таблиц Таблица таблиц Добавляет таблицу таблиц в вывод. Вы должны добавить Заголовки таблиц в шаблон документа для генерации таблицы таблиц в выводе.

Поддерживается только для вывода Microsoft Word.

Необходимо обновить все поля в документе Microsoft Word, чтобы увидеть и получить возможность изменить значение поля.

Нет Нет
Значок таблицы таблиц Таблица таблиц Добавляет таблицу таблиц в вывод. Вы должны добавить Заголовки таблиц в шаблон документа для генерации таблицы таблиц в выводе.

Поддерживается только для вывода Microsoft Word.

Необходимо обновить все поля в документе Microsoft Word, чтобы увидеть и получить возможность изменить значение поля.

Нет Нет
Значок поля Поле Добавляет элемент общего поля Microsoft Word. Можно ввести любой допустимый код Microsoft Word в свойство кода поля.

Поддерживается только для вывода Microsoft Word.

Необходимо обновить все поля в документе Microsoft Word, чтобы увидеть и получить возможность изменить значение поля.

Нет Нет
Значок номера страницы Номер страницы Добавляет номер страницы в вывод. Поддерживается только в выводе Microsoft Word и PDF. Нет Нет
Значок общего числа страниц Общее число страниц Добавляет общее число страниц в вывод. Поддерживается только для Microsoft Word и PDF. Нет Нет
Значок заголовка таблицы Заголовок таблицы Добавляет заголовок таблицы в вывод. Хотя невозможно указать указать динамическое содержимое в заголовке таблицы, каждый последующий текстовый элемент присоединяется к нему.

Поддерживается для Microsoft Word и PDF.

Необходимо обновить все поля в документе Microsoft Word, чтобы увидеть и получить возможность изменить значение поля.

Нет Нет
Значок заголовка рисунка Заголовок рисунка Добавляет заголовок рисунка в вывод. Хотя невозможно указать указать динамическое содержимое в заголовке рисунка, каждый последующий текстовый элемент присоединяется к нему.

Поддерживается для Microsoft Word и PDF.

Необходимо обновить все поля в документе Microsoft Word, чтобы увидеть и получить возможность изменить значение поля.

Нет Нет

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

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

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

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

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

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

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

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

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

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

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

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

Длина таблицы

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

Длинные таблицы могут занимать несколько страниц. При возникновении такого требования выберите элемент Строка в таблице и на панели Свойства укажите для свойства Разбивать строки между страницами значение true. Если это свойство задано, таблицы могут занимать несколько страниц.

Оглавления, рисунки и таблицы в документах Microsoft Word

Для того чтобы добавить оглавление в вывод, определите оглавление в шаблоне или в таблице стилей. Если оглавление определяется в шаблоне, то оно будет показано в документе Microsoft Word только после обновления полей документа. Для обновления полей используйте либо функцию Microsoft Word Обновить поля или Обновить таблицу, либо макрос, содержащийся в таблице стилей rpe.dot. Таблицу стилей rpe.dot можно найти в следующем каталоге установленной версии Rational Publishing Engine: %RPE_HOME%\utils\word\rpe.dot. Аналогичная процедура применима к списку иллюстраций и к списку таблиц.

Подписи и названия в документах Microsoft Word

Подписи к рисункам и названия таблиц не обновляются автоматически. Для обновления этих полей используйте функцию Microsoft Word Обновить поля или макрос, содержащийся в таблице стилей rpe.dot. Таблицу стилей rpe.dot можно найти в следующем каталоге установленной версии Rational Publishing Engine: %RPE_HOME%\utils\word\rpe.dot.

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

Можно или связать файл или физически встроить файл в выходной документ. Однако, способ обработки элементов Включаемый файл зависит от формата вывода и расположения, из которого извлекается файл.
Для вывода Microsoft Word создается поле INCLUDE TEXT. Это означает, что задача импорта файла делегируется Microsoft Word. Включаемый файл отображается в документе вывода только после обновления всех свойств. Поля можно обновить с помощью функции Обновить поля в Microsoft Word или с помощью макроса, входящего в состав таблицы стилей %RPE_HOME%\utils\word\rpe.dot.
Совет: Документ Microsoft Word, содержащий ссылки на другие файлы, не является независимым. В случае перемещения документа на другие компьютеры теряется возможность визуализации содержимого связанных документов. Визуализацию можно обеспечить с помощью функции Удалить ссылки (Alt+E+K) в Microsoft Office 2007, которая позволяет включить содержимое связанного файла в документ Microsoft Word.

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

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

Стили Rational Publishing Engine или внешние стили?

Если основной вывод выполняется в формате Microsoft Word или HTML, то по возможности используйте внешние стили, которые определены в таблице стилей. Такой подход позволяет быстро изменять вид выходного документа и соблюдать единое оформление документов во всей компании.

Нумерация заголовков для Microsoft Word

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

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

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

Объекты OLE

Из источника данных Rational DOORS можно извлечь встроенные объекты, например объекты OLE. Объекты OLE всегда обрабатываются как изображения в выводе HTML, PDF и XSL-FO, поскольку эти форматы не поддерживают объекты OLE.
В случае вывода Microsoft Word вы должны задать свойство Объекты OLE как статические изображения в разделе метаданных спецификации документа.
  • Если свойство Объекты OLE как статические изображения равно true, то объекты OLE включаются в выходной документ как статические изображения. Если объекты OLE добавляются в документ вывода в качестве статических изображений, то документ является автономным.
  • Если свойство Объекты OLE как статические изображения равно false, то в расположении выходного документа Microsoft Word генерируется папка ref. Если объекты OLE не добавляются в документ вывода в качестве статических изображений, то документ не будет автономным, поскольку в этом случае требуется отдельная папка ref.
Папка ref содержит файлы .rtf для объектов OLE. Для каждого экспортированного объекта OLE в вывод Microsoft Word добавляется одно поле, указывающее на файл .rtf. Так как IBM® Rational Publishing Engine не может обновлять поля Microsoft Word, то добавленные поля не отображаются при открытии документа Microsoft Word. Для того чтобы сделать их видимыми, выполните одно из следующих действий:
Табл. 13. Действия
Действие Результат
Выберите содержимое документа целиком и выполните функцию Обновить поля в Microsoft Word. Объекты OLE показаны в документе. Документ не является законченным.
Запустите макрос updateFields, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ не является законченным.
Запустите макрос insertOLEs, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ является законченным.
Запустите макрос rpe или insertOLEs, предоставляемый Rational Publishing Engine. Объекты OLE показаны в документе. Документ является законченным.
Прим.: Если вы переместите незаконченный документ на другой компьютер, то не сможете редактировать объекты OLE. Во избежание этого запустите макрос rpe или insertOLEs.

Комментарии