O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 O2OA(翱途)开发平台如何基于nginx上下文分发的方式快速集群部署
  • 6.2 系统架构-平台集群化部署之基于Nginx端口分发机制实现集群部署
  • 6.3 系统架构-基于nginx快速集群部署-上下文分发
  • 6.4 安装部署-在Windows系统中部署O2OA开发平台
  • 6.5 安装部署-在Linux系统中部署O2OA开发平台
  • 6.6 安装部署-在宝塔/PHPStudy中部署O2OA开发平台
  • 6.7 安装部署-O2OA开发平台之HTTP端口规划
  • 6.8 安装部署-平台服务器版本升级操作说明
  • 6.9 安装部署-私有化部署服务器架构推荐
  • 6.10 安装部署-O2OA开发平台集群部署配置及操作说明
  • 6.11 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.12 服务器配置与管理-​O2OA主要配置文件说明
  • 6.13 服务器配置与管理-服务器端口冲突和端口修改
  • 6.14 服务器配置与管理-如何修改服务器内存占用率?
  • 6.15 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.16 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.17 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.18 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.19 服务器配置与管理-O2OA开发平台平台数据库配置信息样例
  • 6.20 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.21 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.22 服务器配置与管理-文件存储服务器配置
  • 6.23 服务器配置与管理-工作日节假日配置
  • 6.24 服务器配置与管理-为平台增加全文检索功能
  • 6.25 服务器配置与管理-消息提醒配置说明
  • 6.26 服务器配置与管理-自定义消息提醒
  • 6.27 服务器配置与管理-定制消息通知的内容
  • 6.28 服务器配置与管理-消息通知过滤
  • 6.29 服务器配置与管理-为待办创建配置邮件通知
  • 6.30 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.31 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.32 服务器配置与管理-数据导出导入与系统数据备份
  • 6.33 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.34 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.35 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.36 系统安全-访问日志相关配置
  • 6.37 系统安全-审计日志相关配置
  • 6.38 系统安全-平台日志文件说明
  • 6.39 系统安全-O2OA日志输出设置log4j2.xml
  • 6.40 系统安全-用户密码初始化规则的设定
  • 6.41 系统安全-启用HTTPS(百度云版)
  • 6.42 系统安全-启用HTTPS(腾讯云版)
  • 6.43 系统安全-自签名SSL证书验证HTTPS功能
  • 6.44 系统安全-登录密码RSA加密
  • 6.45 系统安全-用户登录IP限制
  • 6.46 系统安全-在用户登录过程中启用图形验证码
  • 6.47 系统安全-平台部署之使用非root用户运行服务
  • 6.48 系统安全-O2Server启用国密加密设置
  • 6.49 系统安全-日志应用使用说明
  • 6.50 系统安全-用户重置密码操作
  • 6.51 系统安全-超级管理员(xadmin)密码修改
  • 6.52 系统安全-使用Web端运行服务器管理命令
  • 6.53 系统安全-o2server无法正常显示验证码解决办法
  • 6.54 O2OA(翱途)开发平台前端安全配置建议(一)
  • 第16章 开发知识及常见问题
  • 16.1 如何替换登录页面二维码中默认的logo图标
  • 16.2 O2OA(翱途)流程引擎中如何修改,定制流程的流转记录
  • 16.3 mysql数据库备份
  • 16.4 domain不正确的时候如何强制设置成正确的
  • 16.5 配置文件中使用密文存储密码
  • 16.6 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.7 常见问题-查看表结构
  • 16.8 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.9 linux环境libreoffice安装及使用
  • 16.10 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.11 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.12 藕粉社区问答系列1
  • 16.13 藕粉社区问答系列2
  • 16.14 藕粉社区问答系列3
  • 16.15 快速入门-平台相关资料汇总
  • 16.16 快速入门-服务器总体介绍汇总
  • 16.17 快速入门-流程表单载入基础数据
  • 16.18 快速入门-常用表单脚本样例汇总
  • 16.19 快速入门-自定义表数据分页样例
  • 16.20 OEM白标-如何修改平台中的Logo图标和文字
  • 16.21 云服务器-阿里云ECS服务器的端口启用
  • 16.22 开发知识-React篇:在O2OA平台框架中使用React
  • 16.23 开发知识-React篇:在O2OA门户页面中使用React
  • 16.24 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.25 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.26 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.27 平台中使用Druid数据库连接及监控
  • 16.28 开发知识-在PAAS平台上部署O2OA开发平台
  • 16.29 开发知识-如何使用Tomcat架设webdav服务器
  • 16.30 开发知识-单个端口模式的Nginx和系统配置
  • 16.31 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.32 开发知识-O2OA平台启用Eruda进行移动端调试
  • 16.33 开发知识-神通数据库安装
  • 16.34 开发知识-人大金仓数据安装
  • 16.35 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.36 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.37 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.38 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.39 开发知识-数据优化知识点
  • 16.40 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.41 消息队列-配置activeMQ、kafka消息队列
  • 16.42 常见问题-数据导出或者导入时发生OOM异常
  • 16.43 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 16.44 常见问题-如何在模块部署中控制模块的访问权限
  • 16.45 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.46 常见问题-如何使用服务管理调用WebService
  • 16.47 常见问题-如何使用脚本调用外部服务
  • 16.48 常见问题-如何使用脚本控制流程自动流转
  • 16.49 常见问题-如何通过脚本调用系统内服务
  • 16.50 常见问题-接口代码疑惑解答汇总
  • 16.51 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.52 常见问题-集群配置后启动报错:NullPointerException
  • 16.53 常见问题-服务器错误:can not decrypt token
  • 16.54 常见问题-IOS移动办公无法收到验证码
  • 16.55 常见问题-服务器和日志时间相差12小时的问题
  • 16.56 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.57 藕粉社区问答系列4
  • 16.58 开发知识-React篇:在React应用中集成O2OA

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

    时间:2023-03-22   

    O2OA提供的服务管理中心可以让用户使用Javascript语言自由编写脚本的处理逻辑来实现与第三方的数据交互,数据同步以及系统内的数据处理等工作,也可以编写系统内的定时任务脚本。本文主要介绍O2OA系统定时代理和接口的脚本编写。

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

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

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

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

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

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


    前端脚本

    视图列

    流程事件

    接口和代理

    运行环境

    浏览器

    服务器端

    服务器端

    服务器端

    访问DOM对象

    允许

    不允许

    不允许

    不允许

    使用JAVA

    不允许

    不允许

    允许

    允许

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

    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

    控制台输出打印 - print()

    分等级控制台输出 - console

    方法定义 - define()

    服务调用 - Actions

    组织查询 - org

    脚本引用 - include()

    数据字典 - Dict

    数据表执行 - Table

    查询视图执行 - statement

    视图执行 - view

    通用service调用 - service

    当前用户全称 - currentPerson

    2、服务管理api

    服务的响应对象 - response

    消息体的文本内容 - requestText


    image (2).png

    四、调用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

    请注意,V7.2之前端口为20030:

    http://centerserver:20030/x_program_center/jest/list.html

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

    x_processplatform_assemble_surface

    流程平台相关服务

    x_portal_assemble_surface

    门户平台相关服务

    x_cms_assemble_control

    内容管理平台相关服务

    x_query_assemble_surface

    数据平台相关服务

    x_organization_assemble_express

    组织架构相关服务

    x_file_assemble_control

    云文件相关服务

    x_meeting_assemble_control

    会议管理相关服务

    x_bbs_assemble_control

    论坛相关服务

    x_calendar_assemble_control

    日程管理相关服务

    x_hotpic_assemble_control

    热点信息相关服务

    x_mind_assemble_control

    脑图模块相关服务

    x_organization_assemble_personal

    个人设置相关服务

    x_attendance_assemble_control

    考勤模块相关服务

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

    1577262052477-dbc9a166-7c1e-4189-97f8-d4cb6c728be9.png

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

    1577262054827-37a31e23-fb06-4207-81bc-776cc930c52d.png

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

    /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地址或者域名。

    请注意,V7.2之前端口为20020:

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

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

    具体请查看API的org章节



    logo_all@1.5x.png


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


    上一篇:服务管理-简介

    下一篇:没有了!