1. 系统代码库

1.1. document函数

1.1.1. 根据字段值获取包含该值的document

方法签名：

getDocByVal(document,name,val)

简要描述：

• 根据某个字段的值获取包含该值的Document

参数：

参数传入示例

document:
<root>
  <b count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </b>
</root>
name: b2
val:a

函数调用示例

Document doc = getDocByVal(document,"b2","a");
return doc;   //该操作将替换原有docment内容

函数返回说明

返回示例

<root>
  <b>
  <row>
    <b2>a</b2>
    <b1>1</b1>
  </row>
</b>
</root>

备注

• 无

1.1.2. 根据字段拆分document

方法签名：

splitDocByName(document, name)

简要描述：

• 根据某个字段的拆分document

参数：

参数传入示例

document:
<root>
  <b count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </b>
</root>
name: b2

函数调用示例

import java.util.List;
List<Document> docList = splitDocByName(document,"b2");

函数返回说明

返回示例

docList.get(0):
<root>
  <b>
  <row>
    <b2>a</b2>
    <b1>1</b1>
  </row>
</b>
</root>
docList.get(1):
<root>
  <b>
  <row>
    <b2>b</b2>
    <b1>1</b1>
  </row>
</b>
</root>

备注

• 无

1.1.3. 获取webservice适配器返回值

方法签名：

getWsResult(document)

简要描述：

• 使用了Webservice适配器以后，如果返回值不满足格式不能被合并到document中，那么可以使用该方法获取Webservice适配器的返回值

参数：

返回值说明

使用例子

//事先的Webservice适配器调用后返回了字符串“hello world”
String wsResult = getWsResult(document);
println wsResult;

输出结果

hello world

备注

• 无

1.1.4. 创建以root为根节点的document

方法签名：

buildDoc()

简要描述：

• 快速生成以root为根节点的document

参数：

参数传入示例

函数调用示例

Document doc = buildDoc();
return doc;  //此操作将把当前document对象替换为doc

函数返回说明

返回示例

<root dee_isNull=true>
</root>

备注

• 无

1.1.5. 获取document根节点

方法签名：

getRootElement(document)

简要描述：

• 获取document根节点

参数：

参数传入示例

document:
<root>
  <b count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </b>
</root>

函数调用示例

Element root = getRootElement(document);
if(root != null){
  for(Element e:root.getChildren()){
   if(e == null) continue;
    println "表名:"+e.getName();     //循环打印根节点下的所有表名
  }
}

函数返回说明

返回示例

备注

• 无

1.1.6. 创建Element节点

方法签名：

buildElement(document, name)

简要描述：

• 创建Element节点

参数：

参数传入示例

document:
<root>
  <b count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </b>
</root>
name: table1

函数调用示例

Element e = buildElement(document, "table1");
if(e != null){
 println "节点信息:"+e.toString(); //打印返回节点信息
}

函数返回说明

返回示例

<table1 dee_isNull="true"></table1>

备注

• 无

1.1.7. 获取Element所有子节点

方法签名：

getAllChildOfElement(element)

简要描述：

• 获取element的所有子节点

参数：

参数传入示例

element:
<root>
  <b count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </b>
</root>

函数调用示例

Element root = getRootElement(document);  //获取document的根节点
if(root != null){
    List<Element> chds = getAllChildOfElement(root); //获取root节点的子节点
    for(Element e:chds){
        if(e == null) continue;
        println "节点信息"+e.toString();
  }
}

函数返回说明

返回示例

备注

• 无

1.1.8. 根据名称获取Element子节点

方法签名：

getChildByName(element, name)

简要描述：

• 根据名称获取element的子节点

参数：

参数传入示例

element:
<root>
  <t1 count=2 totalCount=2>
    <row>
      <b2>a</b2>
      <b1>1</b1>
    </row>
    <row>
      <b2>b</b2>
      <b1>1</b1>
    </row>
  </t1>
  <t2 count=1 totalCount=1>
    <row>
      <b2>c</b2>
      <b1>2</b1>
    </row>
  </t2>
</root>
name: t2

函数调用示例

Element root = getRootElement(document);
if(root != null){
    Element e = getChildByName(root, "t2"); //获取根节点下节点名为t2的子节点
    if(e != null){
        println "节点"+e.toString();
    }
}

函数返回说明

返回示例

示例中e:
  <t2 count=1 totalCount=1>
    <row>
      <b2>c</b2>
      <b1>2</b1>
    </row>
  </t2>

备注

• 无

1.1.9. 设置Element的值

方法签名：

setVal2Element(element, value)

简要描述：

• 设置Element对象的value

参数：

返回值说明

使用例子

Element id = document.getRootElement().getChild("table").getChild("row").getChild("id");//获取名称为id的Element节点
setVal2Element(id, "yangyu");//设置名称为id的Element节点的value为“yangyu”

使用方法之前输出结果

<root>
  <table count=1 totalCount=1>
    <row>
      <name>a</name>
      <id>1001</id>
    </row>
  </table>
</root>

输出结果

<root>
  <table count=1 totalCount=1>
    <row>
      <name>a</name>
      <id>yangyu</id>
    </row>
  </table>
</root>

备注

• 无

1.1.10. 获取Element的值

方法签名：

getElementValue(element)

简要描述：

• 获取Element对象的value值

参数：

返回值说明

使用例子

Element id = document.getRootElement().getChild("table").getChild("row").getChild("id");//获取名称为id的Element节点
println getElementValue(id);//打印名称为id的Element节点的value

输出结果

1001

备注

• 无

1.1.11. 根据xml生成document

方法签名：

createDocByXml(xml)

简要描述：

• 根据xml字符串生成document对象

参数：

返回值说明

使用例子

String xml = "<root><table><row><name>yangyu</name></row></table></root>";//xml格式的字符串
createDocByXml(xml);//生成document

输出结果

<?xml version=1.0 encoding=UTF-8?>
<root>
<table>
  <row>
    <name>yangyu</name>
  </row>
</table>
</root>

备注

• 无

1.1.12. 合并document

方法签名：

mergeDoc(document1,document2)

简要描述：

• 将两个不同的document合并为一个document

参数：

返回值说明

使用例子

String xml = "<root><table><row><name>yangyu</name></row></table></root>";
Document doc1 = createDocByXml(xml);//创建第一个document
String xml1 = "<root><table2><row><sex>男</sex></row></table2></root>";
Document doc2 = createDocByXml(xml1);//创建第二个document
mergeDoc(doc1,doc2);//将两个document合并

输出结果

<root>
  <table count=1 totalCount=1>
    <row>
      <name>yangyu</name>
    </row>
  </table>
  <table2 count=1 totalCount=1>
    <row>
      <sex>男</sex>
    </row>
  </table2>
</root>

备注

• 无

1.1.13. 根据名称获取参数值

方法签名：

getParaByName(document,name)

简要描述：

• 根据指定名称获取参数值

参数：

返回值说明

使用例子

setParam(document, "myName", "yangyu");//设置参数
println getParaByName(document,"myName");//获取参数值

输出结果

yangyu

备注

• 无

1.1.14. 添加参数

方法签名：

setParam(document, name, value)

简要描述：

• 向当前DEE任务的参数容器中添加参数，添加了参数以后，后续的任何适配器都可以使用该参数

参数：

返回值说明

使用例子

setParam(document, "myName", "yangyu");//添加了名称为“myName”的参数
println getParaByName(document,"myName");//获取参数值

输出结果

yangyu

备注

• 无

1.1.15. 根据字段值获取row集合

方法签名：

getRowListByVal(document, name, val)

简要描述：

• 根据指定的字段名称、字段值，获取document包含该字段并且值相同的数据行集合

参数：

返回值说明

使用例子

List<Element> rows = getRowListByVal(document, "name", "yangyu");//获取所有包含“name”字段，并且值为“yangyu”的数据行集合
for(Element row : rows){//循环并打印集合内容
  println getChildByName(row, "id").getValue();
}

document数据内容

<root>
<table>
  <row>
    <name>yangyu</name>
    <id>111</id>
  </row>
  <row>
    <name>yangyu</name>
    <id>222</id>
  </row>
  <row>
    <name>yangyu</name>
    <id>333</id>
  </row>
</table>
</root>

输出结果

111
222
333

备注

• 无

1.1.16. 根据xml文件创建document

方法签名：

createDocByFile(path)

简要描述：

• 根据文件创建document，但要求文件内容必须是XML格式的数据

参数：

返回值说明

使用例子

createDocByFile("/Users/yangyu/Downloads/dee.xml");//读取dee.xml中的数据，并且生成document

文件内容

<root><table><row><name>yangyu</name><sex>nan</sex></row></table></root>

输出结果

<?xml version=1.0 encoding=UTF-8?>
<root>
<table>
  <row>
    <name>yangyu</name>
    <sex>nan</sex>
  </row>
</table>
</root>

备注

• 无

1.1.17. 获取FormData数据(3.1+)

方法签名：

formDataToDoc()

简要描述：

• 直接将A8开发高级中传过来的FormData参数转换成为Document对象
• 如果该任务用于A8开发高级调用，A8开发高级会将表单数据传入DEE任务的参数容器中，名称为“FormData”
• 通过该方法，可以直接将参数容器中的“FormData”数据转换为Document对象，供后续适配器使用

参数：

返回值说明

使用例子

formDataToDoc();//将FormData参数转换成为Document对象

输出结果

<?xml version=1.0 encoding=UTF-8?>
<root formName=表单名>
<formmain_0012>
  <row>
    <id>4937605540874345548</id>
    <state>1</state>
    <start_member_id>901373261631474415</start_member_id>
    <start_date>2016-12-13 13:36:06.5</start_date>
    <approve_member_id>0</approve_member_id>
    <approve_date>2016-12-13 13:36:10.642</approve_date>
    <finishedflag>0</finishedflag>
    <ratifyflag>0</ratifyflag>
    <ratify_member_id>0</ratify_member_id>
    <ratify_date/>
    <sort>0</sort>
    <modify_member_id>901373261631474415</modify_member_id>
    <modify_date>2016-12-13 13:36:06.0</modify_date>
    <field0001 display=编号>123</field0001>
    <field0002 display=填写日期>123</field0002>
    <field0003 display=姓名>123</field0003>
    <field0004 display=部门>123</field0004>
    <field0005 display=岗位职务>123</field0005>
    <field0006 display=印章名称-公章>123</field0006>
    <field0007 display=印章名称-合同专用章>123</field0007>
    <field0008 display=印章名称-法人代表名章>123</field0008>
    <field0009 display=印章名称-财务专用章>123</field0009>
    <field0010 display=印章名称-发票专用章>123</field0010>
    <field0011 display=用印文件名称>123</field0011>
    <field0012 display=用印文件数量>123</field0012>
    <field0013 display=用印文件电子文档>123</field0013>
    <field0014 display=用印文件重要程度>123</field0014>
    <field0015 display=用印文件用途>123</field0015>
    <field0016 display=部门负责人意见>123</field0016>
    <field0017 display=行政部门意见>123</field0017>
    <field0018 display=部门分管领导意见>123</field0018>
    <field0019 display=总经理意见>123</field0019>
    <field0020 display=印章使用记录-用印日期>123</field0020>
    <field0021 display=印章使用记录-文件份数>123</field0021>
    <field0022 display=印章使用记录-用印数量>123</field0022>
    <field0023 display=印章使用记录-操作人>123</field0023>
    <field0024 display=印章使用记录-说明>123</field0024>
  </row>
</formmain_0012>
</root>

备注

• 无

1.1.18. 获取REST适配器返回值(3.1+)

方法签名：

getRestResult(document)

简要描述：

• 获取REST适配器返回值
• REST会尝试将返回值转换成为Document对象，如果返回值不符合Document对象格式，那么就需要使用该方法来获取返回值

参数：

返回值说明

使用例子

getRestResult(document);//直接获取REST适配器返回值

输出结果

备注

• 无

1.1.19. 转换表字段为List(3.1SP2+)

方法签名：

docToListMapByTable(document,tableName)

简要描述：

• 将document内的表字段转化为List集合

参数：

返回值说明

使用例子

List<Map<String, String>> list = docToListMapByTable(document,"person");

输出结果

[[name:tom, id:1], [name:may, id:2]]

备注

• 无

1.1.20. 转换document为Map(3.1SP2+)

方法签名：

docToListMapByAll(document)

简要描述：

• 将document内的所有表转化为Map集合

参数：

返回值说明

使用例子

Map<String, List<Map<String, String>>> map = docToListMapByAll(document);

输出结果

[person:[[name:tom, id:1], [name:may, id:2]]]

备注

• 无

1.1.21. 根据XPath获取一个字段值(3.1SP2+)

方法签名：

getValByXPath(document,path)

简要描述：

• 根据XPath路径获取document的某个字段值(必须指定行号)

参数：

返回值说明

使用例子

String id = getValByXPath(document,"/root/person/row[1]/id");

输出结果

1

备注

• 无

1.1.22. 根据XPath获取一列字段值(3.1SP2+)

方法签名：

getValByXPath(document,path)

简要描述：

• 根据XPath路径获取document的某个字段这一列的值

参数：

返回值说明

使用例子

List<String> ids = getListByXPath(document,"/root/person/row/id");

输出结果

[1, 2]

备注

• 无

1.1.23. 根据XPath设置一个节点值(3.1SP2+)

方法签名：

setValByXPath(document,path,val);

简要描述：

• 根据XPath路径设置document的某个字段的值(必须指定行号)

参数：

返回值说明

使用例子

setValByXPath(document,"/root/person/row[1]/id", "test");

输出结果

备注

• 无

1.2. 数据源函数

1.2.1. 执行存储过程(3.1+)

方法签名：

exeProcedure(sourceName, procedureName, inMap, outMap)

简要描述：

• 使用该方法可以调用数据库存储过程

参数：

返回值说明

使用例子

def inMap = [1:"2"];
def outMap = [2:"count",103:"res"];
exeProcedure("oracle", "test_select", inMap, outMap);//调用名称为“test_select”的存储过程，传入输出参数：2，输出参数：count、res(游标输出参数位置+100所以位置设置的103)

输出结果

<root>
  <form count=3 totalCount=3>
    <row>
      <name>22</name>
      <id>2</id>
    </row>
    <row>
      <name>22</name>
      <id>3</id>
    </row>
    <row>
      <name>test</name>
      <id>1</id>
    </row>
  </form>
</root>

备注

• 上述结果的输出参数count结果可以在document的Parameters获取，参数名：proceduresOutParms。

  下面为上面调用的oracle存储过程：

  CREATE OR REPLACE 
  procedure
  test_select(i_id in varchar, o_count out number, o_cur out sys_refcursor)
  as
  begin
  select count(*) into o_count from "test";
  open o_cur for
    select * from "test";
  end;
  

1.2.2. 根据名称获取数据源

方法签名：

getDsByName(name)

简要描述：

• 根据名称获取数据源

参数：

返回值说明

使用例子

import java.sql.ResultSet;
import java.sql.Statement;
import java.sql.Connection;
import java.sql.SQLException;
import com.seeyon.v3x.dee.resource.DbDataSource;
DbDataSource ds = getDsByName("local"); //获取数据源
Connection connection = ds.getConnection();//获取连接
Statement stmt = null;
ResultSet rs = null;
String sql = "select * from test";//sql
try {
  stmt = connection.createStatement();
  rs = stmt.executeQuery(sql);//执行sql，并获取返回值
  while(rs.next()){
    println(  rs.getObject("id"))//打印返回值中所有“id”字段的值
  }
} catch (SQLException e) {
    throw e;
}finally{//释放资源，必须要做
  rs.close();
  stmt.close();
  connection.close();
}

输出结果

1001
1002
1003
1004

备注

• 无

1.2.3. 执行SQL语句(3.1SP2+)

方法签名：

excuteBySQL(sourceName, sql);

简要描述：

• 执行增删改类型的sql

参数：

返回值说明

使用例子

int num = excuteBySQL("local_mysql", "delete from person");

输出结果

2

备注

• 无

1.3. 开发高级函数

1.3.1. 设置开发高级字符串

方法签名：

setHighSetStr(document,status,ispop,reason,remark)

简要描述：

• 使用A8开发高级时，如果要使用阻塞模式，那么必须要使用此方法设置返回值
• 该方法用于控制A8表单调用DEE任务时是否弹窗阻塞流程或者不阻塞流程

参数：

返回值说明

使用例子

setHighSetStr(document,"F","Y","需要阻塞A8流程","");//这个列子就代表了需要弹窗并且阻塞A8流程，并且A8弹出窗口上显示的是“需要阻塞A8流程”

输出结果

<root>
  <deeblockrtn count=1 totalCount=1>
    <row>
      <deestatus>F</deestatus>
      <dialogispop>Y</dialogispop>
      <reason>需要阻塞A8流程</reason>
      <remark></remark>
    </row>
  </deeblockrtn>
</root>
可以看到输出的document中多了一张名叫deeblockrtn的表，而A8就是通过这张表的数据来判断是否需要阻塞流程

备注

• 无

1.4. 调试函数

1.4.1. 调试

方法签名：

debug(lineNum,name,val)

简要描述：

• 使用弹出窗口显示所调式变量在任务运行到调试函数时的值
• 该函数只有在DEE可视化配置工具中有效，在A8中运行时自动无效

参数：

返回值说明

使用例子

String str = "hello world";
debug("2","str",str);
str = "hello everyone";

输出结果

参数名称：str
脚本名称：script
参数行数：2
参数值：hello world

备注

• 无

1.4.2. 中断任务(3.1+)

方法签名：

interruptTask()

简要描述：

• 使用该函数以后，当前脚本执行完成后自动终止任务

参数：

返回值说明

使用例子

if(false){
  println "成功";
}
else{
  interruptTask();  
}
println "ok";

输出结果

ok

备注

• 注意：设置该函数后，该脚本的后续代码块会继续执行。该脚本执行完后任务将终止后续的适配器不会执行。

1.4.3. 日志打印(3.1SP1+)

方法签名：

printlnLog(msg)

简要描述：

• 将信息记录到日志文件当中

参数：

返回值说明

使用例子

printlnLog(msg);

输出结果

备注

• 无。

1.4.4. FormData模拟数据(3.1+)

方法签名：

getTestFormData(sourceName, formId)

简要描述：

• 在使用开发高级时，数据都是A8通过FormData这个参数传递进DEE里面
• 而在DEE可视化配置工具中配置任务时，无法得到该参数
• 而在后续需要使用到FormData的时候，不知道该格式是什么样子
• 所以提供模拟函数，模拟A8将FormData放入DEE中，方便在DEE可视化配置工具中调试任务
• 该方法只在DEE可视化配置工具中生效，在A8运行环境中不生效
• 所以使用该方法后，在将任务导入到A8当中，A8开发高级会传入带有正确数据的FormData

参数：

返回值说明

使用例子

getTestFormData("a8", "-8848292964178769632");//模拟FormData数据，数据源名称为“a8”，表单id为“-8848292964178769632”

输出结果

会看到DEE参数中多了一个FormData参数

备注

• 无

1.5. 时间函数(3.1+)

1.5.1. 当前时间

方法签名：

date_now()

简要描述：

• 获取当前系统时间

参数：

返回值说明

使用例子

println(date_now());

输出结果

2016-12-26 14:38:53

备注

• 无

1.6. 字符串操作函数(3.1+)

1.6.1. 分割字符串

方法签名：

str_split(str,separator)

简要描述：

• 通过指定字符串分割原字符串

参数：

返回值说明

使用例子

String str = "hello#world#everyone";
String[] stringList = str_split(str,"#");
for(String s : stringList){
  println(s);
}

输出结果

hello
world
everyone

备注

• 无

1.6.2. 截取字符串

方法签名：

str_sub(str,fromIndex,toIndex)

简要描述：

• 截取指定长度，任意位置的字符串

参数：

返回值说明

使用例子

String str = "hello world";
int length = str.length();
println(str_sub(str,0,0)); //两个值相同，那么返回值固定为“”
println(str_sub(str,0,length));//截取所有
println(str_sub(str,0,5));//截取0到5的字符，不包含第5个字符

输出结果

                //第一个截取为“”
hello world     //截取所有
hello           //截取0到5

备注

• 无

1.6.3. 字符串是否为空

方法签名：

str_isEmpty(str)

简要描述：

• 判断字符串是否为空

参数：

返回值说明

使用例子

String str = "";
println(str_isEmpty(str));

输出结果

true

备注

• 无

1.6.4. 是否以指定字符串开头

方法签名：

str_startWith(str,prefix,isIgnoreCase)

简要描述：

• 是否以指定字符串开头

参数：

返回值说明

使用例子

String str = "Hello world";
String prefix = "hello";
println(str_startWith(str,prefix,true));

输出结果

true

备注

• 无

1.7. 数学计算(3.1+)

1.7.1. 数字金额大小写转换

方法签名：

math_digitUppercase(number)

简要描述：

• 将数字的金额转换为中文大写数字

参数：

返回值说明

使用例子

println(math_digitUppercase(33333));

输出结果

叁万叁仟叁佰叁拾叁元整

备注

• 无

1.7.2. 加法

方法签名：

math_add(number1, number2)

简要描述：

• 加法算数运算，不丢失精度

参数：

返回值说明

使用例子

println math_add(11.333, 22.444);

输出结果

33.777

备注

• 无

1.8. 日志管理(3.1+)

1.8.1. 日志清理

方法签名：

clearLogs(day)

简要描述：

• 用于清理指定天数前的日志

参数：

返回值说明

使用例子

int day = 30;
clearLogs(30); //会清理30天前的日志

备注

• 无