ap开发简明手册

AP开发简明手册1、开发前提为了保证开发效率和结果，配置开发前，实施人员需优先做好数据库设计和功能设计。2、部署文件结构说明AP平台中应用部署以文件夹为基础，默认该文件夹的名称为该应用的名称。如合同信息登记模块的应用名为“HTXXDJ”，则文件夹的名称为“HTXXDJ”。一般应用对应的文件夹包含如下三个定义文件APPXML,DMXML,UIXML1APPXML应用描述文件，必须有，文件名称固定为APPXML，不得修改。配置属性中的ID为唯一，MAPPING为映射名称，即应用的别名。详情参考“AP部署文件XML定义”中的APPXML文件描述。2DMXML数据模型描述文件，必须文件，文件后缀名称必须为DMXML。范例CLGLDMXML；主要定义与数据库对应的DATAMODEL（如TABLE字段、REFERENCE外键、索引等）及DATASETS（数据集，供执行SQL语句调用的定义）3UIXML页面模型描述文件，可选文件，文件后缀名称必须为UIXML。范例CLGLUIXML。主要定义模块的视图（VIEW）和表单FORM。一般的UI文件的层次结构大致如下3、UI常用控件介绍XML定义文件提供了常用控件INPUT、SELECT、RADIO、BUTTON、SPAN和特殊功能组件LINKSELECT、COMPUTERTEXT、COMPUTEDFIELD等。1INPUT普通的输入框、日期控件、多行文本框均可使用INPUT组件，且特殊类型的字段，自带了验证功能，比如数字类型的字段。普通使用方式,而前台将显示成输入框还是日期，则取决了相应DMXML文件中对应字段的DATATYPE。日期的DATATYPE”DATE”，多行文本框的DATATYPE”TEXT”。特殊使用方式READONLY为输入框是否为只读，NOTNULL为控制是否可为空。2SELECT普通使用方式从数据字典中取值从数据集中取值，ADDBLANK为是否添加一条空行。事件引用方式3RADIO普通使用方式4BUTTON使用方式5SPANSPAN主要用于显示一些特殊信息或某些事件可将显示信息加载到SPAN中6LINKSELECT联动下拉选择，将数据字典中关联的数据联动引用。7COMPUTEDFIELD主要用于计算性质的字段。比如合计等。COMPUTEDFIELD是不可编辑的控件。金额人民币小写8COMPUTERTEXT特殊显示域，主要用于显示特殊格式的字段，但如果些字段的值需要存入数据库，则需在隐藏域中设定一个对应的INPUT。4、模块权限配置权限配置时，URL路径为/AP/HTXXDJ,其中，HTXXDJ为模块文件夹的名称。5、开发常用功能列举1字段取值赋值平台将取值赋值进行了封装。取值_VAL“XXX”XXX为字段的ID名称赋值_VAL“XXX”,”21323”第二个参数为要赋的值。2触发计算字段的重新计算计算中，经常存在A字段是由其他字段计算而来，却同时被B字段监控执行计算。就需要触发A字段重新计算。参数为字段名称，可多个。_TRIGGERCOMPUTEFIELDS“FPZJE“,“SQZFJE“3从组织架构中选择部门通过按钮打开组织架构，选择相应的部门后，返回部门名称和部门ID4从组织架构中选择用户5自动编号自动编号可调用_GETNEWCASEID函数。如需实现”CGFYBX20120612000001”格式的编号（表单名称简拼年月日流水号），如下若不需要年月日，则去掉“DATEFORMATTER”参数即可6各控件的权限控制权限的控制可使用DISPLAYMODE属性来进行控制。DISPLAYMODE的详情参见XML定义中的说明7打开VIEW并返回值若页面虽打开某模块的VIEW页面，并返回相应的值，可使用APSELECTFORMVIEW函数。第一个参数为要调用的VIEW页面的ID，ROWS代表返回的值集合（只能返回VIEW页面上显示的字段值）8打开特定的FORM根据相应的信息（ID等），可通过_OPENFORM函数打开特定的页面FUNCTIONOPENYSXXVARYSGSID_VAL“YSGS_ID“IFNULLYSGSID|YSGSIDLENGTH0OZMSGINFO“请先选择费用类别“ELSEVARTITLE_VAL“YSGSLX_4“IFNULLTITLE|TITLELENGTH0TITLE_VAL“YSGSLX_3“IFNULLTITLE|TITLELENGTH0TITLE_VAL“YSGSLX_2“IFNULLTITLE|TITLELENGTH0TITLE_VAL“YSGSLX_1“_OPENFORM“FM_YSXX“,“FORM4FMYSXX“,“ID“,YSGSID,TITLE9计算功能使用计算一般使用COMPUTEDFIELD控件，COMPUTEDFIELD控件可指定监控的字段，当被监控字段发生改变时，便触发计算。OBSERVEFIELDS为监控字段，_SUMFLOAT函数为合计函数，参数“2”表示返回两个小数点。人民币小写算减法和乘法，需将相应的字段转换为FLOAT型RETURNOZNUMBERFORMATFLOAT_FLOATVAL“GHHL_HL2“_FLOATVAL“GW_QTFY_JE2“,210SQL语句的执行执行SQL语句需先在将要执行SQL语句的DMXML文件中定义SQL语句及返回的数据集。如实现根据用户的ID，获取之前的备用款总借款金额，其中ARG中的参数为SQL语句需传入的参数，ACALARS为查询结果返回的记录集。UIXML中执行此SQL语句如下，其中SQR_ID_VAL“SQR_ID“,ID_VAL“ID“为传SQL需要的参数。JSONRESULTSETIYQKJE为查询出来的结果集。_EXECUTESQL“DS4FMGETYQKJE“,SQR_ID_VAL“SQR_ID“,ID_VAL“ID“,FUNCTIONJSONIFJSONRESULTCOUNT0/ALERT“执行影响到的行数为0“ELSE/ALERTJSONRESULTSETLENGTHFORVARI0I0FORVARI0I12下拉选择的VALUE值的保存有些下拉选项的值是从数据字典或数据集中获取的，那么其VALUE和NAME属于不相同的值，而且默认保存时只会保存下拉的VLAUE值。所以，需额外在保存前将NAME值保存至相应字段中。_GETSELECTEDOPTIONNAME为取下拉NAME值。币种113表单帮助功能的引用表单中引用帮助信息有两