ap开发简明手册

Ap开发简明手册

1、开发前提

为了保证开发效率和结果，配置开发前，实施人员需优先做好数据库设计和功能设计。

2、部署文件结构说明

AP平台中应用部署以文件夹为基础，默认该文件夹的名称为该应用的名称。如：合同信息登记模块的应用名为“htxxdj”，则文件夹的名称为“htxxdj”。

一般应用对应的文件夹包含如下三个定义文件：app.xml,*.dm.xml,*ui.xml

1)App.xml

应用描述文件，必须有，文件名称固定为app.xml，不得修改。配置属性中的id为唯一，mapping为映射名称，即应用的别名。详情参考“AP部署文件XML定义”中的app.xml文件描述。

2)*.dm.xml

数据模型描述文件，必须文件，文件后缀名称必须为dm.xml。范例：clgl.dm.xml；主要定义与数据库对应的dataModel（如table字段、reference外键、索引等）及datasets（数据集，供执行SQL语句调用的定义）

3)*.ui.xml

页面模型描述文件，可选文件，文件后缀名称必须为ui.xml。范例：clgl.ui.xml。主要定义模块的视图（view）和表单(form)。

一般的UI文件的层次结构大致如下：

3、UI常用控件介绍

XML定义文件提供了常用控件input、select、radio、button、span和特殊功能组件linkselect、computerText、computedField等。

1)input

普通的输入框、日期控件、多行文本框均可使用input组件，且特殊类型的字段，自带了验证功能，比如数字类型的字段。

◆普通使用方式： ,而前台将显示成输入框还是日期，则取决了相

应*.dm.xml文件中对应字段的dataType。日期的dataType=”date”，多行文本框的

dataType=”text”。

◆特殊使用方式： readonly

为输入框是否为只读，notNull为控制是否可为空。

2)select

◆从数据字典中取值

◆从数据集中取值，addBlank为是否添加一条空行。

3)radio

普通使用方式

4)button

5)span

span主要用于显示一些特殊信息或某些事件可将显示信息加载到span中

6)linkselect

联动下拉选择，将数据字典中关联的数据联动引用。

7)computedField

8)computerText

特殊显示域，主要用于显示特殊格式的字段，但如果些字段的值需要存入数据库，则需

4、模块权限配置

权限配置时，URL路径为/ap/ htxxdj ,其中，htxxdj为模块文件夹的名称。

5、开发常用功能列举

1)字段取值赋值

平台将取值赋值进行了封装。

◆取值：_$Val(“xxx”);xxx为字段的id名称

◆赋值：_$Val(“xxx”,”21323”);第二个参数为要赋的值。

2)触发计算字段的重新计算

计算中，经常存在A字段是由其他字段计算而来，却同时被B字段监控执行计算。就

3)从组织架构中选择部门

通过按钮打开组织架构，选择相应的部门后，返回部门名称和部门ID

4)从组织架构中选择用户

5)自动编号

自动编号可调用_$GetNewCaseId函数。

如需实现”CGFYBX20120612000001”格式的编号（表单名称简拼+年月日+流水号），如下

若不需要年月日，则去掉“dateFormatter”参数即可

6)各控件的权限控制

权限的控制可使用displayMode属性来进行控制。displayMode的详情参见XML定义中的说明

7)打开view并返回值

若页面虽打开某模块的view页面，并返回相应的值，可使用apSelectFormView()函数。第一个参数为要调用的view页面的ID，rows代表返回的值集合（只能返回view页面上显

8)打开特定的form

9)计算功能使用

计算一般使用computedField控件，computedField控件可指定监控的字段，当被监控字段发生改变时，便触发计算。observeFields为监控字段，_$SumFloat()函数为合计函数，参

10)SQL语句的执行

执行SQL语句需先在将要执行sql语句的*.dm.xml文件中定义sql语句及返回的数据集。

如实现：根据用户的ID，获取之前的备用款总借款金额，其中：arg 中的参数为sql语句需传入的参数，acalars为查询结果返回的记录集。

SQR_ID:_$Val("SQR_ID"),ID:_$Val("ID")

11)子页签与主表单数据

需合计子页签某字段的总和并返回到主表单。实现中，需给iframe指定dataChange事件，gridData为子页签的数据集，取值后再为主表单相应字段赋值。

12)下拉选择的value值的保存

有些下拉选项的值是从数据字典或数据集中获取的，那么其value和name属于不相同的值，而且默认保存时只会保存下拉的vlaue值。所以，需额外在保存前将name值保存至相应字段中。_$GetSelectedOptionName()为取下拉name值。

13)表单帮助功能的引用

表单中引用帮助信息有两种方式，一种为在UI页面中预设帮助信息，一种是从帮助信息的基础数据中获取。

特殊功能

预算页面选择

根据选择的结果加载不同的数据