Using Databases
Concordia can use databases to retrieve test data or to set the testing environment up before or after running test scripts.
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:npx concordia --db-install mysql
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
.Use
--db-uninstall
plus the driver name. Example:npx concordia --db-uninstall mysql
Just uninstall and then install it again.
A
Database
is global declaration. You must declare it once and then import its file in other features. Example:db.feature
Database: My DB
- type is "mysql"
- host is "127.0.0.1"
- name is "acme"
- username is "tester"
- password is "secret"
Database: Another DB
- type is "json"
- path is "./db.json"
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
import "db.feature"
# ... other declarations here ...
UI Element: Profession
- value comes from "SELECT name FROM [My DB.profession]"
Otherwise, I see "Profession not found."
- required
Otherwise, I see "Please select the profession."
Before Each Scenario:
Given that I connect to [My DB]
When I run the script 'DELETE FROM profession'
and I run the script 'INSERT INTO profession (name) VALUES ("Enginner"), ("Accountant")'
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.
Last modified 2yr ago