TP TreeAge Pro中文帮助中心

查看与编辑文档 XML

TreeAge Pro 文档以 XML 格式存储。TreeAge Pro 提供了在 XML 编辑器或文本编辑器中编辑文档 XML 的选项。

警告:除非您非常熟悉 TreeAge 模型所使用的 XML 语法,否则建议您使用树图编辑器完成模型中的所有编辑(尤其是添加/删除节点),而不要直接编辑 XML 文本文件。对文件 XML 的错误编辑很容易导致模型无法读取。

不过,在编辑 XML 之前手动创建 *.TREX 文件的副本/备份是很简单的。文件视图(Files view)还通过右键菜单支持强大的文本比较/本地历史功能。这样便可以跟踪并移除/还原对任意项目文件所做的选定编辑(无论更改是在树图编辑器中还是在文本/XML 编辑器中进行的)。最后,强大的搜索/查找/替换功能与文件视图结合使用,可以在 XML(以及任何其他基于文本的项目文档)中进行正则表达式搜索/替换。

在 XML 编辑器中打开树:

  • 在文件视图(Files View)中右键点击某个模型。

  • 选择打开方式(Open With)> XML 编辑器(XML Editor)。

警告: 以这种方式打开后,所选模型的“默认”打开方法会随之改变。这意味着下次您直接双击该文件时,将再次使用“文本编辑器(Text Editor)”打开。因此,必须右键点击并选择打开方式(Open With)> 树图编辑器(Tree Diagram Editor),才能恢复原来的默认打开方式。

树将显示在工作区内的 XML 编辑器中。您也可以在文本编辑器(Text Editor)中打开树,以纯文本格式显示 XML。

Special Features 教程中的示例树 Cost Formula.trex 在下图中以 XML 编辑器显示。

XML 由文本数据的层级结构组成。在 XML 编辑器中,结构中的每一层级都可以展开或折叠。

下面给出 TreeAge Pro 树的基本 XML 结构的一部分。

关于 XML 格式的几点说明:

  • 树文档结构中的最高层级元素是 tree 和 notation。

  • tree 元素包含模型的构建单元——变量、节点、首选项等。

  • notation 元素包含与在树图编辑器中呈现模型相关的细节。

  • 变量(Variable)元素嵌套在 tree 元素内,因为变量存在于树的层级上。

  • 定义(Definition)元素嵌套在特定的节点(Node)元素内,因为变量定义是在节点层级上定义的。

  • 有些 XML 元素未在上面列出(Markov、payoffs 等),但它们确实存在于 XML 结构中。

下表中列出了更完整(但并非详尽无遗)的 XML 元素清单。

元素(Element) 说明(Description) 父元素(Parent Element)
tree 树结构的最高层级。 <top level>
notation 控制模型在编辑器中的呈现方式。 <top level>
Variables 变量名称与属性。 tree
Sensitivity Range 变量的敏感性分析范围。 Variable
Node 节点及其属性。按其在该树中的位置嵌套。 tree 或 Node
Definition 与节点关联的变量定义。 Node
CategoriesRoot 树的变量类别。 tree
PreferenceSet 树首选项。 tree
Termination 收益值集/计算方法的终止条件 Node(类型为 Markov)
Prob 分支概率。 Node(父节点为机会节点)
MarkovData (state) 与马尔可夫状态关联的马尔可夫信息集合(状态奖励)。 Node(父节点为马尔可夫节点)
MarkovData (transition) 与马尔可夫转移关联的马尔可夫信息集合(转移奖励、跳跃状态)。 Node(位于转移子树中)
Payoff 该终端节点上特定收益值集的收益值表达式 Node(类型为 Terminal)

您可以在文档的 XML 视图中编辑模型结构或模型元素的属性*(尽管不建议这样做)*。请看下面这张图,它同时展示了树在树图编辑器和 XML 编辑器中的样子。

来看 Node Foot Saved 的 Payoff 元素中的 Value 属性。如果我们把 Value 从 4500 改为 5500,然后在 XML 编辑器中保存文件,树图编辑器将反映出同样的更改。

在打开 XML 编辑器进行更改之前,务必先在树图编辑器中保存所有更改。否则,您可能会用 XML 编辑器中刚更新的版本覆盖掉您在编辑器中所做的更改。

关于 XML 编辑的其他说明:

  • 您可以删除 XML 元素,也可以在 XML 结构内移动元素。

  • 您可以向 XML 结构添加新元素,但新条目的 xml:id 必须具有唯一值。

  • 文件搜索(Control + F)的结果以 XML 格式列出,因此了解一些 XML 格式知识会很有帮助。