Name (%NAME) Macro

Applies to ReadyAPI 3.57, last modified on December 12, 2024

The Name macro is used to insert human names into the strings generated by a data source using the Custom String data generator.

The macro is an analog of the Name data generator.

Syntax

The macro has the following syntax:

%NAME(Gender, NameKind)

Parameters

Gender

Specifies the gender of names to be generated:

  • Any – Default. Generates names of any gender, either male or female.

  • Male – Generates male names only.

  • Female – Generates female names only.

The parameter is case-sensitive.

NameKind

Specifies the type of names to be generated:

  • Full – Default. Generates full names.

  • FirstName – Generates first names only.

  • LastName – Generates last names only.

The parameter is case-sensitive.

Examples

The following example demonstrates how to use the Name macro:

  • Customer's name: %NAME(Any, Full)

    Example: Name macro in Data Generator

    Click the image to enlarge it.

    Generates a string containing full names of any gender.

  • %NAME(Male, FirstName)

    Generates only first male names.

  • %NAME(LastName, Female) <- Invalid value

    The parameters swapped places, so ReadyAPI will not parse the custom string.

  • %NAME(Any) <- Invalid value

    The NameKind parameter is missing, so ReadyAPI will not parse the custom string.

  • %NAME(ANY, FULL) <- Invalid value

    The parameters are case-sensitive, so ReadyAPI will not parse the custom string.

Remarks

For more information on adding macros to custom strings, see About Custom String Generator.

For more information on general rules used for specifying macro parameters, see Custom String Generator Rules.

See Also

Name Generator
Custom String Generator
Macro Reference

Highlight search results