部门组织结构文件(DepartDB.xml)格式说明.docVIP

部门组织结构文件格式说明 概览 1.1、部门组织结构的存储文件是DepartDB.xml文件，存放于路径Agent安装目录中 TOPSEC\TopDesk2.0\Agent目录。 注意，此文件的名称与路径都不可以修改。 1.2、部门组织结构文件的作用就像它的名字一样，是存储某部门的各个部门名称， 及其各个部门之间的下上级关系的，这些信息主要在Agent安装时，对Agent 进行注册使用。 图1.2.1（注册程序主界面） 在图1.2.1中点击三个红框框出的按钮（从上到下）会显示三个不同的界面， 以树的形式来显示。对应下图中的1.2.2，1.2.4，1.2.6 图1.2.2（区域信息树） 图1.2.2显示的是对应文件中区域的信息，区域信息如图1.2.3所示。 图1.2.3 图1.2.4（资产信息树） 图1.2.4显示的是对应文件中资产的信息，资产信息如图1.2.5 图1.2.5 图1.2.6（用户信息树） 图1.2.6显示的是对应文件中资产的信息，用户信息如图1.2.7 图1.2.7 1.3、部门的组织结构， 下面是一个整体结构的概览（我去掉了所有的注释） 注意：划有红线的行的内容是不能够被修改，如果修改将出错。 格式说明 通过上面的例子，你可能以经看出它实际上是一个XML文件，所以它符合XML文件 的使用格式，但是我们对它的格式在XML的格式之上做了更进一步的约束，为了使它 的使用能更简单，结构也更清晰，下面我们来一起看看它的具体格式。 2.1、?xml version=1.0 encoding=gb2312? 它出现在文件的第一行，不用多说了解XML文件格式的朋友都知道它的做用，它主要用以说明此XML文件的版本以及它所使用的字符集，此例中版本为1.0，使用字符集为gb2312也就是中文，一般如果没有特殊的要求，是不需要修改的。 2.2、AgentInfoDB/AgentInfoDB 从它的名称你也许已经猜出了它的作用，对！被它所包含的元素就是整个部门的组织 结构信息，在整个文件中它只能出现一次，不能出现多次。 2.3、AssetDepart/AssetDepart 它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以资产所属的 行政部门为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在 AgentInfoDB/AgentInfoDB块中。 2.4、AssetAddress/AssetAddress 它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以资产所在的 物理位置为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在 AgentInfoDB/AgentInfoDB块中。 2.5、UserDepart/UserDepart 它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以用户所属的 行政部门为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在 AgentInfoDB/AgentInfoDB块中。 2.6、root name=信息/root 这是个元素块，此元素块的内容在界面中会以树型的形式显示，这个元素中name 的值一般能修改为其它内容。 2.7、node name=值[/][/node] 这是最后一个要讲的元素，也是在实际使用中一定会被修改，我们可以看到它的定义 之中有方括号，在方括号中的内容是可选的，并且可选的两项内容只能选一其，不能 同时选，由此我们不难看出它实际上就有两种形式： node name=值/ （注意最后的那个斜杠） 这种形式是一个元素，不是一个元素块，它不能再包含元素块，在界面中显示它的 属性值将是树的叶子节点。 node name=值/node 这种形式是一个元素块，它可以继续包含其它的元素块或元素，例如： node name=值1 node name=值2/ node name=值3/ /node 此例就是一个元素块包含了两个元素，在界面的树中“值1”将是“值2”与 “值3”的父节点。 例子： 看完了上面的介绍，你可能还是有点不太明白，不要紧，我们来看几个小的例子： 3.1、区域： 注意：在上图中第一个划红线的行是一个元素，它不能包含子项，所以是最后是 有一个斜杠的，而第二个划红线的行是一个元素块它可以包含元素或者元素块， 所以它没有斜杠。 3.2、资产 3.3、客户 附加 4.1、现在你已经了解了部门组织结构文件的基本格式了，你可以自己动手来编写一个文件 试试看，我在这里提供一个简单的小框架，去掉了变化的部分，保留了基本不变的内容，你可以在每次写