Macromedia dreamweaver 8-extending dreamweaver User Manual

Page of 504
Participant EDML files
349
<insertText>
Description
This tag provides information about what to insert in the document and where to insert it. It 
contains the text to insert. Parts of the text that are customized should be indicated by using 
the 
@@parameterName@@
 format.
In some cases, such as a translator-only participant, you might not need this tag. 
Parent
implementation
Type
Block tag.
Required
No.
Value
The value is the text to insert in the document. If any parts of the text need customizing, they 
can be passed in later as parameters. Parameters should be embedded within two at (
@@
) signs. 
Because this text can interfere with the EDML structure, it should use the 
CDATA
 construct, as 
shown in the following example:
<insertText location="aboveHTML">
<![CDATA[<%= @@recordset@@).cursorType %>]]>
</insertText>
When the text is inserted, the 
@@recordset@@
 parameter is replaced by a recordset name that 
the user supplies. For more information on conditional and repeating code blocks, see the 
“Adding Custom Server Behaviors” chapter in Getting Started with Dreamweaver.
<insertText> attributes
The following items are valid attributes of the insertText tag.
location
Description
This attribute specifies where the participant text should be inserted. The insert location is 
related to the 
whereToSearch
 attribute of the 
searchPatterns
 tag, so be sure to set both 
).