平台脚本技能#

为自研业务平台提供全面的脚本模板和编码规范。

何时使用#

✅ 使用此技能的情况：

• "帮我写一个平台脚本"
• "需要数据增删改查的脚本"
• "表单验证脚本怎么写"
• "动态控制下拉框选项"
• "合并多个 CI 附件为 PDF"
• "发送邮件的脚本"
• "SQL 查询/分页脚本"
• "审批流程相关脚本"
• "根据我的平台规则写代码"

何时不使用#

❌ 不使用此技能的情况：

• 通用编程问题（不使用平台特定 API）
• 其他平台的脚本代码
• 与平台无关的代码需求

技能位置#

skills/platform-script-skills/

使用方法#

当用户请求平台相关的脚本代码时，读取 references/ 目录中的完整模板文件，理解平台的特殊脚本规则，生成符合规范的可用代码。

核心能力#

1. 基础脚本操作#

• 数据创建 (DataModelUtils.createCIByCIClassName)
• 数据删除 (DataModelUtils.deleteCi, deleteCis)
• 数据修改 (saveCi)
• 数据查询 (getCIByPK, getCIByAttr, queryForListMap)
• 脚本调用 (ScriptUtils.runScriptByCode)

2. 表单脚本操作#

• 数据验证 (validatorFunctions)
• 动态字段控制 (disabledAttributes, dynamicDisabledAttrs)
• 字段值变化 (changeFunctions)
• 下拉框选项控制 (scriptFilterInOptions, setSelectOptionsFunc)
• 字段显示控制 (controlFieldDisplayFunc)
• 自动补全 (controlAutoCompleteFunc)
• 父子表单通信 (addObserver, notifyParent)
• 智能回填 (initBackFillData, initNestedFormData)

3. SQL 脚本操作#

• 数据查询 SQL
• 数据修改 SQL (JDBCUtils.update)
• 分页处理 (LIMIT/OFFSET、逻辑分页)
• 多表连接查询

4. 附件处理#

• 附件函数 (AttachmentsUtils.*)
• 文件导出 (Excel、Word、PDF、zip)
• 多 CI 附件转 PDF
• PDF 合并
• Word 合并

5. 审批流程#

• 自定义提交流程 (flow_base_start)
• 自定义通过流程 (flow_pass)
• 自定义加签脚本 (flow_add_object_by_standalone)

6. 工具函数#

• 日期格式化 (SimpleDateFormat)
• 时间戳生成
• 列表排序 (sortMapList)
• 字符串处理 (removeTrailingZeros)

7. 业务特定脚本#

• 华龙业务相关
• FOS 数据查询
• 航班数据操作

特殊规范#

变量命名#

• 使用中文变量名（如 def 主表数据, def 明细表数据）
• 遵循平台的字段命名规范

数据模型操作#

groovy

// 单条记录
def 数据 = DataModelUtils.getCIByPK("表名",['ID':值])

// 多条记录
def 数据列表 = DataModelUtils.getCIByAttr("表名",['字段名':值])

// 保存
saveCi(数据)

// 删除
DataModelUtils.deleteCi(数据)
DataModelUtils.deleteCis(数据列表)

表单脚本返回格式#

javascript

if(args$){
    return {
        "validatorFunctions": fieldValidateMap,
        "disabledAttributes": list,
        "changeFunctions": feildMapFunc,
        "setSelectOptionsFunc": optionsFunc
    };
}else{
    return null;
}

脚本参数说明#

• args$ - 脚本参数变量
• args$.data - 表单输入数据
• args$.getFieldValueFunc - 获取字段值函数
• args$.setFieldValueFunc - 设置字段值函数
• args$.runScriptFunc - 调用后台脚本
• args$.notification - 打印信息 (error/warning/info/success)

重要提示#

1. 访问 args$ 属性前先检查其是否存在
2. 监听脚本使用 ci$.dataFieldMap 访问当前数据
3. 附件字段需要使用 JsonSlurper 将大文本转换为 JSON
4. 导出文档时使用正确的模板占位符语法
5. 妥善处理 null 值避免异常

完整模板位置#

所有完整代码示例存储在 references/platform-script-templates.txt 文件中，包含：

• 完整的代码示例
• 详细的注释说明
• 各种场景的最佳实践

当需要编写具体脚本时，会参考此文件中的完整模板生成代码。