Insertable

At generation time an insertable routine does not become an object in its own right. Its code is generated within the calling form/report at the point where it is called. If the insertable global routine is called several times by the same form/report, then the code will be inserted several times in the code/report. The result is therefore only the form or report ‘dll’ file, which contains the logic of the insertable global routine. Due to this, an insertable global routine may not be syntactically error free, because it is not validated until generation. At that point the form/report calling the insertable global routine must be syntactically error free, including the code from the insertable global routine. The insertable global routine can have constants and variables declared, but these constants and variables are added at generation time to the object in which they are inserted, so duplicates in names might occur, which will cause generation errors. 

Routines can be defined in a global insertable routine. The insertable should be called in the code, the normal code of the insertable will be executed at the place of the call and the routines can be called anywhere from the rest of the code. 

Inside the insertable routine other insertable routines may be called (inserted). This may be done one level deep (i.e. the inserted routines may not insert routines themselves).

 

 Code should therefore be entered directly after the ‘end_definitions’ section.