PDMS-REPORT功能说明

PDMS-REPORT功能
一、report功能简介：
1、Pdms report功能可以在design、draft和paragon模块中使用，其主要完成如下的功能：
1）、生成项目数据（元件、设备等）的报表到文件或屏幕上；
2）、从“pdms”数据库库中列出任意元件；
3）、通过元件的特性排序列表；
4）、分类汇总或总汇；
5）、利用表达式创建表头；
6）、输出使用者定义的表头、表尾及汇总；
7）、输出不同格式的表格；
2、系统自带报表模板简介：
系统自带报表模板存储于目录“%PDMSUSER%/REPORTS/TEMPLATES”中，不同的模板以pdms软件的宏命令方式存放。

模板文件扩展名为“.tmp”，所生成的pdms格式的报告文件的扩展名为“.rep”。

系统自带报表模板如下：
*nozz_sched 管嘴表，列出所有管嘴的名称、P1点的直径、连接方式及方向和每个管嘴的坐标；
*line_list “branch”列表，按其拥有者“pipe”的名称排序，管线头和尾的管径及管线头和尾的连接属性；
*pipe_mto 管件描述“material”列表，按管路元件类型排序、管件描述、材质描述、管长及元件数量统计；
*tube_mto 管段列表，管段规范描述、P1点管径、管路元件描述、材质描述；
*steel_mto 钢结构元件列表；
*valve_list 阀门元件列表（选择性列表的范例）；
*center_line 管段中心线长度列表（包括元件长度）；
*tube_gradient 管段坡度列表；
*catalogue_param 管路元件“cata”元件列表；
*catalogue_ptgmref
*tube_area_vol
3、路径参数设置
使用report功能，必须设置pdms软件的软件路径变量“%PDMSREPDIR%”为report 模板所在目录。

4、使用report功能
reports>create
5、利用已有的报表模板创建报表
1）、utilities>reports>run出现“file browser”窗体，选择要运行的报表模板，apply；
2）、出现“report detail”窗体，给出生成报告的名称及元件列表层次，ok生成报表。

6、修改已建的报表模板
utilities>reports>modify…
二、创建和运行一个简单的报表
1、创建报表
1）、utilities>reports>create弹出“new report template”窗体，其包括如下的设置；
2）、destination：设置报表输出位置，包括四种：
*screen 输出到计算机屏幕；
*overwrite 输出]到文件，覆盖已建的报表；
*new 输出到新文件
*append 添加报表到已建文件的尾部。

3）、selection：定义报表输出的元件的类型和限制
*type 定义元件的类型；（例“type”）
*with 定义限制条件；
*hierarchy 定义空间限制。

（例“/e1301”）
4）、columns：定义元件列表的形式，即报表中出现的元件属性；
*new…：弹出“creating column”窗体
*expression 定义元件列表中列的内容，可以使用pdms属性或包括元件属性的表达式；
*sorting 设置元件在本类中的排列顺序；
*precedence 如果当前列设置了排序顺序，在此设置其在所有列中的排列顺序的编号；
*units 设置本列的单位制；
*column layout 设置列的格式，单击后，弹出“layout for column”窗体：*layout—spaces before column 设置和前一列的间距；
—column width 设置列的宽度；
—justify 设置对齐方式。

*numeric display 设置数字的显示形式：
—remainder 设置显示形式为小数(decimal)，及小数点后的保留位数(decimal places)；
设置显示形式为分数(fraction)，及分母的最小值(denominator)；
*style 设置英制单位的显示格式；
*text display 表头文字的设置；
*values,subtotals,total 排序的设置，后面详细说明。

*modify…修改已建的列
*move…移动已建列的排列顺序；
*delete 删除已建列。

5）、option>runtime prompts：定义报表运行时，交互输入的数据类型，包括如下几种：*file name 报表文件的名称；
*types 元件的类型
*with 限制条件
*hierarchy 元件的层次
*from
*对于输出到屏幕上的报表，runtime prompts设置应为空；
2、存储和删除报表模板
1）、file>save&save as 存储建立的模板；
2）、reports>delete 删除建立的模板。

3、输出数据库中不同部分的报表
*数据库中不同部分的报表的输出，利用软件提供的“hierarchy”功能。

*如果选择“drawlist”或“obstruction”，则“hierarchy”中应为空。

三、报表中的排序和统计
缺省时，元件在报表中的排列顺序与其在数据库中的存储顺序相同，用户可以通过元件的属性进行排序，多个属性排序时，可以安排排序的先后顺序。

1、常用的可排序pdms和元件属性：
*TYPE 元件的类型，可以按照元件类型的字母顺序排序
*P1 BORE&P2 BORE 元件的管径
*ITLE 管段的长度
*HBORE 管线头的管径
*TBORE 管线尾的管径
*CLLE 管线的中心线（包括元件）长度
*QUANTITY 元件的数量
2、改变排序顺序
1）、改变单个属性的排列顺序，修改column菜单中的sorting选项；
2）、按照元件多个属性排列顺序：当选择多个属性可排序时，用column菜单中的sorting 后面的precedence定义元件排序时的第一执行、第二执行……。

3、统计列表
控制报表中统计在column layout菜单中设置，其的选项如下：
*total 不分元件种类的全部统计数值；
*subtotals 按排序中相同类型元件统计，可选择按哪一个排序属性统计数值；
*values 设置为1st，则只在该排序属性的首项显示排序属性的说明；设置为sub及相应的设置subtatals选项，则在相同元件属性（排序属性）的末尾显示其相应的属性描述；
四、报表中限制条件的应用
在报表模板中使用限制性条件，可以产生用户需要的特定筛选条件的报表。

1、with的操作
with中可以使用表达式和函数及逻辑运算符。

1）、基本逻辑运算符
*EQ 等于
*NE 不等于
*GT 大于
*GE 大于等于
*LE 小于等于
*LT 小于
2）、运算连接符：AND OR NOT
3）、表达式格式遵循如下规定：
*文字字符需用单引号表示；
*运算符或连接符和被操作元素间必须加空格；
*函数必须使用圆括号；
*元件名称的前或厚必须加空格；
3）、操作符的优先权：
a、括号；
b、函数；
c、乘、除；
d、加、减；
e、逻辑运算符；
f、连接运算符。

4）、在表达式中使用坐标：
*“position”属性加“WRT”（坐标系），表示按照某一坐标系取坐标，例：POS OF /VESS1 WRT /*
*直接使用笛卡尔坐标，例：N45 W2000 U1000
*“WRT”（坐标系）的使用
*“FROM”的使用
5）、在表达式中使用元件定义号；
6）、在表达式中使用方向，例：N 45 W、HDIR OF /PIPE1 WRT /*、U WRT CE；
7）、使用复合表达式，例：POS GT U0；
五、报表文件格式定义
主要定义报表文件的如下几个方面：
1、设置文件的表头；
2、设置文件的表尾；
3、在报表中加入介绍；
4、加入摘要；
设置页面纸的长度。