Создание документов с помощью Rational Team Concert в качестве источника данных
Процедура
- В приложении Document Studio или Удаленные службы откройте мастер создания документа. Для этого выберите Спецификация документа > Создать > Настроить и создать документ.
- В разделе Шаблоны показаны шаблоны из спецификации документа. Для добавления шаблона выполните следующие действия:
- Выберите расположение шаблонов для добавления:
- Из централизованной библиотеки: позволяет выбрать шаблоны в компоненте Централизованное управление
- Из локального или удаленного файла: для того чтобы выбрать локальный или удаленный шаблон, введите URL шаблона или выберите шаблон с помощью кнопки Обзор.
- Выберите один или несколько шаблонов для добавления.
- Если выбран вариант Из централизованной библиотеки и выбраны шаблоны из компонента Централизованное управление, нажмите кнопку Добавить выбранные, чтобы добавить шаблоны в спецификацию документа.
- Если выбран вариант Из локального или удаленного файла и указан URL отдельного шаблона, то нажмите кнопку Добавить URL, чтобы добавить шаблон в спецификацию документа.
- Если выбран вариант Из локального или удаленного файла, то при нажатии кнопки Открыть выбранные шаблоны добавляются в спецификацию документа.
- Необязательно: Повторите эти действия для добавления дополнительных шаблонов из других расположений.
- Необязательно: Для изменения порядка шаблонов в спецификации документа выберите шаблон и нажмите кнопку Вверх или Вниз.
- Нажмите кнопку Далее. После добавления шаблона в мастер добавляются источники данных и переменные, указанные в шаблоне.
- В разделе Источники данных настройте каждый источник данных.
Прим.:
- Если для источника данных уже существует значение по умолчанию или задан URI по умолчанию, то источник данных отображается как настроенный и значение по умолчанию применяется в выводе, если не будет выбрано другое значение.
- Если выйти из раздела Источники данных и нажать кнопку Назад для внесения дополнительных изменений в источник данных, то всегда открывается первый источник данных в списке.
- Выберите источник данных в одном из следующих расположений:
- Настройка вручную: позволяет выбрать локальный или удаленный источник данных, для которого не существует другая информация о конфигурации на уровне конфигурации или в компоненте Централизованное управление.
- С помощью значений источников из центральной библиотеки: позволяет выбрать источник данных в компоненте Централизованное управление
- Загрузить из уровня конфигурации: для того чтобы выбрать значение в метаданных конфигурации, указанных для источника данных в шаблоне.
- В зависимости от варианта, выбранного на предыдущем шаге, можно выбрать значение для источника данных одним из следующих способов: ввод URL, выбор с помощью кнопки Обзор или выбор значения на уровне конфигурации. Если значение представляет собой URL или содержит URL, то URL источника данных для Rational Team Concert можно определить следующим образом:
- Определите URL схемы источника данных, с помощью которого схема была добавлена в шаблон.
- Удалите суффикс ?metadata=schema из URL схемы источника данных. Пример:
- URL схемы источника данных: https://сервер:порт/ccm/rpt/repository/workitem?metadata=schema
- URL источника данных: https://сервер:порт/ccm/rpt/repository/workitem.
Один и тот же URL необязательно использовать в качестве схемы источника данных. Вы можете указать на другое хранилище Rational Team Concert, чтобы получить доступ к его данным, поскольку все хранилища Rational Team Concert используют один и тот же API REST.
Если данные, к которым вы планируете обратиться, содержатся в меньшем фрагменте схемы, то вы можете составить более конкретные URI. Например:
- Для возврата поля id всех элементов workItem: https://сервер:порт/ccm/rpt/repository/workitem?fields=workitem/workItem/id
- Для возврата полей id и summary всех элементов workItem: https://сервер:порт/ccm/rpt/repository/workitem?fields=workitem/workItem/(id/summary)
Прим.: API REST Rational Team Concert не поддерживает формат RTF.
- Укажите имя пользователя, если ресурс расположен на защищенном сервере.
- Укажите пароль, если ресурс расположен на защищенном сервере.
- Выберите Тип идентификации в списке. Для Rational Team Concert применяется тип идентификации OAuth. Если значение OAuth не выбрано, то правильный тип идентификации выбирается путем проверки всех типов идентификации. Это может привести к увеличению времени создания документов.
- Необязательно: Введите заголовок accept. Значение по умолчанию: application/xml, */*.
- Необязательно: Для применения указанных идентификационных данных ко всем источникам данных, включите переключатель Применить эти значения имени пользователя и пароля к каждому настроенному и ненастроенному источнику данных.
- Нажмите кнопку Далее
- В разделе Переменные настройте каждую переменную.
Прим.:
- Если для переменной уже существует значение по умолчанию, то переменная отображается как настроенная и значение по умолчанию применяется в выводе, если не будет выбрано другое значение.
- Если выйти из раздела Переменные и нажать кнопку Назад для внесения дополнительных изменений в переменную, то всегда открывается первая переменная в списке.
- В выпадающем меню выберите одну из следующих опций:
- Настройка вручную: позволяет ввести любое значение переменной, для которой не существует другая информация на уровне конфигурации или в компоненте Централизованное управление.
- Из уровня конфигурации: для того чтобы выбрать значение в метаданных конфигурации, указанных для переменной в шаблоне.
- С помощью значений переменных из централизованной библиотеки: позволяет выбрать переменную в компоненте Централизованное управление
- Введите или выберите значение для конфигурации.
- Нажмите кнопку Далее.
- В разделе Вывод выберите типы вывода для создания:
- Microsoft Word
- PDF
- HTML
- XSL-FO
- Устаревший формат PDF
- Необязательно: В поле Расположение для сохранения нажмите кнопку Обзор и выберите каталог для сохранения файла для каждого типа вывода. Можно указать относительный путь из спецификации документа. Если расположение сохранения вывода не указано, то файл создается во временном расположении.
- Необязательно: В поле Таблица стилей нажмите кнопку Обзор и выберите таблицу стилей для каждого типа вывода.
- Необязательно: Только вывод Microsoft Word: в поле Макрос введите имя макроса из таблицы стилей.
- Необязательно: Для того чтобы ввести дополнительные метаданные или настроить другие свойства документа, отсутствующие в мастере, выберите Изменить свойства метаданных.
- Нажмите кнопку Далее.
- Проверьте правильность информации о шаблоне и выводе в окне сводки.
- Выберите действие, выполняемое при нажатии кнопки Готово:
- Начать процесс создания документа: Позволяет создать указанные типы вывода.
- Начать процесс создания документа и закрыть RPE: Позволяет создать указанные типы вывода и закрыть приложение Rational Publishing Engine вместе с окном Результаты.
- Сохранить и закрыть мастер без создания документа: мастер создания документов закрывается, а приложение Панель запуска остается открытым.
|