ADDImage_Propagate has been replaced with ADDSection_Propagate. ADDImage_Propagate and ADDSection_Propagate have same functionality; the only change is to the function name. The existing ADDImage_Propagate scripts will continue to function and will not require any modification.
Use this procedure/function during GenData processing to add a new section and propagate global data onto the newly added section as needed.
Note | This DAL procedure should only be used with the GenData program. Documaker Desktop users should use the AddSection procedure. If called from Documaker Desktop, this procedure will work exactly like the AddSection procedure. |
ADDSection_Propagate (FAP, Section, Form, Group, Flag)
Parameter |
Description |
FAP |
Enter the name of the section file to load and add to the form. |
Section |
Enter the name of a section which will precede the new section. The default is the current section. |
Form |
Enter the name of a form in the form set. If you specify the Section parameter, that section must occur on this form. The default is the current form. |
Group |
Enter the name of a group that contains the specified form. The default is the current group. |
Flag |
Determines if the section is inserted on the same page or on a new page. 0 - new page The default is zero (0). |
Optionally, this procedure returns one (1) on success or zero (0) on failure.
This procedure adds a copy of the section you specify to a form. The system loads the new section onto the page after the section, form, or group you specified or onto a new page which it creates after the section, form, or group you specified. The section added does not have to be predefined for the form.
Keep in mind...
Here are some examples:
Procedure |
Result |
Explanation |
ADDSection_Propagate ("IMG1") |
1 - if successfully added 0 - if not added |
Insert the named section, IMG1, on a new page after the current page. |
ADDSection_Propagate("NEW1", "IMG\3",,"GRP") |
1 - if successfully added 0 - if not added |
Insert the named section, NEW1, after the third occurrence of IMG, within GRP. This section is placed on a new page after the third occurrence of the specified section. |
ADDSection_Propagate ("IMG1",,,, 1) |
1 - if successfully added 0 - if not added |
Insert the named section, IMG1, after the current section on the same page. |
ADDSection_Propagate("NEW1", "IMG\3", , , 1) |
1 - if successfully added 0 - if not added |
Insert the named section, NEW1, after the third occurrence of IMG on the same page. |
© Copyright 2014, Oracle and/or its affiliates. All rights reserved. Legal notices.