单物理库配置

单物理库的配置包含server.xml和service.xml，文件说明如下：

Ø  server.xml

将server.xml文件部署在报表[安装根目录]\report\services的根目录下，其内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<SERVER host="127.0.0.1" license="" port="3366" timeout="3000" log="true" autoStart="false">

<SERVICE name="datalogic"/>

</SERVER>

 

<SERVER/>标签属性如下：

host: 报表DQL Server的主机IP地址。

license: 润乾报表授权。按绝对路径和类路径次序查找授权文件。

port: 报表DQL Server的侦听端口号，缺省为3366。

timeout: 报表DQL Server的最长等待客户端时间，超时后重新等待，缺省为3000，单位为毫秒。该参数影响关闭报表DQL Server的响应时间，时间越长，CPU性能浪费越少，关闭服务器等待时间越长。

log: 是否记录运行日志，缺省为true。日志文件存于[应用根目录]\services\服务目录\log下。

autoStart: 是否自动启动服务，缺省为false。

 

<SERVICE/>: 需要启动的报表DQL Server服务列表，可配置多个，多个时则需添加多个<SERVICE/>节点，每个<SERVICE/>的name属性所指定的服务都必须位于[应用根目录]\services下，services目录下可以有多个报表DQL Server服务目录，但只有这里列出的服务才会被启动。

name: 报表DQL Server的名称，名称必须与服务目录的文件夹名称一致。

 

注：蓝色文字部分为必须配置的节点或属性。

 

Ø  service.xml

将service.xml文件部署在报表[安装根目录]\report\services\服务目录\的根目录下，其内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<SERVICE logicmetadata="demo.lmd">

<DB type="HSQL">

<CONNECTION name="db1" type="jndi" jndi="java:comp/env/report" user="" password=""/>

<CONNECTION name="db2" type="jdbc" url="jdbc:hsqldb:hsql://127.0.0.1/dqldemo" driver="org.hsqldb.jdbcDriver" user="sa" password=""/>

</DB>

<USERS>

<USER name="root" password="root" admin="true">     

<CONNECTION name="db2" />

<CONNECTION name="db1" user="wn" password="wn"/>

</USER>

<USER name="ww" password="ww"/>

</USERS>

</SERVICE>

 

<SERVICE/>标签属性如下：

logicmetadata: 报表DQL Server的元数据文件，存于[应用根目录]\services\服务目录\conf 下。

 

<DB/>配置报表DQL Server使用的物理数据源，标签属性如下：

type: 数据库类型，取值范围ORACLE、SQLSVR、SYBASE、SQLANY、INFMIX、FOXPRO、ACCESS、FOXBAS、DB2、MYSQL、KINGBASE、DERBY、HSQL、TERADATA、POSTGRES、UNKNOWN等。

<CONNECTION/>配置报表DQL Server的物理数据源的连接信息，标签属性如下：

name：物理数据源的名称。

type：连接类型，取值范围jndi、jdbc。jndi：通过web服务环境Context连接；jdbc：通过加载数据库驱动连接。

jdbc连接类型的数据源需同时设置driver（数据库驱动类）、url（数据库连接URL）、user（数据库用户名）、password（数据库密码）属性。

jndi连接类型的数据源需同时设置jndi（JNDI服务提供者的URL）、user（数据库用户名）、password（数据库密码）属性。

 

<USERS/>配置报表DQL Server的用户权限，可配置多个用户，多用户时则添加多个<USER/>节点。

<USER/>配置报表DQL Server的用户连接信息，标签属性如下：

name：连接报表DQL Server的用户名，可选。（注：使用ODBC连接报表DQL Server时，必填）

password：连接报表DQL Server的密码，可选。（注：使用ODBC连接报表DQL Server时，必填）

admin：当前用户是否为管理员，可选。

<CONNECTION/>配置当前用户可连接的数据源名称。可配置多个连接，多连接时则添加多个<CONNECTION/>节点。标签属性如下：

name：要连接的物理数据源名称，连接name必须在<DB>节点已配置，可选。

user：当前用户可以设置自己的数据库用户名，可选。

password：当前用户可以设置自己的数据库密码，可选。

当<USER/>下配置多个<CONNECTION/>节点时，按照其先后顺序，依次进行尝试连接。

当<USER/>下没有配置自己要连接的数据源时，则按照<DB/>节点下的数据源配置的先后顺序，依次进行尝试连接。

 

注：（1）蓝色文字部分为必须配置的节点或属性。

（2）若xml文件中包含特殊字符，需先将特殊字符进行转义，再写入文件中，如将"&"写成"&amp;"。

 

补充说明：

在部署报表DQL Server时，如需修改产品某个逻辑数据库(以datalogic为例)目录下的元数据文件和数据源配置，除手动修改配置文件外，还可通过下面方式进行：

在DQL元数据层设计器中启动报表 DQL Server 时，通过其菜单选项传递相应的属性值，直接实现部署期间的修改。

首先，勾选选项菜单中的启动报表DQL服务时弹出部署窗口

然后，点击服务 - 启动报表DQL服务器，弹出如下窗口：

数据源：下拉列表中的数据源均来自系统 - 数据源中所添加的物理数据源。

报表DQL服务目录：需要修改的逻辑数据库目录所在路径，默认为datalogic逻辑数据库的路径。

元数据文件：新元数据文件所在路径，程序会将该文件上传至报表DQL服务目录所在的逻辑数据库中。

点击【确定】后，程序会根据元数据文件路径获取元数据文件，并将文件上传至[安装根目录]\report\services\datalogic\conf目录下，数据源名称和元数据文件名称也会同步修改到[安装根目录]\report\services\datalogic\service.xml中。