Using Databases
Concordia can use databases to retrieve test data or to set the testing environment up before or after running test scripts.

Installation

Installing

To reduce the number of downloaded packages, Concordia Compiler 2 does not install database drivers by default anymore - as version 1 did.
Use --db-install plus the driver name. Example:
1
npx concordia --db-install mysql
Copied!
Available driver names:
Driver Name
Database
note
csv
CSV files
xlsx
Excel files
firebase
Firebase
ini
INI files
json
JSON files
Already installed
mysql
MySQL
adodb
MS Access
Windows only
mssql
MS SQL Server
postgres
PostgreSQL
sqlite
SQLite
Database drivers are installed as development dependencies of your application.
You can also install or uninstall them with NPM, prefixing the driver name with database-js-. Example: npm i -D database-js-mysql.

Uninstalling

Use --db-uninstall plus the driver name. Example:
1
npx concordia --db-uninstall mysql
Copied!

Upgrading

Just uninstall and then install it again.

Usage

A Database is global declaration. You must declare it once and then import its file in other features. Example:
db.feature
1
Database: My DB
2
- type is "mysql"
3
- host is "127.0.0.1"
4
- name is "acme"
5
- username is "tester"
6
- password is "secret"
7
8
Database: Another DB
9
- type is "json"
10
- path is "./db.json"
Copied!
A database can be referenced inside UI properties and Test Events by its name between [ and ]. Example: [My DB]. To reference a database table, separate the table name from the database name with with a dot (.) - e.g. [My DB.profession]. Let's see an example:
example.feature
1
import "db.feature"
2
3
# ... other declarations here ...
4
5
UI Element: Profession
6
- value comes from "SELECT name FROM [My DB.profession]"
7
Otherwise, I see "Profession not found."
8
- required
9
Otherwise, I see "Please select the profession."
10
11
Before Each Scenario:
12
Given that I connect to [My DB]
13
When I run the script 'DELETE FROM profession'
14
and I run the script 'INSERT INTO profession (name) VALUES ("Enginner"), ("Accountant")'
15
Copied!
Instead of reinventing the wheel, Concordia uses SQL to query and modify databases and files. Even JSON and INI files can be queried with SQL.
In the example above, the property value from the UI Element "Profession" indicates that its (valid) values are retrieved from the table "profession" that belongs to the database declared as "My DB". The test event Before Each Scenario was declared to connect to the database, clean the table "profession", and then insert new records that the UI Element "Profession" will use.

See also

Last modified 1yr ago