Convert Case Action

Declaration

<AMTEXTCONVERTCASE CASE="text [options]" TEXT="text" RESULTVARIABLE="text [variable name]">

See Also

Convert Case Action-Setting Properties, Find Text Action, Get Subtext Action, Insert Text Action, Pad Text Action

Description

Converts the specified text to upper case or lower case letters and place the result in a variable.

Practical Usage

Text manipulation.

Parameters

General Tab

Text to Convert

Text, Required
MARKUP: TEXT="My Name is Joe"

Specifies target text to retrieve the subtext from.  

Convert

text [options], Optional Default is upper_case
MARKUP: CASE="upper_case"

Specifies the case to convert the text to.

The available options are:

Populate Variable with Result

Text [variable name], Required
MARKUP: RESULTVARIABLE="varname"

Specifies the variable to receive the new value.

Notes

Using Variables

All variables must be created before they can be used. This is done using the Create Variable <AMVARIABLE> action. Once created, variables can be set using the Set Variable <AMSET> action, or by certain actions that support populating variables. To get data out of the variables, in any action parameter, simply surround the variable name with percentage % signs (e.g. %varname%). Remember not to use percentage signs when specifying the name of a variable to populate, percentage signs are only needed to get data out.

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMVARIABLE NAME="test">hello</AMVARIABLE>
<AMTEXTCONVERTCASE TEXT="%test%text" RESULTVARIABLE="test">
<AMMESSAGEBOX>%test%</AMMESSAGEBOX>