自定义动作操作手册

自定义动作使用手册文档信息文档作者：彭祖运生成日期：2002-10-27 文档审核者：审核日期：文档维护记录维护日期维护人描述北京奥码天地信息技术有限公司自定义动作操作手册一、自定义动作的使用意义自定义动作一般是用来处理与数据信息直接相关的操作。

在OA系统中，数据库的所有的数据记录，都有类似的操作例如：添加，删除，详细，知会等动作，故这些动作被系统定义为通用的动作，系统管理员可以在数据库的权限设置的时候，将这些动作添加在某个数据的动作操作列表里。

但是，对于有些动作，它只需要在某个特定的情况下，在某个操作者执行时，才会出现让其操作，这些操作就依赖于自定义动作了。

例如会议系统的发会议通知：起草人（当前操作者）要向参会人（会前的一个字段值）发通知。

二、数据库自定义动作的设置现在以会前数据库为例，介绍说明如何设置数据库的自定义动作。

进入会前库数据库设置：说明：操作名称：自定义动作在详细模式下显示的名称图标：自定义动作列表或详细模式下显示的图标（对应/images/action/下的图标）条件：自定义动作出现的条件，使用php的if语句条件格式，可以使用以下参数{!字段名}表示当前数据的字段对应的数值{#姓名} {#岗位} {#部门} {#员工编号}：该用户的信息{|编辑} {|列表} {|详细} ...:该用户对该条数据的权限{^报表管理} {^数据库管理} {^流程管理} {^系统库管理} {^资料库管理}{^模块管理} {^超级用户}:该用户系统权限操作类型：数据更新：[新的字段名]=’新值’工程动作：对应工程动作列表中的工程动作名称外部操作：连接OA系统一个相对地址或是外部网站的绝对地址传递的数据：在工程动作中使用模板新建该数据的关联数据时使用三、操作说明：现在使用上面设置的自定义动作在会前库中添加一条数据：自定义条件是：{![主持人]}=='{#姓名}' and {![会议状态]}=='未通知' 当主持人察看这条数据，且[会议状态]== '未通知' 时，他将看到这个自定义动作，如上图。

自定义动作的功能是如下的PHP代码（给[参加人员]发通知，同时将该数据的[会议状态]置为'已通知'）：$id+=0;$card+=0;$db->query("select [参加人员],[会议名称] from {".$card."} where id=$id");if($db->next_record()){$ps=$db->f(0);$bt=$db->f(1);$nr="";SendMessage_ZHPS($card,$id,$ps,$bt,$nr);$db->query("update {".$card."} set [会议状态]='已通知',endflag=16 where id=$id");}print "<script>location.href='".GetUrl($back_url,2)."';</script>";exit;执行后的页面如下：这时，会议结束的条件出现，故出现会议结束自定义动作。

五、自定义动作的API函数：自定义动作中使用OA系统里的API函数，可以简化编程的复杂度，API函数列表如下：◆actinclude.php3文件的函数列表（扩展动作专用include文件）：function ChkPower($act,$card,$id,$lc,$lcstep) //检测当前数据对当前动作的权限function ReturnURL($userret) //返回需要返回的地址function ActConfirm($AlText) //动作确定(JS确认框)function ShowData($card,$id) //由布局到表格function EditData($card,$id,$rule="",$where="") //编辑当前数据function CopyDb2Db($scard,$sid,$dcard,$gz,$owner,$shareflag,$fjbz)//拷贝function updateDb2Db($scard,$sid,$dcard,$gz,$tj1,$tj2)//更新数据function sx2array($sx) //属性字符串转换成数组function SendMessageToAll($card,$id,$bt) //用于任务库系统◆func.php文件的函数列表(非内部网函数，可以读单独使用)function nr2html($s) //处理文本与html的显示function GetBack($type) //取得返回代码：type=0 无分支状态使用type=1 一般程序使用type=2function html2area($str) //将html转换为textareafunction area2html($str) //将在textarea中输入的内容转化为htmlfunction fgetdate() //返回当前日期function fgettime() //返回当前时间function fgettime() //返回当前时间function B_encode($s) //字符串转换function B_decode($s) //恢复字符串function chkpath($path) //将路径归整好返回，去掉//function FieldString($str)function MakeWriteDir($s) //为写入文件创建目录：$s为文件的绝对路径function VDPDelFile($path) //将文件删除function VDPCopyFile($path1,$path2) //将path1文件拷贝到$path2，统一使用这个函数拷贝文件，已确定将来可以在此扩展到处理文件uidfunction GetPageHtml($url,$page,$allnum,$pagenum)//用于显示分页的函数，$url=不含page参数的url变量，最后不带&,为空自动处理 page:页码(1~n)function checkstr($string) //返回格式化的字符串function riqi() //返回当前的日期function shijian() //返回当前的时间function counttable($db,$table,$where="")//返回$table表中的中的数据条数function PushUrl(&$back_url,$url,$flag=0)//用于返回。

将$back_url如栈function StripQuery($url,$para)//用于返回，去掉$url中的$parafunction PopUrl(&$back_url) //用于返回，将$back_url弹出function GetUrl($back_url,$flag=0) //用于返回，获得返回的$url值function GetMaxRowNum() //获取个人设置的最大条目function Printer($type="0",$value="") //用于打印function get_file_extends($f) //获取文件的扩展名function get_file_name($f) //获取文件名function trans_string($str) //将特殊字符串转义function restore_string($str) //将特殊字符串恢复function StripArray($a,$value="") //去掉数组中值为$value的function ArraySearchValue($a,$value)//搜索数组中值为$value的数组值的位置function ArraySearchKey($a,$key) //搜索数组中键值为$key的数组键值的位置function Cdebug($i) //检测速度function exit_php() //退出(exit)function checkMailLimit() //检测邮箱的容量gb2utf.php文件的函数列表(将给定数组转换成字符串和将给定字符串转换成数组)function arraytotxt($array,$n=0) //将给定数组转换成字符串$array 为给定的数组, $n 为递归的层数function txttoarray($str,$n=0) //将给定字符串转换成数组$str为给定的字符串, $n 为递归的层数function gb2utf($str) //下面这两个函数是将汉字由 Gb2 转化成Utf8 格式function utf2gb($str) //下面这两个函数是将汉字由 Utf8 转化成 Gb2 格式function convert($key,$field) //统计用 SQL 转换函数function convert1($key,$field)function convert2($field,$logic,$value) //根据给定的字段名($field)，逻辑($logic)，值($value)合成where条件function combine_where($where) //合成where条件nbwfunc.php3文件的函数列表(内部网专用函数)function GetWordEditHtml($path,$fid,$bt,$user,$type) //取得显示url的html代码。

type=0 cardshow显示模式function fieldchk($field) //判断字段是否为数字型若，为数字型返回$field，否则返回 '$field' function CreatTable($card,$newid="")//建立表，表的信息从 $card 得来，生成的表名为 t_cardcontent$newid function CreatTableLog($card) //建立log表，表名为 t_cardcon $card log function DBCopy($card,$cardnew)//复制数据库，$card为源数据库的编号或中文数据库名，$cardnew为新数据库的中文名称function SendMessage_ZH($card,$id,$user,$bt,$nr)//发出一个知会信息function SendMessage_XX($card,$id,$user,$bt,$nr)//发出一个消息function SendMessage_RW($card,$id,$srccard,$srcid,$user,$bt,$nr)//发出一个任务信息function Updateinfo($owner) //更新info.html文件function GetUserAct($card,$db,$dbid="")//获取用户自定义动作，返回 array[n][ACT/URL/ICON]function UserHtmlAct($uu) //获取用户自定义代码function SetDataStat($card,$id,$type)//设置一个数据对于某个人的处理状态type=0 发出（无） =1 接收 =2 查看 =3完成function SendLogMessage($card,$id,$user,$ft,$nf,$bt,$nr,$tarcard="",$tarid="")//将消息保存到 log 表中function cardtime($str) //返回时间function SendOrderMessage($url,$zt,$card,$id,$fenlei,$nr,$user,$bt,$time,$xxjb,$ft=0)//将消息保存到发送信息表中function GetTimeJJ($s) //返回时间间距function GetJavaSelTable() //将全部的数据表读出，用于合成选择数据库的java语句，参考/cards/setup/glsetup.php function auto_bj($card) //将$card的数据库进行自动布局function vTemplet($templet) //传入字符串 |s=1|r=2|g=3|... 传出数组 a[s]=1,a[r]=2,a[g]=3...function kindid2cards( $id ) //把卡片类型id变为卡片名称。