Description

Generator Tags override the Data Warehouse's default Generator Assignment. They define rules for automatically assigning a Generator to new Attributes based on a specified tag value and match type. Generator Tags can be created at the: 

  • Project level - Tags apply to all Project Versions created within that Project
  • Organization level - Tags apply to Project Versions of all Projects within the Organization. 


For example, each Project Version in a Project will contain a firstName and lastName Attribute. Based on usage statistics, the Data Warehouse will assign the NameGen as the default Generator for these Attributes. However, the first and last names must be Canadian in each Project Version. Generator Tags can be created at the Project level to ensure that the CanadaNameGen is assigned to those Attributes when a new Project Version is created in that Project. 

Note: If this needs to apply to every Project within the Organization, you can create an Organization level tag or promote a Project level tag to the Organization level. 


In This Article


Generator Tags Video Tutorial

The following video provides additional information about Generator Tags: 



How do Generator Tags Work?

  1. A user creates Generator Tags at the Project or Organization level.
  2. Each Generator Tag has a value and a match type, which are used to determine if the Generator should be assigned to a new Attribute. 
    • Value - Must be in the Attribute name.
    • Match -  How the value should match the Attribute name (e.g., Starts With, Ends With, Matches, or Contains). 

  3. If Generator Tags exist, GenRocket will check the Attribute's name for specified tag values when creating a new Attribute. 
  4. If a match is found, the Generator Tag will automatically assign the Generator to the new Attribute.
  5. Otherwise, the data warehouse will assign a default Generator based on usage statistics (or) assign the SimplePatternGen as a placeholder. 

How to View Generator Usage Statistics

You can view the Generator usage statistics for an Attribute from the Domain Dashboard by clicking on the highlighted icon in the image below: 




The highest percentage rank is the Generator that gets assigned by default. You can use the tag icon to assign one of the other Generators (override it) to the Attribute.



How to Create Generator Tags at the Project Level

Tags created at the Project level apply to all Project Versions within that Project. They are accessed and managed through the Generator Tags tab within the Project Dashboard. You can create Project level tags in one of two ways. 


Method 1 - Generator Tags Tab in Project Dashboard

  1. Select the Project and Project Version.
  2. Select the Generator Tags tab in the Management pane.
  3. Select New Generator Tag.


  4. Enter a Name and a Value. The value must exist within the Attribute name.
  5. Select a Match option from the drop-down menu (Starts With, Ends With, Contains, and Matches).
  6. (Optional) Check the Ignore Case checkbox if you want the case to be ignored. 
    • Note: When Ignore Case is not checked, the Attribute Name case must match the Tag Value case.
  7. Enter the Generator name and select it within the drop-down menu.
  8. Click Save once finished.

     
  9. Optional) You can use the dialog window to make changes to the Parameter configuration for the Generator. 
  10. In this example, the nameType has been changed to firstName. 
  11. Click the Save button to save your changes.
  12. Click the Close button once finished to close the dialog window.


     

Method 2 - Project Tag in the Attribute Dashboard

This option creates the tag based on the currently assigned Generator for the Attribute. It can be accessed by viewing the Attribute Generator in the Attribute Dashboard.

  1. Make sure the appropriate Generator has been assigned to the Attribute.
  2. Configure the Generator Parameters and save the changes.
  3. Select the Project Tag option.


  4. Click Yes in the dialog window to confirm.
  5. Click OK in the dialog window.
  6. The tag can be viewed from the Project Dashboard by selecting the Generator Tags tab in the Management pane.


    Note: The Match Type will default to "Matches when Project level Generator Tags are created this way. 

How to Create Generator Tags at the Organization Level

  1. Expand the Organization Menu and select Generator Tags.


  2. Select New Organization Generator Tag.



  3. Enter a Name and Value for the Generator Tag.
  4. Select a Match type from the drop-down menu (e.g., Starts With, Ends With, Contains, or Matches).
  5. (Optional) Check the Ignore Case check box if the case should be ignored.
  6. Enter part of or the full name of the Generator and select it within the menu.
  7. Once finished, click the Save button.


  8. (Optional) In the dialog window, you can change the Generator's Parameter configuration. 
  9. Remember to click Save if changes are made. Click Close to exit the dialog window.


How to Promote Tags from the Project to the Organization Level

Please note that once a Project level tag has been promoted, it will no longer exist at the project level and may need to be recreated if needed again. Complete these steps:

  1. Select the Project Version within the Project Dashboard.
  2. Select the Generator Tags Tab.
  3. Click on the Move to Organization Generator icon in the Actions column.



  4. Click Yes in the dialog window to confirm.
  5. Click OK to close the dialog window.
  6. Expand the Organization menu and select Generator Tags to view the promoted tag.