将
Rational Rhapsody
与
Rational Publishing Engine
集成
可以将
Rational® Rhapsody®
定义为
Rational Publishing Engine
中的数据源。
提示:
Rational Publishing Engine
安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅
创建 REST 样本模板
。
开始之前
熟悉使用
Rational Publishing Engine
时从
Rational Rhapsody
抽取数据所需的
Rational Rhapsody
REST 服务和各种 URL。要找到适用于
Rational Rhapsody
版本的信息中心,请参阅
关于
Rational Rhapsody
信息中心
。
连接至数据源模式。请参阅
添加数据源模式
。
模式可以位于本地文件系统上。例如,
https://
server
:
port
/Rational/Rhapsody/fields.xsd
是一个使用
fields
参数的模式文件。可以使用此模式从
Rational Rhapsody
项目添加特定数据部分。
可以使用数据源模式中的元素在模板中添加查询。这些查询指定在报告中生成的信息。
Rational Rhapsody
模式的缺省位置为
%Rational_Rhapsody_HOME%\RPE\Schemas
。从应用了概要文件和新增了术语的模型发现模式时,请确保已在
Rational Rhapsody
中装入含有概要文件和新术语的模型。
连接至数据源模式之后,可以创建或导入模板设计。使用
Rational Publishing Engine
Document Studio,可以构建报告模板设计。此设计将确定报告的布局。
使用 Document Studio 来编写模板
.
规划文档的结构并定义内容以抽取数据。请参阅
设计文档模板
,以获取模板开发流程的概述。对于大型文档,可以为每个文档块创建单独的模板。
Rational Publishing Engine
具有可用来构造文档的全面模板元素集。可以将元素拖到模板内容编辑器。有关更多详细信息,请参阅
“选用板”视图中的模板元素
。
使用
查询
、
属性
和
变量
将数据添加至模板。
可以使用数据源配置元素来定义运行时的一些未知属性。请参阅
添加数据源配置元素
。
可以使用过滤器(常规数据源 URI 的更具体版本)来指向特定的数据子集,以免
Rational Publishing Engine
在生成报告期间尝试从
Rational Rhapsody
存储库检索额外的信息。这些过滤器必须足够广泛才能检索到模板引用的所有必需数据,否则生成的报告无法包含完整数据集。有关更多信息,请参阅
使用本机过滤器来抽取数据
和
REST 本机过滤器支持的过滤条件
。
可以使用强制类型转换查询过滤器来优化查询的结果。强制类型转换功能用作数据源元素的备用过滤器;有关详细信息,请参阅
强制类型转换
。
创建报告模板并填之以
Rational Rhapsody
数据点之后,可以生成各种格式的报告。生成报告时,必须连接至数据源。要指向相关数据,请参阅
连接至数据源
。
如果在将某个模板分配给文档规范之后又向该模板添加了数据源模式,那么该文档规范将不同步。可以
手动同步文档规范
,或选择首选项来使文档规范与当前模板自动同步。请参阅
设置文档设计首选项
以获取有关如何设置
是否使文档规范与当前模板保持同步?
首选项的信息。
发布文档之前,请参阅
指定输出属性
主题,以获取有关可以选择的可用输出选项以及哪个选项对于模板中所使用元素最适用的更多信息。
您现在已准备就绪,可以发布文档。请参阅
生成文档
。
注:
发布文档之前,必须打开正确的
Rational Rhapsody
项目,并且必须正在运行
Rational Rhapsody
Web 服务器。
示例:Rational Rhapsody 中的强制类型转换
类型强制类型转换会优化查询的结果并允许
Rational Publishing Engine
将
.xsd
模式类型视为不同的类型,这与编程语言中的强制类型转换操作类似。不会将类型分配给可以具有多种有效类型的模式元素。使用“数据源模式”视图中的
强制类型转换
功能来定义这些元素的类型。
反馈