Документ можно сгенерировать из панели запуска или Document Studio.
Прежде чем начать
Каждый шаблон по умолчанию связан с
пустой спецификацией документа. В ходе предварительного просмотра или публикации шаблона
с помощью приложения Document Studio пустую спецификацию
документа можно дополнительно настроить или использовать для
изменения вывода в исходном виде.
Document Studio выполняет синхронизацию шаблона со спецификацией
документа по умолчанию при открытии или сохранении шаблона. Прим.: Эти инструкции применимы к большинству
источников данных, но не ко всем источникам данных.
За инструкциями для конкретного источника данных
обратитесь к документации
Интеграция
по источнику данных.
Об этой задаче
Существует несколько способов создания документов:
- Документы можно генерировать с помощью панели запуска и
Document Studio. Ниже приведены инструкции по созданию документов с помощью
пользовательского интерфейса приложения.
- Можно перейти в расположение спецификации документа в
файловой системе, щелкнуть правой кнопкой мыши и выбрать
Опубликовать с помощью
Rational Publishing Engine.
Все ошибки при создании документа игнорируются.
- Кроме того, после установки модулей
поддерживается возможность публикации документов в пользовательском
интерфейсе Rational DOORS и Rational Tau.
Приложения Панель запуска и Document Studio создают документы
аналогичным образом. В случае создания документов с помощью мастера в обоих
приложениях применяется один и тот же набор параметров.
Однако в приложении Панель запуска можно настроить сведения о
создании документа на панелях Спецификация документа и Свойства без
помощи мастера.
Процедура
Для создания документов с помощью приложения Панель запуска или Document
Studio выполните следующие действия:
- В приложении Панель запуска или Document Studio выберите .
Кроме того, можно щелкнуть на значке
Настроить и создать документ на панели инструментов.
Открывается мастер настройки, позволяющий выбрать дополнительные
параметры перед созданием документа. В строке состояния отображается
настраиваемая информация в пяти разделах:
- Шаблоны
- Источники данных
- Переменные
- Вывод
- Итог
Щелкните на разделе или на элементе в строке
состояния, чтобы перейти на соответствующую страницу мастера.
Совет: Если выбран по крайней мере один источник данных и один формат
вывода, то в любой можно нажать кнопку Готово,
чтобы приступить к созданию документа; кнопка
Далее позволяет продолжить
работу с мастером
настройки.
- В разделе Шаблоны показаны шаблоны из
спецификации документа.
Для добавления шаблона выполните следующие действия:
- Выберите расположение шаблонов для добавления:
- Из централизованной
библиотеки: позволяет выбрать шаблоны в компоненте
Централизованное управление
- Из локального или удаленного файла: для
того чтобы выбрать локальный или удаленный шаблон,
введите URL шаблона или выберите шаблон с помощью кнопки
Обзор.
- Выберите один или несколько шаблонов для добавления.
- Если выбран вариант Из централизованной
библиотеки и выбраны шаблоны из компонента Централизованное
управление,
нажмите кнопку Добавить выбранные, чтобы
добавить шаблоны в спецификацию документа.
- Если выбран вариант Из локального или удаленного файла и указан URL отдельного шаблона, то нажмите
кнопку
Добавить URL, чтобы добавить шаблон в
спецификацию документа.
- Если выбран вариант Из локального или удаленного
файла, то при нажатии кнопки
Открыть выбранные
шаблоны добавляются в спецификацию документа.
- Необязательно: Повторите эти действия для добавления дополнительных шаблонов из
других расположений.
- Необязательно: Для изменения порядка шаблонов в спецификации документа
выберите шаблон и нажмите кнопку Вверх или
Вниз.
- Нажмите кнопку Далее.
- В разделе Источники данных настройте
каждый источник данных.
Прим.: - Если для источника данных уже существует значение по
умолчанию или задан URI по умолчанию, то
источник данных отображается как настроенный и значение по умолчанию
применяется в выводе, если не будет выбрано другое значение.
- Если выйти из раздела Источники данных и нажать кнопку
Назад для внесения дополнительных изменений в
источник данных, то всегда открывается первый источник данных в
списке.
- Выберите источник данных в одном из следующих расположений:
- Настройка вручную: позволяет выбрать
локальный или удаленный источник данных, для которого не
существует другая информация о конфигурации на
уровне конфигурации или в компоненте Централизованное управление.
- С помощью значений источников из центральной библиотеки: позволяет выбрать источник данных в
компоненте Централизованное управление
- Загрузить из уровня конфигурации: для
того чтобы
выбрать значение в метаданных конфигурации, указанных для источника
данных в шаблоне.
- В зависимости от варианта, выбранного на предыдущем
шаге, можно выбрать значение для источника данных одним из
следующих способов: ввод URL, выбор с помощью кнопки Обзор или выбор значения на уровне
конфигурации.
- Введите имя и пароль пользователя для идентификации в приложении
источника данных.
- Выберите тип идентификации. Если тип не выбран, то правильный тип определяется путем
проверки всех типов. Это может привести к увеличению времени
создания документов.
- Автоматически
- Базовая
- Form
- OAuth
- OAuth-OSLC
- Необязательно: Введите заголовок accept. Значение по умолчанию: application/xml,
*/*.
- Необязательно: Для применения указанных идентификационных данных ко всем
источникам данных, включите переключатель Применить эти
значения имени пользователя и пароля к каждому настроенному и
ненастроенному источнику данных.
- Нажмите кнопку Далее
- В разделе Переменные настройте каждую
переменную.
Прим.: - Если для переменной уже существует значение по
умолчанию, то переменная
отображается как настроенная и значение по умолчанию применяется в
выводе, если не будет выбрано другое значение.
- Если выйти из раздела Переменные и нажать кнопку
Назад для внесения дополнительных изменений в
переменную, то всегда открывается первая переменная в списке.
- В выпадающем меню выберите одну из следующих опций:
- Настройка вручную: позволяет
ввести любое значение переменной, для которой не существует другая
информация на уровне конфигурации или в компоненте
Централизованное управление.
- Из уровня конфигурации: для того чтобы
выбрать значение в метаданных конфигурации, указанных для
переменной в шаблоне.
- С помощью значений переменных из централизованной
библиотеки: позволяет выбрать переменную в
компоненте Централизованное управление
- Введите или выберите значение для конфигурации.
- Нажмите кнопку Далее.
- В разделе Вывод выберите типы вывода для создания:
- Microsoft Word
- PDF
- HTML
- XSL-FO
- устаревший формат PDF
- Необязательно: В поле Расположение для сохранениянажмите
кнопку Обзор и выберите каталог
для
сохранения файла для каждого типа вывода. Если расположение сохранения вывода не указано, то файл
создается во
временном расположении.
- Необязательно: В поле Таблица стилейнажмите кнопку Обзор и выберите таблицу стилей для каждого типа вывода.
- Необязательно: Только вывод
Microsoft Word: в поле
Макрос введите имя макроса из таблицы стилей.
- Необязательно: Для того чтобы ввести дополнительные метаданные или настроить
другие свойства документа, отсутствующие в мастере, выберите
Изменить свойства метаданных.
- Нажмите кнопку Далее.
- Проверьте правильность информации о шаблоне и выводе в окне
сводки.
- Выберите действие, выполняемое при нажатии кнопки Готово:
- Начать процесс создания документа: Позволяет создать указанные типы вывода.
- Начать процесс создания документа и закрыть RPE: Позволяет
создать указанные типы вывода и закрыть приложение
Rational Publishing Engine вместе с окном Результаты.
- Закрыть мастер и открыть клиент RPE:
Позволяет открыть спецификацию документа со сведениями, указанными в
приложении Панель запуска.
- Нажмите кнопку Готово.
Совет: В случае удаленного создания документа приложение
приложение Document Studio или Панель запуска можно закрыть до завершения
процесса создания документа. В случае локального создания документа не закрывайте приложение
Document Studio или Панель запуска до завершения процесса создания
документа.
Результаты
Загружается спецификация документа и документ
генерируется или сохраняется.