EeasyBI报表系统 数据源选择代码开发手册

数据源——选择代码开发手册

一、数据源代码路径

 

数  据  源  代  码  以  文  件  夹  的  形  式  放  在  “   MYOA根 目 录

 

/webroot/inc/db2.0/data_source”下，即插即用，无需做任何数据库方面的修改。

 

如图所示，first_demo 即为一个数据源代码，路径为

 

 “D:/MYOA/webroot/inc/db2.0/data_source”。

 

二、数据源代码包含的文件

 

1、数据源代码主体文件

 

主体文件命名要求：与数据源代码文件夹同名，后加

 

 “DataSource.class.php”；特殊情况，如果数据源代码文件夹的名字中包

 

含下划线，则主体文件命名时需要将下划线去掉，并把下划线后的第一个字母大写。

 

如图所示，数据源代码文件夹的名字为“first_demo”，则主体文件名字为“firstDemoDataSource.class.php”。 需要注意的是数据源代码命名时只

能包含大写、小写英文，数字和下划线，且第一个字符不能是下划线。

 

2、数据源代码配置文件

 

配置文件命名要求：与数据源代码文件夹同名，后加“.ini”；

 

 

如图所示，数据源代码文件夹的名字为“first_demo”，则配置文件名字为 “first_demo.ini”。数据源代码文件夹下 必需包含主体文件和配置文件。

三、数据源代码编写

 

1、数据源代码主体文件

i.

如图所示， 文件中必需引用与数据源代码文件夹相同目录下的

 

“dataSource.class.php”文件。

 

ii.

如图所示，文件中必需声明一个与主体文件名字相同的类，并继承

 

“dataSource”父类。

 

iii.

如图所示，类中 必需声明一个“protected”方法“createDataSource”。

 

1. “createDataSource”方法的实现

 

“createDataSource”方法中必需对类成员变量“$this->dataSource”进

 

行定义；其结构如上图所示，包含两部分内容，“columns”为列头信

 

息，“data”为数据体。

 

“columns”为一个二维数组，其中每个子数组里面包含“title”和“desc”字段；“title”为列头的英文名称，“desc”为列头的中文描述，在 “desc”不为空时，二维表展示的列头信息为中文，否则为英文。

 

如图所示，“用户 ID”和“性别”的“desc”字段都不为空，展示中文， “USER_NAME”的“desc”字段为空，展示英文。需要注意的是“title”不

能为空。

 

“data”同样为一个二维数组，每一个子数组中都需要对列头信息中的“title”字段进行赋值。

 

如图所示，数据源数据会按照代码中数据定义的顺序进行展示。

 

1. 主体文件中可以调用的资源

1. 1. 本地 MySQL 数据库连接对象“$this->_db”：

 

如图所示，“$this->_db”所处数据源为本地 MySQL，且与 TD_OA 保持连接，则其可以通过“prepareQuery”函数对 SQL 进行处理并返回如下图格式的数据。

 

 

 

1. 1. 外部数据库连接对象“$this->_data_source”：

 

该对象为本数据集所处数据源的数据库连接对象，且与选择的数据库保持连接状态。

 

如图所示，“$this->_data_source”所处数据源为本地 MySQL，且与

 

TD_OA 保持连接，则其可以通过“getDataSQL”函数对 SQL 进行处理并返回如下图格式的数据。

 

1. 1. $this->sys_user_id：当前登录用户 ID。4.$this->sys_user_name：当前登录用户姓名。5.$this->sys_dept_id：当前登录用户部门 ID。

6.$this->sys_dept_name：当前登录用户部门名称。7.$this->sys_user_priv：当前登录用户角色。

8.$this->sys_user_priv_name：当前登录用户角色名称。

 

 

 

 

如图所示，调用 3-8 的资源返回以下数据结果。

 

2、数据源代码配置文件

 

如图所示，配置文件中目前支持 3 项配置信息，“NAME”，“DESC”， “STOP”。

“NAME”表示该代码的名称； “DESC”表示该代码的中文描述；

“STOP”表示该代码是否停用，0 表示启用，1 表示停用，停用之后的代

 

码不会在任何代码列表界面中显示。

 

如图所示，代码的各项配置信息在代码列表中的展示。

 

四、检查数据源代码正确性

 

如果数据源代码中需要调用“$this->_db”资源，则在“系统管理->T-ERPLink数据源管理”中选择任意的数据集即可。

如果数据源代码中需要调用“$this->_data_source”资源，则需要在“系统管理

 

->T-ERPLink 数据源管理”中选择对应的数据集。

 

 

 

 

 

如图所示，样例数据源代码中需要调用“$this->_data_source”资源，则首先选

 

择对应数据集并在上方灰色区域点击鼠标右键，选择“查看框架的源代码（”  以

 

chrome 浏览器为例），在打开的新窗口中记录“server_id”，上图为 47。

 

如图所示，在“MYOA 根目录/webroot/”下新建一个 php 文件，内容同上， “server_id”为上述所记录的 server_id，“db_name”为 SQL 需要操作的数据库，并在浏览器进行访问。

 

 

 

如果数据源代码编写无误，则返回如上图类似结构的数据。

 

 

如果数据源代码编写有误，则返回如上图类似结构的数据，并有错误信息提示，帮助用户进行后续调试。