批量更新任务可以帮助您迁移数据,并将资产移到 IBM® Rational® Asset Manager 服务器中。可使用文件系统选项来扩展批处理更新任务并可将任务扩展为读取任何类型的源数据并将源数据映射到资产。
扩展批处理更新任务
您可以将批量更新任务扩展为读取任何类型的源数据并映射到 Rational Asset Manager 中的资产。
Rational Asset Manager 批量更新任务通过查找资产和执行合并而不是每次都创建资产来执行智能映射。
com.ibm.ram.rich.ui.extension 插件包含文件系统扩展的源,它作为已安装的 Rational Asset Manager Eclipse 客户端的一部分包括在 /plugins 文件夹中。 您可以在 Eclipse 客户端安装目录中的 /eclipse/plugins/com.ibm.ram.rich.ui.extension_7.5.2.3.v.jar 处找到 JAR 文件。 解压缩该文件时,您可以在 /src 目录中找到 Java™ 文件。
文件系统扩展代码位于以下两个目录中:src\com\ibm\ram\internal\batch\filesystem\ 和 src\com\ibm\ram\internal\batch\filesystem\ui\
准备扩展和数据源
要使用文件系统选项扩展批处理更新任务,必须创建新的插件项目并实现扩展点的扩展。
批处理更新任务提供了两个要实现的扩展点:batchDataSource 和 batchDataSourceUI。
简化的文件系统扩展
此处是文件系统扩展的简化版本,您可以将其导出为可部署插件。该文件系统扩展可以从文件夹以及给定根文件夹中的 .zip 文件创建资产。该示例使用一个根文件夹,任何子文件夹或 .zip 文件都成为资产。子文件夹或归档文件的名称将成为资产的名称。子文件夹/文件的内容将成为工件,除必需的 .asset_info 文件以外。
FileSystemBatchDataSource 类基于根路径创建和返回资产。在该文件中,您可以指定批处理客户端扩展的数据源以从文件夹以及给定根文件夹中的 .zip 文件创建资产。那些文件夹和 .zip 文件必须包含名为 .asset_info 的文件。
FileSystemBatchUIContributor 类创建新数据源,方法是打开目录选择对话框,用户可以从中选择根目录,然后使用选择的内容来创建资产。 有关根目录的必需结构,请参阅 FileSystemBatchDataSource java 文件。
<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.4"?>
<plugin>
<extension point="com.ibm.ram.rich.core.batchDataSource">
<dataSourceType
class="com.ibm.ram.batch.example.FileSystemBatchDataSource"
id="com.ibm.ram.batch.example.filesystem">
</dataSourceType>
</extension>
<extension point="com.ibm.ram.rich.ui.extension.batchDataSourceUI">
<batchDataSourceUI
class="com.ibm.ram.batch.example.FileSystemBatchUIContributor"
dataSourceID="com.ibm.ram.batch.example.filesystem"
icon="icon.gif"
name="File System Example">
</batchDataSourceUI>
</extension>
</plugin>
这些扩展的代码示例在此:使用批处理上载文件系统扩展。
您还可以使用 Rational Asset Manager Java API 来运行批量上载操作并上载多个资产。请参阅执行批处理上载
本示例描述了如何为 Microsoft Excel 文件创建扩展。在本示例中,Microsoft Excel 文件是数据源,批量更新任务扩展被构建为 Eclipse 插件。批量更新任务可读取已设置格式的 Excel 文件,并将 Excel 行映射到 Rational Asset Manager 内的资产中。然后,用户可以在将数据提交 Rational Asset Manager 前对其进行修改。另请参阅批量上载示例。
准备数据源
| A | B | C | D | E | F | |
|---|---|---|---|---|---|---|
| 1 | 资产类型: 编著者 | 社区: 技术基础结构 | ||||
| 2 | 资产:GUID | 资产:版本 | 资产:名称 | 资产属性: 作者 | 类别模式: 许可证 | 忽略: IDE |
列标题使用一种资产中解析器所使用的特殊格式。行 1 和行 2 被保留。行 1 包含资产类型和社区声明。行 2 包含资产列的描述,如 GUID、版本、名称和资产属性。 要查看期望的格式,请检查样本电子表格。
创建 Eclipse 插件
该代码的结构为常规 Eclipse 插件;由您定义扩展点。
批处理更新任务会执行将资产提交到 Rational Asset Manager 的操作。
使用批处理更新任务
在示例中,Eclipse 客户端插件部署在您的机器上。
选择目标 Rational Asset Manager 存储库后,批处理编辑器将读取 Excel 文件,并将其映射到目标 Rational Asset Manager 实例中。此时,不会上载任何资产。Rational Asset Manager 批处理编辑器提供初始映射的摘要。在本示例中,Excel 文件中的资产将特定 Rational Asset Manager 社区作为目标,而批处理编辑器在 Rational Asset Manager 中没有找到该社区。如本示例中所示,具有访问权的用户可立即创建社区。
映射活动继续检查资产类型、资产版本信息以及关系类型等。在每种情况下,用户都可以映射到 Rational Asset Manager 中的现有配置信息,如果他们拥有访问权限,则可以添加该信息。
类结构和对象