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

部门组织结构文件格式说明1、 概览1.1、部门组织结构的存储文件是DepartDB.xml文件，存放于路径Agent安装目录中TOPSECTopDesk2.0Agent目录。注意，此文件的名称与路径都不可以修改。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.71.3、部门的组织结构，下面是一个整体结构的概览（我去掉了所有的注释）注意：划有红线的行的内容是不能够被修改，如果修改将出错。2、 格式说明通过上面的例子，你可能以经看出它实际上是一个XML文件，所以它符合XML文件 的使用格式，但是我们对它的格式在XML的格式之上做了更进一步的约束，为了使它的使用能更简单，结构也更清晰，下面我们来一起看看它的具体格式。2.1、它出现在文件的第一行，不用多说了解XML文件格式的朋友都知道它的做用，它主要用以说明此XML文件的版本以及它所使用的字符集，此例中版本为1.0，使用字符集为gb2312也就是中文，一般如果没有特殊的要求，是不需要修改的。2.2、从它的名称你也许已经猜出了它的作用，对！被它所包含的元素就是整个部门的组织结构信息，在整个文件中它只能出现一次，不能出现多次。2.3、它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以资产所属的行政部门为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在块中。2.4、它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以资产所在的物理位置为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在块中。2.5、它被包含在2.2中介绍的元素块中，它本身也是一个元素块，包含信息是以用户所属的行政部门为视图来建立的组织结构，它也是在文件中只能出现一次，且必须出现在块中。2.6、 这是个元素块，此元素块的内容在界面中会以树型的形式显示，这个元素中name的值一般能修改为其它内容。2.7、这是最后一个要讲的元素，也是在实际使用中一定会被修改，我们可以看到它的定义之中有方括号，在方括号中的内容是可选的，并且可选的两项内容只能选一其，不能同时选，由此我们不难看出它实际上就有两种形式： （注意最后的那个斜杠）这种形式是一个元素，不是一个元素块，它不能再包含元素块，在界面中显示它的属性值将是树的叶子节点。这种形式是一个元素块，它可以继续包含其它的元素块或元素，例如：此例就是一个元素块包含了两个元素，在界面的树中“值1”将是“值2”与“值3”的父节点。3、 例子：看完了上面的介绍，你可能还是有点不太明白，不要紧，我们来看几个小的例子：3.1、区域：注意：在上图中第一个划红线的行是一个元素，它不能包含子项，所以是最后是有一个斜杠的，而第二个划红线的行是一个元素块它可以包含元素或者元素块，所以它没有斜杠。3.2、资产3.3、客户4、 附加4.1、现在你已经了解了部门组织结构文件的基本格式了，你可以自己动手来编写一个文件试试看，我在这里提供一个简单的小框架，去掉了变化的部分，保留了基本不变的内容，你可以在每次写一个新的部门组织结构文件时使用它。 添加你的内容添加你的内容 添加你的内容4.2、如果你编写的内容很多而且出错，那么在AgentInfo.exe中你将看不到内容，你可以使用IE来打开这个文件，IE会分析这个文件，并给出简单的提示，告诉我们错在那里（有时可能不准），下面给出一个有错