Description

G-Questionnaire is a component of the GenRocket self service platform that can be used to create a G-Questionnaire Suite with a default test data case template for a selected Project Version within a given Project.

Once set up, other users can copy the template to quickly create test data cases and generate the exact variety of data they need for their tests.



In This Article


Solutions Video

The following video provides a solutions example of using the G-Questionnaire feature: 



Benefits of Using G-Questionnaire 

  • Create volume and variety of test data quickly, with minimal effort.
  • Quickly and easily design a test data case from a single form.
  • Users can modify test data cases without changing the original test data case.
  • Create role separation between "Author" and "Tester," thereby providing a simplified screen for users who are not as familiar with GenRocket.


When Should G-Questionnaire be Used? 

  • Any time multiple users will need to use variations of the same default case to generate test data.
  • Any time a user needs to quickly generate a variety of test data from the same test data case.


When Should G-Questionnaire not be Used? 

  • Any time a complex G-Case does not need to be used by testers to create their own cases for testing requirements. 
  • In this case, it can be created and managed within the G-Case Management Dashboard


Who Should use G-Questionnaire? 

  • Org Admin or Test Data Engineer (TDE) - G-Questionnaire Template Setup and Test Data Generation
  • Developers and Testers - Test Data Generation based on Testing Requirements


G-Cases vs. G-Questionnaire

  • G-Cases allow a Power User, such as a Test Data Engineer (TDE), to create multiple, complex test data cases. However, this requires extensive knowledge of GenRocket, which many users in an organization (i.e., Developers and Testers) may not have. 

  • G-Questionnaire solves the above problem by allowing a Power User to configure a default template, which can be used by other users to quickly create cases and generate their test data, regardless of how much knowledge they have of GenRocket.

G-Questionnaire Terms

  • G-Questionnaire Suite - A suite containing the default case template and all created cases. A Project Version can have one or many suites.

  • G-Questionnaire Template - A template that can be configured to create a default case. The template can be used by any user to create their own G-Case(s). Also, referred to as a 'G-Questionnaire'. 

  • G-Questionnaire Cases - Individual cases that users create by copying the default template or other existing cases within a G-Questionnaire Suite. Also referred to as a 'G-Case'.

  • G-Questionnaire Management Dashboard - The management dashboard for managing G-Questionnaire suites, templates, and cases.

  • Power User - A user familiar with the five key components, self service platform, and other features of the GenRocket web platform. This is typically a Test Data Engineer (TDE) or Org Admin.


How to Access G-Questionnaire

  • Select the Project within the Project Dashboard.
  • Expand the Self Serve Menu Options menu for a Project Version and select G-Questionnaire.


G-Questionnaire Editing Modes

  • Author Mode - A user is creating or "authoring" a G-Questionnaire Template. A GenRocket Power User typically does this (e.g., Test Data Engineer or Org Admin).



  • Tester Mode - All users except the Q-Questionnaire Creator and Organization Admin will be in "Tester" mode. These are users, such as Developers or Testers, that need to obtain data for a test case quickly and are not well-versed in every aspect of GenRocket.


    As users become more familiar with GenRocket, they can look "under the hood" and make additional modifications to G-Questionnaire Cases in "Tester" mode.



How Does G-Questionnaire Work?


Use Case Example

A large company would like to test a variety of user data for an application. The Project contains complex rules and queries that must be built into the test data cases. A team of testers needs to quickly generate specific volumes/varieties of data based on their particular test cases. This team does not have extensive knowledge of GenRocket and must obtain their test data quickly through the web platform.


A GenRocket Power User (i.e., Test Data Engineer or Org Admin) can model and design a base test data case (i.e., G-Questionnaire Template) to assist with this. Testers can then copy this default case to create their test data cases, change loop counts, and make other modifications without changing the default case or having a vast knowledge of GenRocket. 


Step 1 - Power User Creates and Sets up a Project

A Test Data Engineer (TDE) creates a Project with the default Project Version for this example. This Project contains four Domains with the following Attributes: 

  • Organization - id, name, address, city, state, zip, phoneNumber
  • Department - id, name, phoneNumber
  • User - id, firstName, lastName, middleInitial, username, password
  • Address - id, address, city, state, zipCode


The TDE sets up Parent/Child/Sibling Relationships between Domains, adds a DelimitedFileReceiver to each Domain, and creates a Scenario for each Domain. A Scenario Chain is also created so each tester can download one Scenario file to generate their data.



Step 2 - Power User Creates a G-Questionnaire Suite

Next, the TDE will create a G-Questionnaire Suite for the default Project Version created in the previous step. Users can create a new, blank G-Questionnaire Suite or one from an existing G-Case. Click here for more information on creating G-Questionnaire Suites.


For this example, the TDE will create a new G-Questionnaire Suite from within the G-Questionnaire Management Dashboard:



Step 3 - Power User "Authors" the G-Questionnaire Template

The system automatically creates a template that cannot be deleted, only modified. The TDE will "author" the template to create the default G-Questionnaire Case.


 

The TDE "authors" the template by adding Domains, Attributes, Receivers, G-Rules, and G-Queries. They may also replace Generators or modify Generator parameters for added Attributes. To see a complete example, click here


Note: An Author can continue to modify a Template even if the Testers are using the template. Any modifications to the template will be immediately reflected in the Cases referencing the template.


Step 4 - Users Create Cases from the G-Questionnaire (or other Cases)

Any user can create one or more G-Questionnaire Cases from the default template. They can also copy other cases that have been added to the suite. 



For this example, two separate testers have created their own G-Questionnaire Cases titled:

  • tester1case
  • tester2case




Step 5 - Users Make Changes to their G-Questionnaire Case

By default, the user will see the "above the hood" view and can perform the following actions when in "Tester" mode. 

  • Alter the Loop Count for each Domain
  • Enter a Constant Value for an Attribute
  • Select from Generated Preview Values
  • Revert to the Original Generator
  • Go "Under the Hood" to make further modifications


Step 5a - Tester 1 Configures their G-Questionnaire Case

For this example, Tester 1 has modified their case to generate the following data: 

  • 1 Organization
  • 3 Departments
  • 10 Users per Department
  • 1 Address per User


They want to use a constant value of "ABC Organization" for the Organization Name.



Step 5b - Tester 2 Configures their G-Questionnaire Case

For this example, Tester 2 has modified their case to generate the following data: 

  • 2 Organizations
  • 5 Departments
  • 100 Users per Department
  • 1 to 3 Addresses per User


No other changes will be made to the Attributes/Generators by Tester 2. 



Note: Click here for a complete example of modifying G-Questionnaire cases in "Tester" mode.

Step 6 - Users Generate Their Test Data

Users will need to complete four steps to generate test data with a G-Questionnaire Case: 

  1. Install GenRocket Runtime on their Local Machine
  2. Download the G-Questionnaire Suite or an Individual Case 
  3. Download the Scenario, Scenario Chain, or Scenario Chain Set
  4. Run the command in a Command Prompt or Terminal Window


Step 6a - Install GenRocket Runtime on Local Machine

Users need to install GenRocket Runtime and download their Profile before they can generate test data. These steps vary depending on what operating system they are using. Please see these articles for more information: 


Step 6b - Download G-Questionnaire Suite or Case

Tester 1 wants to generate data for their G-Questionnaire Case. They can download the entire suite or an individual case by clicking the Download (Cloud) icon. 


Entire Suite (Generate Data for any Case)


Individual Case (Generate Data Only for that Case)


Step 6c - Download the Scenario, Scenario Chain, or Scenario Chain Set

Tester 1 then downloads the Scenario Chain created by the TDE for the Project used in this example. This can be done from the Project Dashboard by clicking the Download (Cloud) icon within the appropriate pane.



Step 6d - Generate Test Data using the G-Questionnaire Command

Within the G-Questionnaire Management Dashboard, Tester 1 selects their G-Questionnaire Case and copies the command line displayed at the bottom of the dashboard. 



They then open a Command Prompt or Terminal window and navigate to the directory where the Scenario, Scenario Chain, or Scenario Chain Set is located. 


For this example, it is the Downloads folder; however, this path may differ depending on how a user's Organization Resources have been set up for their local computer. 


Mac OS/Linux Path Example


Windows Path Example


Paste the command into the command line and replace <ScenarioName.grs> with the name of the Scenario, Scenario Chain, or Scenario Chain Set. For this example, it is a Scenario Chain titled "AllScenarioChain.grs". 



Finally, Tester 1 presses the "Enter" key to run the G-Questionnaire command for their case at the command line.



Sample Output

This example generates four delimited files (one for each Domain): Organization, Department, User, and Address. 



Tester Expected Output

Tester 1 set up the G-Questionnaire Case to generate the following output for each Domain: 

  • 1 Organization
  • 3 Departments
  • 10 Users per Department
  • 1 Address per User


They wanted to use a constant value of "ABC Organization" for the Organization Name.


Organization File

One organization has been generated with "ABC Organization" as the name. 



Department File

Three departments have been generated, and they all belong to the generated organization, as shown by the organization column.


User File

Thirty users have been generated. This is ten users per department, as shown by the department column.


Address File

As shown by the user column, one address has been generated per user (30).



Generating Data using G-Questionnaire with G-Repository

G-Repository Server/Client reduces the steps users must take to generate their test data and ensures they are using the most current files (e.g., G-Questionnaire Suite, Scenario, Scenario Chain, Scenario Chain Set). 


When set up, users do not have to download individual files. This is done automatically in the background via the G-Repository Server and Client. For more information on G-Repository, click here


Additional Information

The following pages provide additional information for using G-Questionnaire: 


Topic

Description

G-Questionnaire Management DashboardLearn more about the G-Questionnaire User Interface.
Two Ways to Create G-Questionnaire SuitesLearn more about the two methods for creating a G-Questionnaire Suite.
How to "Author" a G-Questionnaire TemplateSee an example for authoring a G-Questionnaire Template. 
How to Create Cases from a G-Questionnaire TemplateLearn how to create cases from a G-Questionnaire Template and view use case examples.
How to Add Domains to a G-Questionnaire TemplateLearn about the three ways Domains can be added to a G-Questionnaire Template.
How to Change or Randomize Domain Loop CountsLearn about the options for changing and randomizing loop counts. 
How to Add Attributes to a G-Questionnaire TemplateLearn more about adding Attributes to a G-Questionnaire Template
How to Add Receivers to G-Questionnaire DomainsLearn how to add Receivers to G-Questionnaire Domains.
How to Add Domains to Toggle with the grEnable AttributeLearn how to toggle test data Generation for Domains using the grEnable Attribute.