Description

In the GenRocket web platform, three types of Variables may be created and referenced:

  • Organization Variables - Organization Variables are variables that are global to all Projects within your GenRocket organization. They can be referenced by any Generator within an Attribute of a Domain in any Project Version of a Project. Organization Variables can also be referenced within the Self Service module. 

  • Domain Variables - Domain Variables are instance variables of a Domain, They can be referenced by any Generator within an Attribute of a Domain in the same Project Version of a given Project. This makes Domain's variables global to other Domains. Domain Variables can also be referenced within the Self Service module.

  • Scenario Variables - Scenario Variables only apply to that Scenario and cannot be referenced outside of the Scenario.  


Variable Referencing at the Organization Level

Organization Variables provide a way to reference a Variable at the Organization Level. Organization Variables allow a value to be referenced by multiple Projects without the need to perform the same steps to configure the Variable in each Project. You can set up a collection of Organization Variables, called a suite, with their own defined values and then reference them as needed. 



When Should Organization Variables be Used?

  • Any time a constant value needs to be referenced in multiple Projects within your Organization. 


How do Organization Variables Work?

An Organization Variable must belong to an Organization Variable Suite. A Suite can have one or many individual Organization Variables, each with its own unique name and value.  

  1. Create an Organization Variable Suite
  2. Create one or more Organization Variables
  3. Reference Organization Variables where needed in GenRocket


Sample Story

An Account ID Number must be referenced and used by testers in several Projects within the Organization. Without using Organization Variables, this variable would need to be created within each Project it needs to be referenced within. 


An Organization Variable can be created within a suite so that each tester does not have to create the same variable multiple times. Once created, each tester can reference the variable as needed throughout every Project within the Organization. 


Step 1: Access and View Organization Variables

Organization Variable Suites can be viewed and managed by expanding the Management drop-down menu and selecting Organization Variables.



Step 2: Create an Organization Variable Suite

Organization Variables are created and managed within an Organization Variable Suite. You can create one or many suites within the web platform. Each suite can contain multiple variables. 


If the suite has already been created, continue to Step 3; otherwise, complete these steps: 

  1. Click the Create Variable Suite button.
  2. Enter a Name and Description.
  3. Click the Save button.




Note: To learn more about creating an Organization Variable Suite, click here.


Step 3: Create an Organization Variable

Next, you will need to create the Organization Variable that will be referenced. Each variable has a Name and Value. The value is what will be used when the variable is referenced. 

  1. Click the Create Variable button.
  2. Enter a Name and Value.
  3. Click the Save button.




Note: For more information on creating and managing Organization Variables, click here


Step 4: Reference the Organization Variable

An Organization Variable can be referenced across every Project within your Organization. 


Example 1: Referencing an Organization Variable in Generator Parameters

An Organization Variable can be referenced within an Attribute's Generator Parameter configuration.

  1. Double click on a Parameter input field.
  2. Select the Organization Variables Tab.
  3. Click the Plus (+) to select an Organization Variable.



For this example, the startRange Parameter for an id Attribute will reference the Organization Variable and increment it by one for each record. 



Example 2: Referencing an Organization Variable within a Test Data Case

Organization Variables can also be referenced within the Self Service module by a Test Data Case. This can be done by viewing the Test Data Case Domain within the G-Case. 

  • Click on the View Test Case Domain icon within the Action Column.




  • Within a Test Data Case Domain, you can create a new Attribute or add an existing Attribute and change its configuration. 

  • For this example, we will add an account Attribute. Click the Add Attribute button.



  • Enter the Attribute's Name and click Save.




  • For this example, we have replaced the default assigned Generator with the RangeGen Generator.

  • Double click to add a Reference for a Generator Parameter.



  • Select the Organization Variables Tab and then click the Plus (+) for the appropriate Organization Variable Suite.


  • Remember to click the Save Generator button after making any changes! 



In this example, the first record will start with the Organization Variable value and then increment by 1 for each record: