NameSpace tlv8
tlv8命名空间

 Class Summary
  tlv8
tlv8命名空间

 Method Summary
<static> data对象  XMLHttpRequest(actionName, param, post, ayn,callBack)
发送Action请求 参数
<static> xmlDom  strToXML(str)
将字符串转换成xml
<static> data对象  sqlQueryAction(dbkey,sql,callBack)
执行sql查询动作
<static> data对象  sqlQueryActionforJson(dbkey,sql,callBack)
执行sql查询动作JSON
<static> data对象  sqlUpdateAction(dbkey,sql,callBack)
执行sql跟新动作
<static> data对象  callProcedureAction(dbkey,ProduceName,Param,callBack)
调用存储过程
<static> data对象  callFunctionAction(dbkey,FunctionName,Param,callBack)
调用数据库函数
<static> string  numberL2U(data)
人民币大小写转换
<static> string  numberFormat(number,format)
数字格式化
<static> boolean  CheckMail(mail)
邮箱地址验证
<static> boolean  checkdate(date)
日期验证
<static>[prov,birthday,sex] getIdCardInfo(id)
根据身份证取 省份,生日,性别
<static> boolean  checkId(pId)
检查身份证号码
<static> boolean  Telephone(date)
电话号码验证
<static> boolean  CheckNumber()
数字验证
<static> void  GridSelect(div,dbkey,sql,master,caninput)
列表下拉
<static> void  TreeSelect(div,QueryAction,master)
树形下拉
<static> void  inputCaption(input,dbkey,table,cell,where)
录入提示
<static> void  showMessage(message)
浅入浅出提示信息 可用于非交互的错误提示
<static> void  ExcelImp(dbkey,table,relation,confirmXmlName,callback)
Excel数据导入
<static> void  ExcelExp(dbkey,table,relation,labels,where)
Excel数据导出
<static> void  standardPartition(div)
垂直分割线 (可拖动宽度)
<static> void  fileComponent(div,data,cellname,docPath,canupload,candelete, canedit, viewhistory, limit)
附件组件
<static> void  picComponent(div,data,cellname,canEdit)
图片组件
<static> String   encodeURIComponent(str)
字符串编码
<static> String  decodeURIComponent(endcodeedStr)
字符串反遍吗
<static> void  showModelState(flag)
模式操作
<static> boolean   isHaveAuthorization(url)
判断是否有功能权限

 Class Detail
tlv8
tlv8命名空间

 Method Detail
<static> data对象  XMLHttpRequest(actionName, param, post, ayn,callBack)
发送Action请求 参数

   Parameters:
     actionName
         {string}[required]action名称(可以带参数)
     param
         {Map}[required]参数
     post
         {string}提交方式(GET/POST;)
     ayn
         {string}否为异步请求true/false
     callBack
         {string}回调函数 为异步请求时这个要求必须

   Returns:
         {data对象}

   Example:
         var result=tlv8.XMLHttpRequest("sqlQueryAction?dbkey=tmjdb&sql=select * from
         TMJ_CUSTOMER_INFO","") ;


<static> string strToXML(str)
移除字符串

   Parameters:
     str
         {string}[required]需要转换为xml的dom对象的xml字符串

   Returns:
         {string}

   Example:
         var str="<a>aa</a><b>bb</b>";
         var xmlDom=tlv8.strToXML(str);


<static> data对象 sqlQueryAction(dbkey,sql,callBack)
执行sql查询动作

   Parameters:
     dbkey
         {string}[required]数据源名称
     sql
         {string}[required]sql字符串
     callBack
         {string}回调函数

   Returns:
         {data对象}

   Example:
        var result = tlv8.sqlQueryAction("system","select * from sa_opperson");

        result.flag 为是否执行成功 值:true 或 false

        result.message 为提示信息

        result.data 为xml结构字符串, 如: <name>value</name>

      可用 tlv8.strToXML函数转换成xml对象 如:var xmldata = tlv8.strToXML(result.data);

        result.getCount 获取查询结构的行数, 如: var count = result.getCount();

        result.getColumns 获取查询的所有列名, 如: var columns = result.getColumns();

        result.getValueByName 获取指定列的值, 如: var value = result.getValueByName("FNAME");

        result.getDatas 返回查询的结果集, 如: var datas = result.getDatas();

        查询多行数据建议使用tlv8.sqlQueryActionforJson();便于遍历数据。




<static> data对象 sqlQueryActionforJson(dbkey,sql,callBack)
执行sql查询动作JSON

   Parameters:
     dbkey
         {string}[required]数据源名称
     sql
         {string}[required]sql字符串
     callBack
         {string}回调函数

   Returns:
         {data对象}

   Example:
        var result = tlv8.sqlQueryActionforJson("system","select * from sa_opperson");

        result.data 为json数组, 如: [{name:value},...]

        result.flag 为是否执行成功 值:true 或 false

        result.message 为提示信息


<static> data对象 sqlUpdateAction(dbkey,sql,callBack)
执行sql跟新动作

   Parameters:
     dbkey
         {string}[required]数据源名称
     sql
         {string}[required]sql字符串
     callBack
         {string}回调函数

   Returns:
         {data对象}

   Example:
         var result = tlv8.sqlUpdateAction("system","update sa_opperson
         set sSex = '男'");


<static> data对象 callProcedureAction(dbkey,ProduceName,Param,callBack)
调用存储过程

   Parameters:
     dbkey
         {string}[required]数据源名称
     ProduceName
         {string}[required]存储过程名
     Param
         {string}存储过程需要的参数
     callBack
         {string}回调函数

   Returns:
         {data对象}

   Example:
         var r = tlv8.callProcedureAction("system","ProduceTest","123456;DYCRM201");


<static> data对象 callFunctionAction(dbkey,FunctionName,Param,callBack)
调用数据库的函数

   Parameters:
     dbkey
         {string}[required]数据源名称
     FunctionName
         {string}[required]数据库函数名
     Param
         {string}数据库函数需要的参数
     callBack
         {string}回调函数

   Returns:
         {data对象}

   Example:
         var r = tlv8.callFunctionAction("system","functionTest","123456;DYCRM201");


<static> string numberL2U(data)
人民币大小写转换

   Parameters:
     data
         {number}[required]需要转换为大写的数字

   Returns:
         {string}

   Example:
         tlv8.numberL2U(423.32);


<static> string numberFormat(number,format)
数字格式化

   Parameters:
     number
         {number}[required]需要被格式化的数字
     format
         {string}[required]格式(如:0,000.00)

   Returns:
         {string}

   Example:
         tlv8.numberFormat(23423423423423.87,'0,000.00'));


<static> boolean CheckMail(mail)
邮箱地址验证

   Parameters:
     mail
         {number}[required]需要进行格式验证的邮箱地址

   Returns:
         {boolean}

   Example:
         tlv8.CheckMail('lkj@163.com');


<static> boolean checkdate(date)
日期验证(yyyy-MM-dd)

   Parameters:
     date
         {string}[required]需要进行日期格式验证的字符串

   Returns:
         {boolean}

   Example:
         tlv8.checkdate('2011-12-12');


<static> [ prov, birthday, sex ] getIdCardInfo(id)
根据身份证取 省份,生日,性别

   Parameters:
     id
         {string}[required]身份证号码

   Returns:
         {[ prov, birthday, sex ]}

   Example:
         tlv8.getIdCardInfo('50024119870706615x')


<static> boolean checkId(pId)
检查身份证号码

   Parameters:
     pId
         {string}[required]身份证号码

   Returns:
         {boolean}

   Example:
         tlv8.checkId('50024119870706615x')


<static> boolean Telephone(date)
检查电话号码

   Parameters:
     date
         {string}[required]电话号码

   Returns:
         {boolean}

   Example:
         tlv8.Telephone('15887206089')


<static> boolean CheckNumber()
数字验证(输入框只能输入数字:整数、浮点数)

   Returns:
         {boolean}

   Example:
         <input ID="TBValNum" type="text" onkeydown="tlv8.CheckNumber.valNum(event);"
         onpaste="tlv8.CheckNumber.valClip(event);">


<static> void GridSelect(div,dbkey,sql,master,caninput)
列表下拉

   Parameters:
     div
         {string}[required]显示下拉列表的DIV标签对象
     dbkey
         {string}[required]数据源名称
     sql
         {string}[required]查询的SQL
     master
         {boolean}是否多选
     caninput
         {boolean}是否可录入

   Returns:
         {void}

   Example:
         <div id="testselect" onselected="thisvalue(this)"/>
         var testselect = document.getElementById("testselect");
         var sql = "select sName from sa_oporg";
         tlv8.GridSelect(testselect,"system",sql,false,true);


<static> void TreeSelect(div,QueryAction,master)
树形下拉

   Parameters:
     div
         {string}[required]显示树形下拉的DIV标签对象
     QueryAction
         {string}[required]java后端Action名称
     master
         {boolean}[required]是否多选

   Returns:
         {void}

   Example:
         <div id="tree-select-demo" onchecked="treesignChecked" style="width:180px"/>
         var treeDiv = document.getElementById("tree-select-demo");
         tlv8.TreeSelect(treeDiv,'getOrgTreeInfo',true);


<static> void inputCaption(input,dbkey,table,cell,where)
录入提示

   Parameters:
     input
         {Element text}[required]输入框对象
     dbkey
         {string}[required]数据源名称
     table
         {string}[required]数据库表名
     cell
         {string}[required]数据库表的列名
     where
         {string}[required]额外过滤条件

   Returns:
         {void}

   Example:
         <input size='100' id="quickText" onkeyup="tlv8.inputCaption(this,'system',
         'SA_OPOrg','sName','')"/>


<static> void showMessage(message)
浅入浅出提示信息 可用于非交互的错误提示

   Parameters:
     message
         {string}[required]需要显示的提示信息

   Returns:
         {void}

   Example:
         tlv8.showMessage('显示信息');


<static> void ExcelImp(dbkey,table,relation,confirmXmlName,callback)
Excel数据导入

   Parameters:
     dbkey
         {string}[required]数据源名称
     table
         {string}[required]数据库表名
     relation
         {string}[required]数据库字段名(逗号分隔)
     confirmXmlName
         {string}导入配置的xml文件名(可以不传此参数 默认为impConfirm.xml)
     callback
         {function}回调函数

   Returns:
         {void}

   Example:
         var relation="fTitle,fState,fEndDatetime";
         var confirmXmlName="impConfirm.xml";//和导入页面在同一路径下
         tlv8.ExcelImp("tmjcrm","TMJ_cusomerSurvey",relation,confirmXmlName,callback);


<static> void ExcelExp(dbkey,table,relation,labels,where)
Excel数据导出

   Parameters:
     dbkey
         {string}[required]数据源名称
     table
         {string}[required]数据库表名
     relation
         {string}[required]数据库字段名(逗号分隔)
     labels
         {string}[required]导出的Excel表头显示名称,和relation个数一致
     where
         {string}过滤条件

   Returns:
         {void}

   Example:
         var relation="fTitle,fState,fEndDatetime";
         var labels="标题,状态,结束时间";
         var where="fState='编辑中'";
         tlv8.ExcelImp("tmjcrm","TMJ_cusomerSurvey",relation,labels,where);


<static> void standardPartition(div)
垂直分割线 (可拖动宽度)

   Parameters:
     div
         {Element DIV}[required]垂直分割内容所在的Div层

   Returns:
         {void}

   Example:
         <div id="MyDiv" type="stpa" style="width: 100%; height: 100%;">
             <div stpa="left" style="width: 50%">
             ...左边内容...
             </div>
             <div stpa="right">
             ...右边内容...
             </div>
         </div>
         tlv8.standardPartition(document.getElementById("MyDiv"));


<static> void fileComponent(div,data,cellname,docPath,canupload,candelete, canedit, viewhistory, limit)
附件组件

   Parameters:
    参数说明:

    div:需要放置组件的层;

    data:绑定数据的data(tlv8.Data());

    cellname:附件相关字段(建议类型varchar(1024)或更长的字符类型);

    docPath:文件存储位置;如"/"或"/起步科技"(要求目录必须在文档中心存在);

    canupload:是否可上传(bollean 默认可上传需要取消权限可设置为false);

    candelete:是否可删除(用于删除控制 false为不可删除 默认可删除).

    canedit:是否可编辑(bollean 默认为false);

    viewhistory:是否可查看历史(bollean 默认为false);

    limit:可上传文件个数(number 默认不限);


   Returns:
         {void}

   Example:
        <fieldset style="width: 260px; height: 100px; align: center; margin: 0;padding: 0;">
        <legend>
        附件
        </legend>
        <div id="fileCompDiv"></div>
        </fieldset>        

        var data = new tlv8.Data();
        data.setDbkey("system");
        data.setTable("T_USERS");
        data.setFormId("uploadcopmtestform");
        var cellname = "FILECONT";//设置附件相关字段
        
 var fileComp = new tlv8.fileComponent(document.getElementById("fileCompDiv"),data,cellname);


<static> void picComponent(div,data,cellname,canEdit)
图片组件

   Parameters:
   参数说明:

        div:需要放置组件的层;

        data:绑定数据的data(tlv8.Data());

        cellname:附件相关字段(图片类型Blob或image);

        canEdit:是否可编辑(bollean 默认可编辑, 需要取消权限可设置为false);



   Returns:
         {void}

   Example:
        <form id="PICtestform" name="PICtestform"><!-- 图片组件 -->
        <div id="picDemo" style="width:200px;height:100px;"></div>
        <br/>
        <input type="text" id="SNAME" name="SNAME"></input><!--图片组件一般与数据单据共存-->
        <input type="button" value="保存" title="保存数据" onclick="PICsaveData()"></input>
        </form>
        <script type="text/javascript">
        var PICdata = new tlv8.Data();
        PICdata.setDbkey("system");
        PICdata.setTable("PIC_DEMO");
        PICdata.setFormId("PICtestform");
        var cellname = "SPIC";//设置附件相关字段
        var div = document.getElementById("picDemo");
        tlv8.picComponent(div,PICdata,cellname,true,true);
        function PICsaveData(){
        PICdata.saveData();
        }
        </script>


<static> string encodeURIComponent(str)
字符串编码 与tlv8.decodeURIComponent配合使用可以解决url参数包含特殊字符的问题

   Parameters:
   参数说明:

        str:需要编码的字符;

   Returns:
         {string}

   Example:
        var str = "fCode='zhangsan' and fName like ='%张三%'";
        var param = tlv8.encodeURIComponent(str);
        var url = "/JBIZ/TEST/START.html?param="+param;
        tlv8.portal.openWindow("测试页面",url);


<static> string decodeURIComponent(str)
字符串反编码 与tlv8.encodeURIComponent配合使用可以解决url参数包含特殊字符的问题

   Parameters:
   参数说明:

        str:需要编码的字符;

   Returns:
         {string}

   Example:
        var endcodeedStr = tlv8.RequestURLParam.getParam("param");
        var str = tlv8.decodeURIComponent(endcodeedStr);
        


<static> string showModelState(falg)
模式操作


   Parameters:
   参数说明:

        falg:是否锁住页面; flag为true锁住,flag为false解除

   Returns:
         {string}

   Example:
        tlv8.showModelState(true);//锁住页面
        tlv8.XMLHttpRequest("sqlQueryAction","","post",true,function(r){

tlv8.showModelState(false); //解除

}) ; //执行动作
        
        


<static> boolean isHaveAuthorization(url)
判断是否有功能权限


   Parameters:
   参数说明:

        url:功能地址

   Returns:
         {boolean}true/false

   Example:
        var flag = tlv8.isHaveAuthorization("/JBIZ/SA/OPM/agent/mainActivity.html");