Test Data Generation

Owned by Eric Darchis
Last updated: Apr 26, 2023
3 min read

General information

Each openIMIS module can provide scripts that automatically generate test data with some different patterns to fill the database with a certain amount of data.

Since these scripts are only intended for special test installations and for security purpose, they can only be run from the command line.

Note for developers: do not forget to add a __init__.py file into your commands folder or the commands will not be available when installing the module from pypi.org

Insuree module

The insuree module has a custom Django command generateinsurees that can generate any number of insurees, along with their family and an optional active policy.

Requirements

The Faker module must be installed (see dev-requirements).

Syntax

The generateinsurees syntax is the following:

generateinsurees <number_of_families> <number_of_members_in_each_family> [--policy] [--verbose] [--locale=<locale_name>]

  • <number_of_families>: the number of families that must be generated. Mandatory.

  • <number_of_members_in_each_family>: the number of extra family members - on top of the family head - that should be added to the existing family. Mandatory.

  • [--policy]: (optional) creates an active policy for this family.

  • [--verbose]: (optional) writes in the standard output what the script is doing.

  • [--locale=<locale_name>]: (optional) creates insurees with names that sound like typical names from the country represented by <locale_name>. The list of available locales is available here. A locale can only be used if the faker.providers.person entry is present in the list.

Each generated insuree will have a randomly generated chf_id (code).

Examples

openimis-be_py/openIMIS (openimis-venv) ❯ python manage.py generateinsurees 4 2 --policy --locale=fr_BE

The above command will generate 4 families of 3 members (2 members + 1 head), with an active policy, with Belgian French names.

Similarly, with verbose output and Nepalese locale:

openimis-be_py/openIMIS (openimis-venv) ❯ python manage.py generateinsurees 5 1 --locale=ne_NP --verbose 1 created head insuree and family शिखा राजकर्णिकार 151523265 Created family member 1 सानु 2 created head insuree and family उषा सुनुवार 767839402 Created family member 1 उम्मेद 3 created head insuree and family गोविन्द महर्जन 182442233 Created family member 1 डा. 4 created head insuree and family आयुषा श्रेष्ठ 165451952 Created family member 1 स्वेच्‍छा 5 created head insuree and family निम्मी शाह 376845104 Created family member 1 श्रद्धा

Claim module

 

The claim module has a custom Django command generateclaims that can generate any number of claims, along with their services and items.

Syntax

The generateclaims syntax is the following:

generateclaims <number_of_claims> <number_of_services_in_each_claim> <number_of_items_in_each_claim> [--verbose]

  • <number_of_claims>: the number of claims that must be generated. Each claim will be generated with a random code. Mandatory.

  • <number_of_services_in_each_claim>: the number of services that should be included in each claim. These services are selected randomly among the existing ones, with a random price ([1 ; 1000]) and a random quantity ([1 ; 10]). Mandatory.

  • <number_of_items_in_each_claim>: the number of items that should be included in each claim. These items are selected randomly among the existing ones, with a random price ([1 ; 1000]) and a random quantity ([1 ; 10]). Mandatory.

  • [--verbose]: (optional) writes in the standard output what the script is doing.

Example

openimis-be_py/openIMIS (openimis-venv) ❯ python manage.py generateclaims 4 2 0 --verbose

The above command will generate 4 claims, each of which will have 2 services and no item. The generation process will be displayed in the standard output.

 

 

 

Did you encounter a problem or do you have a suggestion?

Please contact our Service Desk


This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. https://creativecommons.org/licenses/by-sa/4.0/