Database drivers

Error number 4001 in 4: Error while evaluating velocity template menus_content.vm

The error message appears when no database drivers are installed. You need to install the appropriate database driver for your database management system.

Xima® Formcycle does not ship with any database driver anymore. This allows you to use different drivers and driver versions. However, you must first install the appropriate driver for the database management system you are using. The driver are available from the official page of the respective database management system:

The installation procedure depends on the application server you are using. You can find instructions for Apache Tomcat here.

Collation / Encoding

A database lets you choose between different encodings (collation). For Xima® Formcycle, we recommend you use a UTF-8 collation that is case-sensitive. Specifically, we recommend the collation:

utf8_bin

When you use a different collations such as utf8_general_ci (UTF-8, case insensitive), you may encounter issues as that collation does not distinguish between upper case and lower case letters.

Notes on MS SQL and Encoding

For the 2019 server version the encoding Latin1_General_100_CI_AS_SC_UTF8 should be used. In the previous versions it is best to use the following Latin1_General_CI_AS.

Notes on Oracle MySQL

Using Unicode with Oracle MySQL. Normally, the database driver recognizes the encoding automatically. In case it does not, you can specify the encoding explicitly.

Since version 8, Oracle MySQL does not recognize the timezone name Cest anymore. By default, the operating system transmit the timezone to the database. When it transmit that timezone name, the database connection cannot be established. In this case, you can specify the timezone explicitly via the Jdbc-Url:

jdbc:mysql://localhost/db?serverTimezone=Europe/London

Also, there are some circumstances when the character encoding is not recognized correctly. If that happens, you can pass the encoding via Jdbc-Url as well. For example, when using Unicode and the database setting connection collation was set to utf8_general_ci:

jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8

Using different database systems

It is also possible to use different database management systems such as HSQLDB, Derby, or Informix. This requires that you installed the corresponding database driver. Here is a list of the Jdbc-Url and driver class for some database management systems:

NameJDBC-URLJDBC-driver class
 SAP HANA jdbc:sap://<dbhost>:30015/ com.sap.db.jdbc.Driver
 Informix jdbc:informix-sqli://<dbhost>:9088/sysuser:INFORMIXSERVER=hpjpcom.informix.jdbc.IfxDriver
 HSQLDB jdbc:hsqldb:mem:<dbname> org.hsqldb.jdbc.JDBCDriver
 Derby jdbc:derby:target/tmp/derby/hpjp;databaseName=<dbname>;create=true org.apache.derby.jdbc.EmbeddedDriver
Tags:
Copyright 2000-2024