Scripting Readme File - Adobe LiveCycle Designer 7.0

Adobe LiveCycle Designer

Version 7.0

Scripting Readme File

December 2004

This file contains important information that was not available when the product documentation was written. Review this information before running this version of Adobe^® LiveCycle^™ Designer.

Contents

Supported Versions of JavaScript

New mandatoryMessage and formatMessage Properties for Field Type Objects

Calculate Event Does Not Fire Automatically after Adding or Removing a Subform

FormCalc Get, Post, and Put Functions Do Not Fire for the Initialize Event in Acrobat 7.0

Initialize Event Timing

Supported Versions of JavaScript

Designer supports JavaScript version 1.5 and earlier.

Note: If you want to create forms to render to HTML using Adobe Form Server, then you should conform to the version of JavaScript supported by the client web browser of your form users.

Back to Contents

New mandatoryMessage and formatMessage Properties for Field Type Objects

New mandatoryMessage and formatMessage properties were added to Designer after the completion of the Designer Help.

These properties allow form authors who are familiar with the XML Form Object Model to write script to set the Empty Message and Validation Pattern Message for a field through script. They function in a similar way to the validationMessage property and are supported by Adobe Acrobat^®, Adobe Reader, and HTML clients.

Back to Contents

Calculate Event Does Not Fire Automatically after Adding or Removing a Subform

If you add or remove an instance of a subform, the Calculate event does not automatically fire and update calculations that include values from the added or deleted subform. To update calculations you must update the script to invoke the recalculate method for the form. This example to recalculate the form after adding an instance of a subform appears in the Dynamic Interactive Purchase Order Sample:

// Invoke the Instance Manager to add one instance of the detail subform.
_detail.addInstance(1);
//Invoke the recalculate method to include the field values from the added subform in calculations.
xfa.form.recalculate(1);

Back to Contents

FormCalc Get, Post, and Put Functions Do Not Execute for the Initialize Event in Acrobat 7.0

The FormCalc Get, Post, and Put functions will only execute if the form is certified. Acrobat 7 cannot verify that the form is certified until after the initialize event has run. You can use the docReady event to call the Get, Post, and Put functions on certified forms prior to the rendering of the form.

Back to Contents

Initialize Event Timing

The Designer help does not describe all occasions that the initialize scripting event fires. The event fires in these circumstances:

On a PDF form, the initialize event fires when you open a form in either Acrobat or Adobe Reader. After the form opens, the initialize event fires again when the form imports data or adds a new instance of a subform. In the case of a new subform instance, only the initialize event for that subform instance fires.
On a PDF or HTML form rendered using Form Server, any initialize events set to execute on the server occur immediately after data binding has taken place. Initialize events set to fire on the client fire when the form first displays in a browser and do not execute again if the form is routed back to the server.

Back to Contents

Scripting Readme File -- Adobe LiveCycle Designer 7.0 -- 10/28/2004 12:42:01 PM