Description

This article will walk you through every step for generating test data from EDI Projects in the GenRocket web platform. It will cover the following steps: 

  1. Set up GenRocket VPC Runtime
  2. Set up your Database Connection Properties File
  3. Set up Resources in the GenRocket Platform
  4. Download and Update my profile.prg File
  5. Download the EDI Configuration File
  6. Download the Scenario Chain Set for the EDI Project
  7. Set up Test Data Queries (Optional)
  8. Set up Test Data Rules (Optional)
  9. Set up Test Data Cases (Optional)
  10. Run the Scenario Chain Set with the Test Data Case from the Command Line


Step 1: Set up GenRocket VPC Runtime

If you have successfully completed GenRocket University, you will need to migrate to the GenRocket VPC Runtime. Otherwise, you can start by installing the GenRocket VPC Runtime from scratch. 


Step 1a- Migrate from GenRocket University

GenRocket University uses a different GenRocket Runtime and you must migrate to GenRocket VPC Runtime prior to performing any other steps. 


The steps are provided in this knowledge base article: How to move from GenRocket University Runtime to GenRocket App Runtime.


Note: If you have not installed GenRocket Runtime, continue with Step 1b below. 


Step 1b - GenRocket Runtime Installation from Scratch

If you have not installed GenRocket Runtime for University, then you will need to install the GenRocket VPC Runtime from scratch. The steps for this process vary per operating system and links are provided below: 

           

Step 2: Set Up Your Database Connection Properties File

A Database Connection Properties File can be used on the user's local machine to connect to a database. A database connection allows individual users to retrieve data from and populate tables within the connected database. 


Each user wanting connect to a database will need to create a Database Connection Properties File on their local machine. The format for the file is shown below: 


driver=<JDBCDriverClassName>
user=<userToConnectToDatabase>
password=<passwordToConnectToDatabase>
url=<URL>/<databaseName>
batchCount=1000


Note: The detailed steps of this process can be found in this knowledge base article: How do I connect GenRocket Runtime to a Database?


An Organization Admin or a Team Manager will need to add a new Database Resource to the GenRocket web platform if it has not already been added. 


Once added, each user will see the new Database Resource and can edit the value as needed for their local machine. The Database Resource is shared by the Organization; however, the value is User-specific and will vary per user.



Note: The detailed steps of this process can be found in this knowledge base article: How do I connect GenRocket Runtime to a Database?


Step 3: Set up Resources in GenRocket Platform

Resources within the GenRocket web platform must be configured properly to download your EDI Configuration, Scenario Chain Sets, Test Data Cases, etc. 


Every user must have the following 2 resources configured on their local machine: 

  • resource.home.directory - Defines the home directory on your local computer.
  • resource.output.directory - Defines the directory where generated files will be saved.

     

If you plan to retrieve data or populate tables within a connected database, you will need to enter the path of the Database Connection Properties File (Step 2) as the value for the Database Resource in the GenRocket web platform. 


For example, JDBC a very common way to connect to a database. In the example below, resource.jdbc.directory has been added and is used to enter the path of the Database Connection Properties File on the user's local machine.



Note: Additional information about configuring resources can be found in this knowledge base article: GenRocket Installation Overview.


Step 4: Download and Update my profile.prg

Any time the user changes the value of one or more resources, they will need to download their my profile.prg file and replace the old file on their local machine. 

These steps vary per operating system. To learn more, please see one of the following knowledge base articles: 


Step 5: Download the EDI Configuration File

After your EDI Project has been configured appropriately, you will need to download the EDI Configuration File. This can be done through the EDI Management Dashboard shown below. 


Click on the EDI Config button to download your EDI Configuration File for a selected EDI Project and Version.



Step 6: Download the Scenario Chain Set for the EDI Project

Next, you will need to download the Scenario Chain Set that is part of your EDI Project. Please note that this may take a few minutes to complete. 


This can also be done through the EDI Management Dashboard shown below. Click on the Scenarios button to download your Scenario Chain Set for the selected EDI Project and Version.



Step 7: Set up Test Data Queries (Optional)

Sometimes, real data needs to be queried and blended with synthetic test data to meet specific testing goals. Test Data Queries enable the blending of synthetic test data with real data. Within GenRocket, you can query real data from a database or a CSV file. 


To set up a Test Data Query, you will need to do the following: 

  1. Set Parameters for the Query (This will vary depending on whether a Database or CSV is being queried)
  2. Enter the Query to be performed on the Database or CSV File
  3. Add Domain Attributes for Each Column in the Database or CSV
  4. Download the Test Data Query Configuration File


Note: Organizational Variables can be selected and used with a Test Data Query.


The following solutions video provide a quick overview for Test Data Queries:

The following knowledge base articles can be used to learn more about setting up and using Test Data Queries within the GenRocket web platform: 


Step 8: Set up Test Data Rules (Optional)

Test Data Rules allow you to apply business logic when generating your test data. To set up and use Test Data Rules, you will need to do the following: 

  1. Create a Test Data Rule Set
  2. Create Test Data Rules
  3. Add Conditions and Actions for Each Rule
  4. Download the Test Data Rule Configuration File


Test Data Rules can be used to set up and test business logic for data generated by Domains within a Project or Project Version. Each Test Data Rule contains one or more Conditions and Actions, which are applied during data generation.



The following solutions video provide a quick overview for Test Data Rules:

The following knowledge base articles can be used to learn more about setting up and using Test Data Rules within the GenRocket web platform:


Step 9: Set up Test Data Cases (Optional)

Test Data Cases speed up the process of creating Test Data Cases with many variations (Loop Counts) for different types of testing (Beta, Unit, Load, etc.). To set up and use Test Data Cases, you will need to do the following: 

  1. Create a Test Data Case Set
  2. Create One or More Test Data Case Categories
  3. Create One or More Test Data Cases per Category
  4. Add Domains to each Test Data Case and Set Loop Counts
  5. Select Rule Sets and/or Queries for the Test Data Case Set
  6. Download the Test Data Case Set Configuration File


For example, let's say a tester needs to run 5 unit tests. Each Unit Test would be 1 Test Data Case and generate a specified number of Companies, Departments, Users, and Addresses. This example is shown below:


The following solutions video provide a quick overview for Test Data Cases:


The following knowledge base articles can be used to learn more about setting up and using Test Data Cases within the GenRocket web platform:


Step 10: Run the Scenario Chain Set with a Test Data Case from the Command Line

The command line for running a Test Data Case is displayed at the bottom of the Test Data Cases Dashboard. This command line reflects the currently selected Test Data Case within a set. 



Note: If a Test Data Rule or Test Data Query has been included within the Test Data Case, you will need to download the Test Data Rule Set and/or Test Data Query prior to running the command line. 


Important: If you do not need to use a Test Data Case for test data generation, then you will only need to run the Scenario Chain Set from the command line.


genrocket -r ScenarioChainSet.grs


Note: More information about running Test Data Cases with Scenario Chain Sets can be found in this knowledge base article: How to Download and Run a Test Data Case Set with a Scenario.


Useful Links: 

The following links can be used to learn more about getting started with GenRocket, EDI Projects, and Test Data Generation: 

Useful Videos:

The follow solutions videos are a great resource for getting started with GenRocket, the EDI Test Data Management Platform, Test Data Queries, Test Data Rules, and Test Data Cases: 


GenRocket Overview Video

The following solutions video provide a quick introduction to GenRocket:


GenRocket EDI Test Data Management (TDM) Platform

The following solutions video provide a quick overview for the EDI TDM Platform: