O2OA教程
  • 概述
  • 安装管理及配置
    • 服务器主机推荐配置
    • 平台下载及安装部署
    • 平台升级操作说明
    • 平台基本能力介绍
    • 平台目录结构说明
    • 平台配置文件说明
    • O2OA与移动办公
      • 连接O2云使用APP
      • 集成到企业微信
      • 集成到阿里钉钉(DingTalk)
      • 配置绑定微信扫码登录
    • 平台数据库配置
      • 接入第三方数据库
      • 数据库驱动JAR包的更新或新增
      • 数据库配置信息样例
      • 访问和操作H2数据库
      • 清除废弃的业务数据
      • 压缩H2数据库
    • 平台存储库配置
    • 组织人员架构及管理
      • 密码管理
        • 管理员密码管理
        • 普通初始化密码
        • 用户重置密码
      • 组织架构,组织职位,组织属性
        • 组织架构创建过程
          • 顶组织创建
          • 下级组织创建
          • 组织管理设定
        • 组织职位管理
        • 组织职务意义与使用
      • 人员身份,人员属性
        • 人员信息创建
        • 人员与组织的关系(人员身份)
        • 人员数据导入
      • 角色管理
        • 内置角色介绍
        • 角色信息管理
      • 群组管理
      • 常用脚本
        • 人员信息
        • 组织信息
        • 群组信息
        • 角色信息
      • 数据同步接口
        • 人员数据接口
          • 新增用户
          • 修改用户
          • 删除用户
          • 修改用户密码
          • 修改汇报对象
        • 组织数据接口
          • 新增组织
          • 修改组织
          • 删除组织
    • O2OA集群部署
      • 非对称集群配置
    • 平台消息提醒配置
    • 平台审计日志配置
    • 平台工作日节假日配置
    • API接口服务
    • 启用HTTPS(SSL)
      • 自签名SSL证书验证HTTPS功能
    • SSO与单点认证
      • SSO配置
      • 约定密钥单点认证配置
      • SSO客户端程序
      • SSO服务端程序
    • 平台维护工具
      • 备份恢复数据
      • 自动执行数据备份与恢复
      • 待办
      • 已办
      • 待阅
      • 已阅
      • 流转中工作
      • 已完成工作
      • 授权管理
    • 相关数据表
    • 全文检索功能部署
    • 平台错误日志
      • 日志所在目录
      • 日志使用class
  • 业务开发与设计
    • 流程应用开发与设计
      • 流程开发设计入口
      • 应用创建及权限设置
      • 创建流程
        • 新建流程
        • 新建活动
        • 修改活动属性
        • 修改路由
        • 保存流程
        • 活动配置
        • 路由配置
      • 创建表单
        • 创建表单
        • 修改表单字段
        • 保存表单
      • 常用事件脚本说明
      • 数据字典配置
      • Excel数据导入数据网格(仅支持IE)
      • 流程实际样例需求准备
      • 流程应用的导出导入
      • 拆分流程样例
      • 流程服务调用环节使用
        • 服务地址URL动态参数
        • 自定义HTTP头信息
    • 内容管理与信息发布
      • 创建栏目
      • 创建分类
      • 创建表单
      • 设置表单
      • 栏目的权限
      • 分类的权限
      • 测试发布
      • 如何使用流程发布信息
        • 新建信息发布流程
        • 给分类配置信息发布流程
    • 门户管理与应用包装
      • 功能简介
      • 表单设计
      • 部件设计
      • 脚本开发
      • 数据源使用
      • 相关接口
      • 门户样例
      • 模板导入
      • 其他
    • 数据视图与数据统计
      • 视图
      • 数据表
      • 查询语句
    • 定时任务与服务接口
      • 前后端脚本的差异
      • 代理和接口的脚本编写
      • 代理
      • 接口
    • 系统交互样例
      • 登录认证 For Java
        • 发送用户账号密码进行登录认证
        • 发送用户名使用SSO进行登录认证
      • 流程控制 For Java
        • 启动一个新的流程实例(工单)
      • 外系统启动流程
      • 数据导出
        • 数字档案
    • 项目样例说明
      • 公文
    • 数据字典使用说明
    • 前端开发API说明
      • 业务数据 - Object: data
      • 流程实例 - Object: workContext
      • 内容管理实例 - Object: documentContext
      • 组织架构管理 - Object: org
        • 人员信息: person 操作
        • 人员属性: personAttribute操作
        • 组织信息: unit操作
        • 组织职务: unitDuty
        • 组织属性: unitAttribute
        • 身份信息: identity
        • 角色信息: role
        • 群组信息: group
  • 平台内置应用介绍
    • 会议管理
    • 日程安排
    • 个人文件
    • 执行力管理
    • 考勤管理
    • 论坛管理
    • 办公中心
    • 脑图管理
    • 系统应用权限控制
  • 源码的编译及管理
    • 服务器源码编译
    • 移动端源码介绍
      • Android端编译打包处理
      • IOS端打包处理
    • 平台程序调试方法
      • 前端代码调试定位
      • 后端代码的远程调试
  • 常见问题
    • H2数据库异常修复
    • O2OA平台异常
      • 阿里云ECS服务器的端口启用
      • IOS移动办公无法收到验证码
      • 集群配置
    • 数据导出或者导入时发生OOM异常
    • 服务器错误
Powered by GitBook
On this page
  • 概述
  • API总览
  • 嵌入脚本
  • 样例

Was this helpful?

  1. 业务开发与设计

前端开发API说明

主要介绍前端API,代码示例及写法,同步API文档:http://www.o2oa.net/x_desktop/portal.html?id=dcd8e168-2da0-4496-83ee-137dc976c7f6

Previous数据字典使用说明Next业务数据 - Object: data

Last updated 5 years ago

Was this helpful?

概述

  • O2OA 是一个高度可定制化的企业级办公平台,您可以通过脚本语言扩展平台功能。

  • O2OA 脚本基于Javascript语法,您可以通过脚本访问和操作允许的DOM对象;也可以通过平台定义的API操作业务数据、组织、视图等各种对象。脚本可以在后端(服务器端)和前端(浏览器端)执行。定义在流程中的脚本在后端执行;定义在表单等其他地方的脚本在前端执行。

  • 后端脚本基于JDK8标准的Nashorn,遵循ECMAScript 5.1规范。前端脚本基于您使用的浏览器的Javascript引擎。

API总览

对象

业务数据(data)

流程实例(workContext)

内容管理实例(documentContext)

组织(org)

流程表单(form)

页面(page)

视图(view)

数据字典(Dict)

Action(Action)

引用(include)

方法定义(define)

session(session)

服务

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.json

考勤模块相关服务

嵌入脚本

  • O2OA 可在多个位置嵌入脚本代码,用于扩展平台和实现自定义功能。嵌入脚本代码分为前端执行代码和服务端执行代码,两者语法一致,在某些方法和对象的调用上略微有所区别,在后续文档中会一一说明。  可嵌入脚本位置和说明如下表:

表单 页面

名称: 表单和页面元素事件

说明: 流程平台和内容平台的表单和门户平台的页面中,每个设计元素包含多种事件,包括DOM对象原生事件和O2平台扩展事件。

执行: 前端执行,基于浏览器

名称: 表单和页面可编辑元素默认值

说明: 流程平台和内容平台的表单和门户平台的页面中,可编辑元素或文本元素的默认值可以通过脚本指定。

执行: 前端执行,基于浏览器

名称: 表单和页面元素的部分属性

说明: 流程平台和内容平台的表单和门户平台的页面中,有许多元素的相关属性可以通过脚本来定义。如:下拉框、单选多选按钮的可选值、人员字段的选择范围、区段依据等。

执行: 前端执行,基于浏览器

名称: 表单可编辑元素校验

说明: 流程平台的表单中,可编辑的字段可以通过脚本进行有效性校验,校验通过返回true,不通过返回提示信息。

执行: 前端执行,基于浏览器

名称: 表单可编辑元素区段依据

说明: 流程平台的表单中,可编辑的字段可使用区段数据,区段数据依据可通过表单指定

执行: 前端执行,基于浏览器

名称: 脚本

说明: 流程平台、门户平台和内容管理平台中,都有脚本设计元素,可以在此创建自己的脚本库。

执行: 由调用脚本位置决定运行环境

流程

名称: 流程活动事件

说明: 流程平台每个活动都有相关事件可以编写脚本,如:工作到达前后、待办执行前后等。

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 流程事件

说明: 流程平台每个流程都有四个事件可以编写脚本:流程启动前后和流程结束前后。

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 脚本活动

说明: 流程平台的脚本活动,用于自动执行脚本

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 服务调用活动

说明: 流程平台的服务调用活动,可以配置WebService和Restful服务,可通过脚本定义参数、消息体和响应。

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 选择并行节点路由条件

说明: 流程平台的选择活动和并行活动的路由可以编写一个返回true或false的脚本,来决定路由走向。

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 流程和活动的相关人员

说明: 流程平台中,流程和活动的相关人员可以通过脚本指定,如:处理人、阅读人、管理者等

执行: 服务器端执行,基于ECMAScript 5.1规范

视图

名称: 视图列显示

说明: 数据平台中,视图列的显示值可通过脚本指定,仅用于前端展现,不能作用于统计。

执行: 服务器端执行,基于ECMAScript 5.1规范

服务管理

名称: 代理配置

说明: 服务管理中可设置定时运行任务,称之为代理。通过脚本实现功能。

执行: 服务器端执行,基于ECMAScript 5.1规范

名称: 接口配置

说明: 服务管理中可设置Restful的web服务,称之为接口。通过脚本实现功能。

执行: 服务器端执行,基于ECMAScript 5.1规范

样例

  • 这是一个简单的样例,用于展现脚本如何编写和运行。

  • 本例中我们要实现一个表单中,两个下拉框从配置数据中获取可选数据,以及实现联动。

  • 我们需要创建一个流程应用,一个表单以及一个数据字典。在表单中创建两个下拉列表框。

3、在category1和category2两个下拉框的可选值脚本如下:  

category1的可选值脚本
var dict = new this.Dict("category"); //获取名为category的数据字典
var categoryList = dict.get(); //获取数据字典
var options = Object.keys(categoryList); //获取大类,赋值给options变量
options.unshift("(请选择大类)|"); //在options数组首位插入提示选项,并将“”作为value,“(请选择大类)”作为text
return options; //返回列表,作为列表框的可选值  
category2的可选值脚本
var dict = new this.Dict("category"); //获取名为category的数据字典
var categoryList = dict.get(this.data.category1); //获取数据字典,以下拉框category1的值为关键字的数据值(数组)
return categoryList; //返回列表,作为列表框的可选值

 4、在category1的change事件中添加如下代码:

//获category2下拉框,并刷新可选项
this.form.get("category2").resetOption(); 

 5、设计数据字典如下图,并命名为:"分类配置",别名为:“category”。  

6、预览表单,即可看到大类下拉框中选项为数据字典中的第一层数据,选择不同的大类可与小类下拉框实现联动。

1、先在表单中创建两个下拉框  

2、在category1和category2两个下拉框的属性中,选择通过“脚本”编辑可选值。category1category2  

业务数据 - Object: data
流程实例 - Object: workContext
内容管理实例 - Object: documentContext
组织架构管理 - Object: org