Using Databases

Search…
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
​Supported syntax​
​Declaring Tables​
​
Introduction - Previous
Using a Plug-in
Next - Introduction
Command Line Interface
Last modified 1yr ago
Export as PDF
Copy link
Contents