查看完整版本: Soda 使用说明

Soda 使用说明

Rational SoDA for Word 使用说明                                       




SoDA使用说明

原创文章，作者syslnk，引用请注明出处：[url]www.syslnk.com[/url]，内容讨论请致信[email]syslnk@21cn.com[/email]，谢谢！


1SoDA简介

1.1What’s SoDA

SoDA是一种强有力的软件文档自动生成器。它使软件文档的生成实现了自动化，减化了软件开发中文档的生成过程。


SoDA 可定制支持任何文档标准，能够从整个项目文档中，包括需求、设计、编码、测试等文档中全面收集软件开发周期中各阶段信息并以之为基础制作文档。极大提高了文档的可用性、易用性和连贯性，使文档更加有效。


1.2SoDA的特点

SoDA有许多鲜明实用的特点，在实际使用过程中，我觉得最重要的有下面四点特性：

1.2.1可以根据需要定制模板，而且SoDA提供了一个非常方便的文档定义工具，使得用户可以直观的图形化的方式定义模板。这样，我们在一个项目中积累下来的文档模板可以方便的在另一个项目引用。

1.2.2可以方便的从其他项目文档中读取信息，可以使用多信息源生成一个单一的文档，例如，我们可以自动地把从分析、设计工具以及编程环境或是用户的测试方案和故障跟踪工具中得到的信息生成文档。

1.2.3能够生成可不断更新文档的文档。SoDA在生成文档后，还可以比较当前文档和项目数据源之间的对应关系，可以根据数据源中的更新信息自动修改你的文档。并且可以生成更新的报告，还可以列出哪些部分发生变更，变更前后的信息等。

1.2.4生成的文档可以直接添加其他补充信息。SoDA和Word等文本编辑工具紧密结合，在生成文档时，可利用文字处理软件强大的功能创建、编辑文档，还可以嵌入图形，使文档更加精致完美。更重要的是，添加这些补充信息，不会影像文档的自动更新，而且更新的时候不会覆盖这些补充信息。

2利用预置模板生成文档

       看了上述优点，你是否已经被SoDA“深深打动”了？接下来，我们用SoDA的缺省模板生成自己的文档。

       使用“开始->程序－Rational Software－Rational SoDA for Word－Getting Started”启动Getting Started。Getting Started是SoAD提供的一个向导工具，用他能从预置模板中方便的生成你想要的文档。

2.1Step1 Introduction

       介绍信息，大概意思向导将用模板生成报表，如果你已经有自己的模板退出向导在菜单中使用“generate the documents”之类的。



2.2Step2 Select Template

       从SoDA模板列表中读取一个模板。SoDA的模板存放在SoDAWord\template下，你也可以把自己编辑好的模板放在这个路径下。SoDA的模板如何创建将在下文说明。



2.3Step3 Save Template

       SoDA要求把模板文档保存在一个临时目录，这个无所谓，一般你不会对这个保存的模板进行操作，所以存在缺省配置的临时目录就可以了。



2.4Step4 Generate Report

       当你点击“Gentrate”按钮后，SoDA就开始生成文档了，根据不同的模板，通常在生成文档之前，还需要你选择连接的信息源。上述条件都满足后，SoDA就出来一个进度条，开始生成报告文档了。

不错

尝试着用了一下，不错
不过 还不知如何定制自己的模版？

昨天用了SoDA简单的制作了一个模版 觉得用着不错
定制自己想要的信息 但是要达到目前项目模版的规范还得再研究研究

呵呵，不错么！::em61::

接触下来，感觉SoDA是一个非常棒的产品。
但问题也非常多，主要是稳定性方面的需要加强，太容易崩溃了。
计划近期在项目中深入使用一下。