[Stephen]Export from Excel to ALM

1、根据当前安装的ALM版本和Excel版本到https://hpln.hp.com/page/alm-excel-addin-page中对应的插件进行下载安装，安装时Excel需要关闭。
安装成功后，由于Excel版本不同的问题，07和10在加载向下 会看见 “Export To HP ALM”按钮

如果Excel版本为03则会在工具下看到该按钮。

2、在Excel中按ALM的格式要求整理你的测试用例文档，如下为ALM关于插件格式说明的原文翻译：

格式指南

• 在Excel中设置好每行数据的先后顺序
• 把你想导出的字段设计成列。确定其中包含了在ALM中对于需求、测试用例、缺陷所定义的字段。
• 自动映射。Excel插件可以自动映射ALM中的字段到工作表中的列。启用自动映射的条件是：

在Excel的第一行中定义的列名与ALM中定义的字段名称相同.

插件会自动扫描首行的列名与ALM中字段名进行匹配,当遇到到第一个空单元格时停止匹配。所以确保首行中除了末尾外，中间不要出现有空列。

• 确定你写的每一个需求、测试用例、缺陷包含了所有你在ALM中定义的字段。详细字段信息可在QC中查看。
• 当需要向ALM中的某一字段导出多个值时，这些值用分号（;）隔离开。
• Excel中字段的数据必须不超出过ALM中对该字段定义的大小（长度）。
• 数据中导出到ALM选择列表的，必须匹配那些选择列表中定义的条目。例如ALM的“优先级”字段只能接受如下值：5-Urgent，4-Very High，3-High，2-Medium，1-Low
• 只有纯文本和超链接格式可以被导出的ALM中。其他任何图形和格式都会被忽略和移除。
• 你可以导出附件到需求、测试用例、缺陷。更多信息请看“复件的格式化”。
• 你可以导出测试用例的设计步骤，因为他们都和测试用例存放在一起。
• 你不能导出与需求、测试用例、缺陷的间接相关的信息。例如，你导出测试用例时，无法指定多个需求被每一个测试用例覆盖。

然而，如果你在Excel中修改测试用例，或添加测试用例到测试主题，并且再次导出数据到ALM中，在测试计划模块中已经存在的测试用例会被更新，并且会保留测试用例所覆盖需求的关系。

• 每个需求、测试用例或设计步骤在每一个水平行必须有一个唯一不重复的名字。如果名字唯一，数据将会被覆盖。例如，如果你工作表中有两个需求有相同的名字，那么只有一条数据能被导入。

附件的格式化

• 当为需求、测试用例、缺陷格式化附件时，要注意以下几点：
• 附件需要单独指定一列
• 如果要给测试用例的步骤添加附件，（为了区别于给测试用例上添加的附件）测试步骤附件需要单独指定一列
• 一个附件可以是一个文件或者一个URL

导出一个文件，要指定该文件的全路径，例如：C:\file1.txt. Alternatively，以一个超链接的方式放在单元格中指向文件。

导出一个URL，要先保存URL到一个快捷方式文件，然后在单元格中指定该文件的全路径。你不能直接在我那工作表中敲入一个URL地址。

• 要到处多个附件时，他们之间用分号（;）隔离开。

例如：Attachment1;Attachment2;Attachment3

测试用例的格式化

在你将测试用例导出到ALM的测试计划中之前，你需要先在你的工作表中格式化测试用例。

格式化时要注意如下几点：

• 主题   指定一个主题列,用来指当测试用例创建的时候应放在哪个测试主题文件夹下。如果需要在测试计划的子主题下创建测试用例，父主题和子主题之间用反斜杠（\）分隔。确保不要使用正斜杠（/）。
• 设计步骤   在单独的行中输入每一个设计步骤。保证同一测试用例下的设计步骤包含相同的主题和测试名称

下面的例子显示了两个测试用例，每个用例包含两个设计步骤。

导入ALM后看到的效果如下：

编者注：如果是自己导入测试用例，并不建议这样做，按测试步骤新建Excel行数据太浪费时间，直接将所有步骤写在一行中即可。这样导入到ALM中的效果相当于每个测试用例只有一个测试步骤。

3、当将测试用例在Excel中按ALM的要求格式化处理后，开始导入。

导入步骤截图如下：

• 连接服务器，红框中输入ALM地址

• 填写ALM登陆账号

• 选择导入项目

• 选择导入文件类型

• 选择字段映射方案，第一次导入时需要手动填写一个名称，导入后插件自动会保存成方案，再次导入时直接使用方案即可。

第一次导入如下操作

第二次导入直接选择方案

设置字段映射方案,即将ALM中的字段映射为Excel中的哪一列，其中红黑标记的属性表示一定要进行映射匹配的关键字段。

完成如上，点击 Export  完成导入工作。

编者注：

1、如果测试用例中没有我们所需的字段，其实都可以自行配置，配置所在位置：

2、导入数据的时候要用鼠标选中所需导入的行数据。

3、在点击  Export  后，可能遇到提示错误如下：Field < Subject > requires a value from the subject tree 。或者类似提示 主题  字段 验证不同过的情况。

第一考虑是否确实字段错误或没填写

否则可参考如下方案（引用于<http://h30499.www3.hp.com/t5/Quality-Center-Support-and-News/HP-ALM-11-Excel-Export-Error/td-p/4695807#.Uz41wo1wfqg> ）：

• 1. Make sure that the project has been backed up recently
• 2. Login to Site Administration and select the affected project
• 3. Click on the + next to the project name from the Site Projects screen to see the list of tables in this projectâ s DB
• 4. Select the SYSTEM_FIELDS table
• 5. Paste the following query and click on â Execute SQLâ button. Make a note of the SF_ROOT_ID (pointer to a list maintained in the ALL_LIST table) value for this record

SELECT * FROM SYSTEM_FIELD WHERE SF_COLUMN_NAME='TS_SUBJECT'

• 6. Verify that there is no list associated with this root id:

SELECT * FROM ALL_LISTS WHERE AL_ITEM_ID = (SELECT SF_ROOT_ID FROM SYSTEM_FIELD WHERE SF_COLUMN_NAME='TS_SUBJECT')

• 7. Verify that the default list we intend to use for the â Subjectâ field still exists:

SELECT * FROM ALL_LISTS WHERE AL_ITEM_ID = 2

• 8. Update the SYSTEM_FIELD table so that the â Subjectâ field correctly points to an existing list

UPDATE SYSTEM_FIELD SET SF_ROOT_ID=2 WHERE SF_COLUMN_NAME='TS_SUBJECT'

• 9. Verify that the changes were made as expected

SELECT SF_ROOT_ID FROM SYSTEM_FIELD WHERE SF_COLUMN_NAME='TS_SUBJECT'

• 10. Update the SEQUENCES table so that QC knows that fields have been modified

UPDATE SEQUENCES SET SQ_SEQ_VALUE = SQ_SEQ_VALUE+1 WHERE SQ_SEQ_NAME IN ('FIELDS_VERSION', 'TABLES_VERSION')

• 11. Verify that the updates were made correctly

SELECT * FROM SEQUENCES WHERE SQ_SEQ_NAME IN ('FIELDS_VERSION', 'TABLES_VERSION')

• 12. Logout of Site Administration
• 13. Export Tests to QC using Excel add-in and verify that Tests are exported and no errors are noticed

希望以上内容对大家有所帮助