• 周日. 7月 3rd, 2022

5G编程聚合网

5G时代下一个聚合的编程学习网

热门标签

报表系统 API接口

admin

11月 28, 2021

 

复杂报表除了提供上述标准化功能之外,还允许用户通过挂接自定义脚本插件以实现个性化报表需求。自定义脚本插件命名规则是XXX.php,其中XXX代表该报表的id(id可以通过查看编辑报表页面的地址而得到),存放路径为webrootgeneralappbuildermoduleseportplugin。用户自定义的脚本插必须实现以下函数:

/**

*这里实现个性化报表需求

*@param $obj_custome_report 代表当前复杂报表对象

*@return void

*/

function mydraw($obj_custom_report){

//按以下方式调用复杂报表接口

//$obj_custom_report->doCreateSheet(“我的报表”);

}

复杂报表处理引擎会在解析执行当前报表逻辑完成之后、最终输出报表之前判断本报表是否挂接有脚本插件,如果有,则包含该脚本文件并调用mydraw方法,并给它传递代表当前复杂报表对象的$obj_custom_report。复杂报表自定义脚本插件举例如下:

<?
/**
*这里实现个性化报表需求
*@param $obj_custome_report 代表当前复杂报表对象
*@return void
*/
function mydraw($obj_custom_report){
//按以下方式调用复杂报表接口
//$obj_custom_report->doCreateSheet(“我的报表”);
$arr_align = [“horizontal” => “left”, “vertical” => “center”];//对齐方式
$arr_border = [“style” => “thin”, “color” => [“argb” => “FF000000”]];//
$arr_Borders = [“left”=>$arr_border, “right”=>$arr_border,”top”=>$arr_border,”bottom”=>$arr_border];// 边框
$arr_header = [“type”=>”solid”, “color”=>[“argb”=>”FF0000FF”]];//蓝色 表头背景色
$arr_odd = [“type”=>”solid”, “color”=>[“argb”=>”FF00FF00”]];//绿色 奇数行背景数
$arr_even = [“type”=>”solid”, “color”=>[“argb”=>”FFFFFF00”]];//绿色 偶数行背景色

//获得数据集所有数据
$arr_row = $obj_custom_report->doOpenDataset(“人员情况”);
if(!empty($arr_row)){
$i_col = 0;
foreach($arr_row[0] as $s_key => $s_val){ //输出表头

$obj_custom_report->doSetValue(0, $i_col, 1, iconv(“GBK”, “UTF-8”, $s_key));
$obj_custom_report->doSetBorders(0, $i_col, 1, $arr_Borders);
$obj_custom_report->doSetFill(0, $i_col, 1, $arr_header);
$obj_custom_report->doSetAlign(0, $i_col, 1, $arr_align);
$i_col++;
}

$i_row = 2;
$i_prev_row = 2;
$s_prev_val = “”;
foreach($arr_row as $row){//输出数据
$i_col = 0;
foreach($row as $s_val){
$obj_custom_report->doSetValue(0, $i_col, $i_row, iconv(“GBK”, “UTF-8”, $s_val));
$obj_custom_report->doSetBorders(0, $i_col, $i_row, $arr_Borders);
if($i_row % 2 == 0){
$obj_custom_report->doSetFill(0, $i_col, $i_row, $arr_even);
}else{
$obj_custom_report->doSetFill(0, $i_col, $i_row, $arr_odd);
}
$obj_custom_report->doSetAlign(0, $i_col, $i_row, $arr_align);
if($i_col == 5){
if($s_prev_val != “” && $s_prev_val != $s_val){
if($i_prev_row < $i_row – 1){
$obj_custom_report->doMergeCells(0, 5, $i_prev_row, 5, $i_row – 1);
}
$i_prev_row = $i_row;
}
$s_prev_val = $s_val;
}
$i_col++;
}
$i_row++;
}
if($i_prev_row < $i_row – 1){
$obj_custom_report->doMergeCells(0, 5, $i_prev_row, 5, $i_row – 1);
}
}
}
?>

运行结果如下图所示:

复杂报表对象$obj_custom_report包含有丰富的接口供用户调用以实现个性化报表需求。复杂报表对象包含的API说明如下:

添加空白工作表

/**
* 添加空白工作表
* @param string $sTitle
* @param int $iSheetIndex 插入工作表位置(基于0)
* @return MySheet 新工作表对象
*/
public function doCreateSheet($sTitle = “”, $iSheetIndex = NULL)

拷贝工作表

/**
* 拷贝工作表
* @param string $sSourceSheetName 待拷贝的工作表名称
* @param string $sTargetSheetName 新工作表名称
* @param int $iSheetIndex 插入工作表位置(基于0)
*/
public function doCopySheet($sSourceSheetName, $sTargetSheetName, $iSheetIndex = NULL)

删除工作表

/**
* 删除工作表
* @param $iSheetIndex 工作表号(基于0)
*/
public function doRemoveSheet($iSheetIndex)

获得工作表号

/**
* 获得工作表号
* @param $sSheetName 工作表名
* @return int
*/
public function doGetSheetIndex($sSheetName)

获得工作表名

/**
* 获得工作表名
* @param $sSheetName 工作表名
* @return string
*/
public function doGetSheetName($iSheetIndex)

删除工作表

/**
* 删除工作表
* @param $sSheetName 工作表名
*/
public function doRemoveSheetByName($sSheetName)

获得最大列号

/**
* 获得最大列号
* @param $iSheetIndex 工作表号(基于0)
* @return int
*/
public function doGetMaxColumn($iSheetIndex)

获得最大行号

/**
* 获得最大行号
* @param $iSheetIndex
* @return int
*/
public function doGetMaxRow($iSheetIndex)

获得单元格区间

/**
* 获得单元格区间
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array [“x1″,”y1″,”x2″,”y2”]
*/
public function doGetRegion($iSheetIndex, $iColumn = 0, $iRow = 1)

获得字体信息

/**
* 获得字体信息
* underline: none double doubleAccounting single singleAccounting
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array
*/
public function doGetFont($iSheetIndex, $iColumn = 0, $iRow = 1)

设置字体信息

/**
* 设置字体
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @param array $arrFont 字体信息,参考getFont
*/
public function doSetFont($iSheetIndex, $iColumn = 0, $iRow = 1, $arrFont = [])

获得对齐信息

/**
* 获得对齐方式
* 水平对齐:general left right center centerContinuous justify
* 垂直对齐:bottom top center justify
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array
*/
public function doGetAlign($iSheetIndex, $iColumn = 0, $iRow = 1)

设置对齐信息

/**
* 设置对齐方式
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @param array $arrFont 对齐方式,参考getAlign
*/
public function doSetAlign($iSheetIndex, $iColumn = 0, $iRow = 1, $arrAlign = [])

获得单元格边框

/**
* 获得单元格边框
* 对角线方向:const DIAGONAL_NONE = 0; const DIAGONAL_UP = 1; const DIAGONAL_DOWN = 2;const DIAGONAL_BOTH = 3;
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array
*/
public function doGetBorder($iSheetIndex, $iColumn = 0, $iRow = 1)

设置单元格边框

/**
* 设置单元格边框
* 对角线方向:const DIAGONAL_NONE = 0; const DIAGONAL_UP = 1; const DIAGONAL_DOWN = 2;const DIAGONAL_BOTH = 3;
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @param array $arrBorders: [“left”,”right”,”top”,”bottom”,”diagonal”,”diagonaldirection”,”allborders”]
*/
public function doSetBorders($iSheetIndex, $iColumn = 0, $iRow = 1, $arrBorders = [])

获得单元格填充方式

/**
* 获得单元格填充方式
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array
*/
public function doGetFill($iSheetIndex, $iColumn = 0, $iRow = 1)

设置单元格填充方式

/**
* 设置单元格填充方式
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @param array $arrFills 格式参考getFill
*/
public function doSetFill($iSheetIndex, $iColumn = 0, $iRow = 1, $arrFills = [])

获得单元格数据格式化方式

/**
* 获得单元格数据格式化方式
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @return array
* code值为:General、@、0、0.00、#,##0.00、#,##0.00-、0%、0.00%、yyyy-mm-dd、yy-mm-dd、dd/mm/yy、d/m/y、d-m-y、d-m、m-y、mm-dd-yy、d-mmm-yy、d-mmm、mmm-yy、m/d/yy h:mm、d/m/y h:mm、h:mm AM/PM、h:mm:ss AM/PM、h:mm、h:mm:ss、mm:ss、h:mm:ss、i:s.S、h:mm:ss;@、yy/mm/dd;@、$#,##0.00-、$#,##0-、[$EUR ]#,##0.00
*/
public function doGetNumberFormat($iSheetIndex, $iColumn = 0, $iRow = 1)

设置单元格数据格式化方式

/**
* 设置单元格格式化方式
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iRow 行号(基于1)
* @param array $arrFormat
*/
public function doSetNumberFormat($iSheetIndex, $iColumn = 0, $iRow = 1, $arrFormat = [])

获得列宽度

/**
* 获得列宽度
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @return int
*/
public function doGetColumnWidth($iSheetIndex, $iColumn = 0)

设置列宽度

/**
* 设置列宽度
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param int $iWidth 宽度
*/
public function doSetColumnWidth($iSheetIndex, $iColumn = 0, $iWidth = 0)

获得行高度

/**
* 获得行高度
* @param $iSheetIndex 工作表号(基于0)
* @param int $iRow 行号(基于1)
* @return int
*/
public function doGetRowHeight($iSheetIndex, $iRow = 1)

设置行高度

/**
* 设置行高度
* @param $iSheetIndex 工作表号(基于0)
* @param int $iRow 行号(基于1)
* @param int $iWidth 宽度
*/
public function doSetRowHeight($iSheetIndex, $iRow = 1, $iHeight = 0)

获得列是否可视

/**
* 获得列是否可视
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @return boolean
*/
public function doGetColumnVisible($iSheetIndex, $iColumn = 0)

设置列是否可视

/**
* 设置列是否可视
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 列号(基于0)
* @param boolean $bVisible 是否可视
*/
public function doSetColumnVisible($iSheetIndex, $iColumn = 0, $bVisible = false)

获得行是否可视

/**
* 获得行是否可视
* @param $iSheetIndex 工作表号(基于0)
* @param int $iRow 行号(基于1)
* @return boolean
*/
public function doGetRowVisible($iSheetIndex, $iRow = 0)

设置行是否可视

/**
* 设置行是否可视
* @param $iSheetIndex 工作表号(基于0)
* @param int $iRow 行号(基于1)
* @param boolean $bVisible 是否可视
*/
public function doSetRowVisible($iSheetIndex, $iRow = 0, $bVisible = false)

合并单元格

/**
* 合并单元格
* @param $iSheetIndex 工作表号(基于0)
* @param $iStartCol 起始列号(基于0)
* @param $iStartRow 起始行号(基于1)
* @param $iEndCol 终止列号(基于0)
* @param $iEndRow 终止行号(基于1)
*/
public function doMergeCells($iSheetIndex, $iStartCol, $iStartRow, $iEndCol, $iEndRow)

取消合并单元格

/**
* 取消合并单元格
* @param $iSheetIndex 工作表号(基于0)
* @param $iStartCol 起始列号(基于0)
* @param $iStartRow 起始行号(基于1)
* @param $iEndCol 终止列号(基于0)
* @param $iEndRow 终止行号(基于1)
*/
public function doUnmergeCells($iSheetIndex, $iStartCol, $iStartRow, $iEndCol, $iEndRow)

插入行

/**
* 插入行
* @param $iSheetIndex 工作表号(基于0)
* @param $iBefore 插入行位置(基于1)
* @param $iNumRows 插入行数
*/
public function doInsertNewRowBefore($iSheetIndex, $iBefore = 1, $iNumRows = 1)

插入列

/**
* 插入列
* @param $iSheetIndex 工作表号(基于0)
* @param $iBefore 插入列位置(基于1)
* @param $NumColumns 插入列数
*/
public function doInsertNewColumnBefore($iSheetIndex, $iBefore = 0, $NumColumns = 1)

删除行

/**
* 删除行
* @param $iSheetIndex 工作表号(基于0)
* @param $iRow 删除行位置(基于1)
* @param int $iNumRows 删除行数
*/
public function doDeleteRow($iSheetIndex, $iRow, $iNumRows = 1)

删除列

/**
* 删除列
* @param $iSheetIndex 工作表号(基于0)
* @param int $iColumn 删除列位置(基于0)
* @param int $iNumColumns 删除列数
*/
public function doDeleteColumn($iSheetIndex, $iColumn = 0, $iNumColumns = 1)

获得单元格数据

/**
* 获得单元格数据
* @param $iSheetIndex 工作表号(基于0)
* @param $iColumn 列号(基于0)
* @param $iRow 行号(基于1)
* @return mixed
*/
public function doGetValue($iSheetIndex, $iColumn, $iRow)

设置单元格数据

/**
* 设置单元格数据
* @param $iSheetIndex 工作表号(基于0)
* @param $iColumn 列号(基于0)
* @param $iRow 行号(基于1)
* @param mixed $pValue 数值
*/
public function doSetValue($iSheetIndex, $iColumn, $iRow, $pValue)

设置单元格日期时间数据

/**
* 设置单元格日期时间数据
* @param $iSheetIndex 工作表号(基于0)
* @param $iColumn 列号(基于0)
* @param $iRow 行号(基于1)
* @param $iYear 年
* @param $iMonth 月
* @param $iDay 日
* @param $iHour 小时
* @param $iMinute 分钟
* @param $iSecond 秒
*/
public function doSetDateTimeValue($iSheetIndex, $iColumn, $iRow, $iYear, $iMonth, $iDay, $iHour, $iMinute, $iSecond)

获得本地数据库连接

/**
* 获得本地数据库连接
* @return yiidbConnection
*/
public function doGetDb()

根据数据库连接操作数据库,常见方法举例如下:

$command = $connection->createCommand(‘SELECT * FROM post’);

$posts = $command->queryAll();

$post = $command->queryOne();

$command = $connection->createCommand(‘UPDATE post SET status=1’);

$command->execute();

$command = $connection->createCommand(‘SELECT * FROM post WHERE id=:id’);

$command->bindValue(‘:id’, $_GET[‘id’]);

$post = $command->query();

获得数据源里配置的数据库连接

/**
* 获得第三方数据库访问链接功能
* @param $s_sername 数据源名称
* @param string $s_db 数据库名称
* @return mixed|null 数据库连接
*/
public function doGetOtherDB($s_sername, $s_db = “”)

获得参数值

/**
* 获得参数值
* @return array
*/
public function doGetParams()

打开数据集(返回数据集所有数据)

/**
* 打开数据集
* @param $s_dataset 数据集名称
* @return array
*/
public function doOpenDataset($s_dataset)

发表评论

您的电子邮箱地址不会被公开。