TechNote

Indirect submit buttons require static references to submit buttons in LiveCycle Workspace ES

When LiveCycle Designer ES form designs include one indirect submit button, LiveCycle Workspace ES hides the indirect submit button and displays its own Complete button:

Indirect submit buttons include script that point to the actual submit button on the form. The submit button performs the data submission and is typically hidden.
When users click the Workspace ES Complete button, the script of the indirect submit button executes and causes the hidden submit button to submit the form.

The script of the indirect submit button must use a static reference to the actual submit button. If the script does not use a static reference and instead resolves the submit button at run time, Workspace ES does not hide the indirect submit button on the form.

To include a static reference to the submit button, the script includes the full path to the submit button.The following example script includes a static reference to the submit button named RENDERAGAIN. When used in the click event of an indirect submit button, the indirect submit button is correctly hidden when the form is displayed in Workspace ES:

 searchForm.Page1.searchFields.RENDERAGAIN.execEvent("click");

When scripts use the resolveNode function to find a form object, the resolution occurs at run time. For example, if the following script is used in the click event of an indirect submit button, Workspace ES does not hide the indirect submit button:

 xfa.resolveNode("reuseSearchForm.Page1.searchFields.RENDERAGAIN").execEvent("click");

Note: The resolveNode function is used in JavaScript scripts when occurrence values are required to point to same-named form objects, and the pound sign (#) is used to point to unnamed objects or to distinguish object properties from form objects. (See Referencing unnamed and repeated objects.) If your indirect submti button uses the resolveNode function for this reason, you need to either use FormCalc scripts or redesign the form so that occurrence values and pound signs are not required to point to the submit button.

For more information about the behavior of submit buttons in Workspace ES, see How LiveCycle Workspace ES handles buttons in PDF forms.