Text - HTML encode/decode

Declaration

<AMTEXT ACTIVITY="html_encode_decode" TEXT="text" ACTION="text (options)" RESULTVARIABLE="text" />

Description:

Encodes all applicable characters to their corresponding HTML entities or decodes HTML encoded characters to normal binary data.

Practical Usage

Commonly used to convert characters into a format that can be transmitted over the Internet.

Parameters

General

Property

Type

Required

Default

Markup

Description

Text

Text

Yes

 (Empty)

TEXT="text string"

The target data to encode/decode. As with every text parameter, if the data you wish to convert is contained in a variable, simply enter the variable name surrounded by percentage signs to resolve it to it's contents at runtime (e.g.,%variableName%).

Action

Text (options)

Yes

Encode

  1. ACTION="encode"

  2. ACTION="decode"

The action to perform. The available options are:

  • Encode (default) -  Encodes the target data into HTML format.

  • Decode - Decodes HTML encoded characters into binary data.

Populate variable with result

Text

Yes

(Empty)

RESULTVARIABLE="VarName"

The name of an existing variable in which to populate the newly encoded/decoded data.

 

Example

Description:

This sample task demonstrates ability to encode and decode data in HTML format.

 

<AMVARIABLE NAME="theText" />

<AMSHOWDIALOG ACTIVITY="input" DEFAULTVALUE="Enter a string of text here." RESULTVARIABLE="theText">This task demonstrates ability to

encode and decode data in HTML format.</AMSHOWDIALOG>

<AMTEXT ACTIVITY="html_encode_decode" RESULTVARIABLE="theText">%theText%</AMTEXT>

<AMSHOWDIALOG WINDOWTITLE="The text encoded to HTML format.">%theText%</AMSHOWDIALOG>

<AMTEXT ACTIVITY="html_encode_decode" ACTION="decode" RESULTVARIABLE="theText">%theText%</AMTEXT>

<AMSHOWDIALOG WINDOWTITLE="The HTML encoded data decoded back to binary text.">%theText%</AMSHOWDIALOG>