在将
Rational System Architect
用作数据源的情况下设计模板
报告设计者可使用 Document Studio 来导入数据源模式和构建报告模板。
开始之前
提示:
Rational® Publishing Engine
安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅
创建 REST 样本模板
。
熟悉使用
Rational Publishing Engine
从
Rational System Architect
抽取数据所需的
Rational System Architect
REST 服务和各种 URL。要找到与您的
Rational System Architect
版本对应的信息中心,请参阅
关于
Rational System Architect
信息中心
。
关于此任务
使用 REST API 来截取数据。此接口通过数据源应用程序安装和实现,独立于
Rational Publishing Engine
工作。有关数据源的 REST API 的更多信息,请参阅该数据源的文档。
过程
如果要使用
设计管理
,那么将
Rational System Architect
模型发布到
设计管理
,并遵循
在将 设计管理 用作数据源的情况下设计模板
中的指示信息以针对模型设计模板。 如果不要使用
设计管理
,那么继续此任务。
查看
设计文档模板
,以获取模板开发流程的概述。
开始规划文档的结构以及可包括的数据。 例如,决定是将从一个模板还是从多个模板文件(每个文件都包含可复用的内容部分)生成最终文档。
在 Document Studio 应用程序中,
创建文档模板
。
将数据源模式添加至文档模板。
对于
Rational System Architect
,可通过输入应用程序的基本 URL 来发现数据源模式。
在 Document Studio 中,单击
数据
>
模式发现
>
REST 模式发现
。
为数据源输入
名称
。
为数据源输入
描述
。
指定资源的
基本 URL
。
以下是
Rational System Architect
的基本 URL:
https://
server
:
port
/rsasuite/com.ibm.rsa.business.enterprise.xsd
从列表中选择
认证类型
。
如果没有选择类型,那么会测试每种类型,直到找到正确的类型,这会延长文档生成时间。
如果资源位于受保护的服务器中,请指定
用户名
。
如果资源位于受保护的服务器中,请指定
密码
。
单击
下一步
。
会对您输入的基本 URL 自动追加
?metadata=schema
。示例:
https://
server
:
port
/rsasuite/com.ibm.rsa.business.enterprise.xsd?metadata=schema
单击
完成
。
您选择的数据源模式会显示在“数据源模式”视图中。
将元素添加至模板。
Rational Publishing Engine
具有一组全面的模板元素,可以用于构造文档。可以将元素拖动到模板内容编辑器中。例如,可添加容器元素来保存若干段。 每段都可由一个测试条件控制,该条件使该段仅与特定数据关联。关于更多信息,请参阅
“选用板”视图中的模板元素
和
将元素添加至模板
。
使用
查询
、
属性
和
变量
来向模板添加数据。这些项指定会在报告中生成哪些信息部分。
将
格式设置和样式
添加至这些元素,以控制它们在输出中的显示方式。
创建
过滤器
,以精简拉入报告中的数据。
过滤器是通用数据源 URI 的详细版本;可以使用过滤器来指向特定的数据子集,以便使
Rational Publishing Engine
在报告生成期间仅尝试从数据源检索必需的信息。这些过滤器必须足够广泛,能够检索由模板引用的所有必需数据,否则生成的报告就无法包含完整的数据。
创建
排序
,以对报告中的数据进行组织。
上一主题:
配置 Rational System Architect 与 Rational Publishing Engine 之间的集成
下一主题:
在将 Rational System Architect 用作数据源的情况下生成文档
相关信息
:
白皮书:将
Rational Publishing Engine
与
Rational System Architect
一起使用
DeveloperWorks 示例:RPE - System Architect
反馈