Description

Users can "author" a G-Questionnaire Template to create a default case. Once done, any user can copy the default template to create G-Questionnaire Cases and generate the required volume/variety of test data they need. 

In many cases, this step is performed by a Test Data Engineer (TDE), who is familiar with the GenRocket web platform. 


Story Overview

This is a continuation of the use case example discussed here. It will show the steps a Test Data Engineer (TDE) will take to set up the G-Questionnaire Template for other users (i.e., Developers and Testers). 


A TDE is authoring a template for a team of testers who are not very familiar with the GenRocket web platform but need to generate test data for the various tests they must perform. 


The TDE has already created a new G-Questionnaire Suite and will author the default template so testers can quickly create cases from it and generate the required test data. 


Note: Not all of the steps in this example may be required for a particular use case. If the G-Questionnaire Suite and Template have been created from an existing G-Case, some steps may also not be necessary.


Actors

  • G-Questionnaire Suite
  • G-Questionnaire Template
  • Test Data Engineer (TDE)


Prerequisites

  1. The user has already created a Project with the default Project Version
  2. The user has already set up the Project (e.g., added Domains, Attributes, Generators, Receivers, Scenarios, Rules, Queries, etc.) 
  3. The user has already created a new G-Questionnaire Suite within the G-Questionnaire Management Dashboard. To learn how to do so, click here.


Story Steps


Step 1 - Add Domains to the Template

The TDE will add all four Domains (Organization, Department, User, Address) to the template. This can be done in three different ways. To learn more, click here. 



Step 2 - Change Domain Loop Counts

The Loop Counts for each added Domain can be changed by clicking on the Edit (Pencil) icon. For this example, the TDE will not alter the loop counts, and users will do so when they set up their cases. Click here to learn more about changing Domain loop counts.


Step 3 - Add Individual Attributes to the Template

An Attribute must be added to make any Generator changes. Users in "Tester" mode can make limited modifications in the G-Questionnaire Case for these Attributes before generating data.

The TDE will add multiple Attributes to the Template from more than one Domain: 

  • Organization Domain - name Attribute
  • Department Domain - name Attribute
  • Address Domain - city, state, and zipCode Attributes


Note: Please note that new Attributes can also be added to one or more Domains from this form. To learn more about adding existing and new Attributes, click here. 


Step 4 - Replace, Link, or Modify Generators for Attributes

Users can select an Attribute and assign a different Generator, link Generators to generate complex data, or make changes to individual Generator parameters. For this example, the TDE has made the following changes: 


Example 1 - Replace the name Attribute's assigned Generator

For name Attribute, within the Organization Domain, a RangeConstantGen Generator was automatically assigned when it was created. This results in the following output: 

  • Organization1
  • Organization2
  • and so on...


The TDE has selected the name Attribute and replaced the currently assigned Generator with the F500Name2014Gen Generator.



To generate this type of synthetic data: 



Example 2 - Modify Generator Parameters for the address Attribute within the Address Domain

The TDE has also changed two parameters for the Generator assigned to the address Attribute within the Address Domain. This is done by selecting the Attribute and making the needed changes in the Generators Tab. 


The TDE has made the following changes to the Generator parameters: 

  • startNumber - Changed from 1000 to 100
  • randomize - Changed from "False" to "True"



To learn more about each available action for Generators, please see the following knowledge base articles: 


Step 5 - Add a Receiver to Each G-Questionnaire Domain

A user can select a Domain and add one or more Receivers to it through the Receivers Tab. Users can use the Receiver initially assigned to the Domain or add other Receivers. 


For this example, the TDE adds the DelimitedFileReceiver assigned to each of the four Domains when the Project was set up. They perform the following actions: 

  1. Select each Domain.
  2. Click on the Plus (+) icon.
  3. Tick the checkbox for the Receiver.
  4. Click Save.


Once added, users can make changes to the Receiver Parameters, etc.


Note: To learn more about adding and managing Receivers for G-Questionnaire Domains, click here. 


Step 6 - Add G-Rules to the Template

The G-Rules Tab can be used to add G-Rule Suites to the template. For G-Rules to be added, they must have already been created for a Project's Project Version within the G-Rules Management Dashboard. To learn more, click here.


For this example, the TDE will add a G-Rule Suite titled "UserRules" by completing the following steps:


  • Select the G-Rules Tab and click on the Add G-Rule button.


  • Click on each checkbox to select one or more G-Rule Suites, then click on the Add button.




Step 7 - Add G-Queries to the Template

The G-Queries Tab can be used to add G-Queries to the template. For G-Queries to be added, they must have already been created for the Project's Project Version within the G-Queries Management Dashboard. To learn more, click here. 


For this example, the TDE has added one G-Query titled "UserQueries" by completing the following steps:


  • Select the G-Queries Tab and click on the Add G-Query button.



  • Click on each checkbox to select one or more G-Queries and click on the Add button.




Step 8 - (Optional) Add Domains to Toggle

The grEnable Attribute can be used to determine if test data will be generated for a Domain. If a Domain is checked within the tree view, then test data will be automatically generated for it.

If unchecked, it will automatically be added to the Toggle Domain Tab, and the grEnable Attribute will be used to toggle data generation on and off for that Domain.



When a Domain is added to the Toggle Domain Tab, a user can choose to show the grEnable Attribute on the G-Questionnaire Preview. It can be used to enable or disable test data generation for that Domain. To learn more, click here.



For this example, the TDE did not add any Domains to this tab, and test data generation will occur automatically for every G-Questionnaire Domain. 



Step 9 - Preview the G-Questionnaire

Once finished, the user "authoring" the template (TDE, in this case) can preview the template to see how it will appear to other users when they create cases from it.




Note that An Author can continue to modify a Template even if the Testers are using it. The modifications an Author makes to the Template will be immediately reflected in the Cases referencing the Template.