What is an Organization Resource?

Organization Resources are variables shared by all users throughout an organization but whose values may differ for each user. They are available to all Projects and Project Versions within the organization and are added to GenRocket by the Organization Admin. 

These resources are most often referenced by Receiver parameters and Generator parameters to avoid hard-coding a value that may be specific to a particular user. Any time a change is made to a resource, the user will need to download their profile again and place it in their .genrocket folder before they can generate test data. 

In This Article

When Should Organization Resources be Used? 

  • Any time a user wants to run a GenRocket Scenario and generate test data using GenRocket Runtime on their local machine or a server.

What Types of Resources can be Created?

  • User Resources
  • Server Resources

Default Organization Resources

The following three resources are available, by default, for every Organization. 

  • resource.home.directory - defines the user's home directory path, where GenRocket Runtime will look for required test data generation items such as Scenarios and G-Cases at the time of test data generation.
  • resource.jdbc.directory - defines the location of config.properties file(s) used for database connections.
  • resource.output.directory - defines where generated output files will be saved. 

In the example below, the user will be generating test data on their local computer, running the Windows OS:

Note: Org Admins can set up additional resources (ser and server) within the GenRocket web platform as needed. General users can only alter a resource's value and select Server Resources (when available).

How do Organization Resources Work?

Organization Resources allow each user to enter their own directory path for shared resources. This makes it possible for any user within a given Organization to download a Scenario and run it on their local computer.

Each Organization Resource consists of the following:

  • Resource Name - Shared by all users within the organization.
  • Resource Value - Defined per user in the organization.

They can be viewed in the upper right corner of the Project Dashboard after the user logs into the GenRocket web platform.

Example Mac/Linux Resource Setup
The Resource Value will appear as shown below when GenRocket is set up and used on a Linux/Mac computer. 

Example Windows Resource Setup

When GenRocket will be used on a computer running the Windows operating system, the drive will need to be included in the Resource value. 

What Resources Need to be Configured Before a User Can Run Scenarios?

This will depend on several factors, including where the information will be stored and accessed. Here are some examples:  

  • Generate Files on Local Computer
    • resource.home.directory
    • resource.output.directory

  • Query from or Insert into a Database
    • resource.home.directory
    • resource.jdbc.directory
    • resource.output.directory

  • Generate Data on a Server Resource
    • Add the Server Resource
    • Set up Server Resources (they have the same three default resources)

What Should I do When a Displayed Resource is not Needed? 

All added resources for the organization will appear here but may not be necessary for every GenRocket user. If additional Organization Resources are present and not needed by a user, then a N/A can be entered as the value. 

This will allow users to configure their resources appropriately and download their GenRocket User Profile (my profile.prg) to run Scenarios and generate test data. 

If no value is entered, the user will receive an error when attempting to download their profile in the GenRocket web platform.

Additional Information



Connecting to DatabasesGenRocket can connect to most databases with an available JDBC Driver. How do I connect GenRocket Runtime to a Database?
Offline Certificate
GenRocket Runtime can be used while connected to a secure network or offline. To use GenRocket Runtime offline, you must add an offline certificate to your .genrocket folder in your home directory.

An alternative is setting up G-Repository. Click here for more information. 
Using an Offline Certificate for Corporate Environments 
G-RepositoryAn alternative to the Offline Certificate that provides the same benefits and more. Users do not have to manage the downloading of files when set up and organizations gain access to additional reporting features. G-Repository Articles