Script Steps Reference

Chapter 5
|
Fields script steps 47
Insert Text
Format
Insert Text [Select; <table::field>; “<text>”]
Options
• Select entire contents replaces the contents of a field. If you do not select this
option, Insert Text inserts the specified value at the end of the field's data.
• Select Go to target field or click Specify to specify the field to receive the pasted
information. If no field is selected, the Insert Text command will place the specified
text after the insertion point. If no field is active at the time the command executes, it
has no effect. Also, if the selected field is not present on the current Layout, the Insert
Text command has no effect.
• Specify displays the Specify dialog box where you can enter the exact value you
want to paste.
Web compatibility
This script step is web-compatible.
Description
Pastes a text value into a field in the current record. This script step pastes text that is
specified in the script, instead of text provided by the user.
Notes
• This script step is intended to paste text into text field types. To insert other types of
data into other types of fields, use either the Insert Calculated Result script step on
page 48 or the Set Field script step on page 45.
• If the specified field does not exist on the layout where the script is being performed,
Insert Text returns an error code which can be captured with the Get(LastError) function.
• In a web-published database, use a Commit Record/Request script step after an
Insert Text script step to update the record in the browser window.
Example
Insert Text [Select; Table1::LastName; "Smith"]