【正文】 廣州市天翎網絡科技有限公司 iScript操作手冊myApps柔性定制平臺iScript操作手冊廣州市天翎網絡科技有限公司版權所有目 錄1. 什么是iScript 12. 基本語法 1. 比較運算子 1. 邏輯運算子 1. 運算子優(yōu)先級 1. 變量 2. 可分岔執(zhí)行的 ifelse 敘述 2. 計次執(zhí)行的 for 循環(huán) 3. while循環(huán) 33. 函數(shù)的使用 4. 含有參數(shù)的函數(shù) 4. 含有傳回值的函數(shù) 5. 系統(tǒng)內置全局變量 5. 系統(tǒng)內置函數(shù) 5. 當前打開文檔函數(shù) 5. 文檔函數(shù) 6. 郵件函數(shù) 8. 信息函數(shù) 8. FTP操作函數(shù) 9. 數(shù)字函數(shù) 10. 字符（串）函數(shù) 10. 創(chuàng)建JAVA類實例函數(shù) 11. 日期函數(shù) 12. 計數(shù)器函數(shù) 13. 系統(tǒng)函數(shù) 13. 其他函數(shù) 15. 自定義函數(shù) 154. 編程接口/對象API說明 17. Document 17. DataPackage 25. WebUser 26. Item 28. DepartmentVO 30. RoleVO 31. UserProcess 32. DepartmentProcess 35. RoleProcess 37. DocumentProcess 38. FormProcess 44. ViewProcess 46 第 48 頁廣州市天翎網絡科技有限公司 iScript操作手冊1. 什么是iScriptiScript是myApps系統(tǒng)提供的，簡單、以對象為基礎的宏語言。myApps采用目前流行的Java Script語法。iScript緊密地與myApps結合。通過直接訪問myApps所提供的操作對象，方便操作DynaForm,WorkFlow的內容。2. 基本語法. 比較運算子 運算子說明==如果操作數(shù)相等傳回 True!=如果操作數(shù)不相等傳回 True如果左邊的操作數(shù)大于右邊的操作數(shù)就傳回 True如果左邊的操作數(shù)小于右邊的操作數(shù)就傳回 True=如果左邊的操作數(shù)大于或等于右邊的操作數(shù)就傳回 True=如果左邊的操作數(shù)小于或等于右邊的操作數(shù)就傳回 True. 邏輯運算子 運算子說明amp。amp。邏輯 and ：當兩個操作數(shù)是真時傳回 True，否則傳回 False||邏輯 or ：當任一個運算原是真時就傳回 True，只有在兩個操作數(shù)都是假時才傳回False!邏輯 not ：當操作數(shù)是假時傳回 True，當操作數(shù)是真時傳回 False，這是單元運算子且在操作數(shù)之前. 運算子優(yōu)先級因為表達式可以是其它表達式的操作數(shù)，了解運算子的優(yōu)先級是必要的。 你所學到的運算子會被下列的順序被評估（從最低優(yōu)先級到最高）： 指定操作數(shù)= += = *= /= %=條件運算子?:邏輯 or||邏輯 andamp。amp。等式== !=關系式 = =加 / 減+ 乘 / 除 / modulus* / %括號( ). 變量　為了使用變量，最好在使用前申明它。申明變量就告訴 iScript 該變量的存在，以便 iScript在解釋時知道該變量代表什么。雖然使用變量有可能同時申明它了，但申明變量有助于程序的組織性及易于追查變量的范圍。可以使用var指令來申明變量，如：var example=An Example。. 可分岔執(zhí)行的 ifelse 敘述 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。}. 計次執(zhí)行的 for 循環(huán) 如果已經確定執(zhí)行的次數(shù)，使用for循環(huán)最方便，它的格式是： for( 計次變數(shù)＝起始值 。 連續(xù)執(zhí)行循環(huán)的條件 。 更新計次變量的條件 )敘述（區(qū)塊）；示例： for(var i = 1 。 i = 10 。 i++ ){ $(第 + i + 次) 。}. while循環(huán) 示例： var i = 0。 while( i 1000 ) { i++。 if ( i == 5 ) continue。 if ( i == 10 ) break。 $( i + 次)。 }3. 函數(shù)的使用首先來看看定義（建立）函數(shù)的方法，以下是函數(shù)的基本架構：function 函數(shù)名稱( ){ 敘述 ( 區(qū)塊 )。 }定義函數(shù)時我們會設定一個名稱給函數(shù)，利用此一名稱，只要將敘述寫成『函數(shù)名稱( )；』即為調用函數(shù)敘述。示例：function FUN( ){ //FUN是函數(shù)的名稱 $(進入范例函數(shù)FUN( )之中)。}//接著要調用函數(shù) FUN( )FUN()。. 含有參數(shù)的函數(shù)要讓函數(shù)可以接受參數(shù)，在格式上要寫成：function 函數(shù)名稱( 參數(shù)1,參數(shù)2,參數(shù).....) ｛敘述 ( 區(qū)塊 )｝示例：//定義函數(shù)function Add3(A,B,C){$(A + + + B + + + C + = + (A+B+C))。}//調用函數(shù)Add3(10,20,30)。. 含有傳回值的函數(shù)//定義函數(shù)function Add3(A,B,C){ x=A+B+C。 return x。}//調用函數(shù)var y=Add3(10,20,30)。$(10+20+30= + y)。 . 系統(tǒng)內置全局變量變量名類型功能GLOBAL_MAP可以獲取、添加、刪除GLOBAL_MAP中的數(shù)據(jù). 系統(tǒng)內置函數(shù)iScript提供系統(tǒng)內置函數(shù)，以協(xié)助開發(fā)者處理在定制開發(fā)中所遇到的常見問題。. 當前打開文檔函數(shù)函數(shù)名參數(shù)功能getId()無獲取當前打開文檔的IDgetItemValue(fieldName)fieldName:當前打開文檔的字段名獲取當前打開文檔中Item的值getItemValueAsString(fieldName)fieldName:當前打開文檔的字段名獲取當前打開文檔中Item的值,且以字符串形式返回getItemValueAsDate(fieldName)fieldName:當前打開文檔的字段名獲取當前打開文檔中Item的值,且以日期形式返回getItemValueAsDouble(fieldName)fieldName:當前打開文檔的字段名獲取當前打開文檔中Item的值,且以double形式返回getItemValueAsInt(fieldName)fieldName:當前打開文檔的字段名獲取當前打開文檔中Item的值,且以整型值形式返回countSubDocument(formName)formName: 當前打開文檔的子文檔名根據(jù)子文檔名，獲取當前文檔的子文檔個數(shù)sumSubDocument(formName, fieldName)formName: 當前打開文檔的子文檔名；fieldName: 子文檔的字段名根據(jù)子文檔名和字段名，獲取當前打開文檔的子文檔中字段的值總和getCurrentDocument()無返回當前打開文檔對象getParentDocument()無返回當前打開文檔的父文檔對象getRelateDocument()無獲取關聯(lián)的文檔，當包含元素不存在父子關系時生效isFirtNode()無獲取當前文檔是否處在第一個節(jié)點，返回值為：true|falseisComplete()無獲取當前文檔是否審批完成，返回值為：true|falsegetStateLabel()無獲取當前文檔的狀態(tài)標簽，返回當前文檔的狀態(tài)標簽getParentFlowDoc()無獲取父流程文檔getSubFlowDocList()無獲取子流程文檔getStartDoc()無子流程開啟腳本中使用此函數(shù)，可獲取到子流程啟動的文檔對象getLastApprover()無獲取當前文檔的最后審批人對象getLastApproverId()無獲取當前文檔的最后審批人IDgetLastApproverName()無獲取當前文檔的最后審批人名稱getLastApprovedTime()無獲取當前文檔的最后審批時間. 文檔函數(shù)函數(shù)名參數(shù)說明getDocItemValue(docid, fieldName)docid: 文檔的id標識。fieldName: 文檔的字段名獲取文檔中Item的值,且以字符串形式返回getDocItemValueAsString(docid, fieldName)docid: 文檔的id標識。fieldName: 文檔的字段名獲取文檔中Item的值,且以字符串形式返回getDocItemValueAsDouble(docid, fieldName)docid: 文檔的id標識。fieldName: 文檔的字段名獲取文檔中Item的值,且以double形式返回getDocItemValueAsDate(docid, fieldName)docid: 文檔的id標識。fieldName: 文檔的字段名獲取文檔中Item的值,且以日期形式返回getDocItemValueAsInt(docid, fieldName)docid: 文檔的id標識。fieldName: 文檔的字段名獲取文檔中Item的值,且以整型值形式返回findDocument(docid)docid:文檔的id標識根據(jù)給定的docid，獲取Document對象queryByDQL(dql)dql:查詢符合條件語句根據(jù)dql查詢符合條件的Document，結果以Collection對象返回queryBySQL(sql)sql:查詢符合條件語句根據(jù)sql查詢符合條件的Document，結果以Collection對象返回queryByDQLWithCache(dql)dql:查詢符合條件語句根據(jù)dql查詢符合條件的Document，結果以Collection對象返回，并啟用緩存findByDQL(dql)dql:查詢符合條件語句根據(jù)DQL獲取文檔queryByDQLDomain(dql, domainName)dql:查詢符合條件語句domainName：企業(yè)域名稱根據(jù)dql和域名查詢符合條件的Document，結果以Collection對象返回countByDQL(dql)dql:查詢符合條件語句根據(jù)dql統(tǒng)計符合條件的Document數(shù)量countBySQL(sql)sql：查詢符合條件語句根據(jù)sql統(tǒng)計符合條件的Document數(shù)量sumByDQL(dql, fieldName)dql:查詢符合條件語句fieldName:文檔的字段名根據(jù)dql匯總符合條件的Document的指定字段sumBySQL(sql)sql:匯總符合條件語句根據(jù)sql匯總符合條件的Document指定字段checkFieldUnique(fieldName, fieldValue, msg)fieldName: 文檔的字段名fieldValue：文檔的字段值msg：提示信息內容判斷唯一性isFirtNodeByDocId(docid)docid: 文檔的id標識獲取指定文檔是否處在第一個節(jié)點，返回值為：true|falseisCompleteByDocId(docid)docid: 文檔的id標識獲取指定文檔是否審批完成，返回值為：true|false. 郵件函數(shù)函數(shù)名參數(shù)說明sendMail(from, to, subject, body, host, user, password, bbc, validate)from:發(fā)送人地址to:接收人地址subject:主題body:內容host:郵件服務器地址user:郵件服務器用戶名password:密碼bbc:秘密抄送地址validate:是否校驗發(fā)送郵件sendMailtoAllUser(from, subject, host, user,password, bbc, validate)from:發(fā)送人地址subject:主題host:郵件服務器地址user:郵件服務器用戶名password:密碼bbc:秘密抄送地址validate:是否校驗發(fā)送郵件. 信息函數(shù)函數(shù)名參數(shù)說明sendMessage(senderid, receiverid, title, content)senderid:發(fā)送用戶Idreceiverid:接收用戶Idtitle:主題content:內容發(fā)送站內短信sendMessageByDept(departmentid, title, content)departmentid:接收用戶部門Idtitle:主題content:內容根據(jù)部門發(fā)送站內短信sendMessageByRole(roleid, domainid, title, content)roleid:接收用戶角色Iddomainid:企業(yè)域Idtitle:主題content:內容根據(jù)角色發(fā)送站內短信sendSMS(docid,title,content,receiver,isReply,isMass)docid: 文檔Id號title: 標題content: 發(fā)送內容receiver: 接收者電話列表,有多個接收者,使用,做分隔符isReply: true|false,是否需要收到回復isMass: true|false,標識是否為群發(fā),即是否有多位接收者發(fā)送手機短信listReplyByDocid(docid)docid: 文檔Id號. FTP操作函數(shù)函數(shù)名參數(shù)說明listFTP(host, user, password, remoteDir)暫未實現(xiàn)uploadFTP(host, user, password, localFilePath, remoteDir)暫未實現(xiàn)downloadFTP(host, user, password, remoteFilePath, localDir)暫未實現(xiàn)deleteFTP(host, user, password, remoteFilePath)暫未實現(xiàn)deleteAllFTP(host, user, password, remoteDir)暫未實現(xiàn)renameFTP(host, user, password, remoteFilePath, toFileName)暫未實現(xiàn)moveFTP(host, user, password, remoteFilePath, toDir)暫未實現(xiàn). 數(shù)字函數(shù)函數(shù)名參數(shù)說明isPositive(num)num: 數(shù)字型參數(shù)判斷是否為正數(shù)isNegative(num)num