在此发行版的 ClearQuest® 连接器中,存在多项局限性与已知问题。
在此发行版中,存在下列局限性与已知问题:
- 要使用 ClearQuest 连接器,必须运行 IBM® Rational® ClearQuest 7.0.1 或更高版本。
- ClearQuest 连接器安装向导只能在 Windows®
上运行。如果您正在 Linux® 上部署 ClearQuest
连接器,那么可以在 Windows 上运行 ClearQuest 连接器安装向导。此向导将生成供网关使用的
cqconnector.properties 文件。您可以将生成的属性文件复制到 Linux
计算机,对其进行编辑,然后在该计算机上启动网关。
- 在 ClearQuest 连接器安装向导的“Jazz™ 服务器配置”部分中,如果 Jazz
用户注册表处于只读状态(当 Jazz Team Server 在 WebSphere® Application Server
上运行或者已被配置为使用轻量级目录访问协议(LDAP)时,情况即如此),那么创建新帐户选项将失败。
- 在使工作项注释与 ClearQuest 缺陷说明同步时,存在下列限制:
- 该说明中的时间戳记是它的同步时间,而不是该注释的创建时间。
- 与该说明相关联的用户名是 ClearQuest 连接器用户帐户的用户名,而不是创建该注释的用户。
- 由于对说明和注释添加的内容将被追加到现有条目,并且不能交错,因此条目顺序是它们的同步顺序,而不是它们的创建顺序。
- 在 ClearQuest 记录类型与 Rational Team Concert™ 项之间映射状态值时,无法映射从
ClearQuest 的“已关闭”状态到“已打开”状态的过渡。
- Jazz 存储库由于以 Unicode
格式存储数据而能够包含多种本地语言的字符数据,但 ClearQuest
用户数据库每次只能存储一种字符集的数据。如果 ClearQuest
用户数据库的字符集不支持工作项中的字符数据,那么同步操作将失败并返回错误,例如:字段“描述”包含数据代码页“1252(MS
Windows Latin 1)”不支持的字符。
- 在 ClearQuest 用户数据库中,“取消复制”操作将记录状态变更为它在“复制”操作前所处的状态。在某些情况下,Rational Team Concert
工作项会由于其状态过渡模型不支持同一状态过渡而无法进行该过渡。
- 在与 Rational Team Concert 项同步的 ClearQuest 记录类型中定义关键字时,请使用小写字母并且不要包括空格。
- 虽然 ClearQuest 记录可以包含多个附件列表字段,但 Rational Team Concert 项只能包含一个这种字段。
- 请不要对附件同步规则添加“描述”属性的映射;此映射不受支持,并且将导致同步失败并返回错误“附件属性名无效:描述”。
- 在某些情况下,对工作项添加附件时,如果您是在 Microsoft® Internet Explorer 浏览器中使用
Rational Team Concert Web 界面,并且所附加的文件在远程计算机上,那么同步操作将失败。要解决此问题,请除去该附件,将其复制到本地计算机,然后将其重新附加到工作项。此外,也可以将所要附加的文件留在远程计算机上并使用另一款浏览器重新附加该文件。
- 如果将 ClearQuest 连接器与 DB2® 用户数据库和模式存储库配合使用,那么某些情况下可能会发生数据库死锁。为了避免此问题,对于用户数据库和模式存储库,请将 DB2 MAXAPPLS 参数设置为 200。
- 在 cqconnector.properties 文件中指定 Jazz 服务器的统一资源标识(URI)和
com.ibm.team.uris 参数时,请不要在用户名或密码部分中包括不标准的 URL 字符,例如
@ 字符。请使用相应的转义字符来代替不标准的 URL 字符。例如,使用 %40 来代替 @ 字符。
- 如果在非 ASCII 环境中使用 ClearQuest 连接器,那么对于 cqconnector.properties
文件中的任何非 ASCII 字符,必须使用 Unicode 转义字符。Java™ 实用程序 native2ascii
用于将其他格式的字符转换为 Unicode 转义格式。
- 在支持 UTF-8 编码的文本编辑器(例如记事本)中,创建一个包含 cqconnector.properties 文件中的非 ASCII 字符的文件并保存该文件。
- 在运行 Windows 的计算机上,打开 DOS 命令提示符控制台并转到
Java-安装目录/bin 目录。
- 输入 native2ascii.exe -encoding 源文件 要生成的-Unicode-转义文件,其中 源文件 是您在步骤 1 中创建的文件。
- 打开生成的文件并复制 Unicode 转义字符。打开 cqconnector.properties 文件。将 Unicode 转义字符粘贴到
cqconnector.properties 文件中需要该字符的位置。保存修改后的 cqconnector.properties 文件。
- 对模式应用 JazzInterop 包时,您将选择要将该包应用于的记录类型。以后,如果您决定将该包应用于最初应用该包时未选择的某种有状态记录类型,那么可以进行该应用。但是,如果该模式的缺省脚本语言是
Visual Basic,那么无法将该包应用于最初将该包应用于该模式时未选择的无状态记录类型。
- install-directory/gateway 目录中的 server.shutdown 脚本无法关闭
ClearQuest 网关。在 Windows 上,请单击 Tomcat
控制台窗口中的关闭图标(X)。在 Linux
上,请输入命令 kill -9 process-ID。
- Rational Team Concert 2.0 和 2.0.0.1 中的 ClearQuest 导入向导与 ClearQuest 7.1.1
不兼容。要将此向导与 ClearQuest 7.1.1 配合使用,请升级到 Rational Team Concert 2.0.0.2。