You are here: Function Reference > Alphabetical Listing > S > SlipInsert

SlipInsert

Use this procedure/function to insert another email address on a routing slip associated with the form set.

Syntax

SlipInsert (Address, Mode)

Parameter

Description

Address

Enter an email address.

Mode

Choose from these options:

0 - linear recipient
1 - CC recipient

The default is zero (0).

The system optionally returns one (1) on success or zero (0) on failure.

This procedure only works with scripts associated with routing slips. This procedure lets you, via scripts, direct workflow during the routing process. It should not be used in a typical field script situation.

The address name is inserted immediately after the script reference in the routing slip. If two SlipInsert statements are executed in order, the second email address appears before the one inserted by the former statement. Think of this as last in, first out.

For example, assume the following routing slip is defined:

CC

Recipient

 

@MyScript EDJ

If the script executes the statements, SlipInsert("TOM",1); SlipInsert("CAR"), the slip will be adjusted to look as follows.

CC

Recipient

*
X

@MyScript CAR
TOM EDJ

The asterisk (*) indicates the script has already been executed. If the mode parameter is not zero (0), the new entry is appended as a carbon-copy (CC) recipient.

Example

Here are some examples:

Procedure

Result

Explanation

SlipInsert ( "TOM" )

1 or 0

The email address will be inserted immediately after the script reference. The default is a linear recipient.

SlipInsert( "TOM", 1)

1 or 0

Inserts the email address as a CC recipient.

See also