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