实时历史数据库增值软件包 V1.0
用户手册
- 1. 功能简介
实时历史数据库增值软件包是由sui（杭州）公司开发，面向实时历史数据库，增加数据库的功能，提高系统的部署实施速度。
- 2. 适用环境
本软件包经过测试，适用于PI 系统 Processbook 2.31 以上版本。
适用于ActiveView 2.35以上版本。
- 3. 安装注册
本软件为绿色软件，免安装删除。
拷贝在任意目录之后，使用regsvr32 pitool.dll 注册即可。
反注册为regsvr32 pitool.dll -u。
- 4. 主界面
双击打开的PDI图，则PItool软件包主界面跳出在屏幕右上角。
显示如下：
PItool主界面包含4个小图标，把鼠标放在上面，分别显示其名称，分别是：
A 趋势图时间设置
B 开始结束时间
C 趋势图播放
D 趋势图格式设置
单击小图标，则跳出相应的功能页面。同时图标呈现点击激活状态。当功能页面被关闭，小图标回复原样。
主页面为独占模式，触发之后，该对话框为该时刻惟一激活的窗体，用户不能对PDI页面做任何操作。要编辑PDI页面，请关闭PItool主页面。
- 5. 时间范围选择
单击第一个钟表图标，则显示"时间范围选择"功能页面，显示如下：
默认的时间范围为1天。
其他可选的时间范围有1小时，8小说，12小时，7天，30天，90天和365天。
用户选择任何一个时间选项，PDI显示页上的时间范围将变换，方便用户查看不同时间段数据。
还有一个手动选择项，点击手动选择项，出现隐藏的时间输入框等。显示如下：
点击任何时间选项，手动选项将回复隐藏状态。
手动选项默认为2天，鼠标放在时间输入框上会提示用户输入0<X<=3650的数字。
用户可以输入带小数点的数据，比如2.5。
之后，按"变换"按键，PDI显示页上的时间范围将变换
如果客户输入的是汉字，英文字母等非数字类型，系统将报警：
并把非法输入清空。
对于时间微调键，对于合法输入，将加减1天，之后按"变换"，改变PDI图时间范围。非法输入，系统同样报错，并清空输入。
- 6. 开始结束时间设置
点击PItool主页面第二个日历按钮，显示开始结束时间设置页面，如图：
本页面初始默认的结束时间为当前时间，默认开始时间为当前时间的前8个小时，字体颜色为蓝色。时间范围可以在2个时间框看见。
时间框前面是日历。点击日历图标，显示日历对话框，如图：
日历最初显示的是当前时间。
用户可以单击选择时间，时间会变红显示在时间框。
如果用户是双击日历，那么时间变红显示在时间框之后，日历会自动隐藏。
时间框的时间可以微调。每次变化为1个小时。
结束时间框类似。
要注意的是，开始时间要小于结束时间。
当时间选定之后，用户点击"确定"按键就可以改变PDI图的时间范围。
相比前个时间范围选择功能，时间范围更加精确。
用户点击"默认"按键，时间范围将回到初始的8小时时间差，并且刷新PDI图时间范围。
- 7. 趋势图回放
单击PItool第三个图标，显示"趋势图播放"功能页面，如下：
趋势图回放功能可以实现对某一天趋势生长状态的回放，便于用户动态考察趋势。
页面主体是一张日历，用户可以选择某一天，需要是当天前的日期。
下方是回放频率。有1个小时，30分钟，15分钟三个选择。用户可以在回放过程中，随意更换回放频率，并不影响程序运行。
右边有4个按键，分别是"从左向右回放"，"从右向左回放"，"停止回放"和"帮助"。
顾名思义，"从左向右回放"就是实现趋势图从左到右播放，从开始时间播放到结束时间，当播放到结束时间点，趋势图会自动停止播放。
"从右向左回放"同理。
用户可以向某一个方向播放时，点击反方向播放，并不影响程序运行。
任意时候，用户可以点击"停止"按键，停止趋势图回放。
单击"帮助"图标，显示简单的帮助页面，如下：
- 8. 趋势图设置
单击PItool第四个图标，显示"趋势图设置"功能页面，如下：
该功能实现对趋势图纵坐标的设置，便于对一些数字量的设置。
页面上有3个选择，分别是"纵坐标Autorang"，"纵坐标database"，"纵坐标手动设置"。
默认选择是"纵坐标Autorang"。
"纵坐标Autorang"意味着趋势图纵坐标按点的属性，自动取值。
"纵坐标database" 意味着趋势图纵坐标按数据库的属性，自动取值。
"纵坐标手动设置"意味着用户可以自定义趋势图纵坐标的值。点击该选择项，出现如下页面：
隐藏的上限下限数据框出现，默认上限100，下限为0。
用户可以自己输入数值，但是如果输入非法数字，系统则报错：
用户可以微调数据，加减单位为"5"。
之后按"确定"按键，趋势图纵坐标则按相应数据变换。
如果用户下限大于上限，则趋势图上趋势线的走势恰好反了过来，系统并不报错。PItool没有刻意纠正这个有bug嫌疑的功能，也许能用上。
