|
Tip>Designer |
|
|
Creating a FillPoint in a fill operation |
|
|
Article #: |
0020 |
|
Contributor: |
Peter Ottermann |
|
GF version: |
All |
|
Applies to: |
FillPoints at run time |
|
Last updated: |
November 5, 2001 |
Description
Create a FillPoint that will display another FillPoint after an initial fill operation, ready for a second fill operation.
Explanation
You may have a situation where you require a new FillPoint to be displayed once a document has been filled, i.e. instead of a fixed value. This may be necessary for several reasons, for example:
The document moves along a chain of users, each user filling in different parts of the same document.
You want to include a FillPoint in your Script that impacts on your current document e.g., %[Templates.Set('\','Letterhead.dot')]. If you insert this FillPoint into your Script it will attempt to base the Script on the specified template instead of the current document. As a work around, you can insert a FillPoint into your Script that will create a new FillPoint when the Script is run. The new FillPoint is inserted into the document, so the eventual output is then in the document rather than the Script.
This requires a FillPoint to be constructed within another FillPoint. The two most efficient ways of doing this are:
Construct a FillPoint using the BrL (Bracket Left) and BrR (Bracket Right) tasks. These tasks allow you to insert square brackets into a FillPoint without them being interpreted as FillPoint delimiters:
%[BrL()&'Surname'&BrR()].
At run time this FillPoint gets filled. When GhostFill encounters the percent and left square bracket combination "%[", it assumes that this is the start of a FillPoint. The end of the FillPoint is signified by the right square bracket "]". The result is inserted into the document as a new FillPoint:
%[Surname].
Example 2: Using characters that do not require input
Construct a FillPoint using the pipe, tilde or an empty string. This FillPoint then acts as a divider between the "%" and the "[" that will be used to make up the new FillPoint.
%%[|][Surname]
%%[~][Surname]
%%[''][Surname].
At run time the %[character] FillPoint gets filled. The result is then a new FillPoint, ready for a subsequent fill:
%[Surname].