Jama Connect可以把项目中的需求导出为Word、Excel或PDF，也可以通过Office Template整理成固定格式的需求报告。导出后发现Description、自定义字段、负责人或关系信息没有出现时，先要区分使用的是普通导出、Office Template还是Velocity报告，因为这几种方式对字段的读取和模板控制不同。把导出范围、当前视图字段和模板字段逐项核对，通常就能找到缺失位置。

　　一、Jama Connect怎么导出需求报告

　　普通需求报告可以直接从Explorer Tree或筛选结果中导出。需要固定封面、字段顺序或公司报告格式时，再使用Office Template。

　　1、直接导出当前需求数据

　　①进入目标项目，在Explorer Tree中选择需求所在的【Component】【Set】或【Folder】。

　　②切换到【List View】或【Document View】。

　　③如果只需要部分需求，先使用【Filter】筛选目标Item。

　　④点击工具栏中的字段设置按钮，也就是【Show/Hide Fields】。

　　⑤勾选报告需要的【ID】【Name】【Description】【Status】【Priority】【Assigned To】等字段。

　　⑥项目存在需求自定义字段时，把对应字段一并选中。

　　⑦关闭字段设置窗口，确认页面已经显示准备导出的字段。

　　⑧点击【Export】。

　　⑨根据交付格式选择【Export to Word】【Export to Excel】或【Export to PDF】。

　　⑩等待报告生成后打开文件，对照当前页面抽查字段。

　　普通Excel导出中的【Export to Excel Default】会按照当前List View里显示的字段生成列，所以导出前的Show/Hide Fields配置直接影响报告内容。

　　2、使用Office Template导出固定格式报告

　　①在需求列表或Single Item View中点击【Export】。

　　②选择【View all export options】。

　　③在【Office Templates】中选择现有报告模板。

　　④确认当前模板适用于Word还是Excel。

　　⑤选择需要的输出格式。

　　⑥填写该模板要求的报告参数。

　　⑦点击【Run】生成报告。

　　⑧如果现有模板字段不足，选择对应模板并执行【Download Template】。

　　⑨在Word或Excel中修改模板后返回【View all export options】。

　　⑩点击【Upload a Template】上传调整后的模板。

　　Office Template中的正文数据由模板内的字段标签决定。页面能看到某个需求字段，并不代表自定义模板一定已经引用了这个字段。

　　3、需要完整需求明细时选择对应报告

　　①先在Explorer Tree或高级筛选中圈定需求范围。

　　②进入【Export】→【View all export options】。

　　③查看当前系统提供的报告。

　　④需要输出较完整Item信息时，可以检查【All Item Details】。

　　⑤打开报告参数。

　　⑥按需要配置【Include relationships】等项目。

　　⑦选择支持的输出格式。

　　⑧点击【Run】。

　　⑨下载报告并检查需求字段与关系内容。

　　【All Item Details】属于Velocity报告，不能像普通Word Office Template那样直接下载模板后修改。如果字段布局需要重新开发，应改用适合的Office Template或调整Velocity报告。

　　二、Jama Connect导出报告时字段缺失如何调整

　　字段少了以后，不要先改需求本身。可以先确认字段在项目里有没有值，再看当前导出方式到底从视图、模板还是报告脚本读取数据。

　　1、普通Word或Excel导出缺少字段

　　①回到原需求列表。

　　②点击【Show/Hide Fields】。

　　③检查缺失字段当前是否被勾选。

　　④没有勾选时，把它加入当前视图。

　　⑤关闭设置并确认列表里已经显示该字段。

　　⑥再次执行【Export to Excel】或【Export to Word】。

　　⑦重新打开导出文件检查。

　　⑧如果换一个用户导出结果不同，再使用同一View配置做一次对照。

　　Excel默认导出和当前List View字段关系较直接。页面里本身没有显示的字段，使用这类导出时就容易一起缺失。

　　2、Office Template里缺少自定义字段

　　项目调整过Item Type或新增Custom Field以后，旧模板不一定包含新字段标签，可以重新生成当前项目对应的字段参考。

　　①进入【Export】→【View all export options】。

　　②点击【Upload a Template】。

　　③选择【Generate Word Template Reference Guide】。

　　④点击【Run】生成当前项目的字段参考文件。

　　⑤打开Reference Guide。

　　⑥找到缺失的Custom Field。

　　⑦复制该字段对应的Field Tag。

　　⑧下载当前使用的Office Template。

　　⑨把Field Tag放到需求Item和Fields对应区域。

　　⑩保存模板并重新上传。

　　⑪再次运行报告检查字段值。

　　Word Template Reference Guide会按照当前项目生成可用Field Tag。项目后来修改了字段时，可以重新生成一份，不要继续照搬以前保存的标签。

　　3、模板里有字段标签但导出仍为空

　　①先打开一条被导出的需求。

　　②确认目标字段本身已经填写数据。

　　③检查这条Item的【Item Type】。

　　④确认模板使用的Field Tag属于当前项目和对应类型。

　　⑤重新生成【Word Template Reference Guide】核对标签。

　　⑥检查当前报告选择的需求范围里是否包含这条Item。

　　⑦如果使用筛选器导出，检查Filter是否排除了部分需求类型。

　　⑧换一条明确有字段值的需求单独执行报告。

　　⑨单条仍为空时，再修改模板字段标签。

　　同一个项目里不同Item Type可以使用不同Custom Field。某字段只配置给系统需求，却拿另一种需求类型测试时，模板里即使有标签也可能拿不到对应内容。

　　三、字段调整后怎么检查报告是否恢复

　　修改导出字段或报告模板后，可以先用一小组需求验证。把普通导出和模板导出做一次对照，也能判断问题落在数据源还是报告模板。

　　1、用固定测试需求核对字段

　　①准备几条已知字段内容的需求。

　　②让其中一条填写常规字段。

　　③另一条填写项目Custom Field。

　　④再准备一条带Description和Relationship的数据。

　　⑤把这几条需求放入同一个筛选结果。

　　⑥确认【Show/Hide Fields】中已经显示目标字段。

　　⑦先执行普通Excel导出。

　　⑧记录Excel中能够正常输出的字段。

　　⑨再运行Office Template报告做对照。

　　如果普通Excel有值，而Office Template缺失，排查重点可以直接放到模板Field Tag和模板结构，不需要继续修改需求数据。

　　2、报告由管理员维护时检查模板版本

　　①进入【Export】→【View all export options】。

　　②确认当前选中的报告模板名称。

　　③检查是否存在多个相似模板。

　　④下载当前实际使用的模板。

　　⑤确认缺失字段已经加入这一版本。

　　⑥修改后使用新的名称上传，避免和旧模板混淆。

　　⑦在【Share with】中确认选择【Project】还是【Organization】。

　　⑧重新进入导出窗口选择新模板运行。

　　项目范围模板只提供给当前项目，Organization范围模板可以在多个项目中出现。不同项目的Custom Field并不一定一致，因此组织级模板出现某些字段空白时，还要核对当前项目有没有对应Field Tag。

　　总结

　　Jama Connect需求报告字段缺失，通常可以从当前视图字段、Office Template字段标签、需求Item Type和报告数据范围几处检查。普通Excel导出优先核对Show/Hide Fields，自定义Word或Excel报告则更适合重新生成当前项目的Template Reference Guide，再修正模板中的字段标签。先用少量已知数据做对照，也能减少直接修改正式报告模板带来的反复测试。如需进一步了解Jama Connect需求报告导出、Office Template配置与报告字段异常排查方法，欢迎联系咨询。