Use this procedure/function to add a new form to a document and propagate global data onto the new form.
AddForm_Propagate (Form, Insert, Group)
Parameter |
Description |
Form |
Enter the name of a form in the specified group. |
Insert |
Enter the name of a form after which the new form should be inserted. The default is to append after the last form in the group. |
Group |
Enter the name of a group to contain the specified form. The default is the current group. |
The system optionally returns one (1) on success or zero (0) on failure.
The form named must be a valid form for the given group. You cannot add a form defined for one group into another group. You can specify the insert (form) name using the occurrence indicator.
If you include the Group parameter, it must reference a group included in the form set. You cannot add a group or add forms to a group that were not specified during form selection.
Keep in mind...
When using DAL to add sections not predefined within a form and you intend to also import and export those forms, be sure to set the IgnoreInvalidImages option in the ImpFile_CD control group within your INI settings file.
Here are some examples:
Procedure |
Results |
Explanation |
AddForm_Propagate( "0002EA") |
1 (success) or 0 (failed) |
Add the named form, 0002EA, after the last form in the current group. |
AddForm_Propagate ( "C22510WGIM", "C22510WGIM \1", Sales") |
1 (success) or 0 (failed) |
Insert the named form, C22510WGIM, after the first occurrence of specified form, C22510WGIM, within the named group, Sales. See sample output. |
Employer: Employee: Date of Loss: File Number: State Case Num:
|
Oracle Insurance J. Stewart 12/11/10 12345 |
|
form name = section name = |
C22510WGIM GENRCHDR |
Samford and Son |
|
|
|
|
|
|
|
|
|
Sincerely,
|
|
|
|
|
Workers’ Compensation Unit cc: J. Stewart |
|
|
|
Note the missing data (CC: J. Stewart4) for the field, Copies, that has section scope. The fields, employer, employee, date of lost, and file number, that are defined as global scope appear on the added form, C22510WGIM\2.
Employer: Employee: Date of Loss: File Number: State Case Num:
|
Oracle Insurance J. Stewart 12/11/10 12345 |
|
form name = section name = |
C22510WGIM\2 GENRCHDR |
Samford and Son |
|
|
|
|
|
|
|
|
|
Sincerely,
|
|
|
|
|
Workers’ Compensation Unit
|
|
|
|
© Copyright 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices