Domino-Web开发规则(补足六个汉字).docx

Domino Web开发规则 Domino Web开发规则之一：Notes命名规范 所有的设计元素的命名都分成两部分，名称和别名，规定名称用中文命名，别名用英文，别名尽量使用简写，以WEB开发时不会产生较长的URL为前提，提高HTTP Request的响应速度。中文名称前面加上字母A到Y用于组织分类和排序。表单和视图的别名统一在前面加一个空格，代理统一不加空格，其目的是保证在design下看起来对齐一致。 1.设计元素 元素 规则 说明 帧结构集 名称：中文名称 别名：frms+英文 样例： 启动帧结构集|frmsStart 内容帧结构集|frmsContent 帧 名称：中文名称 别名：frm+英文 因为帧只存在于帧结构集中，所以不需要用字母来组织分类。 样例： 导航帧|frmNav 右边帧|frmRight 表单 名称：中文名称 别名：”fm”+英文(用于存贮) 别名:英文+”.html”(用于显示) 别名:英文+”.xml”(用于显示) 别名:英文+”.js”(用于动态JS) 样例： 申请表单|fmApply 主题表单|fmTopic 说明： 如果表单设计属于仅限于显示，如： HTML\查询结果|searchResult.html XML\查询结果|searchResult.xml JS\扩展日期组件|extCalendar.js 此显示类表单使用”?readformlogin参数字符串”打开。根据实际用途设置ContentType。 注：任何需要动态生成显示内容时(页面呈现时，调用后台代码或复杂的公式设计)，如：xml/js/json/html都可使用显示类表单完成。 视图 显示视图命名 名称：中文名称 别名：vw+英文[By+排序关键字描述] 程序视图命名 名称：(+中文名称+) 别名：vw+英文[By+排序关键字描述] 视图的命名与表单是一致的，视图中文名的组织字母与该表单一致，视图别名也与表单的别名的英文部分保持一致。 比如如果表单名为：申请表单|fmApply，那么对应的视图名称应该是申请视图|vwApply。如果对于一个表单可能有不止一个视图，经常用的情况是分类视图，对于此类视图，命名规范是名称:中文名称，别名：vw+英文+By+类别， 样例： 申请\按日期|vwApplyByDate 申请\按类别|vwApplyByType (申请\按文档创建日期)|vwApplyByCreateDate 注：对于视图的列，如果没有强制性的排序要求，请确保所有的文档按创建时间降序排列，这样新文档才会在最前面显示（这个问题一定要注意）。 视图一般分为显示用视图和程序用视图。在开发时，公式或程序不要在显示用视图中进行操作，如查询，取值。应另创建程序视图提供公式或程序使用。这样不会造成视图设计发生改变时而影响公式或程序运行。 代理 名称：中文名称 别名：ag+英文 代理的命名也要与表单保持一致，其名称的中文组织字母与表单一样，在表单中经常要使用到QueryOpenAgent和QuerySaveAgent，对应的代理应该是与其一致，比如表单申请表单|fmApply，那么对应此表单的QueryOpenAgent应该是申请打开代理|agApplyOpen，对应此表单的QuerySaveAgent应该是申请保存代理|agApplySave，对于非上述两种情况的代理，不要加open或者save,尽量在代描备注中进行描述此代理作用。 对于所有的代理，如果不是真正意义的定时代理（需要服务器定时来运行），不要把代理属性设置成“定时”，如果设置成了定时可能存在一定的风险，并且在不同的系统打开进行编辑保存时，代理会自动去查找运行的服务器导致design半天不反应。 注：定时代理在多服务器布署时，如果代理所在数据库在多台服务器上存在复本，请指定定时代理运行的服务器，以免造成文档复制冲突问题。 子表单 名称：中文名称 别名：sfm+英文 只用于编辑类子表单 如果只用于编辑类子表单，别名应该为sfm+英文简称+Edit； 如果只用于只读类子表单，别名应该为sfm+英文简称+Read； 域 命名规范：前缀+英文，其中的英文如果数据字典有，则必须来自于数据字典，数据字典中没有的，可自行命名，但需要遵守数据字典中的命名要求。 除了保留域，规范如下： 单值文本类型：St+英文，样例：StTopic 多值文本类型：Mt++英文，样例：MtAuthor 单值数字类型：Sn+英文，样例：SnMoney 多值数字类型：Mn+英文，样例：MnMoney 单值日期类型：Sd+英文，样例：SdApply 多值日期类型：Md+英文，样例：MdApply RTF类型：Rtf+英文,样例：RtfR