In the GenRocket web platform, within a given Project Version, Attributes may reference other Attributes in three primary levels:
- Domain Level - Withing a Domain, an Attribute may reference other Sibling Attributes. However, Domains are loosely coupled to each other at the Domain level. At the Domain level, parent, child and sibling relationships can be defined, but the relationships are conceptual and not concrete. Thus, at the Domain level, Attributes cannot reference other Attributes outside of their own Domain.
- Scenario Level - Within a Scenario, the parent, child and sibling relationships, which were defined conceptually at the Domain Level, are concrete at the Scenario level within Scenario Domains. Thus, at the Scenario level, Attributes can also reference Attributes from within other sibling Scenario Domains.
- Test Data Case Level - Within a Test Data Case, Domains are global to each other within a given Project Version. The relational coupling between Domains is loose because Test Data Case Domains are not associated with any Scenario and can only dynamically alter a given Scenario at runtime.
The three levels of Attribute referencing, described above, are very flexible and useful for most testing scenarios. However, there are testing scenarios that involve organization-level challenges where Attributes need to reference other Attributes where Domains are not directly related to each other or relationships between Domains cross Project level boundaries. This is where Organization Attributes come into view and can be used to solve this Test Data Challenge.
Attribute Referencing at the Organization Level
Organization Attributes provide a way to reference an Attribute at the Organization Level. Organization Attributes allow an Attribute's generated value to be referenced by multiple Projects without the need to perform the same steps to configure the Attribute in each Project. You can set up a collection of Organization Attributes with their own Generator configurations and then reference them via Test Data Cases as needed.
When Should Organization Attributes Be Used?
Organization Attributes should be used when the generated value needs to be referenced by multiple Projects within the Organization. This allows the Attribute to be referenced across Projects by multiple users without having to define the Attribute within each individual Project.
For example, let's say you need to set up an Attribute that uses linked Generators to generate a unique Code. This configuration takes time to set up for each Project that needs this Code as part of its generated test data. It would be very time consuming to set up the Attribute each time it is needed and have a greater risk of error.
Instead, an Organization Attribute can be configured with the linked Generators to generate the required code value. This allows any Attribute created within a Test Data Case Domain to reference the Organization Attribute, code, without having to set up all the Generators each time for each Project/Project Version. Additionally, all Attributes referencing the Organization Attribute will be producing the same exact values.
How Do Organization Attributes Work?
To reference Organization Attributes, you will need to first set up and configure an Organization Attribute Suite consisting of one or more Attributes with their own Generator configurations.
Once this has been done, you will be able to reference the Organization Attributes within a Project Version's Test Data Cases for test data generation.
How to Access Organization Attributes
Organization Attributes are managed through the Organization Attribute Management Dashboard, which is accessed through the Management menu in the navigation bar.
Defining an Organization Attribute Example
Step 1: Create an Organization Attribute Suite
An Organization Attribute Suite contains one or multiple Organization Attributes. Each Attribute will have its own Generators and Parameter configurations. To view the step-by-step instructions for creating an Organization Attribute Suite, click here.
For this example, an Organization Attribute Suite titled "OrgAttributeExample" has been created.
Step 2: Add Organization Attributes to the Suite
Next, you will need to one or more Organization Attributes to the new suite. To view step-by-step instructions for adding Organization Attributes, click here.
For this example, only one Organization Attribute has been added to the suite:
Step 3: Add and Configure Generators for Each Organization Attribute
To complete the Organization Attribute configuration, you will need to add at least one Generator to each Organization Attribute. A single Generator or multiple Generators can be added at one time to the selected Organization Attribute (highlighted in blue). To view step-by-step instructions, click here.
For this example, five Generators have been assigned to the code Organization Attribute.
- gen1 - Generates first 4 random numbers
- gen2 - Generates first random character
- gen3 - Generates second random character
- gen4 - Generates second 4 random numbers
- gen5 - Combines the values generated from the first 4 Generators into a single code.
Click on a Generator to select it. The selected Generator will be highlighted in blue and its Parameters will appear to the right. The steps for making changes to Generator Parameters and saving these changes are the same as when working with Domain Attributes.
Step 4: Reference Organization Attributes
Once your Organization Attributes have been created and configured with the appropriate Generators, they can be referenced by individual testers across Projects. For step-by-step instructions regarding how to reference Organization Attributes, click here.
Organization Attributes can be referenced directly through Attribute Generators. Double click when viewing the Parameter Configuration for an Attribute Generator. For this example, the ConstantGen Generator will be shown:
In the Select Attribute to Reference dialog window, select the Organization Attribute tab.
Select an Organization Attribute Suite and then use the Plus (+) icon to reference the Organization Attribute within the selected Generator and Parameter.
Step 5: Generating Your Test Data
Once the Organization Attribute has been referenced by an Attribute Generator within a Domain, Scenario Domain, or Test Data Case Domain, it will be included in the generated test data. This occurs when a Scenario, Scenario Chain, or Scenario Chain Set is ran from the Command or Terminal window.
For example, let's say the code Attribute is referenced within a User Domain of a Project as an Attribute titled "identificationCode". This code consists of a unique combination of letters and numbers. It will be generated for each user record generated by the User Domain.
To generate the data, we will need to download the User Scenario and then run it in the Command or Terminal window using the code line below:
genrocket -r UserScenario.grs
The output for this example would appear as shown below: