Polarion的LiveDoc把普通文档编辑和Work Item管理放在同一个页面里，可以直接维护需求、测试用例、缺陷以及它们之间的关联。创建文档后，Work Item显示多少内容并不是固定的，文档自己的展示配置、当前过滤条件、用户权限和Work Item状态都会影响页面结果。遇到标题能看到但字段缺失，或者某些Work Item整条不见时，要先分清是展示配置问题，还是对象已经被过滤、移除或权限限制。

　　一、Polarion怎么创建LiveDoc文档

　　创建LiveDoc时，先确定文档所在项目和文档类型，再配置允许出现的Work Item类型。文档建好后再调整展示字段，比先塞入大量需求再修改结构更容易检查。

　　1、创建新的LiveDoc

　　①进入目标Polarion项目。

　　②点击页面中的【Create】。

　　③在创建对象列表里选择【Document】。

　　④选择准备存放文档的【Space】。

　　⑤填写文档名称。

　　⑥选择项目已经配置好的【Document Type】。

　　⑦项目提供需求规格、测试规格等模板时，选择与当前用途对应的【Template】。

　　⑧确认后创建文档并进入Document Editor。

　　⑨检查文档标题、Outline和基本属性是否符合当前项目设置。

　　如果项目里已经准备了固定模板，优先从现有Document模板创建，这样Work Item类型、文档字段和编号方式更容易保持一致。

　　2、配置文档允许使用的Work Item类型

　　①打开刚建立的LiveDoc。

　　②在Document Editor工具栏中点击【Configure】。

　　③进入【Configure Work Item Presentation】。

　　④查看当前文档允许显示的Work Item类型。

　　⑤需求文档可以加入【Requirement】。

　　⑥测试规格文档可以加入【Test Case】。

　　⑦项目还有自定义Work Item类型时，把需要在当前文档使用的类型一并加入。

　　⑧保存配置并返回Document Editor。

　　这里控制的是文档中哪些Work Item类型可以使用，不要把所有项目类型都放进同一份文档。需求、任务、缺陷混在一起后，后面的字段展示和文档结构会变得很乱。

　　3、在LiveDoc中创建和插入Work Item

　　①把光标放到准备插入需求的位置。

　　②使用文档工具栏中的【Work Item】创建入口。

　　③选择对应的【Work Item Type】。

　　④填写【Title】。

　　⑤在正文区域填写需求或测试内容。

　　⑥打开右侧【Work Item Properties】。

　　⑦补充【Status】【Priority】【Assignee】以及当前项目要求的自定义字段。

　　⑧保存文档。

　　已有Work Item也可以通过引用或插入方式放进LiveDoc。插入后要留意它是当前文档包含的对象，还是来自其他文档的Referenced Work Item，两种情况后续移动和维护方式并不完全一样。

　　二、LiveDoc中的Work Item显示不完整如何处理

　　Work Item还在系统里，但LiveDoc页面只显示标题、缺少状态和自定义字段时，先查Presentation。整条Work Item都不出现，再去看Document Filter和文档对象状态。

　　1、检查Work Item Presentation配置

　　①打开出现问题的LiveDoc。

　　②点击【Configure】。

　　③进入【Configure Work Item Presentation】。

　　④选择当前异常的【Work Item Type】。

　　⑤检查当前Presentation是否只显示【Title】。

　　⑥需要显示正文时，把【Description】加入展示内容。

　　⑦还要查看状态、负责人等信息时，增加【Status】【Assignee】等字段。

　　⑧项目配置了自定义字段时，把对应字段加入Presentation。

　　⑨保存后刷新文档。

　　Polarion允许不同文档配置不同的Work Item展示内容，部分版本还支持用户自己的字段显示方式。别人能看到某个字段，自己的页面看不到时，也要检查当前用户的Presentation设置。

　　2、检查Document Filter有没有把Work Item隐藏

　　①查看LiveDoc工具栏当前是否启用了【Document Filter】。

　　②打开当前过滤条件。

　　③检查【Type】【Status】【Assignee】或其他筛选项。

　　④确认缺失的Work Item是否满足当前条件。

　　⑤暂时切换到完整编辑视图或取消过滤。

　　⑥重新查找原来的Work Item。

　　⑦确认对象出现后，再按实际需求修改过滤条件。

　　⑧保存新的过滤设置。

　　处于过滤视图时，页面展示的是满足查询条件的Work Item，并不代表其他对象已经从项目里删除。排查前先关闭过滤，能避免把筛选结果误当成数据丢失。

　　3、检查是不是使用了Title only展示

　　①打开Document Editor。

　　②进入【Configure Work Item Presentation】。

　　③查看当前布局是否使用【Title only】。

　　④如果只显示标题，把布局改成包含正文或字段的Presentation。

　　⑤保存设置。

　　⑥重新打开文档检查。

　　【Title only】适合条目很多的LiveDoc，用来压缩页面内容；如果用户原本希望看到Description和其他字段，这种布局就会表现成“Work Item显示不完整”。

　　三、配置正常但Work Item仍然缺失怎么检查

　　展示方式和过滤条件都没有问题时，可以继续检查用户权限、Recycle Bin以及按需加载。这里更适合先拿Work Item ID搜索，确认对象到底还在不在当前文档。

　　1、检查Work Item是否被移到Recycle Bin

　　①记录缺失Work Item的ID。

　　②先在项目搜索中查询这个【Work Item ID】。

　　③对象仍然存在时，重新打开原LiveDoc。

　　④打开文档右侧Sidebar。

　　⑤进入【Recycle Bin】。

　　⑥查看目标Work Item是否出现在回收区域。

　　⑦确认只是误移除后，执行恢复操作，把它重新插入文档。

　　⑧返回正文检查位置和层级。

　　LiveDoc里把某个Work Item从正文移走后，对象可能仍保留在系统中，关联关系也没有立即消失。此时直接重新创建一条同名需求，反而容易产生重复数据。

　　2、检查字段权限和Work Item权限

　　①使用出现问题的用户账号打开LiveDoc。

　　②选中目标Work Item。

　　③打开右侧【Work Item Properties】。

　　④检查缺失字段是否在Properties中可见。

　　⑤切换到具备更高权限的测试账号查看同一条Work Item。

　　⑥两个账号显示内容不一致时，进入【Administration】→【User Management】→【Permissions Management】。

　　⑦检查当前角色对Work Item及相关字段的【READ】权限。

　　⑧项目使用字段级权限时，再核对对应自定义字段是否被隐藏。

　　字段没有读取权限时，修改Presentation也不会把内容显示出来。此时应处理权限配置，不要反复改LiveDoc布局。

　　3、文档条目很多时检查按需加载

　　①打开Work Item数量较多的LiveDoc。

　　②等待文档完成当前区域加载。

　　③使用文档内的查找功能搜索目标【Work Item ID】或标题。

　　④不要只依赖浏览器当前已经渲染出来的页面区域判断对象是否存在。

　　⑤切换Document Filter后，再检查目标Work Item有没有被过滤。

　　⑥刷新文档并重新打开对应章节。

　　较大的LiveDoc会使用按需加载机制，一部分Work Item不会在打开页面时立即渲染出来。搜索能够找到、滚动到对应区域后才加载的情况，属于页面加载方式，不是Work Item缺失。

　　总结

　　Polarion LiveDoc里的Work Item显示异常，要把文档展示、过滤条件、对象状态和用户权限分开检查。字段少了更偏向Presentation或权限配置，整条对象不见则要继续查过滤、回收区域和文档加载状态。创建LiveDoc时把文档类型和Work Item展示方式先整理好，也能减少后面不同用户看到的内容不一致。如需进一步了解Polarion LiveDoc创建、Work Item展示配置与文档显示异常排查方法，欢迎联系咨询。