Insert Text Action

Insert Text

Inserts characters into the specified text and places the result in a variable. Mainly used as a text manipulation tool to insert new text into an already existing text value.

Declaration

<AMTEXTINSERT ACTION="text(options)" INSERTTEXT="text" TARGETTEXT="text" RESULTVARIABLE="text(variable name)" />

See Also: Find Text, Get Subtext, Pad Text, Replace Text, Trim Text, Format Date/Time

General Tab

Property	Type	Required	Default	Markup	Description
Text to insert into	Text	Yes	(Empty)	TEXT="My name is Joe"	The target text to insert the new text into. As with every text parameter, if the data you want to write is contained in a variable, enter the variable name surrounded by percentage signs to resolve it to it's contents at runtime (i.e. %VarName%).
Action to Take	Text (options)	No	insert_beginning	ACTION="insert_end"	Indicates the location in the target text in which characters should be inserted into. The available options are: Insert at beginning: The text is inserted at the beginning of the target text. Insert at end: The text is inserted at the end of the target text. Insert at position: The text is inserted at a specific position of the target text.
Position to insert text	Number	No	(Empty)	LENGTH="3"	The position in the text to perform the insert. This parameter is available only if the Action to take parameter is set to Insert at position.
Characters to be inserted	Text	Yes	(Empty)	INSERTTEXT="Hello"	The characters that should be inserted.
Populate Variable with Result	Text	Yes	(Empty)	RESULTVARIABLE="varname"	The name of the variable to receive the new value after character insertion is performed.