Place holder

 

NotesToPaper is able to replace place holders that are part of Notes rich-text fields. If these place holders have a predefined structure, then it is possible to replace them with the content of NotesToPaper fields or variables.

 

If you pass the contents of a Notes rich text field e.g. by using the function NTPSendRTFieldByName to a NotesToPaper Report and the rich text field contains place holders, then these place holders can be replaced by the contents of other NotesToPaper fields or variables. in order to activate this replacement functionality it is necessary to call the function NTPSetOption with the parameter NTPOPTION_RTF_REPLACEFIELDS (replacement with fields) or NTPOPTION_RTF_REPLACEVARIABLES (replacement with variables).

 

The place holders in the rich text must be formatted in the following way: for variables [<VARIABLE:VAR_NAME>] and for fields [<FIELD:FIELD_NAME>]. "VAR_NAME" and "FIELD_NAME" stand for the variable reseptively the field name in NotesToPaper.

 

These place holders are then replaced with the contents of other NotesToPaper fields/variables that have been previously filled by using NTPSendFieldByName or NTPSendVariable.

 

A sample of how to use the place holders may be found in the sample database "NTPRT.NSF"

 

A sample for a rich text with variables:

 

Dear Mr. [<FIELD:NAME>],

[<VARIABLE:PRODUCT>] enables the Notes application designer to integrate the creation of lists and labels, along with other types of correspondence printouts (e.g. form letters), directly into a Lotus Notes application. The user can thus carry ....

 

 

Note: The place holders in a rich text field may not be interrupted by changes in format, i.e. font or font size. If e.g. the font size is changed in a place holder, then the text will not be recognized as a place holder.