【IT168 信息化】
1. 前言
为了提高编码的效率和标准化程度，增强代码的可读性，本规范作为XXX前端展现程序员开发规范。
2. Brio Query编程规范
2.1. 命名规范(Naming Conventions)
在命名规范中，约定统一的命名规则如下：
命名要有意义、具有描述性，避免含糊，具有可读性。
使用全名。不要因为想少击键而任意节略，除非公认的标准节略。
名称前后要一致，可扩展。
每个有意义的单位(单词)之间用下划线分隔。
不使用汉语拼音(文件名除外)，必须使用有意义的英文单词。
大小约定：
标识符(Identifier)、对象(Object)、自定义函数(User_defined Function)全部小写。
系统保留字(Reserved Word)、SQL语句应大写。如：
BEGIN END; IF THEN END IF； SELECT， INSERT
系统函数应按其固有的格式书写。主要是每个意义单位首字母大写。如：
SetTransObject()
2.1.1. Brio Query文件命名规范
Brio Query的文件名分为两类，一类是OCE（Open Catalog Extensions）文件，即数据连接文件，应连接到的数据库来命名，如连接到的数据库为TESTDB，则OCE文件命名为“testdb.oce”。
另一类是BQY文件，即制作查询分析报表文件名，应根据报表的内容来命名，尽量做到简洁清晰，如报表的内容为用户数统计，则BQY文件名为“用户数统计.bqy”。
2.1.2. Brio Query对象命名规范
Brio Query对象：指独立存在于Brio Query中的各个对象，包括查询区、结果区、表区、OLAP查询区、旋转透视表区、图表区、报表区、EIS区、EIS区中的控件和图形以及用户自定义函数。
为便于统一识别，Brio Query对象命名应严格使用标准前缀。
Brio Query所有对象的命名应采用如下标准：
<Brio Query对象标准前缀> _ <变量描述>
Brio Query对象前缀定义及范例如下：
控件对象：指存在EIS中可视的控件对象。
控件的命名规范如下：
<控件前缀>_ <变量描述>
控件对象的前缀定义及范例如下：
▲
图片对象：指存在于EIS区中可视图片的对象。
图片对象的命名规范为：
<图片对象前缀> _ <变量描述>
▲
图片对象前缀定义及范例如下：（第一个g代表ground）
▲
2.1.3. 函数及变量命名规范
变量的命名规范如下：
<作用范围>_<变量含义>
▲
变量含义：简明的英文单词，能表示该变量含义的简洁单词。
备注：在函数外面使用 var 是可选的；可以通过只给变量赋值来声明一个变量。不过，使用var，是一种值得提倡的编程风格，而且，如果函数中有同名的全局变量，则必须使用 var。
例如：var l_num_hits = 0, l_cust_no = 0
但是在定义全局变量时则不可使用var，如：g_bank_id = ‘aa’。
2.2. Brio Query语句规范
2.2.1. Script语句规范
Script语句应体现循环或控制的层次，每不同层次之间应该用一个制表符(TAB或二个空格)区分，如：
//取出结果区中第一行第一列的值
for(i=1;i<=ActiveDocument.Sections["结果"].RowCount;i++)
{
var l_value=ActiveDocument.Sections["结果"].GetCell(i,1)
}
每5、6条Script语句至少应该有一条注释说明。
在Brio Script中对进行字符串赋值操作时，使用双引号或者单引号都可以，如：var l_bank_id=”a”与var l_bank_id=’a’效果是一样的。但是如果要在字符串中输入单引号，则会有所不同，如：与var l_bank_id=”a’b’c”等效的语句为var l_bank_id=’a\’b\’c’，即使用单引号来进行字符串赋值时，要使用转义符\才能把单引号作为普通字符输入。
所以在Script语句中进行字符串赋值操作时，约定使用双引号而不使用单引号。
2.2.2. 函数注释规范
/* FunctionName
<DESC> Description</DESC>
<RETURN> Integer: Description </RETURN>
<ACCESS> Public/Protected/Private
<ARGS> as_Arg1: Description
as_Arg2: Description</ARGS>
<USAGE> How to use this function. </USAGE>
*/
详细例子如下：
/* f_get_token
<DESC>分解字符串，返回第一个单词(由指定的分隔符确定)，
并从字符串中删除该单词以及分隔符</DESC>
<RETURN> string 字符串的第一个单词</RETURN>
<USAGE>
函数的使用方法为：
string ls_source, ls_token
ls_source = "this is a test string!"
ls_token = f_get_token( ls_source, "a" )
这时，ls_token的值为"this is ", 并且ls_source的值变为" test string!"</USAGE>
<ARGS>
source ref 需要分解的字符串
separator 确定第一个单词的分隔符</ARGS>
*/
2.2.3. Script注释规范
在编写script语句时，须遵循以下注释原则：
在循环语句的头进行注释说明；
在选择语句的头进行必要的注释说明；
在关键的script语句前进行注释说明；
对带返回值的return语句必须对返回值进行说明。
2.3. Brio Query界面规范
2.3.1. 总体界面规范
总体界面风格：
分辨率：800*600 / 1024*768显示模式
颜色：256色以上模式
字体：小字体
汉字系统均以宋体9号字为标准
2.3.2. EIS界面规范
在进行EIS界面设计时应遵循以下规范：
所有EIS界面遵循规范：
EIS区上的显示字体均采用宋体 , 尺寸为9；
数字类型 MS Sans Serif 9
字符类型 宋体 9
数据编辑显示风格为：
日期格式： yyyy-mm-dd
数字： #，###，###，##0.00 或 #，###，##0
负数： 前景红色，加负号 （格式为 #，###，##0.00 [RED] -#，###，##0.00
2.3.3. 数据模型主题优先级
进入查询区或数据模型区，点击菜单条上的“数据模型”，在下拉菜单中选择“数据模型选项”，进入数据模型选项窗口，选择“主题优先级”页，对表进行排序。
排序规则如下：
如果表之间的关系是星型结构，则将主表放在第一的位置，其它表的排列顺序影响不是很大，可按照大小或重要程度进行排列，或不进行排列。
