Description

The MatchStringGen Generator checks a string for a value match using a contains, startsWith, or endsWith matching function. You can check a constant or referenced value for a match and link one or more Generators to generate specific output based on the result. 


In This Article


Generator Parameters

The following parameters may be configured for the MatchStringGen Generator. Items with an asterisk* are required. 

  • matchType* - Defines the function to use for matching. The following functions are: 
    • contains
    • startsWith
    • endsWith
  • string* - A string or reference to an Attribute whose string will be checked for a match.
  • value* - A string or reference to an Attribute whose string will be used by the matching function at the token to match.
  • matchCase* - Determines if the string and value are case sensitive when matching.
  • notResult* - Switches the Boolean result.
    • "not" of  false = true
    • "not" of true = false


Example 1 - Email Address Validation

A tester must test an application that requires users to enter a valid email address. They want to check each email address based on the domain name (e.g., com, net, gov). When valid, the value will be 'true'; otherwise, it will be 'false'. 


The MatchStringGen will be used to perform a validation check. If the email address has one of the following domain names, it is valid: 

  • com
  • net
  • gov


This example will use two Attributes to validate the email address:

  • email - generates valid and invalid emails
  • validation - checks if the email is valid or invalid



The generated output is shown below:


ListGen (gen1)

Generates values to check for a valid email domain name (e.g., com, net, gov).

  • random - true, values are generated randomly
  • list - values that will be generated randomly


MatchStringGen (gen2)

Checks each email for the domain names in the referenced ListGen (gen1). If valid, generates 'true'; otherwise, generates 'false'.

  • matchType - endsWith, the string must end with the value
  • string - references the email Attribute
  • value - references the ListGen (gen1) for a list of valid domain names


Example 2 - Check if Account Type is Checking

A user wants to determine if an account is a checking account. They can then use the result to generate a desired outcome when it is a checking account. For this example, account numbers start with one of the following: 

  • CHK - checking
  • SAV - savings


When the account number contains CHK, the generator should generate 'true'; otherwise, it should generate 'false'. This example uses two Attributes:

  • account - generates the account number
  • checkingValidation - checks the account number to see if it is a checking account


NOTE: You can also use Linked Generators to perform the check or to generate specific test data based on the result (true/false).


MatchStringGen (gen1) Configuration

The MatchStringGen will look for CHK in the account number and return 'true' when it is present. 

  • matchType = startsWith, must be at the beginning of the string
  • string = #{Match.account}, references the account Attribute.
  • value = CHK, value it will look for



Example 3 -  Check for Number 4 in a Randomly Generated Number String

For this example, two Generators have been linked to show the randomly generated number string and the MatchStringGen Generator output. 

gen1 = Randomly generated string

gen2 = Result based on generated string


For this example, each string containing a "4" will show true:



A RandomStringGen Generator generates a random number string. It is referenced by the string Parameter of the MatchStringGen Generator.



Here is the RandomStringGen Generator configuration: 

  • length = 6, generates a string of six characters
  • stringType = numbers