Demo Data Generation Guide

1 Introduction
2 Feature Activation
3 Feature User Rights Configuration
4 Feature Usage

Introduction

The Surveillance Outbreak Response Management and Analysis System (SORMAS) offers a built-in developer modus (“dev mode”) feature that allows creation of randomly generated data. Dev mode allows users to use functionalities that are not intended for live systems, such as creating random entities for testing or training purposes.

The test entities that may be generated include: Cases, Contacts, Events and Samples.

This feature should (1) be activated in the .env file of the system (see Feature Activation) by a system administrator and (2) can only be access by a user that has the “Configuration > Access developer options” user right assigned to their user role (see, Feature User Rights Configuration).

Feature Activation

To activate the Developer Options for data generation, set “devmode=true” in the server .env file. See https://github.com/hzi-braunschweig/SORMAS-Project/wiki/Server-Configuration-Options#server-settings for a full list of server feature configurations.

devmode Server Configuration Listing on GitHub

Figure 2 SORMAS .env File with DEVMODE=true (line 76)

Feature User Rights Configuration

For a user to access Developer Options, the “Access developer options” user right must be selected as part of their assigned user role.

In order to add this to a user role, navigate to Users > User Roles (Tab) > Click on the appropriate user role > Scroll to the “Configuration” section, add “Access developer options” and Save.

For more information on User Role Configuration, see https://github.com/hzi-braunschweig/SORMAS-Project/blob/development/docs/SERVER_CUSTOMIZATION.md#user-role-configuration .

Feature Usage

The Developer Options are accessible (if point 2 and 3 above have been completed successfully) by navigating to: Configuration > Developer (Tab).

Please Note:
This feature may be used to generate test entities based on the predefined values. Enter the values, then click on “Generate”. Generating a lot of data at once might take some time. Generated data is neither fully deterministic, nor fully random, and intended for testing and demonstration purposes only. When generating contacts, the generator will pick random existing cases as source. Please make sure the case database is not empty before generating contacts.