导入和导出数据

您可以将数据导入 CA Agile Central 或将数据从 CA Agile Central 导出到其他应用程序。

新信息:如果您要导入测试用例,请阅读此处的更多信息。

导入数据

使用以逗号分隔值 (CSV) 格式的文件将数据从其他产品导入 CA Agile Central。在 CA Agile Central 的每个摘要页面上,您可以从“操作”下拉菜单选择“导入”选项以启动导入向导。

页面 菜单选项
积压工作 导入用户情景
用户情景 导入用户情景
迭代状态 导入用户情景
导入任务
项目组合项(需要 CA Agile Central Portfolio Manager 导入项目组合项
任务 导入任务
缺陷 导入
测试用例(需要 CA Agile Central Quality Manager 导入测试用例

导入数据时,请务必考虑以下内容:


注意:

  • 在导入之前消除重复的工作项;如果 CSV 文件中有重复的工作项,则必须手动对其进行修复
  • 您无法使用导入功能更新现有工作项;随着新工作项的创建,就会导致重复项
  • 您无法在工作项之间导入关联,如父项-子项情景关系
  • 您无法导入测试用例步骤
  • 您导入的任务的排定状态可以更新与其关联的用户情景或缺陷的状态
  • 有关包括关系在内的高级导入,请参阅“适用于 Excel 的 CA Agile Central 加载项

要导入 CSV 文件:

  1. 在需要从中导入工作项的摘要页面上,选择“操作”→“导入”
  2. 在“导入”弹出窗口中,通过单击带超链接的导入模板来验证 CSV 文件格式正确
    这些模板中的标题列必须在 CSV 文件中完全复制才能成功导入。每个模板均可针对导入进行修改。
  3. 单击“浏览”以找到 CSV 文件。
  4. 选择文件,然后单击“打开”。
  5. (可选)单击“高级”超链接以指定字符编码方式。
  6. 单击“导入”,数据随即被导入并显示在摘要视图的末尾。

注意:如果启用拖放排位,然后尝试导出视图并在 CA Agile Central 之外重新对数据进行排位,导出操作则会反映某种页面顺序而非排位数字。导入数据时,将保留新的页面顺序;但是,导入的工作项会被附加到视图的末尾。现有工作项不会被覆盖,但会被视为新的工作项。

数据随即被添加到摘要视图的顶部。

如果导入文件位置的路径为 256 个字符或更长且操作系统为 Microsoft Windows,则无法导入文件。这是 Windows 的限制。

如果管理员已将某些字段标记为必填字段,则必须为 CSV 文件中的这些列提供值。

添加到工作项的所有自定义值或自定义字段均会包括在相关的数据导入模板中。标准字段将列在最前面,后跟自定义字段。

导入先前从父项目导出的文件只会将其导入到当前项目。它不会导入到多个项目。

数据导入规范

不同工作项提供不同级别的数据导入。使用下表来指导您导入工作项。

注意:如果尝试导入包含多个测试步骤的测试用例,则建议使用适用于 Excel 的 CA Agile Central 加载项
导入 已导入字段 字段级规范
用户情景
名称 限制为 256 个字符
说明 限制为 32K(通过 CSV 文件导入)
程序包 
风险 
积压工作状态 
积压工作排位 
所有者所需所有者的用户名
注释 
缺陷
名称 限制为 256 个字符
说明 限制为 32K(通过 CSV 文件导入)
状态 有效值为:未结、已结、已提交、已修复
程序包 
重要级别 有效值为:崩溃/数据丢失、重大问题,轻微问题、外观、无
提交者 
环境 有效值为:生产、测试、开发
已发现于内部版本 最大长度为 128 个字符
优先级 有效值为:立即解决、高度注意、正常、低、无
所有者所需所有者的用户名
影响文档 T/F 
发布说明 T/F 
目标日期 
目标内部版本 
已修复于内部版本 最大长度为 128 个字符
解决办法 有效值为:体系结构、代码更改、配置更改、数据库更改、重复、需要更多信息、不是缺陷、软件限制、用户界面
已验证于内部版本 最大长度为 128 个字符
注释 
任务
名称 限制为 256 个字符
说明 限制为 32K(通过 CSV 文件导入)
工作产品 必填字段;输入关联工作项的格式化 ID(如,US123 或 DE456)
状态  
所有者 所需所有者的用户名
估算 
待做 
受阻
T/F
 
就绪
T/F
 
受阻原因 限制为 256 个字符
程序包有效值取决于当前工作区配置中的对应值
注释 
实际值  
测试用例
名称 限制为 256 个字符
说明 限制为 32K(通过 CSV 文件导入)
注释 
所有者所需所有者的用户名
测试文件夹 测试用例的父文件夹(如,TF123)
工作产品 输入关联工作项的格式化 ID(如,US123 或 DE456)
目标 最大为 2k(仅文本)
类型 有效值取决于当前工作区配置中的测试用例类型值
方法 - 手工/自动 有效值为“手动”和“自动”(区分大小写)
优先级有效值取决于当前工作区配置中的对应值
风险有效值取决于当前工作区配置中的对应值
程序包有效值取决于当前工作区配置中的对应值
最后裁定 有效值取决于当前工作区配置中的对应值;如果 CSV 导入文件中包含“最后裁定”、“最后内部版本”和“最后运行”,则会为测试用例创建测试用例结果
最后内部版本 测试用例结果限制为 128 个字符;如果 CSV 导入文件中包含“最终裁定”、“最后内部版本”和“最后运行”,则会为测试用例创建测试用例结果
最后运行 必须是格式与用户配置文件设置中所设的用户日期/时间格式相同的有效日期;如果 CSV 导入文件中包含“最后裁定”、“最后内部版本”和“最后运行”,则会为测试用例创建测试用例结果
项目组合项
投资类别  
计划结束日期 使用日期格式 mm/dd/yyyy
计划开始日期 使用日期格式 mm/dd/yyyy
项目组合项类型 必填字段
初步估算  
风险记分  
价值记分  
名称  
说明  
注释 
所有者 所需所有者的用户名
就绪  

CSV 导入格式文件

导入对话框包含用于下载数据导入模板的链接,该链接有助于正确格式化 CSV 文件以确保所有数据均会导入。每个工作项均有特定的数据导入模板,该模板为包含在该工作项中的所有字段均提供了格式。要成功导入文件,列标题必须与数据导入模板中的列标题匹配。CA Agile Central 建议您下载提供的模板以便在每次导入文件之前验证格式是否正确。每个模板均可针对导入进行修改。

数据导入模板的第一行为列标题。该模板的第二行包含示例数据。

CSV 文件格式化注意事项:

  • 字段以逗号分隔,且当其包含逗号或引号时用引号括起
  • 输入数据中嵌入的引号会翻倍
  • 嵌入的空格不需要用引号括起
  • 此行的最后一个字段后面没有逗号
  • 空字段用两个连续的逗号表示
  • 字段中的前导和尾部空格(即便在引号内)将被忽略
  • 文件通常必须以单个 CrLf(回车、换行或两者)结束
  • CSV 文件的路径长度不得超过 255 个字符
  • 支持 Windows 和非 Windows 文件浏览

出现以下情况时,CA Agile Central 会提示您消息对话框:

  • 导入的文件大于 2 MB
  • 缺少标题或标题不正确
  • 布尔字段的无效值:有效值为 t、T、F、f、True、False、true、false
  • 数字字段中的无效、非数字值
  • 日期格式无效:所有日期的格式均须为 mm/dd/yyyy
  • 用户名字段(所有者、提交者)无效(如果用户名不存在)
  • 导入非 CSV 文件格式
  • 导入带不匹配的区分大小写的列表值的字段
  • 导入空文件

导出数据

您可以导出用户情景、测试用例、缺陷、发布、迭代、项目组合项和任务。您可以将数据导出到 CSV 或 XML 文件。用任意可访问 CSV 或 XML 文件格式和操纵数据的应用程序打开此文件以通过图表、报告和其他形式进行显示。导出数据中的日期和时间格式如下:2016-05-10T21:26.13.984Z。

  1. 在要从中导出工作项的摘要页面上,单击“操作”,然后选择一种格式:
    • CSV
    • XML(并非在所有摘要页面上均可用)
  2. 在“导出”弹出窗口中,指定要打开还是保存此文件。
  3. 单击“确定”。

CSV 选项将导出当前显示在摘要页面上的字段。创建自定义视图以包括其他字段从而获取所需的导出数据。

注意:如果您尝试导出到 CSV 且包含类似 Unicode UTF-8 字符的特殊字符,则需通过经配置可读取 UTF-8 字符的应用程序来打开导出的文件。否则,这些字符不会显示在导出的文件中。

子用户情景随即被导出,并依次按父用户情景排位、层次结构和子用户情景排位进行排序。“父项 ID”字段包含父用户情景的 ID。

您必须至少具备编辑级别的安全性才能导出工作产品。

如果拖放排位处于活动状态且尝试导出视图并在 CA Agile Central 之外对数据重新进行排位,导出则会反映某种页面顺序而非排位数字。导入数据时,将保留新的页面顺序;但是,导入的工作项会被附加到视图的末尾。现有工作项不会被覆盖,但会被视为新的工作项。

XML 导出

注意:如果使用 XML 导出选项且有包含数千个工作项的大型数据集,导出则可能会因超时而导致导出失败。要避免此问题,请缩小数据集或使用 CSV 导出选项或适用于 Excel 的 CA Agile Central 加载项

XML 导出涉及对象,而非实际的子项集合。集合包括:

  • 构件 → 更改集
  • 构件 → 标记
  • 内部版本 → 更改集
  • 内部版本定义 → 内部版本
  • 内部版本定义 → 项目
  • 更改 → 构件
  • 更改 → 内部版本
  • 更改 → 更改
  • 缺陷 → 更改集
  • 缺陷 → 重复项
  • 缺陷 → 任务
  • 缺陷 → 测试用例结果
  • 缺陷 → 测试用例
  • 缺陷集 → 缺陷
  • 缺陷集 → 任务
  • 用户情景 → 更改集
  • 用户情景 → 子项
  • 用户情景 → 缺陷
  • 用户情景 → 前置项
  • 用户情景 → 后续项
  • 用户情景 → 任务
  • 用户情景 → 测试用例
  • 项目组合项/功能 → 用户情景
  • 项目组合项/新方案 → 子项(项目组合项/功能)
  • 项目组合项/策略 → 子项(项目组合项/新方案)
  • 项目 → 内部版本定义
  • 项目 → 子项
  • 项目 → 编辑器(用户)
  • 项目 → 迭代
  • 项目 → 版本
  • 项目 → 团队成员(用户)
  • SCM 存储库 → 项目
  • 订阅 → 工作区
  • 测试用例 → 结果(测试用例结果)
  • 测试用例 → 步骤(测试用例步骤)
  • 测试文件夹 → 子项(测试文件夹)
  • 测试文件夹 → 测试用例
  • 测试集 → 任务
  • 测试集 → 测试用例

导入测试用例

该功能允许您导入一个文件中的多个类型,以及导入测试用例步骤。


注意:在 Excel 中编辑模板时,请确保将其特别另存为 CSV 文件。Excel 可以更改文件的格式并重新排列各列。您将收到的错误消息为“第 0 行:您必须包括‘对象类型’列。”


注意:
  • 无论何时使用导入程序进行导入,都必须指定 ObjectType。如果不在此字段中输入值,则无论您正在导入的是一个还是多个工作项类型,都会遇到错误。
  • 下载导入模板时,第二行中的必填字段的示例值旁边将显示“(必填)”。
  • 每一行都将单独处理并保存,只有失败的行不会被导入。如果有失败并重新运行同一文件,则出现重复的对象。
  • 项目”字段不能被导入;导入的所有构件都将添加到当前项目中。
  • 如果将测试用例步骤导入到已有步骤的测试用例中,导入文件中的测试用例步骤将始终附加到现有测试用例步骤的列表。
  • 在导入时输入用户 ID 以设置所有者。
  • 导入模板中的字段和示例值特定于测试用例。如果要导入测试用例步骤(或任何其他类型的数据),请将必填字段以列的形式包括在导入文件中。您可以编辑现有测试用例以查看测试用例步骤的必填字段。

无法导入某些字段。例如,导入测试用例时,使用测试集字段不会将其关联到某个测试集。对于这些字段,您不会看到错误消息,因为您可以导入单个文件中的多个项类型。无法导入的字段的其他一些示例包括:

(在“对象类型”字段中)导入以下项时... 不能在同一行上关联以下项:
测试用例 测试集、排位
测试集 测试用例
测试文件夹 测试用例

启用后,用户可以在“测试用例”页面中使用这个新的导入选项。

导入一个文件中的多个类型

这需要“对象类型”列。值应该是您要导入的类型名称,如“测试用例”、“测试用例步骤”等。

对于不适用于特定对象类型的任何属性,都请添加空值。

将测试用例步骤关联到前一行上的测试用例

在“测试用例”列中,使用 line[2] 语法以指示您想要引用在第 2 行创建的对象。

有两个选项用于将测试用例步骤导入现有测试用例。

选项 1 - 复制新测试用例的格式化 ID

在创建并保存新的测试用例后,复制其格式化 ID。使用该格式化 ID 为您的测试用例步骤创建 CSV。选择该文件进行导入,在完成后,您会注意到新创建的测试用例现在已包含测试用例步骤。

在“测试用例”列中使用测试用例的格式化 ID。

注意:如果引用已回收或已删除的项,该行在导入时会失败。

选项 2 - 使用 WSAPI 引用

或者,您可以在“测试用例”列中使用测试用例的 WSAPI 引用。

反馈

需要更多帮助? CA Agile Central 社区为您提供一站式自助和支持。要将反馈或支持请求提交到 CA Agile Central 支持、获取解答并与其他用户协作,请加入我们的 CA Agile Central 社区