myApps柔性定制平台开发者手册.doc

myAppsmyApps柔性定制平台柔性定制平台 开发者手册开发者手册 版本版本2.52.5 广州市天翎网络科技有限公司版权所有广州市天翎网络科技有限公司版权所有 广州市天翎网络科技有限公司 myApps 开发者手册 第 2 页 目目 录录 1 1 MYAPPSMYAPPS 产品介绍产品介绍 .5 5 1.1MYAPPS开发平台概述 .5 1.1.1工作流核心概念介绍.5 1.1.2动态表单核心技术介绍.5 1.1.3移动应用核心技术介绍.6 1.1.4myApps平台的特点.6 1.2MYAPPS平台的组成 .7 1.2.1myApps工作流.7 1.2.2myApps动态表单.8 1.2.3myApps移动访问.8 1.2.4myApps动态打印.9 1.2.5myApps桌面应用程序.9 2 2 走进走进 MYAPPSMYAPPS 开发开发 .1010 2.1MYAPPS平台的开发过程 .10 2.2MYAPPS平台的表单配置 .10 2.2.1关键知识点.10 2.2.2案例介绍.10 2.2.3表单控件.22 2.2.4脚本类型.30 2.2.5操作类型.32 2.2.6表单工具栏.33 2.2.7表单特殊控件的使用.34 2.2.8小结.41 2.3MYAPPS平台的视图配置 .41 2.3.1关键知识点.41 2.3.2视图类型介绍.42 2.3.3案例介绍.55 2.3.4使用设计模式.60 2.3.5使用DQL模式.60 2.3.6使用SQL模式.61 2.3.7代码（存储过程）.62 2.3.8定制列内容.62 2.3.9操作类型.62 2.3.10系统字段.63 2.3.11小结.64 2.4MYAPPS平台的流程配置 .65 2.4.1关键知识点.65 2.4.2案例介绍.65 2.4.3流程与表单绑定.73 2.4.4流程中的事件.74 2.4.5流程的几种特殊功能的配置.74 2.4.6流程配置小结.82 2.5MYAPPS平台的移动接入 .82 2.5.1关键知识点.82 2.5.2案例介绍.83 2.5.3小结.88 2.6MYAPPS平台动态打印的应用 .89 广州市天翎网络科技有限公司 myApps 开发者手册 第 3 页 2.6.1界面布局.89 2.6.2组件功能.90 2.6.3操作动态打印.90 2.6.4创建表单动态打印操作.97 2.6.5效果演示.97 2.7MYAPPS平台桌面应用的使用 .98 2.7.1关键知识点.98 2.7.2安装桌面应用.99 2.7.3待办事务的处理.100 2.7.4进入软件菜单.102 2.7.5即时通信.102 2.8MYAPPS平台资源权限分配 .104 2.9MYAPPS平台的报表配置 .106 2.9.1功能介绍.106 2.9.2图形报表管理模块.106 2.9.3定制图形报表模块.109 2.9.4其他说明.114 3 3 深入深入 MYAPPSMYAPPS 开发开发 .115115 3.1深入MYAPPS表单开发 .115 3.1.1关键知识点.115 3.1.2建立主从表.115 3.1.3建立标签形式表单.119 3.1.4使用脚本块.121 3.1.5使用校验库.123 3.1.6使用函数库.125 3.1.7使用样式库.127 3.2深入MYAPPS流程开发 .129 3.2.1关键知识点.129 3.2.2建立分支流程.129 3.2.3通过脚本计算决定审批人流程.132 3.2.4建立自由流程.134 3.2.5建立自动流程.136 4 4 定制开发定制开发 .142142 4.1自定义皮肤.142 4.2自定义控件.144 4.3与其他系统整合.145 4.3.1数据库方式整合.145 4.3.2表单映射方式整合.147 4.3.3Webservice方式整合.147 5 5 调试器调试器 .164164 6 6 导入导出功能导入导出功能 .168168 6.1软件的导入导出.168 6.1.1软件的导出.168 6.1.2软件的导入.170 广州市天翎网络科技有限公司 myApps 开发者手册 第 4 页 1 1myAppsmyApps 产品介绍产品介绍 1.11.1 myAppsmyApps 开发平台概述开发平台概述 myApps 平台是由天翎公司自主研发的一款前沿的集成化的工作流应用软件开发平台，为企业 提供应用系统开发所需要的一切基础设施，平台涵盖了对企业业务流程需求分析，设计，快速开发 部署，仿真测试，运行维护，更新和发布，流程绩效分析和管理，流程改进等对企业绩效管理 （BPM）进行全生命周期支持。 myApps 内建工作流引擎（Workflow Engine）, Form 构建器，Report 设计器。同时 myApps 支持浏览器（IE/Firefox）做为客户端，同时还提供了强大的图形客户端。涵盖了对企业业务流程 需求分析、快速开发部署、流程绩效分析和管理等等一系列的支持。myApps 从第一版开发到目前 已经有 6 年多的时间，已经包含 50 万行源代码。 .1 工作流核心概念介绍工作流核心概念介绍 工作流（Work Flow）就是工作流程的计算模型，即将工作流程中的工作如何前后组织在一起 的逻辑和规则在计算机中以恰当的模型进行表示并对其实施计算。工作流要解决的主要问题是：为 实现某个业务目标，在多个参与者之间，利用计算机，按某种预定规则自动传递文档、信息或者任 务。简单地说，工作流就是一系列相互衔接、自动进行的业务活动或任务。我们可以将整个业务过 程看作是一条河，其中流过的河水就是工作流。 工作流属于计算机支持的协同工作（Computer Supported Cooperative Work，CSCW）的一 部分。后者是普遍地研究一个群体如何在计算机的帮助下实现协同工作的。 协同工作流 .2 动态表单核心技术介绍动态表单核心技术介绍 进入互联网时代，HTML 技术的出现使得集成商能够开发基于 Web 的应用系统。早期的 广州市天翎网络科技有限公司 myApps 开发者手册 第 5 页 Web 表单，通常与 HTML 和诸如 JavaScript 这样的技术紧密绑定。HTML 表单编制简单，并 且有众多熟悉该技术的开发人员。但是，HTML 表单也和 HTML 技术本身一样，充满了缺陷。 HTML 结构松散，并且没有标准的开发界面。HTML 表单构建在不完备的基础之上。因而开发商 面临开发效率低下的问题依旧没有得到根本改观。 进入二十一世纪后，为了解决电子表单这个开发效率中的瓶颈问题，一种新的表单技术应运而 生。对于这种新技术，有多种不同的名称，如：“智能表单” 、 “动态表单” 、 “活动文档” 、 “智能文 档”等。但不管叫什么名称，它们的本质基本上是一致的，那就是以 XML 为核心并且实现数据模 型与表现层分离的一种技术。我们姑且将这种技术称之为“动态表单” 。 .3 移动应用核心技术介绍移动应用核心技术介绍 信息产业部最新统计数据显示，国内手机用户已超过 4.5 亿，且以高于 20%的速度持续增长。 随着 3G 通信、智能手机等新的移动技术的发展，各类增值服务层出不穷。同时，各种嵌入式移动 终端也在交通运输、生产调度、电子政务、实时数据采集等企业/政务级应用领域显示出巨大的前 景。 目前，占据市场主流技术的智能手机系统平台主要有稳居霸主地位的 symbian 操作系统、与 windows 无缝连接的 windows mobile 操作系统，以及具有强大跨平台优势的 Kjava（J2ME）平台 等。 其中 J2ME 兼容性最好，可以在非智能手机上运行。 .4 myAppsmyApps 平台的特点平台的特点 可视化：可视化工作流、动态表单、智能报表、所见即所得，真正零代码开发； 模板功能：整合包括客户关系管理、软件缺陷管理系统、任务分派管理系统、办公管理系统这 四套比较具有代表性的应用模板，用户只需拷贝模板进行必要修改即可使用，无需从“零”开 始； 手机运用：myApps 平台支持短信和手机客户端，平台配置的任何功能都可以直接在手机上运 行。无论在何时何地只要手机有信号，用户就能通过手机处理事务； 首创内置宏语言：在流程和表单中内置宏语言（JavaScript）实现，在不需要重新编译、安装 的条件下，可动态地创建或调整业务逻辑，满足高级用户的要求； 灵活与扩展：对于动态表单所创建的数据，采用了查询微语言 DQL（类似 SQL 语法） ，为检 索提供全面的灵活性和可扩展性，同时能够很好的封装不同数据库的本地方言； 与主流系统的通用：myApps 平台具有与 SAP ERP 无缝整合能力，并已经通过 SAP NET WEAVER 认证。同时系统提供第三方开发接口，可以和当前主流 ERP 系统整合； 采用 Java 开发：产品采用 Java 开发，全面兼容主流应用服务器平台，包括 IBM 广州市天翎网络科技有限公司 myApps 开发者手册 第 6 页 Websphere、BEA Weblogic、Jboss、Apache Tomcat 等； 兼容性强：对移动终端设备的型号有广泛的适合性。支持手机等智能设备的接入、兼容手机、 PDA、上网本等移动终端设备； 支持主流数据库：实现几乎所有主流数据库的 DAO 接口，系统可以运行在各种主流的关系型 数据库下，包括 DB2、MS SQL、Oracle、Sybase 等； myAPPS 内建工作流引擎（Workflow Engine）, Form 构建器，Report 设计器。MYAPPS 支 持浏览器（IE/Firefox）做为客户端，同时还提供了强大的图形客户端，涵盖了对企业业务流 程需求分析、快速开发部署、流程绩效分析和管理等等一系列的支持； 完美的打印解决方案。 1.21.2 myAppsmyApps 平台的组成平台的组成 myApps 平台由工作流引擎、动态表单、智能表单、手机运用、宏命令、打印定制器其他扩展 功能等功能组成。并且按照应用和模块为单位组织。 .1 myAppsmyApps 工作流工作流 myApps 工作流是 myApps 平台的重要组成部分，它是以有限状态机原理设计的工作流引擎， 它具有以下的特点： 完全基于 Web 的 WYSIWYG 的编辑器； 广州市天翎网络科技有限公司 myApps 开发者手册 第 7 页 无需代码实现、打包、发布； 采用状态机的模式、侧重人和系统的交互； 与动态表单天然整合，能在流程过程中动态对表单进行处理及其权限问题。 支持服务器端的宏语言，支持复杂的流程分支判断； 提供常用 ERP 接口和其它业务系统进行整合； 支持移动设备的接入。 .2 myAppsmyApps 动态表单动态表单 动态表单是 myApps 的重要组成部分之一。通过对动态表单的应用，可以避免在电子流程系统 中硬编码的数据采集及表单处理，提高系统的可维护性。它包括以下特点: 表单的定制通过 B/S 结构的定制终端定制表单模板，实现各种版式的定义包括：单行文本 框控件、多行文本框控件、下拉列表框控件、单选框控件、复选框控件、部门控件、Word 嵌 入编辑控件等； 表单的描述采用 XML 描述表单布局及样式，并能够在定制器和页面生成器之间保持定制 时和显示时状态和布局一致； 主从等复杂数据结构在 B/S 结构下的表达主从等复杂数据结构在 C/S 结构下可以很容易 通过数据绑定等方式实现。但由于 B/S 结构下主要的通讯协议 HTTP 是一种无状态的网络通 讯协议，表和表之间的数据关系不能通过内存持有的方式表达，所以必须通过额外的处理才能 实现数据对象关系的展现； 动态数据存储结构动态表单必定对应动态数据存储结构。我们通过 Parser 描述动态表单 的 XML，并自动生成对应的数据动态存储结构； 表间数据计算和校验通过内嵌的宏语言实现。详见“嵌入式宏语言及调试工具”部分描述。 .3 myAppsmyApps 移动访问移动访问 myApps 平台是天翎公司基于 JAVA 技术研发的。集可视化开发、部署、验证、发布于一体的 综合性平台。myApps 平台融合了先进“移动”技术（支持各种主流的移动终端，如 PDA、手机 和智能设备，兼容移动、联通、电信三大运营商网络） 、软件柔性定制技术及平台运营支持技术， 拥有良好的易用性、稳定性，是中小企业实现移动商务的完美工具平台。 通过 myApps 平台可以象搭积木一样简单、快速、灵活的搭建移动商务应用（如移动数据采集、 移动 CRM、移动 DRP、移动 SCM.） ，屏蔽了时间、地点对应用系统的限制。使得企业内部各种 信息可以随着移动设备的移动而移动，有效的建立企业与市场的信息桥梁，而使企业资金流、物流、 信息流的管理得以有效地延伸，极大的提高了企业对市场变化的响应速度，继而提高企业决策能力、 广州市天翎网络科技有限公司 myApps 开发者手册 第 8 页 协同能力和执行能力。实现“随时随地的移动管理、触及商务领域的每一细节 .4m m yAppsyApps 动态打印动态打印 动态打印是一个功能强大的打印配置平台。它的目标是让用户轻松地配置打印模板,提供打印 预览。 .5 myAppsmyApps 桌面应用程序桌面应用程序 myApps 平台桌面应用程序是 2.4 版本推出的功能，这样客户除了通过 Web 浏览器访问到平台 客户端外，同样添加了通过桌面应用程序访问客户端来处理并提醒相关待办事务，访问到平台对应 的应用以及联系相关人员进行站内、邮件和手机的即时联系。 Anywhere Anytime Anything 广州市天翎网络科技有限公司 myApps 开发者手册 第 9 页 2 2走进走进 myAppsmyApps 开发开发 2.12.1 myAppsmyApps 平台的开发过程平台的开发过程 myApps 平台使用于各种业务系统的开发，除了专业的程序人员， 业务分析人员甚至最终用户也能直接利用平台定制，能帮助缩短项目 开发进程。特别能够快速建立系统原型，并能基于原型进行系统需求 讨论、然后在原型上不断地继续优化和实现，缩短项目迭代的过程。 2.22.2 myAppsmyApps 平台的表单配置平台的表单配置 .1 关键知识点关键知识点 本章主要介绍 myApps 平台的核心功能：动态表单的定制，通过本章的学习就对 myApps 平 台的表单定制有一个基础的了解,并可以轻松的使用 myApps 平台建立自己的业务表单。 关键知识点： 建立简单的业务表单 各类控件的使用 各类事件脚本的使用 表单操作的使用 .2 案例介绍案例介绍 案例描述案例描述 myApps 平台除了使用向导外，还可以在模块上建立表单。此案例演示从创建软件到新建模块， 最后新建一个表单的过程。新建一个办公自动化软件，然后新建一个请假申请模块，最后新建一请 假申请表单。 原型 讨论 优化 广州市天翎网络科技有限公司 myApps 开发者手册 第 10 页 请假申请单中主要设计以下字段信息： 字段名字段名界面表现形式界面表现形式备注备注 申请单号文本框自动生成申请单号 请假类别单选框选择请假类型，不能为空 请假开始日期日期选择框选择请假开始日期，不能为 空 请假结束日期日期选择框选择请假结束日期，不能为 空 请假原由多行文本框请假原由为必填，不能为空 案例开发案例开发 新建软件新建软件： 第一步：第一步：进入 myApps 平台台后，点击“软件管理” ； 第二步：第二步：进入“软件管理”后，点击软件列表中的“新建”按钮； 第三步：第三步：进入软件信息界面，按前章说明创建软件“办公自动化系统” 。 新建模块：新建模块： 第一步：第一步：进入软件，然后鼠标右键点击左侧，然后点击“新建模块” ； 第二步：第二步：输入模块名称，模块描述，然后点击“保存” ； 广州市天翎网络科技有限公司 myApps 开发者手册 第 11 页 第三步：第三步：保存成功。 新建表单：新建表单： 第一步：第一步：点击模块“请假申请” ，然后点击“表单” ，再然后点击“新建” ； 第二步：第二步：详细填写表单名称,描述，选择类型，然后点击“保存”按钮； 第三步：第三步：保存成功后，表单会显示操作，进入后则可以详细编辑表单信息； 广州市天翎网络科技有限公司 myApps 开发者手册 第 12 页 第四步：第四步：点击“格式”按钮，对表单进行高级设置， 选择组件编辑表单字段； （1）首先点击插入表格，然后设计如下： 插入表格： 设置表格属性： （2）添加“申请单号”字段 要求： 广州市天翎网络科技有限公司 myApps 开发者手册 第 13 页 设置基本信息： 设置值脚本： 效果：设置完成后，生成一个带有默认格式的申请单号文本框，如下图： （3）添加“请假类别”字段 要求： 设置基本信息： 广州市天翎网络科技有限公司 myApps 开发者手册 第 14 页 设置选项脚本 广州市天翎网络科技有限公司 myApps 开发者手册 第 15 页 设置校验脚本： 效果：效果：设置完成后，生成一个单选框，如下图： （4）添加“请假开始时间”和“请假结束时间”字段 要求： 设置基本信息： 设置校验脚本： 广州市天翎网络科技有限公司 myApps 开发者手册 第 16 页 设置限制条件： 效果效果：设置完成后，生成二个日期选择框，如下图： （5）添加“请假因由”字段 要求： 设置基本信息： 广州市天翎网络科技有限公司 myApps 开发者手册 第 17 页 设置校验脚本： 效果：设置完成后，生成一个多行文本框，如下图： 第五步：第五步：点击表单“保存”按钮完成高级设置，然后点击预览效果如下图： 广州市天翎网络科技有限公司 myApps 开发者手册 第 18 页 设置操作设置操作 第一步：第一步：完成高级设置后，点击操作，然后点击创建； 第二步：第二步：选择类型，包括保存，返回，保存并返回等。然后填写名称，并点击保存按钮； 广州市天翎网络科技有限公司 myApps 开发者手册 第 19 页 完成以上操作后，表单的基本设置也完成了。除了创建“请假申请”表单外，还需要创建一 个“请假申请_查询表单”的查询表单。 创建查询表单创建查询表单 查询表单是一种特殊的表单，它可以根据表单里的一些字段来查询过滤视图的信息。 第一步：第一步：进入表单，点击创建，然后填写表单名称，设置类型为查询表单，最后点击保存， 第二步：第二步：设置“高级” ，添加字段“申请单号