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.
General Parameters
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 |
|
The action to perform. The available options are:
|
Populate variable with result |
Text |
Yes |
(Empty) |
RESULTVARIABLE="VarName" |
The name of an existing variable in which to populate the newly encoded/decoded data. |
Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.
Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)
On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)
Example
The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.
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>