掌握执行服务器过程
在事件响应设置面板中可以设置执行服务器过程来完成对数据的持久化操作。绝大多数情况下，只需写 SQL 即可完成 业务逻辑。
1. 执行 SQL
1.1 SQL 设置方法
执行单条 SQL
直接书写带变量的 SQL，取用前端和后端提供的变量数据做持久化操作，如：
INSERT INTO TAB_A(F1, F2, F3, ...) VALUES(@11-VAR1@, @11-VAR2@, @VAR3@)
一次执行多条 SQL
可以使用 $0, $1, $2, ... 标识符依次来表示引用第 1 条, 第 2 条, 第 3 条 SQL... 执行的结果。如：
SELECT * FROM tab_a WHERE id = @12-USER_ID@ AND master = @USER_ID@; -- 一定要分号分隔
INSERT INTO tab_b(F1, F2, F3, ...) VALUES($0.rows[0]["field1"] , @11-VAR2@, @VAR3@);
-- ^^^^^^^ 即第 1 条 SELECT 查询结果集合。
UPDATE tab_b SET f1 = @12-VAR1@, f2 = @VAR2@ WHERE id = $1.insertId; --<-- 即 第 2 条 SQL 执行的结果。
【说明 1】$n 标识符代表的第 n+1 条 SQL 执行结果，本身是一个 JSON 对象，结构如下：
{
rows: [{...}, {...}, {...} ...], // 执行 SELECT 语句才有该字段，表示查询结果。
insertId: 12889, // 执行 INSERT 语句才有该字段，表示插入后获得的自增长 ID，仅适用于 mysql。
affectedRows: 3, // 执行 INSERT, UPDATE, DELETE 才有该字段，表示影响行数。
}
【说明 2】执行多条 SQL 时，解释器会根据上下文依赖，决定是否并发执行还是串行执行；同时，如果包含两条以上的更新语句(INSERT、UPDATE、DELETE)，则会采用事务方式执行，如果有错误会自动回滚，开发者无需关心。
SQL 中嵌入 JavaScript 脚本
可以使用 # JavaScript 脚本 # 嵌入 SQL 中对变量进行加工处理，如：
INSERT INTO tab_a(F1, F2, F3) VALUES(
-- 字段 F1 值
#@11-VAR1@ + '-' + @11-VAR2@#,
-- 字段 F2 值
#@12-NAMES@.split(',').map(function(s) {
return s.replace(/\s/g, '');
}).join(':')#,
-- 字段 F3 值
#@12-VAR@ + b#
);
1.2 添加错误码对照提示
对于一些需要明确提示给用户的 SQL 错误，可以设置SQL 错误码对应的错误提示信息，以增加交互的友好性。比如给常见的主键重复错误码ER_DUP_KEY添加对照提示您添加的学号已经存在！，
1.3 执行提交前前端脚本（可选）
设置提交前前端脚本的设置可以满足以下需求：
- 如果您想在过程提交到后台执行前，做一些条件判断，来决定是否要提交，则直接在脚本中返回 false 即可阻止本次提交，如：
if (/** 条件不满足 **/) {
return false;
}
- 如果想改变提交的参数变量的值，可以直接返回包含新变量值的 JSON，对即将提交到后台的变量值做覆盖，如：
var amount = @11-amount@ + @11-total@ + 3;
var rows = @11-rows@.map(function(s) {
return s.split('-')[0];
});
return {
"11-amount": amount,
"11-rows": rows,
"12-other": "something"
};
1.4 执行 SQL 执行前后台脚本（可选）
设置此脚本可以满足以下需求：
- SQL 执行前需要对参数做后台校验。
- SQL 执行前需要改变或者新增参数。
例：
if (!@11-PHONE@) {
// 校验不合法则调用 done 方法，并设置 sucess 参数为 false。
done(null, {
success: false,
message: '电话号码必填'
});
return;
}
// 可以根据情况再做一次 IO 来深度校验某些参数，然后调用 done() 方法。
// var dbService = Enhancer.getDatabaseService();
// ...
// 可以在 SQL 执行前再次改变参数的值。
parameters['11-PHONE'] = '86' + @11-PHONE@;
// 一定要调用 done 方法，这样才能继续执行后续程序。
done();
注意：一定要调用 done 方法，程序才能继续执行
1.5 同步执行（可勾选）
- 如果勾选，则前端后续动作需要等待此后台过程完成之后才能执行，并且要求后台过程执行正确。如果后台执行发生错误，则前端的后续动作不会执行。
- 如果不勾选，则前端的后续动作不会受后台过程执行影响，彼此独立进行。
2 执行 JavaScript 过程【选修】
如果编写通用 SQL 的方式不能满足您的特殊业务需求，那么可以编写原生后台 JavaScript 过程，控制整个执行过程。后台可供使用的 API 参考API-Server.md
- 通用示例
var sql = `UPDATE student SET name = ?
, birthday = ?, birth_place = ?
, gender = ?, phone = ?
, nation = ?, entry_year = ?
, ssn = ?, family_address = ?
, political_status = ?, school_year_length = ?
WHERE student_no = ?`;
// 直接 @变量@ 从页面取用本次过程执行需要的数据。
var params = [
@12-NAME@, @12-BIRTHDAY@, @12-BIRTH_PLACE@
, @12-GENDER@, @12-PHONE@, @12-NATION@, @12-ENTRY_YEAR@
, @12-SSN@, @12-FAMILY_ADDRESS@, @12-POLITICAL_STATUS@
, @12-SCHOOL_YEAR_LENGTH@, @12-STUDENT_NO@
];
// Enhancer 是全局对象，直接使用。
var databaseService = Enhancer.getDatabaseService();
// 执行 SQL
databaseService.execute(sql, params, function(err, result) {
if (err) {
// 不论结果执行成功失败，需要调用 done 方法表示本次过程结束。
// done 方法的第一个参数传递系统级 err，第二个参数传递常规结
// 果对象（包含 success 和 message 字段）。
done(null, {
success: false,
message: '操作失败操作失败。' + err.message
});
return;
}
done(null, {
success: true,
message: '修改成功！'
});
});
// 注意：执行 SQL 的数据库连接的获取和释放由内部统一控制，用户无需关心。
// 如果需要做事务，可以调用 databaseService.beginTransaction 方法，
// 请参考： https://assets.enhancer.io/enhancer/tutorials/0.3.0/zh-cn/api-server.html
【附】服务器端编程 API
注意：一定要调用 done 方法，程序才能继续执行
使用 Enhancer 后台执行程序，结合 Enhancer 变量体系，可以使得业务逻辑的开发变得更直观和高效。