服务管理-定时代理和接口的脚本编写

一、前后端脚本的一些差异

O2OA中复杂的应用通常需要通过Javascript来实现。根据运行环境的差异，分为前后端脚本。

前端脚本是运行在浏览器上的，本系统的前端脚本基于mootools来构建，遵循ECMAScript 5.1规范。

后端脚本运行在服务器上，基于JDK8标准的Nashorn，遵循ECMAScript 5.1规范。

前端脚本在本系统的WebAPI中有详细介绍，这里不再过多介绍。

后端脚本在视图列脚本、流程事件、接口和代理中都有使用，并且这些地方的上下文都有不同。

总结上表，我们在代理和接口的代码中可以使用的规则：

1、使用JavaScript语法来编写定时代理和接口的代码。

2、对o2oa的功能，可以调用后端api来进行调用。

3、另外，还可以调用Java类处理一些功能。

二、Jascript语法

我们通过下面的例子，可以看出这是典型的ECMAScript 5写法。

var appId = "6e075ac7-3eb3-436f-8ba1-e98f9b64349e"; //流程应用id
var process = "4cca966f-3682-45c8-bddc-f2980654dc5e"; //流程id

var data = JSON.parse(this.requestText); //通过api this.requestText获取外部传入的初始数据
data.application = appId;
data.process = process;

//通过api this.Actions加载流程服务根
var action = this.Actions.load("x_processplatform_service_processing"); 
action.WorkAction.assignCreate(//发起流程
    data,//body请求参数
    function (json) { //服务调用成功的回调函数, json为服务传回的数据
        print("流程启动返回的数据为="+JSON.stringify(json);  //在服务器控制台输出
        this.response.setBody("success!"); //通过api this.response来响应请求
    }.bind(this),
    function (json) { //服务调用失败的回调函数, json为服务传回的数据
        console.error("流程启动失败"); //在服务器控制台输出错误
        this.response.setBody(json);
    }.bind(this)
);

三、使用API（6.3及以后版本）

在6.3及以后版本，o2oa提供了后台API来编写脚本和代理。

打开地址：http://{hostname}/api，如：https://www.o2oa.net/api

我们在API中提供的功能如下：

1、通用后台api

2、服务管理api

四、调用JAVA类

//classString 为类名字符串，比如 "java.util.Calendar"
var Class = Java.type( classString );
var object = new Class();
//object.method()
或者
var object = new Class();
//比如 var simpleDateFormat = new java.text.SimpleDateFormat("yyyy-MM-dd hh:mm:ss");
样例:
获取当前日期后的第5天
function setDate(){
    var Date = java.util.Date();
    var Calendar = Java.type("java.util.Calendar");
    var GregorianCalendar = Java.type("java.util.GregorianCalendar");
    var now = new Date();
    var calendar = new GregorianCalendar();
    calendar.setTime(now);
    calendar.set(Calendar.DATE, calendar.get(Calendar.DATE) - Config.waitDay);
    return calendar.getTime();
}

五、V6.3版本之前的写法

在6.3版本之前的版本，我们还未提供后台api，可以通过以下方式进行脚本编写。

1、输出调试信息

var text = "在服务器控制台输出的消息"
print( text );

2、调用O2OA后台服务

服务查看和调试需要打开 http://centerserver/x_program_center/jest/list.html

本小节中的“服务根(serviceRoot)”如下：

查找method，后台服务有GETPOSTPUTDELET几种方法，可以在服务详情中找到，如下图：

本小节中的“路径(path)”，可以在服务详情中找到，如下图：

以上图的服务为例，最后拼接成下列两种路径均可使用

/jaxrs/work/workorworkcompleted/dcd8e168-2da0-4496-83ee-137dc976c7f6

或

work/workorworkcompleted/dcd8e168-2da0-4496-83ee-137dc976c7f6

GET方法

var applications = resources.getContext().applications();
//serviceRoot 服务根
//path 路径
applications.getQuery( serviceRoot, path );
//样例：
//已知work id为dcd8e168-2da0-4496-83ee-137dc976c7f6，获取work内容，并解析成JSON。
var applications = resources.getContext().applications();
var serviceRoot = "x_processplatform_assemble_surface";
var path = "work/workorworkcompleted/dcd8e168-2da0-4496-83ee-137dc976c7f6"
var resp = applications.getQuery( serviceRoot, path );
var json = JSON.parse( resp.toString() );

POST方法

var applications = resources.getContext().applications();
//serviceRoot 服务根
//path 路径
//string 数据字符串，json转字符串可以用 JSON.stringify( json )
applications.postQuery( serviceRoot, path, string );

样例：

已知发文流程的ID为“0b7c5c43-caa8-4789-a263-308508d44016”，发起人的dn是“张三@zhangsan@I”。需要发起一个流程。

查到发起流程的路径是“jaxrs/work/process/{processFlag}”。

var applications = resources.getContext().applications();
var serviceRoot = "x_processplatform_assemble_surface";
var path = "work/process/0b7c5c43-caa8-4789-a263-308508d44016";
var string = JSON.stringify({
    "latest" : false,
    "title" : "测试发文流程",
    "identity" : "张三@zhangsan@I",
    "data" : {  //业务数据
         "fileNoPrefix" : "xxx"  //文号冠字
    }
});
var resp = applications.postQuery( serviceRoot, path, string );
var json = JSON.parse( resp.toString() );

PUT方法

var applications = resources.getContext().applications();
//serviceRoot 服务根
//path 路径
//string 数据字符串，json转字符串可以用 JSON.stringify( json )
applications.putQuery( serviceRoot, path, string );

样例：

已知发文流程实例的work id为“0b7c5c43-caa8-4789-a263-308508d44016”，需要更新数据。

查到修改流程数据的路径是“jaxrs/data/work/{id}”。

var applications = resources.getContext().applications();
var serviceRoot = "x_processplatform_assemble_surface";
var path = "data/work/0b7c5c43-caa8-4789-a263-308508d44016";
var string = JSON.stringify({
    "subject" : "测试流程11",
    "fileNoPrefix" : "xxx1"
});
var resp = applications.putQuery( serviceRoot, path, string );
var json = JSON.parse( resp.toString() );

DELETE方法

var applications = resources.getContext().applications();
//serviceRoot 服务根
//path 路径
applications.deleteQuery( serviceRoot, path );

样例：

已知发文流程实例的work id为“0b7c5c43-caa8-4789-a263-308508d44016”，需要删除改流程实例。

查到删除流程实例的路径是“jaxrs/work/{id}”。

var applications = resources.getContext().applications();
var serviceRoot = "x_processplatform_assemble_surface";
var path = "work/0b7c5c43-caa8-4789-a263-308508d44016";
var resp = applications.deleteQuery( serviceRoot, path );
var json = JSON.parse( resp.toString() );

3、调用本系统服务管理中的接口

样例：现有一个名称为“sendSMS”的接口，接收的requestText为 "{ mobile : mobile, content : content }"

var CipherConnectionAction = Java.type('com.x.base.core.project.connection.CipherConnectionAction');
var Config = Java.type('com.x.base.core.project.config.Config');
var path = "invoke/sendSMS/execute";
var dataString = JSON.stringify({
    "mobile" : "13500000000",
    "content" : "测试短信内容"
});
var resp = CipherConnectionAction.post(false, Config.url_x_program_center_jaxrs() + path, dataString );
//var resp = CipherConnectionAction.post(false, Config.x_program_centerUrlRoot() + path, dataString );
var json = JSON.parse( resp.toString() );

4、调用外系统的服务

样例：现有一个外系统的服务，url为 'http://hostname/UnifiedWorkbench/ProcessTaskService'，接收的Content-type 为 'text/xml; charset=utf-8'

function sendRequest( xml ){
    try{
        print("发起请求:"+xml);
        var url =  'http://hostname/UnifiedWorkbench/ProcessTaskService'
        var ArrayList = Java.type('java.util.ArrayList');
        var heads = new ArrayList();
        var NameValuePair = Java.type('com.x.base.core.project.bean.NameValuePair');
        var p1 = new NameValuePair('Content-Type', 'text/xml; charset=utf-8');
        heads.add(p1);
        var HttpConnectionClass = Java.type('com.x.base.core.project.connection.HttpConnection');
        var resp = HttpConnectionClass.postAsString(url, heads, xml);
        print( "统一待办返回:"+ resp.toString());
    }catch(e){
        print("发送请求出错：");
        print(  e.printStackTrace() );
    }
}

5、人员组织操作

组织管理中包括人员、人员属性、组织、组织属性、身份、群组和角色。有两种方法可以进行组织管理的操作：

1、通过调用后台组织查询服务“x_organization_assemble_express”进行组织管理的操作。具体服务请查看

http://{applicationServer}/x_organization_assemble_express/jest/index.html

其中：{applicationServer}为部署的服务器IP地址或者域名。

2、你可以通过 this.org 获取组织中的人员、人员属性、组织、组织属性、身份、群组和角色。

具体请查看API的org章节

以上是对定时代理和接口脚本编写的描述，希望对您有帮助。如果您想进一步了解服务和接口，可以查看以下文章：
《服务管理-定时代理开发》
《服务管理-接口服务开发》
《后端脚本api》