DB connections

Content [ Hide ]

Creating a DB connection in Xima® Formcycle. (1) To the left is a list of existing database connections. (2) On the right users can configure the selected database connection.

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", without all users having to know the access information.

Create database connection

  • Open the module "DB-connections" and click on the button "New" in the header of the list (see figure).
  • Allocate a various alias and an optional description.
  • For the data base connection itself, the following data is necessary:
    • Name: Name for this database connection.
    • Description: Description of the database connection
    • Type: Type of the database management system. Currently we support Oracle® MySQL, Oracle® Database, PostgreSQL, Microsoft® SQL Server and "Other (JDBC)".
      7.0.10+  The H2 database driver is no longer supplied by Xima® Formcycle since version 7.0.10 and has to be installed manually like the drivers of the other database types.
    • JDBC URL: The JDBC URL of the database server
    • 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
    • Username: Username of the database user.
    • Password: Password of the data base user.
    • 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".
    • Timeout: The idle timeout in milliseconds before the a database-connection is closed.
  • After creating the DB-connection, it appears in the left part (list) of the connections.

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.

Upload and execute script data

If you want to run an Sql 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.

Delete database connections

A database connection can only be deleted when it is not referenced by an action or database query anymore.