Jasper-Reports-Publisher/docs/components/datasources/index.rst

79 lines
2.4 KiB
ReStructuredText

.. This is a comment. Note how any initial comments are moved by
transforms to after the document title, subtitle, and docinfo.
.. demo.rst from: http://docutils.sourceforge.net/docs/user/rst/demo.txt
.. |EXAMPLE| image:: static/yi_jing_01_chien.jpg
:width: 1em
**********************
Data Sources
**********************
.. contents:: Table of Contents
Data Source Types
=================
Data Sources are used to connect your Oracle database.
JRI Publisher supports both JDBC and JNDI Data Source types included with JRI.
JDBC Data Sources are stored in a flat file at::
${CATALINA_HOME}/jasper_reports/conf/
JDBC Data Sources have the following form::
#====================================================================
# JDBC datasource configuration
# http://www.orafaq.com/wiki/JDBC#Thin_driver
# additional jdbc configurations, please uncomment
#====================================================================
[datasource:test]
name=test
url=jdbc:oracle:thin:@127.0.0.1:1521:XE
username=my_oracle_user
password=my_oracle_user_pwd
JNDI Data Sources are stored in a database and referenced in the application server rather than stored in a flat file as with JDBC Data Sources.
JNDI Data Sources have the following form::
#====================================================================
# Native JNDI datasource, to be configured in the application server
# name: jndi_test
#====================================================================
[datasource:jndi_test]
type=jndi
name=jndi_test
Working with Data Sources
=========================
Data Sources can be added, edited and removed from the JRI Publisher Module via the Data Source tab, as shown below
.. image:: _static/data-source-tab.png
The default view on clicking the tab is the List view, as shown below.
.. image:: _static/data-source-default.png
To add a Data Source, click on the Add tab at top.
Select the desired Data Source type and enter the required information as shown below. Then click the Add button:
.. image:: _static/add-data-source.png
On the main Data Source tab we can confirm the Data Source has been added:
.. image:: _static/data-source-added-ok.png
To remove a Data Source, click on the Remove tab and select the Data Source you wish to remove using the drop-down selector as shown below:
.. image:: _static/data-source-remove.png