Text - Base64 encode/decode

Declaration

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

Description:

Encodes a sequence of binary data into Base64 format and/or decodes a sequence of Base64 encoded text into binary data.

Practical Usage

Commonly used to encode binary data that needs to be stored and transferred over media that are designed to deal with textual data. This is to ensure that the data remains intact without modification during transport. Base64 is used commonly in a number of applications including e-mail via MIME and storing complex data in XML.

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 Base64 format.

  • Decode - Decodes Base64 encoded data 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 Base64 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 Base64 format.

</AMSHOWDIALOG>

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

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

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

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