Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.gru
	1	+XWiki.awa

Content

...	...	@@ -2,35 +2,38 @@
2	2
3	3	Database connections pose a possibility to record data connections to different data bases, apart from location and type, centrally. You can access deposited file connections later comfortably, for example in ""actions" (data base) or "[[DB querys>>doc:DBQueries]]", without all users having to know the access information.
4	4
5		-{{figure image="db-verbindung-en.png" width="300"}}
6		-Creating an DB connection in {{formcycle case="dat"/}}
7		-{{/figure}}
	5	+{{id name="fig_data_db_con"/}}
	6	+{{figure image="data_db_con_en.png"}}Creating a DB connection in {{formcycle case="dat"/}}. (1) To the left is a list of existing database connections. (2) On the right users can configure the selected database connection.{{/figure}}
8	8
	8	+
	9	+{{html wiki="true"}}
	10	+<div class='xm-figure xm-float-right xm-clear-global' data-alt='Creating a DB connection in . (1) To the left is a list of existing database connections. (2) On the right users can configure the selected database connection.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='data_db_con_en.png' width='300' group='$height' group='$group' title='Creating a DB connection in . (1) To the left is a list of existing database connections. (2) On the right users can configure the selected database connection.'/}}<div class='xm-figure-caption'>Creating a DB connection in {{formcycle case="dat"/}}. (1) To the left is a list of existing database connections. (2) On the right users can configure the selected database connection.</div></div></div>
	11	+{{/html}}
	12	+
	13	+
9	9	== Create database connection ==
10	10
11		-* Open the module "DB-connections" and click on the button "New".
	16	+* Open the module "DB-connections" and click on the button "New" {{ficon name="plus-circle-outline"/}} in the header of the list (see [[figure>>||anchor="fig_data_db_con"]]).
12	12	* Allocate a various alias and an optional description.
13	13	* For the data base connection itself, the following data is necessary:
14		-** **Name**: Name of the database, which needs to be connected.
15		-** **Description**: Description of the database-connection
16		-** **Type:** Type of the database. At the time Oracle® MySQL, Oracle® Database, PostgreSQL, Microsoft® SQL Server and "Other (JDBC)" are available.
17		-** **JDBC URL**: The JDBC URL of the database-server
18		-** **JDBC driver**:The name of the JDBC driver if the type is "Other (JDBC)". This value can automatically be set with the button "Determine", othweise please refer [[Database configuration>>doc:Datenbankkonfiguration||rel="__blank"]].
	19	+** **Name**: Name for this database connection.
	20	+** **Description**: Description of the database connection
	21	+** **Type:** Type of the database management system. Currently we support Oracle® MySQL, Oracle® Database, PostgreSQL, Microsoft® SQL Server and "Other (JDBC)".
	22	+** **JDBC URL**: The JDBC URL of the database server
	23	+** **JDBC driver**:The name of the JDBC driver if the type is //Other (JDBC)//. This value can automatically be set with the button "Determine", otherwise please refer to [[database drivers>>doc:Formcycle.SystemSettings.DatabaseDrivers||rel="__blank"]]
19	19	** **Username**: Username of the database user.
20	20	** **Password**: Password of the data base user.
21	21	** **Number of connections at once**: Number of connections to the data base at once. On a great many of accesses to this connection, the value should be > 10. Notice here the utilization of the database server if necessary and accommodate the settings correspondingly. Normally the default setting 10 should be enough. Confirm the information with the button "Save".
22	22	** **Timeout**: The idle timeout in milliseconds before the a database-connection is closed.
23	23
24		-* After creating the DB-coonection, it appears in the left part (list) of the connections.
	29	+* After creating the DB-connection, it appears in the left part (list) of the connections.
25	25
26		-Before saving you have the opportunity to test the inserted data. The button "Tect connection" checks, if a connection was set up successfully. If no connection was set up, an error message is displayed. Then maybe approach the concerned administrator.
	31	+Before saving you have the opportunity to test the connection. Press the button //Test connection// to check if the connection can be established. If no connection could be established, read the error message carefully. If it does not help you, contact a system administrator.
27	27
28		-
29	29	== Upload and execute script data ==
30	30
31		-Via the button "Upload SQL file and execute" you can upload an SQL file, which is executed directly after uploading.
	35	+If you want to run an {{smallcaps}}Sql{{/smallcaps}} script, press the button //Upload SQL file and execute//. This lets you upload a file with the extension //sql//. It will be run immediately against the database connection.
32	32
33		-
34	34	== Delete database connections ==
35	35
36		-A DB-connection can only be deleted, if it is not referenced by an action/data source anymore.
	39	+A DB-connection can only be deleted {{ficon name="trash-alt2"/}}, if it is not referenced by an action or data source anymore.