通达OA应用中心使用手册(脚本编写指南)

1对1

1对1

app_data_XXX 表单除列表之外且

不是大文本字段数据存储表，XXX

对应表单id，该表为表单数据主

表id 记录idPKguid 数据记录guidPK
FK    main_id 主表的数据记录id

run_id 工作流水号

isdeleted 删除标识

position 记录顺序号

create_userid 创建者uid

create_time 创建时间

update_userid 最后更新者 uid

update_time 最后更新时间

col_XXX 字段数据，XXX代表字段id

app_data_XXX_text 表单除列表之

外的大文本字段数据存储表，XXX

对应表单idid 记录idPKguid 数据记录guidPK
FK    main_id 主表的数据记录id

run_id 工作流水号

isdeleted 删除标识

position 记录顺序号

create_userid 创建者uid

create_time 创建时间

update_userid 最后更新者

uid

update_time 最后更新时间

col_XXX 字段数据，XXX代

表字段id

app_data_XXX_list_YYY 表单列表

字段数据存储表，XXX对应表单

id，YYY为列表字段id

PKid 记录idguid 数据记录guidPK
FK    main_id 主表的数据记录id

run_id 工作流水号

isdeleted 删除标识

position 记录顺序号

create_userid 创建者uid

create_time 创建时间

update_userid 最后更新者

uid

update_time 最后更新时间

col_XXX 字段数据，XXX代

表字段id

1.4 应用中心控件数据结构

新版应用中心采取前后端分离方式实现，前端和后端采取规定好的数据结构进行通信，

因此用户自己编写脚本过程中读取和设置数据时要满足规定好的结构。应用中心各控件数据

单行文本、多行文本、数字文本、货币文本、自动编号：具体值，例如："应用中心"，"2017

版\n 应用中心操作手册"，96，25.98，"2017110056"。

日期文本：类型为日期时，数据格式为 yyyy-M-d，例如：2017-11-20；类型为时间时，

数据格式为 HH:mm:ss，例如：11:07:01；类型为日期+时间时，数据格式为 yyyy-M-d

HH:mm:ss，例如：2017-11-20 11:07:01。

单选框：选项值结构为：[["code","name"]]，code 为代码保存值，name 为代码显示值，

例如：[["code"=>"01","name"=>"男"],["code"=>"02","name"=>"女"]]；选定值为：选择后的

代码 code 值，例如：01。

多选框：选项值结构与单选框一样；选定值为：数组，数组里元素为选择后的代码 code

值，例如：["01","02"]。

下拉选择：选项值结构与单选框一样；不支持多选的选定值结构与单选框一致，支持多

选的选定值结构与多选框一致。

地    址    ：    数    据    结    构    为    ：

["prov"=>["id","name"],"city"=>["id","name"],"country"=>["id","name"],"street"] ，分别对应

省 、 市 、 县 以 及 详 细 地 址 ， 例 如 ： ["prov"=>["id"=>"110000","name"=>" 北 京

市"],"city"=>["id"=>"110100","name"=>"市辖区"],"country"=>["id"=>"110108","name"=>"海

淀区"],"street"=>"紫竹院路 69 号"]。

定位：数据结构为：["lat","lng","address"]，分别对应纬度、经度以及具体地址，例如：

["lat"=>39.9241,"lng"=>116.404,"address"=>"北京市东城区"]。

附件、图片：数据结构为：[["attach_id","attach_name"]]，分别对应附件 ID 以及附件名

称 ， 例 如 ： [["attach_id"=>"    [email protected]_754692181","attach_name"=>"    报 表 需 求 开

发.docx"],["attach_id"=>" [email protected]_303458136","name"=>" 17 版应用中心建议.docx"]]。

部门选择：数据结构为：[["dept_id","dept_name"]]，分别对应部门 ID 以及部门名称，

例    如    ：    [["dept_id"=>"ALL_DEPT","dept_name"=>"    全    体    部    门    "]]    ，

[["dept_id"=>1,"dept_name"=>"总经理"],["dept_id"=>2,"dept_name"=>"财务部"]]。

人员选择：数据结构为：[["uid","username"]]，分别对应人员的 UID 以及人员真实姓名，

例如：[["uid"=>1,"username"=>"张三"],["uid"=>2,"username"=>"李四"]]。

列表：数据结构为：["flag","index","data"=>[["field_id","value"]]]，解释如下：

flag：新增行标识，新增行 flag 值为 new，非新增行时为空；

data：记录数据，是一个二维数组，每列数据包含 field_id 和 value，field_id 为该列

字段的 GUID，value 为该列的数值，数值结构参考之前的描述。

列表数据例子如下：

[

["flag"=>"new","index"=>"

1511236728561","data"=>[["field_id"=>"{4C022D90-83C4-5EBA-EE7B-ED1A98AFD7ED}","value"=>

2],["field_id"=>"    {6FF2B352-A9D9-C1EC-414C-795016C2141D}","value"=>[11,12]]]],

["flag"=>"new","index"=>"    1511236715995",    "data"=>

[["field_id"=>"{4C022D90-83C4-5EBA-EE7B-ED1A98AFD7ED}","value"=>1],["field_id"=>"

{6FF2B352-A9D9-C1EC-414C-795016C2141D}","value"=>[5,1]]]]

]

1.5 公共函数

系统内置了一系列公共函数可供自定义函数、自定义脚本插件使用，这些函数封装在一

个名为 APPPluginUtils 的类里，在运行时这个类会实例化为$PLUGIN_UTILS 对象，并以实

参或者变量形式传递给自定义函数、自定义插件。具体调用方式请参考后面例子。

1.5.1 获得当前表单 id

方法：getFormId()

输入：无

输出：当前表单 id

1.5.2 获得当前表单 guid

方法：getFormGuid()

输入：无。

输出：当前表单 guid。

方法：getFormGuidById($i_id)

输入: $i_id 表单 id。

输出：指定表单 guid。

1.5.4 获得字段 guid

方法：getItemGuidByName（$i_formid, $s_title, $s_subtitle = ""）

输入：$i_formid 表单 id；$s_title 字段名称；$s_subtitle 列表子字段名称，可不传。

输出：字段 guid。

1.5.5 根据名称获得当前字段值

方法：getValueByName($s_item_name, $s_subitem_name = "", $i_seq = 1)

输入：$s_item_name 字段名称；$s_subitem_name 列表子字段名称，可不传；$i_seq 行

顺序号，默认取第一行数据。

输出：字段值。

1.5.6 获得当前字段值

方法： getValue($s_item_guid, $i_seq = 1)

输入：$s_item_guid 字段 guid；$i_seq 行顺序号，默认取第一行数据。

输出：字段值。

1.5.7 根据名称获得表单基本数据（非列表数据）或者

列表数据

方法：getRowByName($s_list_name = "", $i_seq = 0)

输入：$s_list_name 列表名称，可不传，不传时返回表单基本数据；$i_seq 行顺序号，

默认取所有数据。

输出：基本数据或者列表数据。

方法：getRow($s_list_guid = "", $i_seq = 0)

输入：$s_list_guid 列表 guid，可不传，不传时返回表单基本数据；$i_seq 行顺序号，

默认取所有数据。

输出：基本数据或者列表数据。

1.5.9 设置字段数据

方法：setValue($s_item_guid, $value, $i_seq = 1)

输入：$s_item_guid 字段 guid；$value 字段值；$i_seq 记录行顺序号。

输出：无。

1.5.10    设置字段选项数据

方法：setOptionValues($s_item_guid, $arr_options, $i_seq = 1)

输入：$s_item_guid 字段 guid；$arr_options 选项数组；$i_seq 记录行顺序号。

输出：无。

1.5.11    清除列表数据

方法：function clearDetailTable($s_item_guid)

输入：$s_item_guid 字段 guid。

输出：无。

1.5.12    获得应用中心数据库连接

方法：function getDb()

输入：无。

输出：应用中心数据库连接。

根据数据库连接操作数据库，常见方法举例如下：

$posts = $command->queryAll();

$post = $command->queryOne();

$command = $connection->createCommand(‘UPDATE post SET status=1‘); $command->execute();

$command = $connection->createCommand(‘SELECT * FROM post WHERE id=:id‘);

$command->bindValue(‘:id‘, $_GET[‘id‘]);

$post = $command->query();

1.5.13    获得数据源里配置的数据库连接

方法：function getOtherDB($s_sername, $s_db = "")

输入：$s_sername 数据源名称，在系统管理》数据源管理中设置；$s_db 数据库名称，

不传时使用数据源里设置的数据库。

输出：数据库连接。

1.5.14    根据表单名称获得表单 id

方法：function getFormIdByName($s_app, $s_form)

输入：$s_app 应用名称；$s_form 表单名称。

输出：表单 id。

1.5.15    根据表单 guid 获得表单 id

方法：function getFormIdByGuid($s_guid)

输入：$s_guid 表单 guid。

输出：表单 id。

方法：function getItemIdByGuid($s_guid)

输入：$s_guid 字段 guid。

输出：字段 id。

1.5.17    根据字段名称获得字段 ID

方法：function getItemIdByName($i_formid, $s_title, $s_subtitle = "")

输入：$i_formid 表单 id；$s_title 字段名称；$s_subtitle 列表子字段名称，可不传。

输出：字段 id。

1.6 概述

应用中心提供了大量的标准函数，通过组合这些标准函数可以实现各种复杂度不一的数

据处理。此外，应用中心还提供了自定义函数功能，方便用户自行扩充数据处理功能。自定

义函数语法如下：

MYFUNC(<函数名>)：返回由<函数名>指定的自定义函数处理后的结果。例如：

MYFUNC("get_aux_quantity")。

处理引擎命名规则：XXX 名称.func，对应的实现文件为：XXX 名称.func.php，例如：

MYFUNC("get_aux_quantity")指定处理引擎为 get_aux_quantity.func，对应的实现文件为：

get_aux_quantity.func.php。

引擎实现文件存放路径为：webroot\general\appbuilder\modules\appcenter\plugin\表单 id，

例如：webroot\general\reportshop\utils\plugins\1。

如何查看表单 id？点击该表单设计界面，浏览器地址栏上会显示 formId=XXX，XXX

即为该表单 id。

注意：自定义函数只能用在填充表达式中，不能用在筛选条件中。

1.7 输入参数与输出结果

应用中心调用自定义函数时，将给自定义函数传递以下实参(即自定义函数的输入参

数)：

$PLUGIN_UTILS：插件公共对象，包含了访问公共函数接口；

自定义函数输出结果为计算结果值。

1.8 举例

以倍数换算为例，举例说明如何使用自定义函数。首先，定义如下提取触发器：

9

其中，MYFUNC("calculate_it")为自定义函数。处理引擎定义为：calculate.func。引擎实现文

calculate.func.php 包含自定义函数 calculate_it，其脚本如下：

/**

计算基数根据陪数翻番后的结果