Test Data Cases (or G-Cases) are organized into a suite that contains one or many categories. Each category may have one or many cases.

A Test Data Case contains the configured Domains and parameters necessary to generate a variation of synthetic test data. Changes made at the Test Data Case level do not impact components at the Domain (Template) level and only apply to that case. 

In This Article

Prerequisite Steps

Users will need to complete the following project setup steps before following  the steps in this article:

  1. Create a Project with at least the Default Version.
  2. Import or create Domains. 
  3. Set Parent/Child Relationships at the Domain level (Manually or Wizard)
  4. Modify Attributes and Generators
  5. Add a Receiver to each Domain.
  6. Create Scenarios for needed Domains (Manually or Wizard).
  7. Create a Scenario Chain or Scenario Chain Set (as required).

Note: Some steps may be performed automatically when Domains are imported. 

Important: All of the above steps should be performed at the Domain level. Additional changes are then made at the Case level from within the G-Cases Management Dashboard to generate different variations of data using the defined template. 

Step 1 - Add a Case to the Selected Project Version

  • Select a Project and Project Version.
  • Select G-Cases within the Self Serve Menu Options.

  • Select a G-Case Suite and Category. Add these items first if they are not available. 
  • Click Add G-Case.

  • Enter a Name and Description
  • Click Save once finished.

Step 2 - Add Domains to the Case

Available Domains are based on the selected Project and Project Version. When multiple cases exist, click on a case name to select it.

  • Click the Plus (+) to add each Domain in the G-Case Editor tab.

    Tip: By clicking on the Plus (+) in the order the Domains should be listed, you will not have to change the order at a later time.

  • The added Domains will appear within the table on the right side of the G-Case Editor.

Step 3 - Change Domain Loop Counts

Each Domain added to a case will default to the global loop count value (i.e., #{global.DomainName.loopCount}). 

The Domain Loop Counts can be changed to set up different variations of generated data per case. Users can change or randomize the loop count value by using the Update Loop Count button. 

The following options are provided:  

  • Constant - Constant value that does not change (e.g., 5, 10)
  • Random - Randomly generated value within a Min and Max Range (e.g., between 1 and 3)
  • Increasing - Increasing from a Min to Max Value (e.g., 1 to 3)
  • Decreasing - Decreasing from a Max to Min Value (e.g., 3 to 1)

Note: Click here to see examples of changing and randomizing Domain loop counts.

(Optional) Add, Remove, and Modify Attributes at Case Level

After adding the required Domains, Attributes can be added, removed, and modified at the Test Data Case level. These changes do not impact what has been configured at the Domain (Template) level and include the following: 

  • Adding New Attributes to the Case Domain
  • Adding Domain Level Attributes to Make Changes at the Case Level

Once added, users can modify Generator Parameters, link Generators, or assign a new Generator. This works the same as it does at the Domain level.

Note: For more information, please see Adding Attributes to a Case Domain

(Optional) Turn Domains or Attributes On and Off within a Case

Domains and Attributes within a specific case can be turned on and off in multiple ways from within the G-Cases Management Dashboard.

Test data will not be generated for the Domain (including child hierarchy) or the individual Attribute when turned off. This can be done in one of the following ways: 

  1. Domain Tree View - Use to turn Domains and/or Attributes on or off. When a Domain or Attribute is unchecked, it is turned off. If it is a Domain with a child hierarchy, its entire hierarchy will also be turned off.

  2. Toggle Attributes Option - Turn Attributes on and off within a Domain.

  3. Domain Toggle - Turn a Domain and its child hierarchy on or off.

(Optional) Add Receivers or Change Receiver Parameter Values

Users can add the same Receiver to make parameter changes or a different Receiver. Changes here only apply to the individual case. They do not impact what has been configured for the Receiver at the Domain (Template) level.

  • Click the Pencil icon to edit the Domain.

  • Click the Plus+ to add the Receiver assigned at the Domain level to the case and make changes. 
  • Click New Receiver to add a different Receiver to the Domain at the case level.

(Optional) Add Rules and/or Queries

Test Data Rules and Queries can be added to an individual case. Users do not have to download the rules/queries to their local machine to generate test data when added to a case. To learn more, see these articles.

Next Steps

After setting up at least one case, download the suite or an individual case to your local machine and any other required files (Scenario, Scenario Chain, configuration files, etc.). 

Then, you can use the command provided in the G-Cases Management Dashboard to generate your test data. Please see this article for more information: How to Download and Run Test Data Cases.