myApps柔性定制平台iScript操作手册.doc

广州市天翎网络科技有限公司 iScript操作手册myApps柔性定制平台iScript操作手册版本2.5广州市天翎网络科技有限公司版权所有目 录1.什么是iScript12.基本语法12.1.比较运算子12.2.逻辑运算子12.3.运算子优先级12.4.变量22.5.可分岔执行的 if-else 叙述22.6.计次执行的 for 循环32.7.while循环33.函数的使用43.1.含有参数的函数43.2.含有传回值的函数53.3.系统内置全局变量53.4.系统内置函数53.4.1.当前打开文档函数53.4.2.文档函数63.4.3.邮件函数83.4.4.信息函数83.4.5.FTP操作函数93.4.6.数字函数103.4.7.字符（串）函数103.4.8.创建JAVA类实例函数113.4.9.日期函数123.4.10.计数器函数133.4.11.系统函数133.4.12.其他函数153.5.自定义函数154.编程接口/对象API说明174.1.Document174.2.DataPackage254.3.WebUser264.4.Item284.5.DepartmentVO304.6.RoleVO314.7.UserProcess324.8.DepartmentProcess354.9.RoleProcess374.10.DocumentProcess384.11.FormProcess444.12.ViewP 第 48 页广州市天翎网络科技有限公司 iScript操作手册1. 什么是iScriptiScript是myApps系统提供的，简单、以对象为基础的宏语言。myApps采用目前流行的Java Script语法。iScript紧密地与myApps结合。通过直接访问myApps所提供的操作对象，方便操作DynaForm,WorkFlow的内容。2. 基本语法2.1. 比较运算子 运算子说明=如果操作数相等传回 True!=如果操作数不相等传回 True如果左边的操作数大于右边的操作数就传回 True=如果左边的操作数大于或等于右边的操作数就传回 True=如果左边的操作数小于或等于右边的操作数就传回 True2.2. 逻辑运算子 运算子说明&逻辑 and ：当两个操作数是真时传回 True，否则传回 False|逻辑 or ：当任一个运算原是真时就传回 True，只有在两个操作数都是假时才传回False!逻辑 not ：当操作数是假时传回 True，当操作数是真时传回 False，这是单元运算子且在操作数之前2.3. 运算子优先级因为表达式可以是其它表达式的操作数，了解运算子的优先级是必要的。 你所学到的运算子会被下列的顺序被评估（从最低优先级到最高）： 指定操作数= += -= *= /= %=条件运算子?:逻辑 or|逻辑 and&等式= !=关系式 =加 / 减+ -乘 / 除 / modulus* / %括号( )2.4. 变量为了使用变量，最好在使用前申明它。申明变量就告诉 iScript 该变量的存在，以便 iScript在解释时知道该变量代表什么。虽然使用变量有可能同时申明它了，但申明变量有助于程序的组织性及易于追查变量的范围。可以使用var指令来申明变量，如：var example=An Example;2.5. 可分岔执行的 if-else 叙述 if condition JavaScript Code; else JavaScript Code; 示例： /定义变量var question=What is 10+10 ? ; var answer=20; var correct=你答对了 var incorrect=你答错了 /问问题 var response=prompt(question,0); /第一次检查 if (response!=answer) /答案错误！correct; else /答案正确！incorrect;2.6. 计次执行的 for 循环 如果已经确定执行的次数，使用for循环最方便，它的格式是： for( 计次变数起始值 ; 连续执行循环的条件 ; 更新计次变量的条件 )叙述（区块）；示例： for(var i = 1 ; i = 10 ; i+ ) $PRINTER.println(第 + i + 次) ;2.7. while循环 示例： var i = 0; while( i 高级工具-数据源的支持。首先需要开发者在软件的数据源模块创建数据源。createParamsTable()无生成参数对象getLastRelationHis(docid, flowid)docid：文档IDflowid：流程ID根据文档ID与流程ID获取文档最后审批记录对象3.4.9. 日期函数函数名参数说明getToday()无获取当日日期getDay(date)date: 日期型参数获取日期getMonth(date)date: 日期型参数获取月份getYear(date)date: 日期型参数获取年份parseDate(str, format)str: 待转换的字符串,需符合format指定的格式;format: 日期格式将字符串按给定格式转换为日期型diffYears(startDate, endDate)startDate和endDate是“yyyy-MM-dd”格式的字符串获取相隔年份数diffMonths(startDate, endDate)startDate和endDate是“yyyy-MM-dd”格式的字符串获取相隔月份数diffDays(startDate, endDate)startDate和endDate是“yyyy-MM-dd”格式的字符串获取相隔天数diffHours(startDate, endDate)startDate和endDate是“yyyy-MM-dd”格式的字符串获取相隔小时数adjustYear(date, num)date:日期型参数，num:正负整数校正年份adjustMonth(date, num)date:日期型参数，num:正负整数校正月份adjustDay(date, num)date:日期型参数，num:正负整数校正天数format(date,formatText)date:日期型参数;formatText:指定字符串格式把其日期参数转化成指定格式的字符串getCurDate(formatText)date:日期型参数formatText:字符串型参数，指定需要显示的格式，如yyyy-MM-dd HH:mm:ss按其参数指定的格式获取当前时间，并以字符串的形式返回3.4.10. 计数器函数函数名参数说明countNext(countLabel)countLabel: 字符串型参数每次调用时指定计数器都会自动增长1(根据计算器名,以0为基元),可用作生成增长序列号getLastCount(countLabel)countLabel: 字符串型参数根据计数器名称获取计数器的当前计数值getLastCount2(headText, isYear, isMonth, isDay, digit)headText:作为前缀的字符串 isYear: boolean型,前缀中是否包含年份 isMonth: boolean型,前缀中是否包含月份 isDay: boolean型,前缀中是否包含日期 digit: 数值型，指定随机序列号的位数返回“前缀 +年月日+ 计数器的当前计数值”countNext2(headText, isYear, isMonth, isDay, digit)headText: 作为前缀的字符串isYear: boolean型,前缀中是否包含年份isMonth: boolean型,前缀中是否包含月份isDay: boolean型,前缀中是否包含日期digit：整数型，指定计数器序列号的位数，如长度不足在计数值前面补0；返回“前缀 +年月日+ 计数器的下一个计数值” resetCounter(base)base: 字符串型参数重置计数器的值,使其归03.4.11. 系统函数函数名参数说明getApplication()无返回项目id号getWebUser()无返回用户对象.getDomainid()无返回企业域Id号getParamsTable()无获取参数列表对象，可以对参数进行基本的增,删和格式化参数getParameter(paramName)paramName：参数名获取参数值,以字符串的形式返回getParameterAsText(paramName)paramName：参数名获取参数值,以;进行切割格式化成文本型,以字符串的形式返回getParameterAsArray(paramName)paramName：参数名获取参数值,并以字符数组的形式返回getContextPath()无获取当前项目请求的URI部分。如：http:/localhost/obpm,获取到的值“/obpm”createAlert(content)content: 提示内容。如：“单据填写有误无法保存！”createConfirm(content)content: 提示内容。如：“单据填写不完整，是否确认保存？”返回true|false。true: 表示确认。false: 表示取消getSession(sessionName)sessionName: session属性名称获取当前浏览器sessiongetDepartmentByLevel(level)level:部门等级值返回获取到的对应等级的所有部门的集合getDeptIdByNameAndLevel(name,level)level:部门等级值name:部门名称返回对应部门IDgetRoleIdByName(name)name:角色名称返回对应角色IDgetUserIdByLoginno(loginno)loginno:用户登录名返回对应用户IDgetDepartmentsByParent(parent)parent:部门ID返回指定部门的下级部门对象的集合getUsersByDptId(dptid)dptid:部门ID返回指定部门下的所有用户对象的集合getUsersByRoleId(roleid)roleid:角色ID返回指定角色下的所有用户对象的集合getUsersByDptIdAndRoleId(dptid,roleid)dptid:部门IDroleid:角色ID返回指定部门、角色的所有用户对象的集合getAllUsers()无返回当前域下面的所有用户对象的集合getAllRoles()无返回当前软件下面的所有角色组别的集合queryByDSName(dsName,sql)dsName：数据源名称sql： SQL查询语句根据数据源名称，执行SQL查询, 返回SQL查询语句执行的结果，以Collection方式返回（存储的是数据记录的Map对象）。insertByDSName(dsName,sql)dsName：数据源名称sql： SQL查询语句根据数据源名称，执行SQL插入操作（SQL语句为：insert into table .）updateByDSName(dsName,sql)dsName：数据源名称sql： SQL查询语句根据数据源名称，执行SQL更新操作（SQL语句为：update table set.）deleteByDSName(dsName,sql)dsName：数据源名称sql： SQL查询语句根据数据源名称，执行SQL删除操作（SQL语句为：delete from table .）getUserById(userid)userid:用户ID根据用户ID获取用户对象getUserByLoginno(loginno)loginno:用户登录名根据用户登录名取用户对象 getRoleByName(name)name:角色名称根据角色名取角色对象println(text)text:要输出文本的内容输出文本到控制台3.4.12. 其他函数函数名参数说明getOptionsByDQL(dql, keyFieldName, blankFirst)dql：查询符合条件语句；keyFieldName：文档的字段名；blankFirst：默认是否为空选项返回符合查询条件语句的文档中keyFieldName字段的所有值集合，作为下拉框控件的选项getWorkingDayCount(startDate, endDate)startDate： “yyyy-MM-dd HH:mm:ss”格式的字符串 endDate： “yyyy-MM-dd HH:mm:ss”格式的字符串获取相隔工作天数getWorkingTimesCount(startDate, endDate)startDate： “yyyy-MM-dd HH:mm:ss”格式的字符串 endDate： “yyyy-MM-dd HH:mm:ss”格式的字符串获取相隔工作小时数3.5. 自定义函数iScript提供自定义函数库的功能。用户需要定义自己的函数库时，通过系统的“MacroLib”功能建立，定义方式和JavaScript方式相同（见上文所述）。在具体需要使用自定义函数库中所定义的函数时，需要在需要引用自定义函数库的开头，进行引用申明。语法如下：#include “mylib”;/申明var rtn = myfunction();/调用/其他代码4. 编程接口/对象API说明4.1. Document方法摘要voidaddDateItem(java.lang.StringitemName, java.util.DateitemValue) 添加日期类型itemvoidaddDoubleItem(java.lang.StringitemName, doubleitemValue) 添加双精度浮点类型itemvoidaddFloatItem(java.lang.StringitemName, floatitemValue) 添加单精度浮点类型itemvoidaddIntItem(java.lang.StringitemName, intitemValue) 添加整型itemvoidaddItem(Itemitem) 添加Document的Item(项目).voidaddItems(java.util.Collectionitems) 添加Item集合voidaddLongItem(java.lang.StringitemName, longitemValue) 添加长整型itemvoidaddStringItem(java.lang.StringitemName, java.lang.StringitemValue) 添加字符串类型itemvoidaddTextItem(String itemName, String itemValue) 添加大文本类型itemjava.lang.Objectclone() 克隆对象ItemfindItem(java.lang.Stringfieldname) 根据字段名(fieldname)，获取Item.java.lang.StringgetLastFlowOperation() 最后一次流程处理(运行,回退,暂停,结束等)java.lang.StringgetAuditorList() 获取当前审批人列表java.util.MaptoMap() 将文档转换成Map结构java.util.CollectioncompareWith(Collection items) 用比较器来比较Item名,用于排序Itemjava.util.CollectioncompareTo(Document doc) 用比较器来比较Item名,用于排序ItemBooleancompareFieldValue(Document oldDoc, Document newDoc) 比较上一个版本与现在版本的Field 的值是否一致BooleanisEditAble(WebUser webUser) 判断当前用户是否可对文档进行编辑java.util.CollectiongetStateLableList() 返回流程状态以逗号分割Java.lang.StringformatFieldNameByPageDiv(String fieldname, String page) 返回格式化后的字列名booleanget_issubdoc() 是否为子表单 ，true为子文档，返回false不为子文档ParamsTableget_params() 获取所有参数Java.util.DategetAuditdate() 修改的日期java.lang.StringgetAudituser() 返回最后审核人姓名java.lang.StringgetAudituserid() 返回设置审计者 idjava.lang.StringgetAuditusers() 返回所有已审核人ID(以分号隔开)UserVOgetAuthor() 返回用户java.util.CollectiongetChilds() 获取当前父文档的子文档集合.java.util.CollectiongetChilds(java.lang.StringformName) 根据子表单名，获取当前文档的子文档集合.Java.util.DategetCreated() 创建日期intgetDisplayType() 返回Document显示类型.FieldPermissionListgetFieldPermList() 创建许可频道列表java.util.CollectiongetFirstNodeList(WebUseruser) 根据用户，获取第一结点列表java.lang.StringgetFlowid() 返回流程IDjava.lang.StringgetFormid() 返回表单主键java.lang.StringgetFormname() 获取表单名java.lang.StringgetId() 返回Document主键idjava.lang.StringgetImgItemUrlAsString(java.lang.StringfieldName) 根据字段名， 返回将图片url值转换为字符串型booleangetIstmp() 返回是否显示Documentjava.util.CollectiongetItems() 获取所有itemjava.util.DategetItemValueAsDate(java.lang.StringfieldName) 根据字段名，返回将item值转换为日期型doublegetItemValueAsDouble(java.lang.StringfieldName) 根据字段名，返回将item值转换为双精度浮点数型floatgetItemValueAsFloat(java.lang.StringfieldName) 根据字段名，返回将item值转换为单精度浮点数型intgetItemValueAsInt(java.lang.StringfieldName) 根据Field name ,返回Double类型的item值.longgetItemValueAsLong(java.lang.StringfieldName) 根据字段名，返回将item值转换为长整型java.lang.StringgetItemValueAsString(java.lang.StringfieldName) 根据字段名（Field name），返回item值转换为字符串.java.util.DategetLastmodified() 返回修改Document最后的日期.DocumentgetParent() 根据父Document主键查询,获取父Document对象.java.lang.StringgetParentid() 返回父Document主键FlowStateRTgetState() 返回流程状态FlowStateRT对象java.lang.StringgetStateid() 返回状态intgetStateInt() 状态代号java.lang.StringgetStateLabel() 返回状态标识java.lang.StringgetValueByPropertyName(java.lang.StringpropName) 根据常用属性名称,获取Document属性的值java.lang.StringgetLastFlowOperation() 最后一次流程处理(运行,回退,暂停,结束等)java.lang.StringgetLastmodifier() 获取最后修改人java.lang.StringgetMappingId() 获取表单数据对象映射IDintgetVersion() 返回文档版本booleanis_new() 是否新文档(在新建时就已创建文档id, 故保存时只能通过增加此属性判断是否为新文档).voidremoveItem(Itemitem) 根据Item对象实例移除itemvoidremoveItem(java.lang.Stringitemname) 根据项目item name 移除itemvoidset_issubdoc(boolean_issubdoc) 设置是否为子文档 ，true为子文档，返回false不为子文档voidset_new(boolean_new) set 是否新文档(在新建时就已创建文档id, 故保存时只能通过增加此属性判断是否为新文档).voidset_params(ParamsTable_params) 设置所有参数voidsetAuditdate(java.util.Dateauditdate) 设置修改的日期voidsetAudituser(java.lang.Stringaudituser) 设置最后审核人姓名voidsetAudituserid(java.lang.Stringaudituserid) 设置审计者 idvoidsetAuditusers(java.lang.Stringauditusers) 设置所有已审核人ID(以分号隔开)voidsetAuthor(UserVOauthor) voidsetCreated(java.util.Datecreated) 设置