很多人用Enterprise Architect出文档时，前面模型整理得很认真，到了导出这一步却总觉得不顺。常见情况是文档能导出来，但内容范围不对，模板没套上，封面和目录层级也跟着乱。Sparx官方其实把这套流程拆得很清楚，文档生成走【Publish】【Model Reports】【Report Builder】【Generate Documentation】，模板编辑走【Publish】【Model Reports】【Template Editor】；真正影响结果的，不只是最后点不点【Generate】，而是当前选中的根包、模板、封面、目录和文档选项有没有先配好。

　　一、Enterprise Architect文档怎么导出

　　文档导出这一步，最好先把“导什么”和“用什么导”分开想。Enterprise Architect的官方说明里明确写到，生成文档时要先选定Package或元素，再在【Generate Documentation】窗口里设置输出文件、模板和其他选项，所以不要一上来就先填文件名，先把根对象选准更重要。

　　1、先在浏览器里选中要导出的包或元素

　　官方说明里把这个动作放在最前面，因为【Generate Documentation】窗口会直接读取你当前选中的Root Package或Root Element。若这里选错，后面模板再精细，导出的范围也还是不对。

　　2、打开【Generate Documentation】窗口

　　具体入口是【Publish】【Model Reports】【Report Builder】【Generate Documentation】【Generate】，快捷键也可以直接按【F8】。这一步进去以后，先停在【Generate】页，不要急着马上导出，因为输出路径、模板、封面和目录都还要在这里确认。

　　3、在【Output to File】里先定文件格式

　　官方说明里写得很明确，输出文件支持PDF、RTF和DOCX，所以你在文件名后缀里填什么，最后导出的就是哪一类文档。实务里如果后面还要继续微调排版，通常先出DOCX更稳；若主要是交付阅读版，直接出PDF会更省事。

　　4、在【Template】里选模板，再补【Cover Page】和【Table of Contents】

　　Sparx官方说明，模板下拉列表会同时显示Custom Templates、System Templates和技术扩展里的模板，同一个窗口里还能继续选封面页和目录模板。也就是说，正式导出前至少要把这三项看一遍，不然很容易出现正文模板换了，封面和目录却还停在旧样式上的情况。

　　二、Enterprise Architect文档模板怎么修改

　　模板修改这一步，不建议直接拿系统模板硬用到底。官方说明里写得很清楚，文档模板可以从零创建，也可以复制系统模板后再改，而且模板本身不只是排版样式，还包括要报告哪些模型内容、提取哪些字段、用什么版式去排这些内容。

　　1、从【Template Editor】进入模板设计器

　　标准入口是【Publish】【Model Reports】【Template Editor】。打开以后会自动进入Document Template Designer，同时拉起【Document-Edit】功能区。这个入口比在生成文档窗口里临时改模板更稳，因为你能完整看到Sections、Content和工具栏。

　　2、优先复制系统模板再修改

　　官方说明里明确提到，你可以通过【Resources】里的【Report Templates】【System Templates】右击系统模板后选择【Copy】，再到自定义模板里继续编辑。这样做的好处是，系统模板原样保留，你改的是自己的副本，后面想回退也更容易。

　　3、先改Sections，再改Content

　　Sparx官方对模板结构的定义很直接，模板由Sections、字段、样式和模板片段组成。实际修改时，先在【Sections】里决定报告哪些模型内容，再到【Content】区改字段和版式，会比一开始就在编辑区里硬改文字顺序更稳。

　　4、需要统一企业格式时，连样式表、封面和目录一起改

　　官方说明，除了完整文档模板，还可以单独创建Stylesheets、Cover Pages和Tables of Contents，而且这些都可以作为独立模板参与文档生成。也就是说，若你想统一公司文档风格，不要只改正文模板，封面、目录和样式表最好成套处理。

　　三、Enterprise Architect导出为什么总会反复返工

　　很多返工并不是模板不会改，而是导出前几个关键选项没有统一。Sparx官方在文档选项里给了不少容易被忽略的控制项，例如【Adjust Heading Levels】、【Indent Linked Document Headings】、【Skip root package】和图像格式选择，这些看着像细枝末节，实际非常影响最终文档层级和阅读感受。

　　1、目录层级先看【Adjust Heading Levels】

　　官方说明，这个选项用来控制嵌套子包在文档中最低能展开到哪一级标题，默认是Heading 9。若你觉得导出的目录层级太深或太浅，先调这里，通常比导出后在Word里一层层手改更有效。

　　2、带Linked Document时看【Indent Linked Document Headings】

　　如果报告里含有Linked Document，官方说明这个选项会把链接文档里的标题级别按当前报告层级做缩进匹配。这个选项没看好时，最容易出现正文层级正常，但插入的链接文档标题突然跳级的情况。

　　3、正式定稿前把模板方案固定下来

　　官方说明，自定义模板可以保存、新建副本、导出参考数据，也可以导入到别的模型里复用。实际使用时，等模板、封面、目录和标题层级都确认后，最好就固定成一套正式模板，不要每次导出都临时改一轮，这样后面团队协作时才不会一人一个版本。

　　总结

　　Enterprise Architect文档怎么导出，Enterprise Architect文档模板怎么修改，真正要抓住的是两条线。第一条线是导出线，也就是先选对根包，再通过【Generate Documentation】把输出格式、模板、封面和目录配齐。第二条线是模板线，也就是通过【Template Editor】先复制系统模板，再按Sections、Content、样式表、封面和目录逐步改。只要这两条线分开处理，再把【Adjust Heading Levels】这类关键选项提前定住，后面的文档输出通常会顺很多，也不容易反复返工。