Description

G-Families discovers related Domains ("Families") within an imported Database Schema based on relationships that have been set among imported Domains. Once families have been discovered, permitted users can view visual diagrams for families and create G-Cases from them.


G-Families provides a visual grouping of related Domains to help focus testing. With a few clicks, users can automatically create a Suite of G-Cases from a discovered G-Family. 


In This Article


What are the Benefits of G-Families?

  • Users can focus on the related Domains that are necessary for specific test data challenges.
  • Users can quickly categorize (unit, load, negative, etc.) and create a suite of G-Cases.
  • Users can create new G-Cases from other G-Families when needed.
  • G-Families provides a visual diagram of related Domains (“families”) in Domain-specific and Entity-Relationship (ER) diagram formats.
  • Provides test data architects, engineers, and testers a better understanding of the data model.


Applicable GenRocket Personas

  • Data Architect
  • Test Data Engineer


Supported Import Types for G-Families

G-Families will be available any time a user completes one of the following import methods: 

  • XTS
  • XSD
  • DDL
  • JSON

Required Prerequisites for G-Families (XTS Imports)

The following steps must be performed before G-Families can be discovered from an XTS Import:

  1. Export Database Schema using genrocket -xts command. For more information, please see Using GenRocket XTS – Extract Table Schema.
  2. Import an XTS file. For step-by-step instructions, please see How do I use the XTS Import Wizard?.
  3. Validate and Set Parent/Sibling Relationships between Domains. For step-by-step instructions, please see How do I use the Domain Referencing Wizard?.


Required Prerequisites for Other Types of Imports

The following steps must be performed before G-Families can be discovered from a JSON, XSD, or DDL import: 

  1. Create Domains by importing a JSON, XSD, or DDL file into a selected Project and Project Version. 
  2. Validate and Set Parent/Sibling Relationships between Domains. For step-by-step instructions, please see How do I use the Domain Referencing Wizard?.


How to Access and View G-Families

G-Families can be accessed in one of two ways: 


Method 1 (JSON, DDL, and XSD Imports): 

  • Select a Project within the Project Dashboard.

    Graphical user interface, text, application, email 
Description automatically generated

  • Next, expand the Self Serve Options Menu for a Project Version and select G-Families



Method 2 (XTS Imports): 

  • Select a Project within the Project Dashboard.

    Graphical user interface, text, application, email 
Description automatically generated

  • Next, expand the Self Serve Options Menu for a Project Version and select XTS Wizard.

    Graphical user interface, text, application, chat or text message 
Description automatically generated 

  • Select the Domain Family Wizard within XTS Wizard.


How to Discover New Families

Complete the following steps to discover new Families for imported Domains:

  • Click on the Find New Families button.

    Graphical user interface, application

Description automatically generated

 

  • Click on Find New Families to continue.

    Graphical user interface, application

Description automatically generated

 

  • Click OK in the confirmation window.

    Graphical user interface, text, application

Description automatically generated

 

  • The process will go to the Queue and can be viewed in the Queue Status Pane.

    Graphical user interface, text, application

Description automatically generated

  • Detected families will appear in the Families Pane. They will have generic names (e.g., Family1, Family2) and can be renamed using the Pencil icon.

    Chart

Description automatically generated


G-Families Icons and Buttons

The following icons and buttons will be available once families have been discovered for the imported Domains and G-Cases have been created for each family:

Icon/Button

Description

Find new families based on the imported Domains and set Parent/Child/Sibling Relationships.
Download the currently displayed image (GenRocket Domains or ER Diagram).

 

View and access G-Cases for a Family. This icon will not be present until G-Cases have been created for a Family.

Create a G-Cases for a discovered Family.

Edit the Family name.


Delete a Family.


 

G-Families Viewing Mode Options

GenRocket Domain Mode (Default View)

This view can be used to view each Domain within a selected Family and the relationships between those Domains.

 

Entity Relationship Mode

This view can be used to view an ER Diagram for the selected G-Family. This diagram shows the actual names of the tables within the database.


How to Change What is Visible in the View

The bottom pane can be used to change what information is displayed for a selected Family within the GenRocket Domain or ER Diagram:

  • Attributes
  • Primary Keys
  • Foreign Keys

Everything is hidden by default. This pane can be used to change what is displayed for all Domains or selected Domains.

Chart

Description automatically generated

Visibility options can be changed for all Domains or selected Domains. The Filter Field can be used to locate a specific Domain within the G-Family.

Graphical user interface, application

Description automatically generated

 

Use the checkboxes to select or deselect Domains within the selected Family. Then use the Visibility Menu to change what is displayed:

  • Hide All – Attributes, Primary Keys, and Foreign Keys
  • Show All – Attributes, Primary Keys, and Foreign Keys
  • Show All PKs – Primary Keys
  • Show All PKs and FKs – Primary Keys and Foreign Keys

Graphical user interface, text, application

Description automatically generated

In the example below, “Show All” has been selected for all Domains within the selected G-Family.

Diagram

Description automatically generated


How to Create G-Cases from a G-Family

G-Cases can be created from each discovered Family. The first time a G-Case is created from a Family, GenRocket will create a suite that contains the selected category and an individual G-Case for each selected Domain.

  • Click on the Plus (+) icon for a G-Family.

    Graphical user interface, application

Description automatically generated

  • (Optional) Change the name for the G-Case Suite. It defaults to the Family Name.
  • Select a Suite Category (e.g., Beta, Negative, Load, Unit).
  • Enter a Default LoopCount for all selected Domains. This is the standard LoopCount for every selected Domain.

    Graphical user interface, application

Description automatically generated

  • Check one or all Domains by using the checkboxes. A G-Case will be created for each selected Domain.

  • (Optional) Enter a LoopCount for one or more selected Domains. This LoopCount will override the Default LoopCount.

    Graphical user interface, application, table

Description automatically generated

  • Click the Save button to finish.

    Graphical user interface, application, table

Description automatically generated

  • The G-Case Suite will be created, and the user will be redirected to the G-Cases Management Dashboard.

    Graphical user interface, text, application, email

Description automatically generated

  • Users can navigate back to G-Families from the G-Case Suite by clicking on the Family Name within the G-Cases Management Dashboard.

    Graphical user interface, application

Description automatically generated


Note: Once G-Cases have been created from a G-Family, future changes will need to be made within the G-Case itself. Changes made to the G-Family will not be reflected within existing G-Cases.

How to View G-Cases for a G-Family

After a G-Case has been added to a G-Family, the Briefcase icon will be present within the Families Pane.

Graphical user interface

Description automatically generated

Hover the mouse over this icon to view the G-Case Suite, Category, and Case information for the G-Family.

Graphical user interface, application, Word

Description automatically generated

How to Make Changes to an Existing G-Family

When Families are discovered, they are given a generic name (e.g., Family1, Family2). This name can be changed at any time.

  • Click on the Pencil icon for the Family.

    Graphical user interface, chart

Description automatically generated

  • Enter a new Name and click Save.

    Graphical user interface, application

Description automatically generated

  • The new name will be displayed in the Family Pane.

    Graphical user interface, application

Description automatically generated


How to Add New G-Cases to an Existing G-Family

More G-Cases can be added for a G-Family. When added, they will be added to the G-Cases Suite that was initially created for the G-Family.

  • Click on the Plus icon to add more cases to a Family.

    Graphical user interface, application

Description automatically generated

 

  • The Name cannot be changed once a G-Case Suite has been created from a G-Family.
  • Select a Suite Category and make changes to the Default LoopCount.

    Graphical user interface, application

Description automatically generated

  • Use the checkboxes to select one or more Domains.
  • (Optional) Enter a LoopCount for selected Domains.

    Graphical user interface, application, table

Description automatically generated

  • Click Save to finish.

    Graphical user interface, application, table

Description automatically generated

  • The user will be redirected to the G-Cases Management Dashboard and see the additional Category and/or Cases.

    Graphical user interface, text, application, email

Description automatically generated

 

How to Make Changes to Existing G-Cases for a G-Family

Any changes that need to be made to already created G-Cases from a G-Family will need to be made within the G-Cases Management Dashboard.

As mentioned previously, the G-Case information can be viewed by hovering the mouse over the Briefcase icon.

A picture containing graphical user interface

Description automatically generated

Click on the Briefcase icon to access the G-Case Suite and make changes to Cases created from the Family.

Graphical user interface

Description automatically generated

Within the G-Cases Management Dashboard, select a Category and Case to make changes.

Graphical user interface, text, application, email

Description automatically generated